ad_group_ad

Help me build a query

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 action_items ad.added_by_google_ads ad.app_ad.descriptions ad.app_ad.headlines ad.app_ad.html5_media_bundles ad.app_ad.html5_media_bundles.asset ad.app_ad.images ad.app_ad.images.asset ad.app_ad.mandatory_ad_text ad.app_ad.youtube_videos ad.app_ad.youtube_videos.asset ad.app_engagement_ad.descriptions ad.app_engagement_ad.headlines ad.app_engagement_ad.images ad.app_engagement_ad.images.asset ad.app_engagement_ad.videos ad.app_engagement_ad.videos.asset ad.app_pre_registration_ad.descriptions ad.app_pre_registration_ad.headlines ad.app_pre_registration_ad.images ad.app_pre_registration_ad.images.asset ad.app_pre_registration_ad.youtube_videos ad.app_pre_registration_ad.youtube_videos.asset ad.call_ad.business_name ad.call_ad.call_tracked ad.call_ad.conversion_action ad.call_ad.conversion_reporting_state ad.call_ad.country_code ad.call_ad.description1 ad.call_ad.description2 ad.call_ad.disable_call_conversion ad.call_ad.headline1 ad.call_ad.headline2 ad.call_ad.path1 ad.call_ad.path2 ad.call_ad.phone_number ad.call_ad.phone_number_verification_url ad.demand_gen_product_ad.breadcrumb1 ad.demand_gen_product_ad.breadcrumb2 ad.demand_gen_product_ad.business_name ad.demand_gen_product_ad.call_to_action ad.demand_gen_product_ad.call_to_action.asset ad.demand_gen_product_ad.description ad.demand_gen_product_ad.headline ad.demand_gen_product_ad.logo_image ad.demand_gen_product_ad.logo_image.asset ad.device_preference ad.discovery_carousel_ad.business_name ad.discovery_carousel_ad.call_to_action_text ad.discovery_carousel_ad.carousel_cards ad.discovery_carousel_ad.carousel_cards.asset ad.discovery_carousel_ad.description ad.discovery_carousel_ad.headline ad.discovery_carousel_ad.logo_image ad.discovery_carousel_ad.logo_image.asset ad.discovery_multi_asset_ad.business_name ad.discovery_multi_asset_ad.call_to_action_text ad.discovery_multi_asset_ad.descriptions ad.discovery_multi_asset_ad.headlines ad.discovery_multi_asset_ad.lead_form_only ad.discovery_multi_asset_ad.logo_images ad.discovery_multi_asset_ad.logo_images.asset ad.discovery_multi_asset_ad.marketing_images ad.discovery_multi_asset_ad.marketing_images.asset ad.discovery_multi_asset_ad.portrait_marketing_images ad.discovery_multi_asset_ad.portrait_marketing_images.asset ad.discovery_multi_asset_ad.square_marketing_images ad.discovery_multi_asset_ad.square_marketing_images.asset ad.discovery_video_responsive_ad.breadcrumb1 ad.discovery_video_responsive_ad.breadcrumb2 ad.discovery_video_responsive_ad.business_name ad.discovery_video_responsive_ad.call_to_actions ad.discovery_video_responsive_ad.call_to_actions.asset ad.discovery_video_responsive_ad.descriptions ad.discovery_video_responsive_ad.headlines ad.discovery_video_responsive_ad.logo_images ad.discovery_video_responsive_ad.logo_images.asset ad.discovery_video_responsive_ad.long_headlines ad.discovery_video_responsive_ad.videos ad.discovery_video_responsive_ad.videos.asset ad.display_upload_ad.display_upload_product_type ad.display_upload_ad.media_bundle ad.display_upload_ad.media_bundle.asset ad.display_url ad.expanded_dynamic_search_ad.description ad.expanded_dynamic_search_ad.description2 ad.expanded_text_ad.description ad.expanded_text_ad.description2 ad.expanded_text_ad.headline_part1 ad.expanded_text_ad.headline_part2 ad.expanded_text_ad.headline_part3 ad.expanded_text_ad.path1 ad.expanded_text_ad.path2 ad.final_app_urls ad.final_mobile_urls ad.final_url_suffix ad.final_urls ad.hotel_ad ad.id ad.image_ad.image_asset.asset ad.image_ad.image_url ad.image_ad.mime_type ad.image_ad.name ad.image_ad.pixel_height ad.image_ad.pixel_width ad.image_ad.preview_image_url ad.image_ad.preview_pixel_height ad.image_ad.preview_pixel_width ad.legacy_app_install_ad ad.legacy_responsive_display_ad.accent_color ad.legacy_responsive_display_ad.allow_flexible_color ad.legacy_responsive_display_ad.business_name ad.legacy_responsive_display_ad.call_to_action_text ad.legacy_responsive_display_ad.description ad.legacy_responsive_display_ad.format_setting ad.legacy_responsive_display_ad.logo_image ad.legacy_responsive_display_ad.long_headline ad.legacy_responsive_display_ad.main_color ad.legacy_responsive_display_ad.marketing_image ad.legacy_responsive_display_ad.price_prefix ad.legacy_responsive_display_ad.promo_text ad.legacy_responsive_display_ad.short_headline ad.legacy_responsive_display_ad.square_logo_image ad.legacy_responsive_display_ad.square_marketing_image ad.local_ad.call_to_actions ad.local_ad.descriptions ad.local_ad.headlines ad.local_ad.logo_images ad.local_ad.logo_images.asset ad.local_ad.marketing_images ad.local_ad.marketing_images.asset ad.local_ad.path1 ad.local_ad.path2 ad.local_ad.videos ad.local_ad.videos.asset ad.name ad.resource_name ad.responsive_display_ad.accent_color ad.responsive_display_ad.allow_flexible_color ad.responsive_display_ad.business_name ad.responsive_display_ad.call_to_action_text ad.responsive_display_ad.control_spec.enable_asset_enhancements ad.responsive_display_ad.control_spec.enable_autogen_video ad.responsive_display_ad.descriptions ad.responsive_display_ad.format_setting ad.responsive_display_ad.headlines ad.responsive_display_ad.logo_images ad.responsive_display_ad.logo_images.asset ad.responsive_display_ad.long_headline ad.responsive_display_ad.main_color ad.responsive_display_ad.marketing_images ad.responsive_display_ad.marketing_images.asset ad.responsive_display_ad.price_prefix ad.responsive_display_ad.promo_text ad.responsive_display_ad.square_logo_images ad.responsive_display_ad.square_logo_images.asset ad.responsive_display_ad.square_marketing_images ad.responsive_display_ad.square_marketing_images.asset ad.responsive_display_ad.youtube_videos ad.responsive_display_ad.youtube_videos.asset ad.responsive_search_ad.descriptions ad.responsive_search_ad.headlines ad.responsive_search_ad.path1 ad.responsive_search_ad.path2 ad.shopping_comparison_listing_ad.headline ad.shopping_product_ad ad.shopping_smart_ad ad.smart_campaign_ad.descriptions ad.smart_campaign_ad.headlines ad.system_managed_resource_source ad.text_ad.description1 ad.text_ad.description2 ad.text_ad.headline ad.tracking_url_template ad.travel_ad ad.type ad.url_collections ad.url_custom_parameters ad.video_ad.bumper.action_button_label ad.video_ad.bumper.action_headline ad.video_ad.bumper.companion_banner.asset ad.video_ad.in_feed.description1 ad.video_ad.in_feed.description2 ad.video_ad.in_feed.headline ad.video_ad.in_feed.thumbnail ad.video_ad.in_stream.action_button_label ad.video_ad.in_stream.action_headline ad.video_ad.in_stream.companion_banner.asset ad.video_ad.non_skippable.action_button_label ad.video_ad.non_skippable.action_headline ad.video_ad.non_skippable.companion_banner.asset ad.video_ad.out_stream.description ad.video_ad.out_stream.headline ad.video_ad.video.asset ad.video_responsive_ad.breadcrumb1 ad.video_responsive_ad.breadcrumb2 ad.video_responsive_ad.call_to_actions ad.video_responsive_ad.companion_banners ad.video_responsive_ad.companion_banners.asset ad.video_responsive_ad.descriptions ad.video_responsive_ad.headlines ad.video_responsive_ad.long_headlines ad.video_responsive_ad.videos ad.video_responsive_ad.videos.asset ad_group ad_strength labels policy_summary.approval_status policy_summary.policy_topic_entries policy_summary.review_status primary_status primary_status_reasons resource_name status

Segments ad_destination_type ad_network_type click_type conversion_action conversion_action_category conversion_action_name conversion_adjustment conversion_attribution_event_type conversion_lag_bucket conversion_or_adjustment_lag_bucket date day_of_week device external_conversion_source interaction_on_this_extension keyword.ad_group_criterion keyword.info.match_type keyword.info.text month month_of_year new_versus_returning_customers placeholder_type quarter search_term_match_type slot week year

Metrics absolute_top_impression_percentage active_view_cpm active_view_ctr active_view_impressions active_view_measurability active_view_measurable_cost_micros active_view_measurable_impressions active_view_viewability all_conversions all_conversions_by_conversion_date all_conversions_from_interactions_rate all_conversions_from_interactions_value_per_interaction all_conversions_value all_conversions_value_by_conversion_date all_conversions_value_per_cost all_new_customer_lifetime_value average_cart_size average_cost average_cpc average_cpe average_cpm average_cpv average_order_value_micros average_page_views average_time_on_site bounce_rate clicks conversions conversions_by_conversion_date conversions_from_interactions_rate conversions_from_interactions_value_per_interaction conversions_value conversions_value_by_conversion_date conversions_value_per_cost cost_micros cost_of_goods_sold_micros cost_per_all_conversions cost_per_conversion cost_per_current_model_attributed_conversion cross_device_conversions cross_device_conversions_value_micros cross_sell_cost_of_goods_sold_micros cross_sell_gross_profit_micros cross_sell_revenue_micros cross_sell_units_sold ctr current_model_attributed_conversions current_model_attributed_conversions_from_interactions_rate current_model_attributed_conversions_from_interactions_value_per_interaction current_model_attributed_conversions_value current_model_attributed_conversions_value_per_cost engagement_rate engagements gmail_forwards gmail_saves gmail_secondary_clicks gross_profit_margin gross_profit_micros impressions interaction_event_types interaction_rate interactions lead_cost_of_goods_sold_micros lead_gross_profit_micros lead_revenue_micros lead_units_sold new_customer_lifetime_value orders percent_new_visitors phone_calls phone_impressions phone_through_rate revenue_micros top_impression_percentage units_sold value_per_all_conversions value_per_all_conversions_by_conversion_date value_per_conversion value_per_conversions_by_conversion_date value_per_current_model_attributed_conversion video_quartile_p100_rate video_quartile_p25_rate video_quartile_p50_rate video_quartile_p75_rate video_view_rate video_views view_through_conversions

ad_group_ad.action_items Field description 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.". Category ATTRIBUTE Data Type STRING Type URL N/A Filterable False Selectable True Sortable False Repeated True

