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.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
    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
    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
    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
    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
    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
    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
    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
    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
    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
    Create a Mobile Website
    View Site in Mobile | Classic
    Share by: