ad_group_ad

An ad group ad.

Attributed resources
ad_group
campaign
customer

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

Fields/Segments/Metrics

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

Is ad_group_ad specified in the FROM clause of your query?

Resource fields
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_carousel_ad.business_name
ad.demand_gen_carousel_ad.call_to_action_text
ad.demand_gen_carousel_ad.carousel_cards
ad.demand_gen_carousel_ad.carousel_cards.asset
ad.demand_gen_carousel_ad.description
ad.demand_gen_carousel_ad.headline
ad.demand_gen_carousel_ad.logo_image
ad.demand_gen_carousel_ad.logo_image.asset
ad.demand_gen_multi_asset_ad.business_name
ad.demand_gen_multi_asset_ad.call_to_action_text
ad.demand_gen_multi_asset_ad.descriptions
ad.demand_gen_multi_asset_ad.headlines
ad.demand_gen_multi_asset_ad.lead_form_only
ad.demand_gen_multi_asset_ad.logo_images
ad.demand_gen_multi_asset_ad.logo_images.asset
ad.demand_gen_multi_asset_ad.marketing_images
ad.demand_gen_multi_asset_ad.marketing_images.asset
ad.demand_gen_multi_asset_ad.portrait_marketing_images
ad.demand_gen_multi_asset_ad.portrait_marketing_images.asset
ad.demand_gen_multi_asset_ad.square_marketing_images
ad.demand_gen_multi_asset_ad.square_marketing_images.asset
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.demand_gen_video_responsive_ad.breadcrumb1
ad.demand_gen_video_responsive_ad.breadcrumb2
ad.demand_gen_video_responsive_ad.business_name
ad.demand_gen_video_responsive_ad.call_to_actions
ad.demand_gen_video_responsive_ad.call_to_actions.asset
ad.demand_gen_video_responsive_ad.descriptions
ad.demand_gen_video_responsive_ad.headlines
ad.demand_gen_video_responsive_ad.logo_images
ad.demand_gen_video_responsive_ad.logo_images.asset
ad.demand_gen_video_responsive_ad.long_headlines
ad.demand_gen_video_responsive_ad.videos
ad.demand_gen_video_responsive_ad.videos.asset
ad.device_preference
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_format_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.v17.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.v17.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.v17.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.v17.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.v17.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.v17.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.v17.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.v17.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.v17.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.v17.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.v17.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.v17.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.v17.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.v17.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.v17.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_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.demand_gen_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.demand_gen_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.v17.common.AdDemandGenCarouselCardAsset`
Filterable	False
Selectable	True
Sortable	False
Repeated	True

ad_group_ad.ad.demand_gen_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.demand_gen_carousel_ad.description
Field description	Required. The descriptive text of the ad.
Category	`ATTRIBUTE`
Data Type	`MESSAGE`
Type URL	`google.ads.googleads.v17.common.AdTextAsset`
Filterable	False
Selectable	True
Sortable	False
Repeated	False

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

ad_group_ad.ad.demand_gen_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.v17.common.AdImageAsset`
Filterable	False
Selectable	True
Sortable	False
Repeated	False

ad_group_ad.ad.demand_gen_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.demand_gen_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.demand_gen_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.demand_gen_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.v17.common.AdTextAsset`
Filterable	False
Selectable	True
Sortable	False
Repeated	True

ad_group_ad.ad.demand_gen_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.v17.common.AdTextAsset`
Filterable	False
Selectable	True
Sortable	False
Repeated	True

ad_group_ad.ad.demand_gen_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.demand_gen_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.v17.common.AdImageAsset`
Filterable	False
Selectable	True
Sortable	False
Repeated	True

ad_group_ad.ad.demand_gen_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.demand_gen_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.v17.common.AdImageAsset`
Filterable	False
Selectable	True
Sortable	False
Repeated	True

ad_group_ad.ad.demand_gen_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.demand_gen_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.v17.common.AdImageAsset`
Filterable	False
Selectable	True
Sortable	False
Repeated	True

ad_group_ad.ad.demand_gen_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.demand_gen_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.v17.common.AdImageAsset`
Filterable	False
Selectable	True
Sortable	False
Repeated	True