ad_group_ad.ad.added_by_google_ads Field description Output only. Indicates if this ad was automatically added by Google Ads and not by a user. For example, this could happen when ads are automatically created as suggestions for new ads based on knowledge of how existing ads are performing. Category ATTRIBUTE Data Type BOOLEAN Type URL N/A Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.app_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.googleads.v16.common.AdTextAsset Filterable False Selectable True Sortable False Repeated True

ad_group_ad.ad.app_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.googleads.v16.common.AdTextAsset Filterable False Selectable True Sortable False Repeated True

ad_group_ad.ad.app_ad.html5_media_bundles Field description List of media bundle assets that may be used with the ad. Category ATTRIBUTE Data Type MESSAGE Type URL google.ads.googleads.v16.common.AdMediaBundleAsset Filterable False Selectable True Sortable False Repeated True

ad_group_ad.ad.app_ad.html5_media_bundles.asset Field description The Asset resource name of this media bundle. Category ATTRIBUTE Data Type RESOURCE_NAME Type URL N/A Filterable True Selectable False Sortable False Repeated False

ad_group_ad.ad.app_ad.images Field description List of image assets that may be displayed with the ad. Category ATTRIBUTE Data Type MESSAGE Type URL google.ads.googleads.v16.common.AdImageAsset Filterable False Selectable True Sortable False Repeated True

ad_group_ad.ad.app_ad.images.asset Field description The Asset resource name of this image. Category ATTRIBUTE Data Type RESOURCE_NAME Type URL N/A Filterable True Selectable False Sortable False Repeated False

ad_group_ad.ad.app_ad.mandatory_ad_text Field description Mandatory ad text. Category ATTRIBUTE Data Type MESSAGE Type URL google.ads.googleads.v16.common.AdTextAsset Filterable False Selectable True Sortable False Repeated False

ad_group_ad.ad.app_ad.youtube_videos Field description List of YouTube video assets that may be displayed with the ad. Category ATTRIBUTE Data Type MESSAGE Type URL google.ads.googleads.v16.common.AdVideoAsset Filterable False Selectable True Sortable False Repeated True

ad_group_ad.ad.app_ad.youtube_videos.asset Field description The Asset resource name of this video. Category ATTRIBUTE Data Type RESOURCE_NAME Type URL N/A Filterable True Selectable False Sortable False Repeated False

ad_group_ad.ad.app_engagement_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.googleads.v16.common.AdTextAsset Filterable False Selectable True Sortable False Repeated True

ad_group_ad.ad.app_engagement_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.googleads.v16.common.AdTextAsset Filterable False Selectable True Sortable False Repeated True

ad_group_ad.ad.app_engagement_ad.images Field description List of image assets that may be displayed with the ad. Category ATTRIBUTE Data Type MESSAGE Type URL google.ads.googleads.v16.common.AdImageAsset Filterable False Selectable True Sortable False Repeated True

ad_group_ad.ad.app_engagement_ad.images.asset Field description The Asset resource name of this image. Category ATTRIBUTE Data Type RESOURCE_NAME Type URL N/A Filterable True Selectable False Sortable False Repeated False

ad_group_ad.ad.app_engagement_ad.videos Field description List of video assets that may be displayed with the ad. Category ATTRIBUTE Data Type MESSAGE Type URL google.ads.googleads.v16.common.AdVideoAsset Filterable False Selectable True Sortable False Repeated True

ad_group_ad.ad.app_engagement_ad.videos.asset Field description The Asset resource name of this video. Category ATTRIBUTE Data Type RESOURCE_NAME Type URL N/A Filterable True Selectable False Sortable False Repeated False

ad_group_ad.ad.app_pre_registration_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.googleads.v16.common.AdTextAsset Filterable False Selectable True Sortable False Repeated True

ad_group_ad.ad.app_pre_registration_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.googleads.v16.common.AdTextAsset Filterable False Selectable True Sortable False Repeated True

ad_group_ad.ad.app_pre_registration_ad.images Field description List of image asset IDs whose images may be displayed with the ad. Category ATTRIBUTE Data Type MESSAGE Type URL google.ads.googleads.v16.common.AdImageAsset Filterable False Selectable True Sortable False Repeated True

ad_group_ad.ad.app_pre_registration_ad.images.asset Field description The Asset resource name of this image. Category ATTRIBUTE Data Type RESOURCE_NAME Type URL N/A Filterable True Selectable False Sortable False Repeated False

ad_group_ad.ad.app_pre_registration_ad.youtube_videos Field description List of YouTube video asset IDs whose videos may be displayed with the ad. Category ATTRIBUTE Data Type MESSAGE Type URL google.ads.googleads.v16.common.AdVideoAsset Filterable False Selectable True Sortable False Repeated True

ad_group_ad.ad.app_pre_registration_ad.youtube_videos.asset Field description The Asset resource name of this video. Category ATTRIBUTE Data Type RESOURCE_NAME Type URL N/A Filterable True Selectable False Sortable False Repeated False

ad_group_ad.ad.call_ad.business_name Field description The business name in the ad. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.call_ad.call_tracked Field description Whether to enable call tracking for the creative. Enabling call tracking also enables call conversions. Category ATTRIBUTE Data Type BOOLEAN Type URL N/A Filterable False Selectable True Sortable False Repeated False

ad_group_ad.ad.call_ad.conversion_action Field description The conversion action to attribute a call conversion to. If not set a default conversion action is used. This field only has effect if call_tracked is set to true. Otherwise this field is ignored. Category ATTRIBUTE Data Type RESOURCE_NAME Type URL N/A Filterable True Selectable True Sortable False Repeated False

ad_group_ad.ad.call_ad.conversion_reporting_state Field description The call conversion behavior of this call ad. It can use its own call conversion setting, inherit the account level setting, or be disabled. Category ATTRIBUTE Data Type ENUM DISABLED UNKNOWN UNSPECIFIED USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION Type URL google.ads.googleads.v16.enums.CallConversionReportingStateEnum.CallConversionReportingState Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.call_ad.country_code Field description The country code in the ad. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.call_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.call_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.call_ad.disable_call_conversion Field description Whether to disable call conversion for the creative. If set to true, disables call conversions even when call_tracked is true. If call_tracked is false, this field is ignored. Category ATTRIBUTE Data Type BOOLEAN Type URL N/A Filterable False Selectable True Sortable False Repeated False

ad_group_ad.ad.call_ad.headline1 Field description First headline in the ad. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.call_ad.headline2 Field description Second headline in the ad. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.call_ad.path1 Field description First part of text that can be appended to the URL in the ad. Optional. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.call_ad.path2 Field description Second part of text that can be appended to the URL in the ad. This field can only be set when path1 is also set. Optional. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.call_ad.phone_number Field description The phone number in the ad. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.call_ad.phone_number_verification_url Field description The URL to be used for phone number verification. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.demand_gen_product_ad.breadcrumb1 Field description First part of text that appears in the ad with the displayed URL. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.demand_gen_product_ad.breadcrumb2 Field description Second part of text that appears in the ad with the displayed URL. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.demand_gen_product_ad.business_name Field description Required. The advertiser/brand name. Category ATTRIBUTE Data Type MESSAGE Type URL google.ads.googleads.v16.common.AdTextAsset Filterable False Selectable True Sortable False Repeated False

ad_group_ad.ad.demand_gen_product_ad.call_to_action Field description Asset of type CallToActionAsset used for the "Call To Action" button. Category ATTRIBUTE Data Type MESSAGE Type URL google.ads.googleads.v16.common.AdCallToActionAsset Filterable False Selectable True Sortable False Repeated False

ad_group_ad.ad.demand_gen_product_ad.call_to_action.asset Field description The Asset resource name of this call to action asset. Category ATTRIBUTE Data Type RESOURCE_NAME Type URL N/A Filterable True Selectable False Sortable False Repeated False

ad_group_ad.ad.demand_gen_product_ad.description Field description Required. Text asset used for the description. Category ATTRIBUTE Data Type MESSAGE Type URL google.ads.googleads.v16.common.AdTextAsset Filterable False Selectable True Sortable False Repeated False

ad_group_ad.ad.demand_gen_product_ad.headline Field description Required. Text asset used for the short headline. Category ATTRIBUTE Data Type MESSAGE Type URL google.ads.googleads.v16.common.AdTextAsset Filterable False Selectable True Sortable False Repeated False

ad_group_ad.ad.demand_gen_product_ad.logo_image Field description Required. Logo image to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 128x128 and the aspect ratio must be 1:1 (+-1%). Category ATTRIBUTE Data Type MESSAGE Type URL google.ads.googleads.v16.common.AdImageAsset Filterable False Selectable True Sortable False Repeated False

ad_group_ad.ad.demand_gen_product_ad.logo_image.asset Field description The Asset resource name of this image. Category ATTRIBUTE Data Type RESOURCE_NAME Type URL N/A Filterable True Selectable False Sortable False Repeated False

ad_group_ad.ad.device_preference Field description The device preference for the ad. You can only specify a preference for mobile devices. When this preference is set the ad will be preferred over other ads when being displayed on a mobile device. The ad can still be displayed on other device types, for example, if no other ads are available. If unspecified (no device preference), all devices are targeted. This is only supported by some ad types. Category ATTRIBUTE Data Type ENUM CONNECTED_TV DESKTOP MOBILE OTHER TABLET UNKNOWN UNSPECIFIED Type URL google.ads.googleads.v16.enums.DeviceEnum.Device Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.discovery_carousel_ad.business_name Field description Required. The Advertiser/brand name. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.discovery_carousel_ad.call_to_action_text Field description Call to action text. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.discovery_carousel_ad.carousel_cards Field description Required. Carousel cards that will display with the ad. Min 2 max 10. Category ATTRIBUTE Data Type MESSAGE Type URL google.ads.googleads.v16.common.AdDiscoveryCarouselCardAsset Filterable False Selectable True Sortable False Repeated True

ad_group_ad.ad.discovery_carousel_ad.carousel_cards.asset Field description The Asset resource name of this discovery carousel card. Category ATTRIBUTE Data Type RESOURCE_NAME Type URL N/A Filterable True Selectable False Sortable False Repeated False

ad_group_ad.ad.discovery_carousel_ad.description Field description Required. The descriptive text of the ad. Category ATTRIBUTE Data Type MESSAGE Type URL google.ads.googleads.v16.common.AdTextAsset Filterable False Selectable True Sortable False Repeated False

ad_group_ad.ad.discovery_carousel_ad.headline Field description Required. Headline of the ad. Category ATTRIBUTE Data Type MESSAGE Type URL google.ads.googleads.v16.common.AdTextAsset Filterable False Selectable True Sortable False Repeated False

ad_group_ad.ad.discovery_carousel_ad.logo_image Field description Required. Logo image to be used in the ad. The minimum size is 128x128 and the aspect ratio must be 1:1 (+-1%). Category ATTRIBUTE Data Type MESSAGE Type URL google.ads.googleads.v16.common.AdImageAsset Filterable False Selectable True Sortable False Repeated False

ad_group_ad.ad.discovery_carousel_ad.logo_image.asset Field description The Asset resource name of this image. Category ATTRIBUTE Data Type RESOURCE_NAME Type URL N/A Filterable True Selectable False Sortable False Repeated False

