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?

No Yes, it is

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.descriptions ad.responsive_search_ad.headlines 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 effective_labels 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_by_conversion_date all_conversions_value all_conversions_value_by_conversion_date 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_by_conversion_date cross_device_conversions_value cross_device_conversions_value_by_conversion_date 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.descriptions Field description List of text assets for descriptions. When the ad serves the descriptions will be selected from this list. Category ATTRIBUTE Data Type MESSAGE Type URL google.ads.searchads360.v0.common.AdTextAsset Filterable False Selectable True Sortable False Repeated True

ad_group_ad.ad.responsive_search_ad.headlines Field description List of text assets for headlines. When the ad serves the headlines will be selected from this list. Category ATTRIBUTE Data Type MESSAGE Type URL google.ads.searchads360.v0.common.AdTextAsset Filterable False Selectable True Sortable False Repeated True

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 MULTIMEDIA_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.effective_labels Field description The resource names of effective labels attached to this ad. An effective label is a label inherited or directly assigned to this ad. Category ATTRIBUTE Data Type RESOURCE_NAME Type URL N/A Filterable True Selectable True Sortable False Repeated True

ad_group_ad.engine_id Field description ID of the ad in the external engine account. This field is for Search Ads 360 account only, for example, Yahoo Japan, Microsoft, Baidu etc. For non-Search Ads 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_by_conversion_date Field description The total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/sa360/answer/9250611. 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.all_conversions_value_by_conversion_date Field description The value of all conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/sa360/answer/9250611. 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_by_conversion_date Field description The number of cross-device conversions by conversion date. Details for the by_conversion_date columns are available at https://support.google.com/sa360/answer/9250611. 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.cross_device_conversions_value_by_conversion_date Field description The sum of cross-device conversions value by conversion date. Details for the by_conversion_date columns are available at https://support.google.com/sa360/answer/9250611. 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