The new Search Ads 360 Reporting API is now available. Join the searchads-api-announcements Google group to stay up to date on upcoming enhancements and releases.

ad_group_ad

An ad group ad.

Attributed resources
ad_group
campaign
customer

Fields from the above resources may be selected along with this resource in your SELECT and WHERE clauses. These fields will not segment metrics in your SELECT clause.

Fields/Segments/Metrics

This page shows all metrics and segments that can be put in the same SELECT clause as the fields of ad_group_ad. However, when you specify ad_group_ad in the FROM clause, some metrics and segments cannot be used. Use the following filter to show only the fields that can be used when ad_group_ad is specified in the FROM clause.

Is ad_group_ad specified in the FROM clause of your query?

Resource fields
ad.display_url
ad.expanded_dynamic_search_ad.ad_tracking_id
ad.expanded_dynamic_search_ad.description1
ad.expanded_dynamic_search_ad.description2
ad.expanded_text_ad.ad_tracking_id
ad.expanded_text_ad.description1
ad.expanded_text_ad.description2
ad.expanded_text_ad.headline
ad.expanded_text_ad.headline2
ad.expanded_text_ad.headline3
ad.expanded_text_ad.path1
ad.expanded_text_ad.path2
ad.final_urls
ad.id
ad.name
ad.resource_name
ad.responsive_search_ad.ad_tracking_id
ad.responsive_search_ad.path1
ad.responsive_search_ad.path2
ad.text_ad.ad_tracking_id
ad.text_ad.description1
ad.text_ad.description2
ad.text_ad.display_mobile_url
ad.text_ad.display_url
ad.text_ad.headline
ad.type
creation_time
engine_id
engine_status
labels
last_modified_time
resource_name
status

Segments
ad_network_type
conversion_action_name
date
device
keyword.ad_group_criterion
keyword.info.match_type
keyword.info.text
month
quarter
week
year

Metrics
all_conversions
all_conversions_value
average_cpc
average_cpm
clicks
client_account_conversions
client_account_conversions_value
client_account_view_through_conversions
conversions
conversions_value
cost_micros
cross_device_conversions
cross_device_conversions_value
ctr
impressions
visits

ad_group_ad.ad.display_url
Field description	The URL that appears in the ad description for some ad formats.
Category	`ATTRIBUTE`
Data Type	`STRING`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

ad_group_ad.ad.expanded_dynamic_search_ad.ad_tracking_id
Field description	The tracking id of the ad.
Category	`ATTRIBUTE`
Data Type	`INT64`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

ad_group_ad.ad.expanded_dynamic_search_ad.description1
Field description	The first line of the ad's description.
Category	`ATTRIBUTE`
Data Type	`STRING`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

ad_group_ad.ad.expanded_dynamic_search_ad.description2
Field description	The second line of the ad's description.
Category	`ATTRIBUTE`
Data Type	`STRING`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

ad_group_ad.ad.expanded_text_ad.ad_tracking_id
Field description	The tracking id of the ad.
Category	`ATTRIBUTE`
Data Type	`INT64`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

ad_group_ad.ad.expanded_text_ad.description1
Field description	The first line of the ad's description.
Category	`ATTRIBUTE`
Data Type	`STRING`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

ad_group_ad.ad.expanded_text_ad.description2
Field description	The second line of the ad's description.
Category	`ATTRIBUTE`
Data Type	`STRING`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

ad_group_ad.ad.expanded_text_ad.headline
Field description	The headline of the ad.
Category	`ATTRIBUTE`
Data Type	`STRING`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

ad_group_ad.ad.expanded_text_ad.headline2
Field description	The second headline of the ad.
Category	`ATTRIBUTE`
Data Type	`STRING`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

ad_group_ad.ad.expanded_text_ad.headline3
Field description	The third headline of the ad.
Category	`ATTRIBUTE`
Data Type	`STRING`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

ad_group_ad.ad.expanded_text_ad.path1
Field description	Text appended to the auto-generated visible URL with a delimiter.
Category	`ATTRIBUTE`
Data Type	`STRING`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

ad_group_ad.ad.expanded_text_ad.path2
Field description	Text appended to path1 with a delimiter.
Category	`ATTRIBUTE`
Data Type	`STRING`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

ad_group_ad.ad.final_urls
Field description	The list of possible final URLs after all cross-domain redirects for the ad.
Category	`ATTRIBUTE`
Data Type	`STRING`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	False
Repeated	True

ad_group_ad.ad.id
Field description	The ID of the ad.
Category	`ATTRIBUTE`
Data Type	`INT64`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