ad_group_ad.ad.discovery_multi_asset_ad.business_name Field description The Advertiser/brand name. Maximum display width is 25. Required. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.discovery_multi_asset_ad.call_to_action_text Field description Call to action text. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.discovery_multi_asset_ad.descriptions Field description The descriptive text of the ad. Maximum display width is 90. At least 1 and max 5 descriptions can be specified. Category ATTRIBUTE Data Type MESSAGE Type URL google.ads.googleads.v16.common.AdTextAsset Filterable False Selectable True Sortable False Repeated True

ad_group_ad.ad.discovery_multi_asset_ad.headlines Field description Headline text asset of the ad. Maximum display width is 30. At least 1 and max 5 headlines can be specified. Category ATTRIBUTE Data Type MESSAGE Type URL google.ads.googleads.v16.common.AdTextAsset Filterable False Selectable True Sortable False Repeated True

ad_group_ad.ad.discovery_multi_asset_ad.lead_form_only Field description Boolean option that indicates if this ad must be served with lead form. Category ATTRIBUTE Data Type BOOLEAN Type URL N/A Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.discovery_multi_asset_ad.logo_images Field description Logo image assets to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 128x128 and the aspect ratio must be 1:1 (+-1%). At least 1 and max 5 logo images can be specified. Category ATTRIBUTE Data Type MESSAGE Type URL google.ads.googleads.v16.common.AdImageAsset Filterable False Selectable True Sortable False Repeated True

ad_group_ad.ad.discovery_multi_asset_ad.logo_images.asset Field description The Asset resource name of this image. Category ATTRIBUTE Data Type RESOURCE_NAME Type URL N/A Filterable True Selectable False Sortable False Repeated False

ad_group_ad.ad.discovery_multi_asset_ad.marketing_images Field description Marketing image assets to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 600x314 and the aspect ratio must be 1.91:1 (+-1%). Required if square_marketing_images is not present. Combined with square_marketing_images and portrait_marketing_images the maximum is 20. Category ATTRIBUTE Data Type MESSAGE Type URL google.ads.googleads.v16.common.AdImageAsset Filterable False Selectable True Sortable False Repeated True

ad_group_ad.ad.discovery_multi_asset_ad.marketing_images.asset Field description The Asset resource name of this image. Category ATTRIBUTE Data Type RESOURCE_NAME Type URL N/A Filterable True Selectable False Sortable False Repeated False

ad_group_ad.ad.discovery_multi_asset_ad.portrait_marketing_images Field description Portrait marketing image assets to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 480x600 and the aspect ratio must be 4:5 (+-1%). Combined with marketing_images and square_marketing_images the maximum is 20. Category ATTRIBUTE Data Type MESSAGE Type URL google.ads.googleads.v16.common.AdImageAsset Filterable False Selectable True Sortable False Repeated True

ad_group_ad.ad.discovery_multi_asset_ad.portrait_marketing_images.asset Field description The Asset resource name of this image. Category ATTRIBUTE Data Type RESOURCE_NAME Type URL N/A Filterable True Selectable False Sortable False Repeated False

ad_group_ad.ad.discovery_multi_asset_ad.square_marketing_images Field description Square marketing image assets to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 300x300 and the aspect ratio must be 1:1 (+-1%). Required if marketing_images is not present. Combined with marketing_images and portrait_marketing_images the maximum is 20. Category ATTRIBUTE Data Type MESSAGE Type URL google.ads.googleads.v16.common.AdImageAsset Filterable False Selectable True Sortable False Repeated True

ad_group_ad.ad.discovery_multi_asset_ad.square_marketing_images.asset Field description The Asset resource name of this image. Category ATTRIBUTE Data Type RESOURCE_NAME Type URL N/A Filterable True Selectable False Sortable False Repeated False

ad_group_ad.ad.discovery_video_responsive_ad.breadcrumb1 Field description First part of text that appears in the ad with the displayed URL. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.discovery_video_responsive_ad.breadcrumb2 Field description Second part of text that appears in the ad with the displayed URL. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.discovery_video_responsive_ad.business_name Field description Required. The advertiser/brand name. Category ATTRIBUTE Data Type MESSAGE Type URL google.ads.googleads.v16.common.AdTextAsset Filterable False Selectable True Sortable False Repeated False

ad_group_ad.ad.discovery_video_responsive_ad.call_to_actions Field description Assets of type CallToActionAsset used for the "Call To Action" button. Category ATTRIBUTE Data Type MESSAGE Type URL google.ads.googleads.v16.common.AdCallToActionAsset Filterable False Selectable True Sortable False Repeated True

ad_group_ad.ad.discovery_video_responsive_ad.call_to_actions.asset Field description The Asset resource name of this call to action asset. Category ATTRIBUTE Data Type RESOURCE_NAME Type URL N/A Filterable True Selectable False Sortable False Repeated False

ad_group_ad.ad.discovery_video_responsive_ad.descriptions Field description List of text assets used for the description. Category ATTRIBUTE Data Type MESSAGE Type URL google.ads.googleads.v16.common.AdTextAsset Filterable False Selectable True Sortable False Repeated True

ad_group_ad.ad.discovery_video_responsive_ad.headlines Field description List of text assets used for the short headline. Category ATTRIBUTE Data Type MESSAGE Type URL google.ads.googleads.v16.common.AdTextAsset Filterable False Selectable True Sortable False Repeated True

ad_group_ad.ad.discovery_video_responsive_ad.logo_images Field description Logo image to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 128x128 and the aspect ratio must be 1:1 (+-1%). Category ATTRIBUTE Data Type MESSAGE Type URL google.ads.googleads.v16.common.AdImageAsset Filterable False Selectable True Sortable False Repeated True

ad_group_ad.ad.discovery_video_responsive_ad.logo_images.asset Field description The Asset resource name of this image. Category ATTRIBUTE Data Type RESOURCE_NAME Type URL N/A Filterable True Selectable False Sortable False Repeated False

ad_group_ad.ad.discovery_video_responsive_ad.long_headlines Field description List of text assets used for the long headline. Category ATTRIBUTE Data Type MESSAGE Type URL google.ads.googleads.v16.common.AdTextAsset Filterable False Selectable True Sortable False Repeated True

ad_group_ad.ad.discovery_video_responsive_ad.videos Field description List of YouTube video assets used for the ad. Category ATTRIBUTE Data Type MESSAGE Type URL google.ads.googleads.v16.common.AdVideoAsset Filterable False Selectable True Sortable False Repeated True

ad_group_ad.ad.discovery_video_responsive_ad.videos.asset Field description The Asset resource name of this video. Category ATTRIBUTE Data Type RESOURCE_NAME Type URL N/A Filterable True Selectable False Sortable False Repeated False

ad_group_ad.ad.display_upload_ad.display_upload_product_type Field description The product type of this ad. See comments on the enum for details. Category ATTRIBUTE Data Type ENUM DYNAMIC_HTML5_CUSTOM_AD DYNAMIC_HTML5_EDUCATION_AD DYNAMIC_HTML5_FLIGHT_AD DYNAMIC_HTML5_HOTEL_AD DYNAMIC_HTML5_HOTEL_RENTAL_AD DYNAMIC_HTML5_JOB_AD DYNAMIC_HTML5_LOCAL_AD DYNAMIC_HTML5_REAL_ESTATE_AD DYNAMIC_HTML5_TRAVEL_AD HTML5_UPLOAD_AD UNKNOWN UNSPECIFIED Type URL google.ads.googleads.v16.enums.DisplayUploadProductTypeEnum.DisplayUploadProductType Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.display_upload_ad.media_bundle Field description A media bundle asset to be used in the ad. For information about the media bundle for HTML5_UPLOAD_AD, see https://support.google.com/google-ads/answer/1722096 Media bundles that are part of dynamic product types use a special format that needs to be created through the Google Web Designer. See https://support.google.com/webdesigner/answer/7543898 for more information. Category ATTRIBUTE Data Type MESSAGE Type URL google.ads.googleads.v16.common.AdMediaBundleAsset Filterable False Selectable True Sortable False Repeated False

ad_group_ad.ad.display_upload_ad.media_bundle.asset Field description The Asset resource name of this media bundle. Category ATTRIBUTE Data Type RESOURCE_NAME Type URL N/A Filterable True Selectable False Sortable False Repeated False

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.description Field description The description 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_dynamic_search_ad.description2 Field description The second description 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.description Field description The description 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.description2 Field description The second description 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.headline_part1 Field description The first part of the ad's headline. 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_part2 Field description The second part of the ad's headline. 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_part3 Field description The third part of the ad's headline. 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 The text that can appear alongside the ad's displayed URL. 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 Additional text that can appear alongside the ad's displayed URL. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.final_app_urls Field description A list of final app URLs that will be used on mobile if the user has the specific app installed. Category ATTRIBUTE Data Type MESSAGE Type URL google.ads.googleads.v16.common.FinalAppUrl Filterable False Selectable True Sortable False Repeated True

ad_group_ad.ad.final_mobile_urls Field description The list of possible final mobile 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.final_url_suffix Field description The suffix to use when constructing a final URL. 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.hotel_ad Field description Details pertaining to a hotel ad. Category ATTRIBUTE Data Type MESSAGE Type URL google.ads.googleads.v16.common.HotelAdInfo Filterable False Selectable True Sortable False Repeated False

ad_group_ad.ad.id Field description Output only. 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.image_ad.image_asset.asset Field description The Asset resource name of this image. Category ATTRIBUTE Data Type RESOURCE_NAME Type URL N/A Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.image_ad.image_url Field description URL of the full size image. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.image_ad.mime_type Field description The mime type of the image. Category ATTRIBUTE Data Type ENUM AUDIO_MP3 AUDIO_WAV FLASH HTML5_AD_ZIP IMAGE_GIF IMAGE_JPEG IMAGE_PNG MSEXCEL MSWORD PDF RTF TEXT_HTML UNKNOWN UNSPECIFIED Type URL google.ads.googleads.v16.enums.MimeTypeEnum.MimeType Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.image_ad.name Field description The name of the image. If the image was created from a MediaFile, this is the MediaFile's name. If the image was created from bytes, this is empty. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.image_ad.pixel_height Field description Height in pixels of the full size image. Category ATTRIBUTE Data Type INT64 Type URL N/A Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.image_ad.pixel_width Field description Width in pixels of the full size image. Category ATTRIBUTE Data Type INT64 Type URL N/A Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.image_ad.preview_image_url Field description URL of the preview size image. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.image_ad.preview_pixel_height Field description Height in pixels of the preview size image. Category ATTRIBUTE Data Type INT64 Type URL N/A Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.image_ad.preview_pixel_width Field description Width in pixels of the preview size image. Category ATTRIBUTE Data Type INT64 Type URL N/A Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.legacy_app_install_ad Field description Immutable. Details pertaining to a legacy app install ad. Category ATTRIBUTE Data Type MESSAGE Type URL google.ads.googleads.v16.common.LegacyAppInstallAdInfo Filterable False Selectable True Sortable False Repeated False

ad_group_ad.ad.legacy_responsive_display_ad.accent_color Field description The accent color of the ad in hexadecimal, for example, #ffffff for white. If one of main_color and accent_color is set, the other is required as well. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.legacy_responsive_display_ad.allow_flexible_color Field description Advertiser's consent to allow flexible color. When true, the ad may be served with different color if necessary. When false, the ad will be served with the specified colors or a neutral color. The default value is true. Must be true if main_color and accent_color are not set. Category ATTRIBUTE Data Type BOOLEAN Type URL N/A Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.legacy_responsive_display_ad.business_name Field description The business name in the ad. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.legacy_responsive_display_ad.call_to_action_text Field description The call-to-action text for the ad. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

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

