AdGroupAd

  • An ad group ad is identified by a resource name with a specific format including customer_id, ad_group_id, and ad_id.

  • Key information about an ad group ad includes its status, the associated ad, policy summary, ad strength, and recommendations for improvement.

  • Output-only fields provide aggregated views of the ad's performance, including reasons for underperformance, attached labels, and asset automation settings.

  • Each ad group ad is linked to a specific ad group.

An ad group ad.

Fields

resource_name

string

Immutable. The resource name of the ad. Ad group ad resource names have the form:

customers/{customer_id}/adGroupAds/{ad_group_id}~{ad_id}

status

AdGroupAdStatus

The status of the ad.

Ad

Immutable. The ad.

policy_summary

AdGroupAdPolicySummary

Output only. Policy information for the ad.

ad_strength

AdStrength

Output only. Overall ad strength for this ad group ad.

action_items[]

string

Output only. A list of recommendations to improve the ad strength. For example, a recommendation could be "Try adding a few more unique headlines or unpinning some assets.".

labels[]

string

Output only. The resource names of labels attached to this ad group ad.

primary_status

AdGroupAdPrimaryStatus

Output only. Provides aggregated view into why an ad group ad is not serving or not serving optimally.

primary_status_reasons[]

AdGroupAdPrimaryStatusReason

Output only. Provides reasons for why an ad group ad is not serving or not serving optimally.

ad_group_ad_asset_automation_settings[]

AdGroupAdAssetAutomationSetting

Settings that control the types of asset automation. See the AssetAutomationTypeEnum documentation for the default opt in/out behavior of each type.

ad_group

string

Immutable. The ad group to which the ad belongs.