ad_group_ad.ad.name
Field description	The name of the ad. This is only used to be able to identify the ad. It does not need to be unique and does not affect the served ad. The name field is currently only supported for DisplayUploadAd, ImageAd, ShoppingComparisonListingAd and VideoAd.
Category	`ATTRIBUTE`
Data Type	`STRING`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

ad_group_ad.ad.resource_name
Field description	The resource name of the ad. Ad resource names have the form: `customers/{customer_id}/ads/{ad_id}`
Category	`ATTRIBUTE`
Data Type	`RESOURCE_NAME`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	False
Repeated	False

ad_group_ad.ad.responsive_search_ad.ad_tracking_id
Field description	The tracking id of the ad.
Category	`ATTRIBUTE`
Data Type	`INT64`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

ad_group_ad.ad.responsive_search_ad.path1
Field description	Text appended to the auto-generated visible URL with a delimiter.
Category	`ATTRIBUTE`
Data Type	`STRING`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

ad_group_ad.ad.responsive_search_ad.path2
Field description	Text appended to path1 with a delimiter.
Category	`ATTRIBUTE`
Data Type	`STRING`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

ad_group_ad.ad.text_ad.ad_tracking_id
Field description	The tracking id of the ad.
Category	`ATTRIBUTE`
Data Type	`INT64`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

ad_group_ad.ad.text_ad.description1
Field description	The first line of the ad's description.
Category	`ATTRIBUTE`
Data Type	`STRING`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

ad_group_ad.ad.text_ad.description2
Field description	The second line of the ad's description.
Category	`ATTRIBUTE`
Data Type	`STRING`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

ad_group_ad.ad.text_ad.display_mobile_url
Field description	The displayed mobile URL of the ad.
Category	`ATTRIBUTE`
Data Type	`STRING`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

ad_group_ad.ad.text_ad.display_url
Field description	The displayed URL of the ad.
Category	`ATTRIBUTE`
Data Type	`STRING`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

ad_group_ad.ad.text_ad.headline
Field description	The headline of the ad.
Category	`ATTRIBUTE`
Data Type	`STRING`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

ad_group_ad.ad.type
Field description	The type of ad.
Category	`ATTRIBUTE`
Data Type	ENUM APP_AD APP_ENGAGEMENT_AD APP_PRE_REGISTRATION_AD CALL_ONLY_AD DISCOVERY_CAROUSEL_AD DISCOVERY_MULTI_ASSET_AD DISCOVERY_VIDEO_RESPONSIVE_AD DYNAMIC_HTML5_AD EXPANDED_DYNAMIC_SEARCH_AD EXPANDED_TEXT_AD GMAIL_AD HOTEL_AD HTML5_UPLOAD_AD IMAGE_AD LEGACY_APP_INSTALL_AD LEGACY_RESPONSIVE_DISPLAY_AD LOCAL_AD RESPONSIVE_DISPLAY_AD RESPONSIVE_SEARCH_AD SHOPPING_COMPARISON_LISTING_AD SHOPPING_PRODUCT_AD SHOPPING_SMART_AD SMART_CAMPAIGN_AD TEXT_AD TRAVEL_AD UNKNOWN UNSPECIFIED VIDEO_AD VIDEO_BUMPER_AD VIDEO_NON_SKIPPABLE_IN_STREAM_AD VIDEO_OUTSTREAM_AD VIDEO_RESPONSIVE_AD VIDEO_TRUEVIEW_DISCOVERY_AD VIDEO_TRUEVIEW_IN_STREAM_AD
Type URL	`google.ads.searchads360.v0.enums.AdTypeEnum.AdType`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