ad_group_ad.ad.legacy_responsive_display_ad.format_setting Field description Specifies which format the ad will be served in. Default is ALL_FORMATS. Category ATTRIBUTE Data Type ENUM ALL_FORMATS NATIVE NON_NATIVE UNKNOWN UNSPECIFIED Type URL google.ads.googleads.v16.enums.DisplayAdFormatSettingEnum.DisplayAdFormatSetting Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.legacy_responsive_display_ad.logo_image Field description The MediaFile resource name of the logo image used in the ad. Category ATTRIBUTE Data Type RESOURCE_NAME Type URL N/A Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.legacy_responsive_display_ad.long_headline Field description The long version of the ad's headline. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.legacy_responsive_display_ad.main_color Field description The main color of the ad in hexadecimal, for example, #ffffff for white. If one of main_color and accent_color is set, the other is required as well. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.legacy_responsive_display_ad.marketing_image Field description The MediaFile resource name of the marketing image used in the ad. Category ATTRIBUTE Data Type RESOURCE_NAME Type URL N/A Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.legacy_responsive_display_ad.price_prefix Field description Prefix before price. For example, 'as low as'. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.legacy_responsive_display_ad.promo_text Field description Promotion text used for dynamic formats of responsive ads. For example 'Free two-day shipping'. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.legacy_responsive_display_ad.short_headline Field description The short version of the ad's headline. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.legacy_responsive_display_ad.square_logo_image Field description The MediaFile resource name of the square logo image used in the ad. Category ATTRIBUTE Data Type RESOURCE_NAME Type URL N/A Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.legacy_responsive_display_ad.square_marketing_image Field description The MediaFile resource name of the square marketing image used in the ad. Category ATTRIBUTE Data Type RESOURCE_NAME Type URL N/A Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.local_ad.call_to_actions Field description List of text assets for call-to-actions. When the ad serves the call-to-actions will be selected from this list. At least 1 and at most 5 call-to-actions must be specified. Category ATTRIBUTE Data Type MESSAGE Type URL google.ads.googleads.v16.common.AdTextAsset Filterable False Selectable True Sortable False Repeated True

ad_group_ad.ad.local_ad.descriptions Field description List of text assets for descriptions. When the ad serves the descriptions will be selected from this list. At least 1 and at most 5 descriptions must be specified. Category ATTRIBUTE Data Type MESSAGE Type URL google.ads.googleads.v16.common.AdTextAsset Filterable False Selectable True Sortable False Repeated True

ad_group_ad.ad.local_ad.headlines Field description List of text assets for headlines. When the ad serves the headlines will be selected from this list. At least 1 and at most 5 headlines must be specified. Category ATTRIBUTE Data Type MESSAGE Type URL google.ads.googleads.v16.common.AdTextAsset Filterable False Selectable True Sortable False Repeated True

ad_group_ad.ad.local_ad.logo_images Field description List of logo image assets that may be displayed with the ad. The images must be 128x128 pixels and not larger than 120KB. At least 1 and at most 5 image assets must be specified. Category ATTRIBUTE Data Type MESSAGE Type URL google.ads.googleads.v16.common.AdImageAsset Filterable False Selectable True Sortable False Repeated True

ad_group_ad.ad.local_ad.logo_images.asset Field description The Asset resource name of this image. Category ATTRIBUTE Data Type RESOURCE_NAME Type URL N/A Filterable True Selectable False Sortable False Repeated False

ad_group_ad.ad.local_ad.marketing_images Field description List of marketing image assets that may be displayed with the ad. The images must be 314x600 pixels or 320x320 pixels. At least 1 and at most 20 image assets must be specified. Category ATTRIBUTE Data Type MESSAGE Type URL google.ads.googleads.v16.common.AdImageAsset Filterable False Selectable True Sortable False Repeated True

ad_group_ad.ad.local_ad.marketing_images.asset Field description The Asset resource name of this image. Category ATTRIBUTE Data Type RESOURCE_NAME Type URL N/A Filterable True Selectable False Sortable False Repeated False

ad_group_ad.ad.local_ad.path1 Field description First part of optional text that can be appended to the URL in the ad. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.local_ad.path2 Field description Second part of optional text that can be appended to the URL in the ad. This field can only be set when path1 is also set. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.local_ad.videos Field description List of YouTube video assets that may be displayed with the ad. At least 1 and at most 20 video assets must be specified. Category ATTRIBUTE Data Type MESSAGE Type URL google.ads.googleads.v16.common.AdVideoAsset Filterable False Selectable True Sortable False Repeated True

ad_group_ad.ad.local_ad.videos.asset Field description The Asset resource name of this video. Category ATTRIBUTE Data Type RESOURCE_NAME Type URL N/A Filterable True Selectable False Sortable False Repeated False

ad_group_ad.ad.name Field description Immutable. 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 Immutable. 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_display_ad.accent_color Field description The accent color of the ad in hexadecimal, for example, #ffffff for white. If one of main_color and accent_color is set, the other is required as well. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.responsive_display_ad.allow_flexible_color Field description Advertiser's consent to allow flexible color. When true, the ad may be served with different color if necessary. When false, the ad will be served with the specified colors or a neutral color. The default value is true. Must be true if main_color and accent_color are not set. Category ATTRIBUTE Data Type BOOLEAN Type URL N/A Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.responsive_display_ad.business_name Field description The advertiser/brand name. Maximum display width is 25. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.responsive_display_ad.call_to_action_text Field description The call-to-action text for the ad. Maximum display width is 30. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.responsive_display_ad.control_spec.enable_asset_enhancements Field description Whether the advertiser has opted into the asset enhancements feature. Category ATTRIBUTE Data Type BOOLEAN Type URL N/A Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.responsive_display_ad.control_spec.enable_autogen_video Field description Whether the advertiser has opted into auto-gen video feature. Category ATTRIBUTE Data Type BOOLEAN Type URL N/A Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.responsive_display_ad.descriptions Field description Descriptive texts for the ad. The maximum length is 90 characters. At least 1 and max 5 headlines can be specified. Category ATTRIBUTE Data Type MESSAGE Type URL google.ads.googleads.v16.common.AdTextAsset Filterable False Selectable True Sortable False Repeated True

ad_group_ad.ad.responsive_display_ad.format_setting Field description Specifies which format the ad will be served in. Default is ALL_FORMATS. Category ATTRIBUTE Data Type ENUM ALL_FORMATS NATIVE NON_NATIVE UNKNOWN UNSPECIFIED Type URL google.ads.googleads.v16.enums.DisplayAdFormatSettingEnum.DisplayAdFormatSetting Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.responsive_display_ad.headlines Field description Short format headlines for the ad. The maximum length is 30 characters. At least 1 and max 5 headlines can be specified. Category ATTRIBUTE Data Type MESSAGE Type URL google.ads.googleads.v16.common.AdTextAsset Filterable False Selectable True Sortable False Repeated True

ad_group_ad.ad.responsive_display_ad.logo_images Field description Logo images to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 512x128 and the aspect ratio must be 4:1 (+-1%). Combined with square_logo_images, the maximum is 5. Category ATTRIBUTE Data Type MESSAGE Type URL google.ads.googleads.v16.common.AdImageAsset Filterable False Selectable True Sortable False Repeated True

ad_group_ad.ad.responsive_display_ad.logo_images.asset Field description The Asset resource name of this image. Category ATTRIBUTE Data Type RESOURCE_NAME Type URL N/A Filterable True Selectable False Sortable False Repeated False

ad_group_ad.ad.responsive_display_ad.long_headline Field description A required long format headline. The maximum length is 90 characters. Category ATTRIBUTE Data Type MESSAGE Type URL google.ads.googleads.v16.common.AdTextAsset Filterable False Selectable True Sortable False Repeated False

ad_group_ad.ad.responsive_display_ad.main_color Field description The main color of the ad in hexadecimal, for example, #ffffff for white. If one of main_color and accent_color is set, the other is required as well. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.responsive_display_ad.marketing_images Field description Marketing images to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 600x314 and the aspect ratio must be 1.91:1 (+-1%). At least one marketing_image is required. Combined with square_marketing_images, the maximum is 15. Category ATTRIBUTE Data Type MESSAGE Type URL google.ads.googleads.v16.common.AdImageAsset Filterable False Selectable True Sortable False Repeated True

ad_group_ad.ad.responsive_display_ad.marketing_images.asset Field description The Asset resource name of this image. Category ATTRIBUTE Data Type RESOURCE_NAME Type URL N/A Filterable True Selectable False Sortable False Repeated False

ad_group_ad.ad.responsive_display_ad.price_prefix Field description Prefix before price. For example, 'as low as'. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.responsive_display_ad.promo_text Field description Promotion text used for dynamic formats of responsive ads. For example 'Free two-day shipping'. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.responsive_display_ad.square_logo_images Field description Square logo images to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 128x128 and the aspect ratio must be 1:1 (+-1%). Combined with logo_images, the maximum is 5. Category ATTRIBUTE Data Type MESSAGE Type URL google.ads.googleads.v16.common.AdImageAsset Filterable False Selectable True Sortable False Repeated True

ad_group_ad.ad.responsive_display_ad.square_logo_images.asset Field description The Asset resource name of this image. Category ATTRIBUTE Data Type RESOURCE_NAME Type URL N/A Filterable True Selectable False Sortable False Repeated False

ad_group_ad.ad.responsive_display_ad.square_marketing_images Field description Square marketing images to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 300x300 and the aspect ratio must be 1:1 (+-1%). At least one square marketing_image is required. Combined with marketing_images, the maximum is 15. Category ATTRIBUTE Data Type MESSAGE Type URL google.ads.googleads.v16.common.AdImageAsset Filterable False Selectable True Sortable False Repeated True

ad_group_ad.ad.responsive_display_ad.square_marketing_images.asset Field description The Asset resource name of this image. Category ATTRIBUTE Data Type RESOURCE_NAME Type URL N/A Filterable True Selectable False Sortable False Repeated False

ad_group_ad.ad.responsive_display_ad.youtube_videos Field description Optional YouTube videos for the ad. A maximum of 5 videos can be specified. Category ATTRIBUTE Data Type MESSAGE Type URL google.ads.googleads.v16.common.AdVideoAsset Filterable False Selectable True Sortable False Repeated True

ad_group_ad.ad.responsive_display_ad.youtube_videos.asset Field description The Asset resource name of this video. Category ATTRIBUTE Data Type RESOURCE_NAME Type URL N/A Filterable True Selectable False Sortable False 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.googleads.v16.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.googleads.v16.common.AdTextAsset Filterable False Selectable True Sortable False Repeated True

ad_group_ad.ad.responsive_search_ad.path1 Field description First part of text that can be appended to the URL in the ad. 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 Second part of text that can be appended to the URL in the ad. This field can only be set when path1 is also set. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.shopping_comparison_listing_ad.headline Field description Headline of the ad. This field is required. Allowed length is between 25 and 45 characters. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.shopping_product_ad Field description Details pertaining to a Shopping product ad. Category ATTRIBUTE Data Type MESSAGE Type URL google.ads.googleads.v16.common.ShoppingProductAdInfo Filterable False Selectable True Sortable False Repeated False

