Ad
The Ad object represents an individual advertisement within an ad group.
¶ Properties
| Property | Type | Description |
|---|---|---|
ad_id |
string | Unique ad identifier |
ad_group_id |
string | Ad group identifier |
campaign_id |
string | Campaign identifier |
name |
string | Ad name |
creative_id |
string | Creative identifier (UUID). Present on Sponsored Brands ads. References a creative created and approved in Ads Manager. |
configured_status |
string | Status configured by the user |
effective_status |
string | Status representing deliverability of the ad |
effective_status_reasons |
array[string] | Reasons why the ad is not eligible to be served |
¶ Configured Status Values
| Value | Description |
|---|---|
AD_CONFIGURED_STATUS_INVALID |
Invalid status |
AD_CONFIGURED_STATUS_ACTIVE |
Ad is active and running |
AD_CONFIGURED_STATUS_PAUSED |
Ad is paused by the user |
AD_CONFIGURED_STATUS_DRAFT |
Ad is in draft state |
¶ Effective Status Values
| Value | Description |
|---|---|
AD_EFFECTIVE_STATUS_INVALID |
Invalid status |
AD_EFFECTIVE_STATUS_ACTIVE |
Ad is active and serving |
AD_EFFECTIVE_STATUS_PAUSED |
Ad is paused |
AD_EFFECTIVE_STATUS_SCHEDULED |
Ad is scheduled to start in the future |
AD_EFFECTIVE_STATUS_COMPLETED |
Ad has run to its scheduled end date |
AD_EFFECTIVE_STATUS_DRAFT |
Ad is in draft state |
AD_EFFECTIVE_STATUS_WITH_ISSUES |
Ad has issues preventing it from serving |
AD_EFFECTIVE_STATUS_DELETED |
Ad’s campaign was deleted or archived before the ad completed |