ad_group_ad.creation_time
Field description	The timestamp when this ad_group_ad was created. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss.ssssss" format.
Category	`ATTRIBUTE`
Data Type	`DATE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

ad_group_ad.engine_id
Field description	ID of the ad in the external engine account. This field is for SearchAds 360 account only, for example, Yahoo Japan, Microsoft, Baidu etc. For non-SearchAds 360 entity, use "ad_group_ad.ad.id" instead.
Category	`ATTRIBUTE`
Data Type	`STRING`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

ad_group_ad.engine_status
Field description	Additional status of the ad in the external engine account. Possible statuses (depending on the type of external account) include active, eligible, pending review, etc.
Category	`ATTRIBUTE`
Data Type	`ENUM AD_GROUP_AD_ACCOUNT_PAUSED AD_GROUP_AD_AD_GROUP_PAUSED AD_GROUP_AD_APPROVED AD_GROUP_AD_CAMPAIGN_PAUSED AD_GROUP_AD_DISAPPROVED AD_GROUP_AD_ELIGIBLE AD_GROUP_AD_INAPPROPRIATE_FOR_CAMPAIGN AD_GROUP_AD_MOBILE_URL_UNDER_REVIEW AD_GROUP_AD_NOT_REVIEWED AD_GROUP_AD_ON_HOLD AD_GROUP_AD_PARTIALLY_INVALID AD_GROUP_AD_PAUSED AD_GROUP_AD_PENDING_REVIEW AD_GROUP_AD_REMOVED AD_GROUP_AD_SERVING AD_GROUP_AD_TO_BE_ACTIVATED AD_GROUP_AD_UNDER_REVIEW UNKNOWN UNSPECIFIED`
Type URL	`google.ads.searchads360.v0.enums.AdGroupAdEngineStatusEnum.AdGroupAdEngineStatus`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

ad_group_ad.labels
Field description	The resource names of labels attached to this ad group ad.
Category	`ATTRIBUTE`
Data Type	`RESOURCE_NAME`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	False
Repeated	True

ad_group_ad.last_modified_time
Field description	The datetime when this ad group ad was last modified. The datetime is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss.ssssss" format.
Category	`ATTRIBUTE`
Data Type	`DATE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

ad_group_ad.resource_name
Field description	The resource name of the ad. Ad group ad resource names have the form: `customers/{customer_id}/adGroupAds/{ad_group_id}~{ad_id}`
Category	`ATTRIBUTE`
Data Type	`RESOURCE_NAME`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	False
Repeated	False

ad_group_ad.status
Field description	The status of the ad.
Category	`ATTRIBUTE`
Data Type	`ENUM ENABLED PAUSED REMOVED UNKNOWN UNSPECIFIED`
Type URL	`google.ads.searchads360.v0.enums.AdGroupAdStatusEnum.AdGroupAdStatus`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

segments.ad_network_type
Field description	Ad network type.
Category	`SEGMENT`
Data Type	`ENUM CONTENT MIXED SEARCH SEARCH_PARTNERS UNKNOWN UNSPECIFIED YOUTUBE_SEARCH YOUTUBE_WATCH`
Type URL	`google.ads.searchads360.v0.enums.AdNetworkTypeEnum.AdNetworkType`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

segments.conversion_action_name
Field description	Conversion action name.
Category	`SEGMENT`
Data Type	`STRING`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

segments.date
Field description	Date to which metrics apply. yyyy-MM-dd format, for example, 2018-04-17.
Category	`SEGMENT`
Data Type	`DATE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

segments.device
Field description	Device to which metrics apply.
Category	`SEGMENT`
Data Type	`ENUM CONNECTED_TV DESKTOP MOBILE OTHER TABLET UNKNOWN UNSPECIFIED`
Type URL	`google.ads.searchads360.v0.enums.DeviceEnum.Device`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

segments.keyword.ad_group_criterion
Field description	The AdGroupCriterion resource name.
Category	`SEGMENT`
Data Type	`RESOURCE_NAME`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	False
Repeated	False

segments.keyword.info.match_type
Field description	The match type of the keyword.
Category	`SEGMENT`
Data Type	`ENUM BROAD EXACT PHRASE UNKNOWN UNSPECIFIED`
Type URL	`google.ads.searchads360.v0.enums.KeywordMatchTypeEnum.KeywordMatchType`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

segments.keyword.info.text
Field description	The text of the keyword (at most 80 characters and 10 words).
Category	`SEGMENT`
Data Type	`STRING`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

segments.month
Field description	Month as represented by the date of the first day of a month. Formatted as yyyy-MM-dd.
Category	`SEGMENT`
Data Type	`DATE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

segments.quarter
Field description	Quarter as represented by the date of the first day of a quarter. Uses the calendar year for quarters, for example, the second quarter of 2018 starts on 2018-04-01. Formatted as yyyy-MM-dd.
Category	`SEGMENT`
Data Type	`DATE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

segments.week
Field description	Week as defined as Monday through Sunday, and represented by the date of Monday. Formatted as yyyy-MM-dd.
Category	`SEGMENT`
Data Type	`DATE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

segments.year
Field description	Year, formatted as yyyy.
Category	`SEGMENT`
Data Type	`INT32`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

metrics.all_conversions
Field description	The total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric.
Category	`METRIC`
Data Type	`DOUBLE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

metrics.all_conversions_value
Field description	The value of all conversions.
Category	`METRIC`
Data Type	`DOUBLE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