ad_group_ad.ad.shopping_smart_ad Field description Details pertaining to a Smart Shopping ad. Category ATTRIBUTE Data Type MESSAGE Type URL google.ads.googleads.v16.common.ShoppingSmartAdInfo Filterable False Selectable True Sortable False Repeated False

ad_group_ad.ad.smart_campaign_ad.descriptions Field description List of text assets, each of which corresponds to a description when the ad serves. This list consists of a minimum of 2 and up to 4 text assets. Category ATTRIBUTE Data Type MESSAGE Type URL google.ads.googleads.v16.common.AdTextAsset Filterable False Selectable True Sortable False Repeated True

ad_group_ad.ad.smart_campaign_ad.headlines Field description List of text assets, each of which corresponds to a headline when the ad serves. This list consists of a minimum of 3 and up to 15 text assets. Category ATTRIBUTE Data Type MESSAGE Type URL google.ads.googleads.v16.common.AdTextAsset Filterable False Selectable True Sortable False Repeated True

ad_group_ad.ad.system_managed_resource_source Field description Output only. If this ad is system managed, then this field will indicate the source. This field is read-only. Category ATTRIBUTE Data Type ENUM AD_VARIATIONS UNKNOWN UNSPECIFIED Type URL google.ads.googleads.v16.enums.SystemManagedResourceSourceEnum.SystemManagedResourceSource 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.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.tracking_url_template Field description The URL template for constructing a tracking URL. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.travel_ad Field description Details pertaining to a travel ad. Category ATTRIBUTE Data Type MESSAGE Type URL google.ads.googleads.v16.common.TravelAdInfo Filterable False Selectable True Sortable False Repeated False

ad_group_ad.ad.type Field description Output only. The type of ad. Category ATTRIBUTE Data Type ENUM APP_AD APP_ENGAGEMENT_AD APP_PRE_REGISTRATION_AD CALL_AD DEMAND_GEN_PRODUCT_AD DISCOVERY_CAROUSEL_AD DISCOVERY_MULTI_ASSET_AD DISCOVERY_VIDEO_RESPONSIVE_AD DYNAMIC_HTML5_AD EXPANDED_DYNAMIC_SEARCH_AD EXPANDED_TEXT_AD HOTEL_AD HTML5_UPLOAD_AD IMAGE_AD IN_FEED_VIDEO_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_IN_STREAM_AD Type URL google.ads.googleads.v16.enums.AdTypeEnum.AdType Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.url_collections Field description Additional URLs for the ad that are tagged with a unique identifier that can be referenced from other fields in the ad. Category ATTRIBUTE Data Type MESSAGE Type URL google.ads.googleads.v16.common.UrlCollection Filterable False Selectable True Sortable False Repeated True

ad_group_ad.ad.url_custom_parameters Field description The list of mappings that can be used to substitute custom parameter tags in a tracking_url_template, final_urls, or mobile_final_urls. For mutates, use url custom parameter operations. Category ATTRIBUTE Data Type MESSAGE Type URL google.ads.googleads.v16.common.CustomParameter Filterable False Selectable True Sortable False Repeated True

ad_group_ad.ad.video_ad.bumper.action_button_label Field description Label on the "Call To Action" button taking the user to the video ad's final URL. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.video_ad.bumper.action_headline Field description Additional text displayed with the CTA (call-to-action) button to give context and encourage clicking on the button. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.video_ad.bumper.companion_banner.asset Field description The Asset resource name of this image. Category ATTRIBUTE Data Type RESOURCE_NAME Type URL N/A Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.video_ad.in_feed.description1 Field description First text line for the ad. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.video_ad.in_feed.description2 Field description Second text line for the ad. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.video_ad.in_feed.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.video_ad.in_feed.thumbnail Field description Video thumbnail image to use. Category ATTRIBUTE Data Type ENUM DEFAULT_THUMBNAIL THUMBNAIL_1 THUMBNAIL_2 THUMBNAIL_3 UNKNOWN UNSPECIFIED Type URL google.ads.googleads.v16.enums.VideoThumbnailEnum.VideoThumbnail Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.video_ad.in_stream.action_button_label Field description Label on the CTA (call-to-action) button taking the user to the video ad's final URL. Required for TrueView for action campaigns, optional otherwise. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.video_ad.in_stream.action_headline Field description Additional text displayed with the CTA (call-to-action) button to give context and encourage clicking on the button. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.video_ad.in_stream.companion_banner.asset Field description The Asset resource name of this image. Category ATTRIBUTE Data Type RESOURCE_NAME Type URL N/A Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.video_ad.non_skippable.action_button_label Field description Label on the "Call To Action" button taking the user to the video ad's final URL. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.video_ad.non_skippable.action_headline Field description Additional text displayed with the "Call To Action" button to give context and encourage clicking on the button. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.video_ad.non_skippable.companion_banner.asset Field description The Asset resource name of this image. Category ATTRIBUTE Data Type RESOURCE_NAME Type URL N/A Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.video_ad.out_stream.description Field description The description line. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.video_ad.out_stream.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.video_ad.video.asset Field description The Asset resource name of this video. Category ATTRIBUTE Data Type RESOURCE_NAME Type URL N/A Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.video_responsive_ad.breadcrumb1 Field description First part of text that appears in the ad with the displayed URL. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.video_responsive_ad.breadcrumb2 Field description Second part of text that appears in the ad with the displayed URL. Category ATTRIBUTE Data Type STRING Type URL N/A Filterable True Selectable True Sortable True Repeated False

ad_group_ad.ad.video_responsive_ad.call_to_actions Field description List of text assets used for the button, for example, the "Call To Action" button. Currently, only a single value for the button is supported. Category ATTRIBUTE Data Type MESSAGE Type URL google.ads.googleads.v16.common.AdTextAsset Filterable False Selectable True Sortable False Repeated True

ad_group_ad.ad.video_responsive_ad.companion_banners Field description List of image assets used for the companion banner. Currently, only a single value for the companion banner asset is supported. Category ATTRIBUTE Data Type MESSAGE Type URL google.ads.googleads.v16.common.AdImageAsset Filterable False Selectable True Sortable False Repeated True

ad_group_ad.ad.video_responsive_ad.companion_banners.asset Field description The Asset resource name of this image. Category ATTRIBUTE Data Type RESOURCE_NAME Type URL N/A Filterable True Selectable False Sortable False Repeated False

ad_group_ad.ad.video_responsive_ad.descriptions Field description List of text assets used for the description. Currently, only a single value for the description is supported. Category ATTRIBUTE Data Type MESSAGE Type URL google.ads.googleads.v16.common.AdTextAsset Filterable False Selectable True Sortable False Repeated True

ad_group_ad.ad.video_responsive_ad.headlines Field description List of text assets used for the short headline. Currently, only a single value for the short headline is supported. Category ATTRIBUTE Data Type MESSAGE Type URL google.ads.googleads.v16.common.AdTextAsset Filterable False Selectable True Sortable False Repeated True

ad_group_ad.ad.video_responsive_ad.long_headlines Field description List of text assets used for the long headline. Currently, only a single value for the long headline is supported. Category ATTRIBUTE Data Type MESSAGE Type URL google.ads.googleads.v16.common.AdTextAsset Filterable False Selectable True Sortable False Repeated True

ad_group_ad.ad.video_responsive_ad.videos Field description List of YouTube video assets used for the ad. Currently, only a single value for the YouTube video asset is supported. Category ATTRIBUTE Data Type MESSAGE Type URL google.ads.googleads.v16.common.AdVideoAsset Filterable False Selectable True Sortable False Repeated True

ad_group_ad.ad.video_responsive_ad.videos.asset Field description The Asset resource name of this video. Category ATTRIBUTE Data Type RESOURCE_NAME Type URL N/A Filterable True Selectable False Sortable False Repeated False

ad_group_ad.ad_group Field description Immutable. The ad group to which the ad belongs. Category ATTRIBUTE Data Type RESOURCE_NAME Type URL N/A Filterable True Selectable True Sortable False Repeated False

ad_group_ad.ad_strength Field description Output only. Overall ad strength for this ad group ad. Category ATTRIBUTE Data Type ENUM AVERAGE EXCELLENT GOOD NO_ADS PENDING POOR UNKNOWN UNSPECIFIED Type URL google.ads.googleads.v16.enums.AdStrengthEnum.AdStrength Filterable True Selectable True Sortable True Repeated False

ad_group_ad.labels Field description Output only. 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.policy_summary.approval_status Field description Output only. The overall approval status of this ad, calculated based on the status of its individual policy topic entries. Category ATTRIBUTE Data Type ENUM APPROVED APPROVED_LIMITED AREA_OF_INTEREST_ONLY DISAPPROVED UNKNOWN UNSPECIFIED Type URL google.ads.googleads.v16.enums.PolicyApprovalStatusEnum.PolicyApprovalStatus Filterable True Selectable True Sortable True Repeated False

ad_group_ad.policy_summary.policy_topic_entries Field description Output only. The list of policy findings for this ad. Category ATTRIBUTE Data Type MESSAGE Type URL google.ads.googleads.v16.common.PolicyTopicEntry Filterable False Selectable True Sortable False Repeated True

ad_group_ad.policy_summary.review_status Field description Output only. Where in the review process this ad is. Category ATTRIBUTE Data Type ENUM ELIGIBLE_MAY_SERVE REVIEWED REVIEW_IN_PROGRESS UNDER_APPEAL UNKNOWN UNSPECIFIED Type URL google.ads.googleads.v16.enums.PolicyReviewStatusEnum.PolicyReviewStatus Filterable True Selectable True Sortable True Repeated False

ad_group_ad.primary_status Field description Output only. Provides aggregated view into why an ad group ad is not serving or not serving optimally. Category ATTRIBUTE Data Type ENUM ELIGIBLE LIMITED NOT_ELIGIBLE PAUSED PENDING REMOVED UNKNOWN UNSPECIFIED Type URL google.ads.googleads.v16.enums.AdGroupAdPrimaryStatusEnum.AdGroupAdPrimaryStatus Filterable True Selectable True Sortable True Repeated False

ad_group_ad.primary_status_reasons Field description Output only. Provides reasons for why an ad group ad is not serving or not serving optimally. Category ATTRIBUTE Data Type ENUM AD_GROUP_AD_APPROVED_LABELED AD_GROUP_AD_AREA_OF_INTEREST_ONLY AD_GROUP_AD_DISAPPROVED AD_GROUP_AD_NO_ADS AD_GROUP_AD_PAUSED AD_GROUP_AD_POOR_QUALITY AD_GROUP_AD_REMOVED AD_GROUP_AD_UNDER_APPEAL AD_GROUP_AD_UNDER_REVIEW AD_GROUP_PAUSED AD_GROUP_REMOVED CAMPAIGN_ENDED CAMPAIGN_PAUSED CAMPAIGN_PENDING CAMPAIGN_REMOVED UNKNOWN UNSPECIFIED Type URL google.ads.googleads.v16.enums.AdGroupAdPrimaryStatusReasonEnum.AdGroupAdPrimaryStatusReason Filterable True Selectable True Sortable False Repeated True

