Ad Group
The Ad Group object represents a group of ads within a campaign that share the same targeting and bidding strategy.
¶ Properties
| Field | Type | Description |
|---|---|---|
ad_group_id |
string | Unique ad group identifier |
campaign_id |
string | Parent campaign ID |
name |
string | Ad group name |
ad_product |
string | Ad product type |
schedule |
Schedule | Ad group schedule |
budget |
Budget | Ad group budget |
bidding |
Bidding | Bidding strategy |
targeting |
TargetingCriteria | Targeting criteria |
actions |
list[AdGroupAction] | Ad group actions |
dayparting_schedule |
DaypartingSchedule | Dayparting schedule |
subjects |
AdSubjects | Ad subjects |
configured_status |
string | Status configured by the user |
effective_status |
string | Status representing deliverability of the ad group |
effective_status_reasons |
array[string] | Reasons why the ad group is not eligible to be served |
ads |
array[AdSummary] | Summary of ads in this ad group |
¶ Configured Status Values
| Value | Description |
|---|---|
AD_GROUP_CONFIGURED_STATUS_INVALID |
Invalid ad group status |
AD_GROUP_CONFIGURED_STATUS_DRAFT |
Ad group is in draft state |
AD_GROUP_CONFIGURED_STATUS_ACTIVE |
Ad group is active and running |
AD_GROUP_CONFIGURED_STATUS_PAUSED |
Ad group is paused by the user |
AD_GROUP_CONFIGURED_STATUS_DELETED |
Ad group has been deleted |
¶ Effective Status Values
| Value | Description |
|---|---|
AD_GROUP_EFFECTIVE_STATUS_INVALID |
Invalid status |
AD_GROUP_EFFECTIVE_STATUS_PAUSED |
Ad group is paused |
AD_GROUP_EFFECTIVE_STATUS_CAMPAIGN_PAUSED |
Ad group is paused due to campaign being paused |
AD_GROUP_EFFECTIVE_STATUS_ACTIVE |
Ad group is active and serving ads |
AD_GROUP_EFFECTIVE_STATUS_COMPLETED |
Ad group has completed |
AD_GROUP_EFFECTIVE_STATUS_SCHEDULED |
Ad group is scheduled to start |
AD_GROUP_EFFECTIVE_STATUS_DELETED |
Ad group is deleted |
AD_GROUP_EFFECTIVE_STATUS_DRAFT |
Ad group is in draft state |
AD_GROUP_EFFECTIVE_STATUS_WITH_ISSUES |
Ad group has issues preventing delivery |