ad_group_ad.ad.demand_gen_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.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.v17.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.v17.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.v17.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.v17.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.v17.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.demand_gen_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.demand_gen_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.demand_gen_video_responsive_ad.business_name
Field description	Required. The advertiser/brand name.
Category	`ATTRIBUTE`
Data Type	`MESSAGE`
Type URL	`google.ads.googleads.v17.common.AdTextAsset`
Filterable	False
Selectable	True
Sortable	False
Repeated	False

ad_group_ad.ad.demand_gen_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.v17.common.AdCallToActionAsset`
Filterable	False
Selectable	True
Sortable	False
Repeated	True

ad_group_ad.ad.demand_gen_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.demand_gen_video_responsive_ad.descriptions
Field description	List of text assets used for the description.
Category	`ATTRIBUTE`
Data Type	`MESSAGE`
Type URL	`google.ads.googleads.v17.common.AdTextAsset`
Filterable	False
Selectable	True
Sortable	False
Repeated	True

ad_group_ad.ad.demand_gen_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.v17.common.AdTextAsset`
Filterable	False
Selectable	True
Sortable	False
Repeated	True

ad_group_ad.ad.demand_gen_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.v17.common.AdImageAsset`
Filterable	False
Selectable	True
Sortable	False
Repeated	True

ad_group_ad.ad.demand_gen_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.demand_gen_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.v17.common.AdTextAsset`
Filterable	False
Selectable	True
Sortable	False
Repeated	True

ad_group_ad.ad.demand_gen_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.v17.common.AdVideoAsset`
Filterable	False
Selectable	True
Sortable	False
Repeated	True

ad_group_ad.ad.demand_gen_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.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.v17.enums.DeviceEnum.Device`
Filterable	True
Selectable	True
Sortable	True
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.v17.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.v17.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.v17.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.v17.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.v17.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.v17.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.v17.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.v17.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.v17.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.v17.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.v17.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.v17.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.v17.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.v17.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.v17.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.v17.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.v17.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.v17.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.v17.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.v17.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.v17.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.v17.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.v17.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.v17.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.v17.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.v17.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.v17.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.v17.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.v17.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.v17.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_CAROUSEL_AD DEMAND_GEN_MULTI_ASSET_AD DEMAND_GEN_PRODUCT_AD DEMAND_GEN_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.v17.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.v17.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.v17.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.v17.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.v17.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.v17.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.v17.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.v17.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.v17.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.v17.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.v17.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.v17.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.v17.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.v17.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.v17.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.v17.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.v17.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.v17.enums.AdDestinationTypeEnum.AdDestinationType`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

segments.ad_format_type
Field description	Ad Format type.
Category	`SEGMENT`
Data Type	`ENUM AUDIO BUMPER INFEED INSTREAM_NON_SKIPPABLE INSTREAM_SKIPPABLE MASTHEAD OTHER OUTSTREAM SHORTS UNKNOWN UNSEGMENTED UNSPECIFIED`
Type URL	`google.ads.googleads.v17.enums.AdFormatTypeEnum.AdFormatType`
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.v17.enums.AdNetworkTypeEnum.AdNetworkType`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

segments.click_type
Field description	Click type.
Category	`SEGMENT`
Data Type	ENUM AD_IMAGE 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.v17.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.v17.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.v17.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.v17.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.v17.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.v17.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.v17.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.v17.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.v17.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.v17.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.v17.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.v17.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.v17.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.v17.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.v17.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

ad_group_ad

Fields/Segments/Metrics

ad_group_ad.action_items

ad_group_ad.ad.added_by_google_ads

ad_group_ad.ad.app_ad.descriptions

ad_group_ad.ad.app_ad.headlines

ad_group_ad.ad.app_ad.html5_media_bundles

ad_group_ad.ad.app_ad.html5_media_bundles.asset

ad_group_ad.ad.app_ad.images

ad_group_ad.ad.app_ad.images.asset

ad_group_ad.ad.app_ad.mandatory_ad_text

ad_group_ad.ad.app_ad.youtube_videos

ad_group_ad.ad.app_ad.youtube_videos.asset

ad_group_ad.ad.app_engagement_ad.descriptions

ad_group_ad.ad.app_engagement_ad.headlines

ad_group_ad.ad.app_engagement_ad.images

ad_group_ad.ad.app_engagement_ad.images.asset

ad_group_ad.ad.app_engagement_ad.videos

ad_group_ad.ad.app_engagement_ad.videos.asset

ad_group_ad.ad.app_pre_registration_ad.descriptions