ad_group_ad.resource_name Field description Immutable. 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.googleads.v16.enums.AdGroupAdStatusEnum.AdGroupAdStatus Filterable True Selectable True Sortable True Repeated False

segments.ad_destination_type Field description Ad Destination type. Category SEGMENT Data Type ENUM APP_DEEP_LINK APP_STORE LEAD_FORM LOCATION_LISTING MAP_DIRECTIONS MESSAGE NOT_APPLICABLE PHONE_CALL UNKNOWN UNMODELED_FOR_CONVERSIONS UNSPECIFIED WEBSITE YOUTUBE Type URL google.ads.googleads.v16.enums.AdDestinationTypeEnum.AdDestinationType Filterable True Selectable True Sortable True Repeated False

segments.ad_network_type Field description Ad network type. Category SEGMENT Data Type ENUM CONTENT GOOGLE_TV MIXED SEARCH SEARCH_PARTNERS UNKNOWN UNSPECIFIED YOUTUBE Type URL google.ads.googleads.v16.enums.AdNetworkTypeEnum.AdNetworkType Filterable True Selectable True Sortable True Repeated False

segments.click_type Field description Click type. Category SEGMENT Data Type ENUM APP_DEEPLINK BREADCRUMBS BROADBAND_PLAN CALLS CALL_TRACKING CLICK_ON_ENGAGEMENT_AD CROSS_NETWORK GET_DIRECTIONS HOTEL_BOOK_ON_GOOGLE_ROOM_SELECTION HOTEL_PRICE LOCATION_EXPANSION LOCATION_FORMAT_CALL LOCATION_FORMAT_DIRECTIONS LOCATION_FORMAT_IMAGE LOCATION_FORMAT_LANDING_PAGE LOCATION_FORMAT_MAP LOCATION_FORMAT_STORE_INFO LOCATION_FORMAT_TEXT MOBILE_CALL_TRACKING OFFER_PRINTS OTHER PRICE_EXTENSION PRODUCT_AD_APP_DEEPLINK PRODUCT_EXTENSION_CLICKS PRODUCT_LISTING_ADS_COUPON PRODUCT_LISTING_AD_CLICKS PRODUCT_LISTING_AD_LOCAL PRODUCT_LISTING_AD_MULTICHANNEL_LOCAL PRODUCT_LISTING_AD_MULTICHANNEL_ONLINE PRODUCT_LISTING_AD_TRANSACTABLE PROMOTION_EXTENSION SHOPPING_COMPARISON_LISTING SHOWCASE_AD_CATEGORY_LINK SHOWCASE_AD_LOCAL_PRODUCT_LINK SHOWCASE_AD_LOCAL_STOREFRONT_LINK SHOWCASE_AD_ONLINE_PRODUCT_LINK SITELINKS STORE_LOCATOR SWIPEABLE_GALLERY_AD_HEADLINE SWIPEABLE_GALLERY_AD_SEE_MORE SWIPEABLE_GALLERY_AD_SITELINK_FIVE SWIPEABLE_GALLERY_AD_SITELINK_FOUR SWIPEABLE_GALLERY_AD_SITELINK_ONE SWIPEABLE_GALLERY_AD_SITELINK_THREE SWIPEABLE_GALLERY_AD_SITELINK_TWO SWIPEABLE_GALLERY_AD_SWIPES UNKNOWN UNSPECIFIED URL_CLICKS VIDEO_APP_STORE_CLICKS VIDEO_CALL_TO_ACTION_CLICKS VIDEO_CARD_ACTION_HEADLINE_CLICKS VIDEO_END_CAP_CLICKS VIDEO_WEBSITE_CLICKS VISUAL_SITELINKS WIRELESS_PLAN Type URL google.ads.googleads.v16.enums.ClickTypeEnum.ClickType Filterable True Selectable True Sortable True Repeated False

segments.conversion_action Field description Resource name of the conversion action. Category SEGMENT Data Type RESOURCE_NAME Type URL N/A Filterable True Selectable True Sortable True Repeated False

segments.conversion_action_category Field description Conversion action category. Category SEGMENT Data Type ENUM ADD_TO_CART BEGIN_CHECKOUT BOOK_APPOINTMENT CONTACT CONVERTED_LEAD DEFAULT DOWNLOAD ENGAGEMENT GET_DIRECTIONS IMPORTED_LEAD OUTBOUND_CLICK PAGE_VIEW PHONE_CALL_LEAD PURCHASE QUALIFIED_LEAD REQUEST_QUOTE SIGNUP STORE_SALE STORE_VISIT SUBMIT_LEAD_FORM SUBSCRIBE_PAID UNKNOWN UNSPECIFIED Type URL google.ads.googleads.v16.enums.ConversionActionCategoryEnum.ConversionActionCategory 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.conversion_adjustment Field description This segments your conversion columns by the original conversion and conversion value versus the delta if conversions were adjusted. False row has the data as originally stated; While true row has the delta between data now and the data as originally stated. Summing the two together results post-adjustment data. Category SEGMENT Data Type BOOLEAN Type URL N/A Filterable True Selectable True Sortable True Repeated False

segments.conversion_attribution_event_type Field description Conversion attribution event type. Category SEGMENT Data Type ENUM IMPRESSION INTERACTION UNKNOWN UNSPECIFIED Type URL google.ads.googleads.v16.enums.ConversionAttributionEventTypeEnum.ConversionAttributionEventType Filterable True Selectable True Sortable True Repeated False

segments.conversion_lag_bucket Field description An enum value representing the number of days between the impression and the conversion. Category SEGMENT Data Type ENUM EIGHT_TO_NINE_DAYS ELEVEN_TO_TWELVE_DAYS FIVE_TO_SIX_DAYS FORTY_FIVE_TO_SIXTY_DAYS FOURTEEN_TO_TWENTY_ONE_DAYS FOUR_TO_FIVE_DAYS LESS_THAN_ONE_DAY NINE_TO_TEN_DAYS ONE_TO_TWO_DAYS SEVEN_TO_EIGHT_DAYS SIXTY_TO_NINETY_DAYS SIX_TO_SEVEN_DAYS TEN_TO_ELEVEN_DAYS THIRTEEN_TO_FOURTEEN_DAYS THIRTY_TO_FORTY_FIVE_DAYS THREE_TO_FOUR_DAYS TWELVE_TO_THIRTEEN_DAYS TWENTY_ONE_TO_THIRTY_DAYS TWO_TO_THREE_DAYS UNKNOWN UNSPECIFIED Type URL google.ads.googleads.v16.enums.ConversionLagBucketEnum.ConversionLagBucket Filterable True Selectable True Sortable True Repeated False

segments.conversion_or_adjustment_lag_bucket Field description An enum value representing the number of days between the impression and the conversion or between the impression and adjustments to the conversion. Category SEGMENT Data Type ENUM ADJUSTMENT_EIGHT_TO_NINE_DAYS ADJUSTMENT_ELEVEN_TO_TWELVE_DAYS ADJUSTMENT_FIVE_TO_SIX_DAYS ADJUSTMENT_FORTY_FIVE_TO_SIXTY_DAYS ADJUSTMENT_FOURTEEN_TO_TWENTY_ONE_DAYS ADJUSTMENT_FOUR_TO_FIVE_DAYS ADJUSTMENT_LESS_THAN_ONE_DAY ADJUSTMENT_NINETY_TO_ONE_HUNDRED_AND_FORTY_FIVE_DAYS ADJUSTMENT_NINE_TO_TEN_DAYS ADJUSTMENT_ONE_TO_TWO_DAYS ADJUSTMENT_SEVEN_TO_EIGHT_DAYS ADJUSTMENT_SIXTY_TO_NINETY_DAYS ADJUSTMENT_SIX_TO_SEVEN_DAYS ADJUSTMENT_TEN_TO_ELEVEN_DAYS ADJUSTMENT_THIRTEEN_TO_FOURTEEN_DAYS ADJUSTMENT_THIRTY_TO_FORTY_FIVE_DAYS ADJUSTMENT_THREE_TO_FOUR_DAYS ADJUSTMENT_TWELVE_TO_THIRTEEN_DAYS ADJUSTMENT_TWENTY_ONE_TO_THIRTY_DAYS ADJUSTMENT_TWO_TO_THREE_DAYS ADJUSTMENT_UNKNOWN CONVERSION_EIGHT_TO_NINE_DAYS CONVERSION_ELEVEN_TO_TWELVE_DAYS CONVERSION_FIVE_TO_SIX_DAYS CONVERSION_FORTY_FIVE_TO_SIXTY_DAYS CONVERSION_FOURTEEN_TO_TWENTY_ONE_DAYS CONVERSION_FOUR_TO_FIVE_DAYS CONVERSION_LESS_THAN_ONE_DAY CONVERSION_NINE_TO_TEN_DAYS CONVERSION_ONE_TO_TWO_DAYS CONVERSION_SEVEN_TO_EIGHT_DAYS CONVERSION_SIXTY_TO_NINETY_DAYS CONVERSION_SIX_TO_SEVEN_DAYS CONVERSION_TEN_TO_ELEVEN_DAYS CONVERSION_THIRTEEN_TO_FOURTEEN_DAYS CONVERSION_THIRTY_TO_FORTY_FIVE_DAYS CONVERSION_THREE_TO_FOUR_DAYS CONVERSION_TWELVE_TO_THIRTEEN_DAYS CONVERSION_TWENTY_ONE_TO_THIRTY_DAYS CONVERSION_TWO_TO_THREE_DAYS CONVERSION_UNKNOWN UNKNOWN UNSPECIFIED Type URL google.ads.googleads.v16.enums.ConversionOrAdjustmentLagBucketEnum.ConversionOrAdjustmentLagBucket 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.day_of_week Field description Day of the week, for example, MONDAY. Category SEGMENT Data Type ENUM FRIDAY MONDAY SATURDAY SUNDAY THURSDAY TUESDAY UNKNOWN UNSPECIFIED WEDNESDAY Type URL google.ads.googleads.v16.enums.DayOfWeekEnum.DayOfWeek 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.googleads.v16.enums.DeviceEnum.Device Filterable True Selectable True Sortable True Repeated False

segments.external_conversion_source Field description External conversion source. Category SEGMENT Data Type ENUM AD_CALL_METRICS ANALYTICS ANALYTICS_SEARCH_ADS_360 ANDROID_FIRST_OPEN ANDROID_IN_APP APP_UNSPECIFIED CLICK_TO_CALL DISPLAY_AND_VIDEO_360_FLOODLIGHT FIREBASE FIREBASE_SEARCH_ADS_360 FLOODLIGHT GOOGLE_ATTRIBUTION GOOGLE_HOSTED GOOGLE_PLAY IOS_FIRST_OPEN IOS_IN_APP SALESFORCE SEARCH_ADS_360 STORE_SALES STORE_SALES_CRM STORE_SALES_DIRECT_UPLOAD STORE_SALES_PAYMENT_NETWORK STORE_VISITS THIRD_PARTY_APP_ANALYTICS UNKNOWN UNSPECIFIED UPLOAD UPLOAD_CALLS WEBPAGE WEBSITE_CALL_METRICS Type URL google.ads.googleads.v16.enums.ExternalConversionSourceEnum.ExternalConversionSource Filterable True Selectable True Sortable True Repeated False

