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 |
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_ELIGIBLE |
Ad group is eligible to serve ads |
AD_GROUP_EFFECTIVE_STATUS_NOT_ELIGIBLE |
Ad group is not eligible to serve ads |