metrics.average_cpc
Field description	The total cost of all clicks divided by the total number of clicks received. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
Category	`METRIC`
Data Type	`DOUBLE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

metrics.average_cpm
Field description	Average cost-per-thousand impressions (CPM). This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
Category	`METRIC`
Data Type	`DOUBLE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

metrics.clicks
Field description	The number of clicks.
Category	`METRIC`
Data Type	`INT64`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

metrics.client_account_conversions
Field description	The number of client account conversions. This only includes conversion actions which include_in_client_account_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
Category	`METRIC`
Data Type	`DOUBLE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

metrics.client_account_conversions_value
Field description	The value of client account conversions. This only includes conversion actions which include_in_client_account_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
Category	`METRIC`
Data Type	`DOUBLE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

metrics.client_account_view_through_conversions
Field description	The total number of view-through conversions. These happen when a customer sees an image or rich media ad, then later completes a conversion on your site without interacting with (for example, clicking on) another ad.
Category	`METRIC`
Data Type	`INT64`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

metrics.conversions
Field description	The number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
Category	`METRIC`
Data Type	`DOUBLE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

metrics.conversions_value
Field description	The sum of conversion values for the conversions included in the "conversions" field. This metric is useful only if you entered a value for your conversion actions.
Category	`METRIC`
Data Type	`DOUBLE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

metrics.cost_micros
Field description	The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
Category	`METRIC`
Data Type	`INT64`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

metrics.cross_device_conversions
Field description	Conversions from when a customer clicks on an ad on one device, then converts on a different device or browser. Cross-device conversions are already included in all_conversions.
Category	`METRIC`
Data Type	`DOUBLE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

metrics.cross_device_conversions_value
Field description	The sum of the value of cross-device conversions.
Category	`METRIC`
Data Type	`DOUBLE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

metrics.ctr
Field description	The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).
Category	`METRIC`
Data Type	`DOUBLE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

metrics.impressions
Field description	Count of how often your ad has appeared on a search results page or website on the Google Network.
Category	`METRIC`
Data Type	`INT64`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

metrics.visits
Field description	Clicks that Search Ads 360 has successfully recorded and forwarded to an advertiser's landing page.
Category	`METRIC`
Data Type	`DOUBLE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

ad_group_ad

Fields/Segments/Metrics

ad_group_ad.ad.display_url

ad_group_ad.ad.expanded_dynamic_search_ad.ad_tracking_id

ad_group_ad.ad.expanded_dynamic_search_ad.description1

ad_group_ad.ad.expanded_dynamic_search_ad.description2

ad_group_ad.ad.expanded_text_ad.ad_tracking_id

ad_group_ad.ad.expanded_text_ad.description1

ad_group_ad.ad.expanded_text_ad.description2

ad_group_ad.ad.expanded_text_ad.headline

ad_group_ad.ad.expanded_text_ad.headline2

ad_group_ad.ad.expanded_text_ad.headline3

ad_group_ad.ad.expanded_text_ad.path1

ad_group_ad.ad.expanded_text_ad.path2

ad_group_ad.ad.final_urls

ad_group_ad.ad.id

ad_group_ad.ad.name

ad_group_ad.ad.resource_name

ad_group_ad.ad.responsive_search_ad.ad_tracking_id

ad_group_ad.ad.responsive_search_ad.path1

ad_group_ad.ad.responsive_search_ad.path2

ad_group_ad.ad.text_ad.ad_tracking_id

ad_group_ad.ad.text_ad.description1

ad_group_ad.ad.text_ad.description2

ad_group_ad.ad.text_ad.display_mobile_url

ad_group_ad.ad.text_ad.display_url

ad_group_ad.ad.text_ad.headline

ad_group_ad.ad.type

ad_group_ad.creation_time

ad_group_ad.engine_id

ad_group_ad.engine_status

ad_group_ad.labels

ad_group_ad.last_modified_time

ad_group_ad.resource_name

ad_group_ad.status

segments.ad_network_type

segments.conversion_action_name

segments.date

segments.device

segments.keyword.ad_group_criterion

segments.keyword.info.match_type

segments.keyword.info.text

segments.month

segments.quarter

segments.week

segments.year

metrics.all_conversions

metrics.all_conversions_value

metrics.average_cpc

metrics.average_cpm

metrics.clicks

metrics.client_account_conversions

metrics.client_account_conversions_value

metrics.client_account_view_through_conversions

metrics.conversions

metrics.conversions_value

metrics.cost_micros

metrics.cross_device_conversions

metrics.cross_device_conversions_value

metrics.ctr

metrics.impressions

metrics.visits