segments.interaction_on_this_extension Field description Only used with feed item metrics. Indicates whether the interaction metrics occurred on the feed item itself or a different extension or ad unit. Category SEGMENT Data Type BOOLEAN Type URL N/A 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.googleads.v16.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.month_of_year Field description Month of the year, for example, January. Category SEGMENT Data Type ENUM APRIL AUGUST DECEMBER FEBRUARY JANUARY JULY JUNE MARCH MAY NOVEMBER OCTOBER SEPTEMBER UNKNOWN UNSPECIFIED Type URL google.ads.googleads.v16.enums.MonthOfYearEnum.MonthOfYear Filterable True Selectable True Sortable True Repeated False

segments.new_versus_returning_customers Field description This is for segmenting conversions by whether the user is a new customer or a returning customer. This segmentation is typically used to measure the impact of customer acquisition goal. Category SEGMENT Data Type ENUM NEW NEW_AND_HIGH_LTV RETURNING UNKNOWN UNSPECIFIED Type URL google.ads.googleads.v16.enums.ConvertingUserPriorEngagementTypeAndLtvBucketEnum.ConvertingUserPriorEngagementTypeAndLtvBucket Filterable True Selectable True Sortable True Repeated False

segments.placeholder_type Field description Placeholder type. This is only used with feed item metrics. Category SEGMENT Data Type ENUM AD_CUSTOMIZER AFFILIATE_LOCATION APP CALL CALLOUT DYNAMIC_CUSTOM DYNAMIC_EDUCATION DYNAMIC_FLIGHT DYNAMIC_HOTEL DYNAMIC_JOB DYNAMIC_LOCAL DYNAMIC_REAL_ESTATE DYNAMIC_TRAVEL IMAGE LOCATION MESSAGE PRICE PROMOTION SITELINK STRUCTURED_SNIPPET UNKNOWN UNSPECIFIED Type URL google.ads.googleads.v16.enums.PlaceholderTypeEnum.PlaceholderType 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.search_term_match_type Field description Match type of the keyword that triggered the ad, including variants. Category SEGMENT Data Type ENUM BROAD EXACT NEAR_EXACT NEAR_PHRASE PHRASE UNKNOWN UNSPECIFIED Type URL google.ads.googleads.v16.enums.SearchTermMatchTypeEnum.SearchTermMatchType Filterable True Selectable True Sortable True Repeated False

segments.slot Field description Position of the ad. Category SEGMENT Data Type ENUM CONTENT MIXED SEARCH_OTHER SEARCH_PARTNER_OTHER SEARCH_PARTNER_TOP SEARCH_SIDE SEARCH_TOP UNKNOWN UNSPECIFIED Type URL google.ads.googleads.v16.enums.SlotEnum.Slot 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.absolute_top_impression_percentage Field description Search absolute top impression share is the percentage of your Search ad impressions that are shown in the most prominent Search position. Category METRIC Data Type DOUBLE Type URL N/A Filterable True Selectable True Sortable True Repeated False

metrics.active_view_cpm Field description Average cost of viewable impressions (active_view_impressions). Category METRIC Data Type DOUBLE Type URL N/A Filterable True Selectable True Sortable True Repeated False

metrics.active_view_ctr Field description Active view measurable clicks divided by active view viewable impressions. This metric is reported only for the Display Network. Category METRIC Data Type DOUBLE Type URL N/A Filterable True Selectable True Sortable True Repeated False

metrics.active_view_impressions Field description A measurement of how often your ad has become viewable on a Display Network site. Category METRIC Data Type INT64 Type URL N/A Filterable True Selectable True Sortable True Repeated False

metrics.active_view_measurability Field description The ratio of impressions that could be measured by Active View over the number of served impressions. Category METRIC Data Type DOUBLE Type URL N/A Filterable True Selectable True Sortable True Repeated False

metrics.active_view_measurable_cost_micros Field description The cost of the impressions you received that were measurable by Active View. Category METRIC Data Type INT64 Type URL N/A Filterable True Selectable True Sortable True Repeated False

metrics.active_view_measurable_impressions Field description The number of times your ads are appearing on placements in positions where they can be seen. Category METRIC Data Type INT64 Type URL N/A Filterable True Selectable True Sortable True Repeated False

metrics.active_view_viewability Field description The percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions). Category METRIC Data Type DOUBLE 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/google-ads/answer/9549009. Category METRIC Data Type DOUBLE Type URL N/A Filterable True Selectable True Sortable True Repeated False

metrics.all_conversions_from_interactions_rate Field description All conversions from interactions (as oppose to view through conversions) divided by the number of ad interactions. Category METRIC Data Type DOUBLE Type URL N/A Filterable True Selectable True Sortable True Repeated False

metrics.all_conversions_from_interactions_value_per_interaction Field description The value of all conversions from interactions divided by the total number of interactions. 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/google-ads/answer/9549009. Category METRIC Data Type DOUBLE Type URL N/A Filterable True Selectable True Sortable True Repeated False

metrics.all_conversions_value_per_cost Field description The value of all conversions divided by the total cost of ad interactions (such as clicks for text ads or views for video ads). Category METRIC Data Type DOUBLE Type URL N/A Filterable True Selectable True Sortable True Repeated False

metrics.all_new_customer_lifetime_value Field description All of new customers' lifetime conversion value. If you have set up customer acquisition goal at either account level or campaign level, this will include the additional conversion value from new customers for both biddable and non-biddable conversions. If your campaign has adopted the customer acquisition goal and selected "bid higher for new customers", these values will be included in "all_conversions_value". See https://support.google.com/google-ads/answer/12080169 for more details. Category METRIC Data Type DOUBLE Type URL N/A Filterable True Selectable True Sortable True Repeated False

metrics.average_cart_size Field description Average cart size is the average number of products in each order attributed to your ads. How it works: You report conversions with cart data for completed purchases on your website. Average cart size is the total number of products sold divided by the total number of orders you received. Example: You received 2 orders, the first included 3 products and the second included 2. The average cart size is 2.5 products = (3+2)/2. This metric is only available if you report conversions with cart data. Category METRIC Data Type DOUBLE Type URL N/A Filterable True Selectable True Sortable True Repeated False

metrics.average_cost Field description The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions. 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. Category METRIC Data Type DOUBLE Type URL N/A Filterable True Selectable True Sortable True Repeated False

metrics.average_cpe Field description The average amount that you've been charged for an ad engagement. This amount is the total cost of all ad engagements divided by the total number of ad engagements. 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). Category METRIC Data Type DOUBLE Type URL N/A Filterable True Selectable True Sortable True Repeated False

metrics.average_cpv Field description The average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views. Category METRIC Data Type DOUBLE Type URL N/A Filterable True Selectable True Sortable True Repeated False

metrics.average_order_value_micros Field description Average order value is the average revenue you made per order attributed to your ads. How it works: You report conversions with cart data for completed purchases on your website. Average order value is the total revenue from your orders divided by the total number of orders. Example: You received 3 orders which made $10, $15 and $20 worth of revenue. The average order value is $15 = ($10 + $15 + $20)/3. This metric is only available if you report conversions with cart data. Category METRIC Data Type INT64 Type URL N/A Filterable True Selectable True Sortable True Repeated False

metrics.average_page_views Field description Average number of pages viewed per session. Category METRIC Data Type DOUBLE Type URL N/A Filterable True Selectable True Sortable True Repeated False

metrics.average_time_on_site Field description Total duration of all sessions (in seconds) / number of sessions. Imported from Google Analytics. Category METRIC Data Type DOUBLE Type URL N/A Filterable True Selectable True Sortable True Repeated False

metrics.bounce_rate Field description Percentage of clicks where the user only visited a single page on your site. Imported from Google Analytics. 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.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_by_conversion_date 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. 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/google-ads/answer/9549009. Category METRIC Data Type DOUBLE Type URL N/A Filterable True Selectable True Sortable True Repeated False

metrics.conversions_from_interactions_rate Field description Conversions from interactions divided by the number of ad interactions (such as clicks for text ads or views for video ads). 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_from_interactions_value_per_interaction Field description The value of conversions from interactions divided by the number of ad interactions. 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 value 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_by_conversion_date Field description The value 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. 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/google-ads/answer/9549009. Category METRIC Data Type DOUBLE Type URL N/A Filterable True Selectable True Sortable True Repeated False

metrics.conversions_value_per_cost Field description The value of conversions divided by the cost of ad interactions. 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.cost_micros Field description The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. Category METRIC Data Type INT64 Type URL N/A Filterable True Selectable True Sortable True Repeated False

metrics.cost_of_goods_sold_micros Field description Cost of goods sold (COGS) is the total cost of the products you sold in orders attributed to your ads. How it works: You can add a cost of goods sold value to every product in Merchant Center. If you report conversions with cart data, the products you sold are matched with their cost of goods sold value and this can be used to calculate the gross profit you made on each order. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat has a cost of goods sold value of $3, the shirt has a cost of goods sold value of $5. The cost of goods sold for this order is $8 = $3 + $5. This metric is only available if you report conversions with cart data. Category METRIC Data Type INT64 Type URL N/A Filterable True Selectable True Sortable True Repeated False

metrics.cost_per_all_conversions Field description The cost of ad interactions divided by all conversions. Category METRIC Data Type DOUBLE Type URL N/A Filterable True Selectable True Sortable True Repeated False

metrics.cost_per_conversion Field description The cost of ad interactions divided by 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.cost_per_current_model_attributed_conversion Field description The cost of ad interactions divided by current model attributed 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.cross_device_conversions Field description Conversions from when a customer clicks on a Google Ads 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_micros Field description The sum of the value of cross-device conversions, in micros. Category METRIC Data Type INT64 Type URL N/A Filterable True Selectable True Sortable True Repeated False

metrics.cross_sell_cost_of_goods_sold_micros Field description Cross-sell cost of goods sold (COGS) is the total cost of products sold as a result of advertising a different product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell cost of goods sold is the total cost of the products sold that weren't advertised. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat has a cost of goods sold value of $3, the shirt has a cost of goods sold value of $5. The cross-sell cost of goods sold for this order is $5. This metric is only available if you report conversions with cart data. Category METRIC Data Type INT64 Type URL N/A Filterable True Selectable True Sortable True Repeated False

metrics.cross_sell_gross_profit_micros Field description Cross-sell gross profit is the profit you made from products sold as a result of advertising a different product, minus cost of goods sold (COGS). How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the purchase is a sold product. If these products don't match then this is considered cross-sell. Cross-sell gross profit is the revenue you made from cross-sell attributed to your ads minus the cost of the goods sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The shirt is priced $20 and has a cost of goods sold value of $5. The cross-sell gross profit of this order is $15 = $20 - $5. This metric is only available if you report conversions with cart data. Category METRIC Data Type INT64 Type URL N/A Filterable True Selectable True Sortable True Repeated False

metrics.cross_sell_revenue_micros Field description Cross-sell revenue is the total amount you made from products sold as a result of advertising a different product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell revenue is the total value you made from cross-sell attributed to your ads. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and the shirt is priced $20. The cross-sell revenue of this order is $20. This metric is only available if you report conversions with cart data. Category METRIC Data Type INT64 Type URL N/A Filterable True Selectable True Sortable True Repeated False