ad_group_ad.ad.app_pre_registration_ad.headlines

ad_group_ad.ad.app_pre_registration_ad.images

ad_group_ad.ad.app_pre_registration_ad.images.asset

ad_group_ad.ad.app_pre_registration_ad.youtube_videos

ad_group_ad.ad.app_pre_registration_ad.youtube_videos.asset

ad_group_ad.ad.call_ad.business_name

ad_group_ad.ad.call_ad.call_tracked

ad_group_ad.ad.call_ad.conversion_action

ad_group_ad.ad.call_ad.conversion_reporting_state

ad_group_ad.ad.call_ad.country_code

ad_group_ad.ad.call_ad.description1

ad_group_ad.ad.call_ad.description2

ad_group_ad.ad.call_ad.disable_call_conversion

ad_group_ad.ad.call_ad.headline1

ad_group_ad.ad.call_ad.headline2

ad_group_ad.ad.call_ad.path1

ad_group_ad.ad.call_ad.path2

ad_group_ad.ad.call_ad.phone_number

ad_group_ad.ad.call_ad.phone_number_verification_url

ad_group_ad.ad.demand_gen_carousel_ad.business_name

ad_group_ad.ad.demand_gen_carousel_ad.call_to_action_text

ad_group_ad.ad.demand_gen_carousel_ad.carousel_cards

ad_group_ad.ad.demand_gen_carousel_ad.carousel_cards.asset

ad_group_ad.ad.demand_gen_carousel_ad.description

ad_group_ad.ad.demand_gen_carousel_ad.headline

ad_group_ad.ad.demand_gen_carousel_ad.logo_image

ad_group_ad.ad.demand_gen_carousel_ad.logo_image.asset

ad_group_ad.ad.demand_gen_multi_asset_ad.business_name

ad_group_ad.ad.demand_gen_multi_asset_ad.call_to_action_text

ad_group_ad.ad.demand_gen_multi_asset_ad.descriptions

ad_group_ad.ad.demand_gen_multi_asset_ad.headlines

ad_group_ad.ad.demand_gen_multi_asset_ad.lead_form_only

ad_group_ad.ad.demand_gen_multi_asset_ad.logo_images

ad_group_ad.ad.demand_gen_multi_asset_ad.logo_images.asset

ad_group_ad.ad.demand_gen_multi_asset_ad.marketing_images

ad_group_ad.ad.demand_gen_multi_asset_ad.marketing_images.asset

ad_group_ad.ad.demand_gen_multi_asset_ad.portrait_marketing_images

ad_group_ad.ad.demand_gen_multi_asset_ad.portrait_marketing_images.asset

ad_group_ad.ad.demand_gen_multi_asset_ad.square_marketing_images

ad_group_ad.ad.demand_gen_multi_asset_ad.square_marketing_images.asset

ad_group_ad.ad.demand_gen_product_ad.breadcrumb1

ad_group_ad.ad.demand_gen_product_ad.breadcrumb2

ad_group_ad.ad.demand_gen_product_ad.business_name

ad_group_ad.ad.demand_gen_product_ad.call_to_action

ad_group_ad.ad.demand_gen_product_ad.call_to_action.asset

ad_group_ad.ad.demand_gen_product_ad.description

ad_group_ad.ad.demand_gen_product_ad.headline

ad_group_ad.ad.demand_gen_product_ad.logo_image

ad_group_ad.ad.demand_gen_product_ad.logo_image.asset

ad_group_ad.ad.demand_gen_video_responsive_ad.breadcrumb1

ad_group_ad.ad.demand_gen_video_responsive_ad.breadcrumb2

ad_group_ad.ad.demand_gen_video_responsive_ad.business_name

ad_group_ad.ad.demand_gen_video_responsive_ad.call_to_actions

ad_group_ad.ad.demand_gen_video_responsive_ad.call_to_actions.asset

ad_group_ad.ad.demand_gen_video_responsive_ad.descriptions

ad_group_ad.ad.demand_gen_video_responsive_ad.headlines

ad_group_ad.ad.demand_gen_video_responsive_ad.logo_images

ad_group_ad.ad.demand_gen_video_responsive_ad.logo_images.asset

ad_group_ad.ad.demand_gen_video_responsive_ad.long_headlines

ad_group_ad.ad.demand_gen_video_responsive_ad.videos