metrics.cross_sell_units_sold Field description Cross-sell units sold is the total number of products sold as a result of advertising a different product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If these products don't match then this is considered cross-sell. Cross-sell units sold is the total number of cross-sold products from all orders attributed to your ads. Example: Someone clicked on a Shopping ad for a hat then bought the same hat, a shirt and a jacket. The cross-sell units sold in this order is 2. This metric is only available if you report conversions with cart data. 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.current_model_attributed_conversions Field description Shows how your historic conversions data would look under the attribution model you've currently selected. 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.current_model_attributed_conversions_from_interactions_rate Field description Current model attributed conversions from interactions divided by the number of ad interactions (such as clicks for text ads or views for video ads). 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.current_model_attributed_conversions_from_interactions_value_per_interaction Field description The value of current model attributed conversions from interactions divided by the number of ad interactions. 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.current_model_attributed_conversions_value Field description The value of current model attributed 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.current_model_attributed_conversions_value_per_cost Field description The value of current model attributed conversions divided by the cost of ad interactions. 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.engagement_rate Field description How often people engage with your ad after it's shown to them. This is the number of ad expansions divided by the number of times your ad is shown. Category METRIC Data Type DOUBLE Type URL N/A Filterable True Selectable True Sortable True Repeated False

metrics.engagements Field description The number of engagements. An engagement occurs when a viewer expands your Lightbox ad. Also, in the future, other ad types may support engagement metrics. Category METRIC Data Type INT64 Type URL N/A Filterable True Selectable True Sortable True Repeated False

metrics.gmail_forwards Field description The number of times the ad was forwarded to someone else as a message. Category METRIC Data Type INT64 Type URL N/A Filterable True Selectable True Sortable True Repeated False

metrics.gmail_saves Field description The number of times someone has saved your Gmail ad to their inbox as a message. Category METRIC Data Type INT64 Type URL N/A Filterable True Selectable True Sortable True Repeated False

metrics.gmail_secondary_clicks Field description The number of clicks to the landing page on the expanded state of Gmail ads. Category METRIC Data Type INT64 Type URL N/A Filterable True Selectable True Sortable True Repeated False

metrics.gross_profit_margin Field description Gross profit margin is the percentage gross profit you made from orders attributed to your ads, after taking out the cost of goods sold (COGS). How it works: You report conversions with cart data for completed purchases on your website. Gross profit margin is the gross profit you made divided by your total revenue and multiplied by 100%. Gross profit margin calculations only include products that have a cost of goods sold value in Merchant Center. Example: Someone bought a hat and a shirt in an order on your website. The hat is priced $10 and has a cost of goods sold value of $3. The shirt is priced $20 but has no cost of goods sold value. Gross profit margin for this order will only take into account the hat because it has a cost of goods sold value, so it's 70% = ($10 - $3)/$10 x 100%. This metric is only available if you report conversions with cart data. Category METRIC Data Type DOUBLE Type URL N/A Filterable True Selectable True Sortable True Repeated False

metrics.gross_profit_micros Field description Gross profit is the profit you made from orders attributed to your ads minus the cost of goods sold (COGS). How it works: Gross profit is the revenue you made from sales attributed to your ads minus cost of goods sold. Gross profit calculations only include products that have a cost of goods sold value in Merchant Center. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt in an order from your website. The hat is priced $10 and the shirt is priced $20. The hat has a cost of goods sold value of $3, but the shirt has no cost of goods sold value. Gross profit for this order will only take into account the hat, so it's $7 = $10 - $3. This metric is only available if you report conversions with cart data. Category METRIC Data Type INT64 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.interaction_event_types Field description The types of payable and free interactions. Category METRIC Data Type ENUM Type URL google.ads.googleads.v16.enums.InteractionEventTypeEnum.InteractionEventType Filterable True Selectable True Sortable False Repeated True

metrics.interaction_rate Field description How often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown. Category METRIC Data Type DOUBLE Type URL N/A Filterable True Selectable True Sortable True Repeated False

metrics.interactions Field description The number of interactions. An interaction is the main user action associated with an ad format-clicks for text and shopping ads, views for video ads, and so on. Category METRIC Data Type INT64 Type URL N/A Filterable True Selectable True Sortable True Repeated False

metrics.lead_cost_of_goods_sold_micros Field description Lead cost of goods sold (COGS) is the total cost of products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the cost of these goods is counted under lead cost of goods sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat has a cost of goods sold value of $3, the shirt has a cost of goods sold value of $5. The lead cost of goods sold for this order is $3. This metric is only available if you report conversions with cart data. Category METRIC Data Type INT64 Type URL N/A Filterable True Selectable True Sortable True Repeated False

metrics.lead_gross_profit_micros Field description Lead gross profit is the profit you made from products sold as a result of advertising the same product, minus cost of goods sold (COGS). How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the revenue you made from these sales minus the cost of goods sold is your lead gross profit. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and has a cost of goods sold value of $3. The lead gross profit of this order is $7 = $10 - $3. This metric is only available if you report conversions with cart data. Category METRIC Data Type INT64 Type URL N/A Filterable True Selectable True Sortable True Repeated False

metrics.lead_revenue_micros Field description Lead revenue is the total amount you made from products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the total value you made from the sales of these products is shown under lead revenue. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt. The hat is priced $10 and the shirt is priced $20. The lead revenue of this order is $10. This metric is only available if you report conversions with cart data. Category METRIC Data Type INT64 Type URL N/A Filterable True Selectable True Sortable True Repeated False

metrics.lead_units_sold Field description Lead units sold is the total number of products sold as a result of advertising the same product. How it works: You report conversions with cart data for completed purchases on your website. If the ad that was interacted with before the purchase has an associated product (see Shopping Ads) then this product is considered the advertised product. Any product included in the order the customer places is a sold product. If the advertised and sold products match, then the total number of these products sold is shown under lead units sold. Example: Someone clicked on a Shopping ad for a hat then bought the same hat, a shirt and a jacket. The lead units sold in this order is 1. This metric is only available if you report conversions with cart data. Category METRIC Data Type DOUBLE Type URL N/A Filterable True Selectable True Sortable True Repeated False

metrics.new_customer_lifetime_value Field description New customers' lifetime conversion value. If you have set up customer acquisition goal at either account level or campaign level, this will include the additional conversion value from new customers for biddable conversions. If your campaign has adopted the customer acquisition goal and selected "bid higher for new customers", these values will be included in "conversions_value" for optimization. See https://support.google.com/google-ads/answer/12080169 for more details. Category METRIC Data Type DOUBLE Type URL N/A Filterable True Selectable True Sortable True Repeated False

metrics.orders Field description Orders is the total number of purchase conversions you received attributed to your ads. How it works: You report conversions with cart data for completed purchases on your website. If a conversion is attributed to previous interactions with your ads (clicks for text or Shopping ads, views for video ads etc.) it's counted as an order. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt in an order on your website. Even though they bought 2 products, this would count as 1 order. This metric is only available if you report conversions with cart data. Category METRIC Data Type DOUBLE Type URL N/A Filterable True Selectable True Sortable True Repeated False

metrics.percent_new_visitors Field description Percentage of first-time sessions (from people who had never visited your site before). Imported from Google Analytics. Category METRIC Data Type DOUBLE Type URL N/A Filterable True Selectable True Sortable True Repeated False

metrics.phone_calls Field description Number of offline phone calls. Category METRIC Data Type INT64 Type URL N/A Filterable True Selectable True Sortable True Repeated False

metrics.phone_impressions Field description Number of offline phone impressions. Category METRIC Data Type INT64 Type URL N/A Filterable True Selectable True Sortable True Repeated False

metrics.phone_through_rate Field description Number of phone calls received (phone_calls) divided by the number of times your phone number is shown (phone_impressions). Category METRIC Data Type DOUBLE Type URL N/A Filterable True Selectable True Sortable True Repeated False

metrics.revenue_micros Field description Revenue is the total amount you made from orders attributed to your ads. How it works: You report conversions with cart data for completed purchases on your website. Revenue is the total value of all the orders you received attributed to your ads, minus any discount. Example: Someone clicked on a Shopping ad for a hat then bought the same hat and a shirt in an order from your website. The hat is priced $10 and the shirt is priced $20. The entire order has a $5 discount. The revenue from this order is $25 = ($10 + $20) - $5. This metric is only available if you report conversions with cart data. Category METRIC Data Type INT64 Type URL N/A Filterable True Selectable True Sortable True Repeated False

metrics.top_impression_percentage Field description The percent of your ad impressions that are shown adjacent to the top organic search results. Category METRIC Data Type DOUBLE Type URL N/A Filterable True Selectable True Sortable True Repeated False

metrics.units_sold Field description Units sold is the total number of products sold from orders attributed to your ads. How it works: You report conversions with cart data for completed purchases on your website. Units sold is the total number of products sold from all orders attributed to your ads. Example: Someone clicked on a Shopping ad for a hat then bought the same hat, a shirt and a jacket. The units sold in this order is 3. This metric is only available if you report conversions with cart data. Category METRIC Data Type DOUBLE Type URL N/A Filterable True Selectable True Sortable True Repeated False

metrics.value_per_all_conversions Field description The value of all conversions divided by the number of all conversions. Category METRIC Data Type DOUBLE Type URL N/A Filterable True Selectable True Sortable True Repeated False

metrics.value_per_all_conversions_by_conversion_date Field description The value of all conversions divided by the number 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/google-ads/answer/9549009. Category METRIC Data Type DOUBLE Type URL N/A Filterable True Selectable True Sortable True Repeated False

metrics.value_per_conversion Field description The value of conversions divided by 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.value_per_conversions_by_conversion_date Field description The value of conversions divided by 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. 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/google-ads/answer/9549009. Category METRIC Data Type DOUBLE Type URL N/A Filterable True Selectable True Sortable True Repeated False

metrics.value_per_current_model_attributed_conversion Field description The value of current model attributed conversions divided by the number of the 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.video_quartile_p100_rate Field description Percentage of impressions where the viewer watched all of your video. Category METRIC Data Type DOUBLE Type URL N/A Filterable True Selectable True Sortable True Repeated False

metrics.video_quartile_p25_rate Field description Percentage of impressions where the viewer watched 25% of your video. Category METRIC Data Type DOUBLE Type URL N/A Filterable True Selectable True Sortable True Repeated False

metrics.video_quartile_p50_rate Field description Percentage of impressions where the viewer watched 50% of your video. Category METRIC Data Type DOUBLE Type URL N/A Filterable True Selectable True Sortable True Repeated False

metrics.video_quartile_p75_rate Field description Percentage of impressions where the viewer watched 75% of your video. Category METRIC Data Type DOUBLE Type URL N/A Filterable True Selectable True Sortable True Repeated False

metrics.video_view_rate Field description The number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads. Category METRIC Data Type DOUBLE Type URL N/A Filterable True Selectable True Sortable True Repeated False

metrics.video_views Field description The number of times your video ads were viewed. Category METRIC Data Type INT64 Type URL N/A Filterable True Selectable True Sortable True Repeated False

metrics.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