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

ad_group_ad

Page Summary

The ad_group_ad resource in the Google Ads API represents an ad within an ad group and provides access to its attributes and performance data.
You can query and analyze ad performance using various fields like headlines, descriptions, and URLs, segments such as date and device, and metrics including clicks, impressions, and conversions.
The resource allows for retrieving detailed information about each field and segmenting data for deeper insights.
A comprehensive list of metrics provides insights into ad performance, including cost, conversions, click-through rates, and more.
The documentation serves as a reference for understanding available data points for ad_group_ad within the Google Ads API, enabling users to leverage the resource for reporting and optimization.

An ad group ad.

Attributed resources
ad_group
campaign
customer

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

Fields/Segments/Metrics

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

Is ad_group_ad specified in the FROM clause of your query?

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

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

Metrics
all_conversions
all_conversions_by_conversion_date
all_conversions_value
all_conversions_value_by_conversion_date
average_cart_size
average_cpc
average_cpm
average_order_value_micros
clicks
client_account_conversions
client_account_conversions_value
client_account_view_through_conversions
conversions
conversions_value
cost_micros
cost_of_goods_sold_micros
cross_device_conversions
cross_device_conversions_by_conversion_date
cross_device_conversions_value
cross_device_conversions_value_by_conversion_date
cross_sell_cost_of_goods_sold_micros
cross_sell_gross_profit_micros
cross_sell_revenue_micros
cross_sell_units_sold
ctr
gross_profit_margin
gross_profit_micros
impressions
lead_cost_of_goods_sold_micros
lead_gross_profit_micros
lead_revenue_micros
orders
revenue_micros
units_sold
visits

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

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

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

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

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

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

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

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

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

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

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

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

ad_group_ad.ad.final_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.searchads360.v0.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.id
Field description	The ID of the ad.
Category	`ATTRIBUTE`
Data Type	`INT64`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ad_group_ad.effective_labels
Field description	The resource names of effective labels attached to this ad. An effective label is a label inherited or directly assigned to this ad.
Category	`ATTRIBUTE`
Data Type	`RESOURCE_NAME`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	False
Repeated	True

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

metrics.all_conversions_by_conversion_date
Field description	The total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/sa360/answer/9250611.
Category	`METRIC`
Data Type	`DOUBLE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

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

metrics.all_conversions_value_by_conversion_date
Field description	The value of all conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/sa360/answer/9250611.
Category	`METRIC`
Data Type	`DOUBLE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

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

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

metrics.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.clicks
Field description	The number of clicks.
Category	`METRIC`
Data Type	`INT64`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

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

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

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

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

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

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

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

metrics.cross_device_conversions_by_conversion_date
Field description	The number of cross-device conversions by conversion date. Details for the by_conversion_date columns are available at https://support.google.com/sa360/answer/9250611.
Category	`METRIC`
Data Type	`DOUBLE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

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

metrics.cross_device_conversions_value_by_conversion_date
Field description	The sum of cross-device conversions value by conversion date. Details for the by_conversion_date columns are available at https://support.google.com/sa360/answer/9250611.
Category	`METRIC`
Data Type	`DOUBLE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

metrics.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. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
Category	`METRIC`
Data Type	`INT64`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

metrics.cross_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. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
Category	`METRIC`
Data Type	`INT64`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

metrics.cross_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. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
Category	`METRIC`
Data Type	`INT64`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

metrics.cross_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.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.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. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
Category	`METRIC`
Data Type	`INT64`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

metrics.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. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
Category	`METRIC`
Data Type	`INT64`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

metrics.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. This metric is a monetary value and returned in the customer's currency by default. See the metrics_currency parameter at https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
Category	`METRIC`
Data Type	`INT64`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

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

ad_group_ad Stay organized with collections Save and categorize content based on your preferences.

Page Summary

Fields/Segments/Metrics

ad_group_ad.ad.display_url

ad_group_ad.ad.expanded_dynamic_search_ad.ad_tracking_id

ad_group_ad.ad.expanded_dynamic_search_ad.description1

ad_group_ad.ad.expanded_dynamic_search_ad.description2

ad_group_ad.ad.expanded_text_ad.ad_tracking_id

ad_group_ad.ad.expanded_text_ad.description1

ad_group_ad.ad.expanded_text_ad.description2

ad_group_ad.ad.expanded_text_ad.headline

ad_group_ad.ad.expanded_text_ad.headline2

ad_group_ad.ad.expanded_text_ad.headline3

ad_group_ad.ad.expanded_text_ad.path1

ad_group_ad.ad.expanded_text_ad.path2

ad_group_ad.ad.final_app_urls

ad_group_ad.ad.final_mobile_urls

ad_group_ad.ad.final_url_suffix

ad_group_ad.ad.final_urls

ad_group_ad.ad.id

ad_group_ad.ad.name

ad_group_ad.ad.resource_name

ad_group_ad.ad.responsive_search_ad.ad_tracking_id

ad_group_ad.ad.responsive_search_ad.descriptions

ad_group_ad.ad.responsive_search_ad.headlines

ad_group_ad.ad.responsive_search_ad.path1

ad_group_ad.ad.responsive_search_ad.path2

ad_group_ad.ad.text_ad.ad_tracking_id

ad_group_ad.ad.text_ad.description1

ad_group_ad.ad.text_ad.description2

ad_group_ad.ad.text_ad.display_mobile_url

ad_group_ad.ad.text_ad.display_url

ad_group_ad.ad.text_ad.headline

ad_group_ad.ad.tracking_url_template

ad_group_ad.ad.type

ad_group_ad.creation_time

ad_group_ad.effective_labels

ad_group_ad.engine_id

ad_group_ad.engine_status

ad_group_ad.labels

ad_group_ad.last_modified_time

ad_group_ad.resource_name

ad_group_ad.status

segments.ad_network_type

segments.conversion_action_name

segments.date

segments.device

segments.keyword.ad_group_criterion

segments.keyword.info.match_type

segments.keyword.info.text

segments.month

segments.quarter

segments.week

segments.year

metrics.all_conversions

metrics.all_conversions_by_conversion_date

metrics.all_conversions_value

metrics.all_conversions_value_by_conversion_date

metrics.average_cart_size

metrics.average_cpc

metrics.average_cpm

metrics.average_order_value_micros

metrics.clicks

metrics.client_account_conversions

metrics.client_account_conversions_value

metrics.client_account_view_through_conversions

metrics.conversions

metrics.conversions_value

metrics.cost_micros

metrics.cost_of_goods_sold_micros

metrics.cross_device_conversions

metrics.cross_device_conversions_by_conversion_date

metrics.cross_device_conversions_value

metrics.cross_device_conversions_value_by_conversion_date

metrics.cross_sell_cost_of_goods_sold_micros

metrics.cross_sell_gross_profit_micros

metrics.cross_sell_revenue_micros

metrics.cross_sell_units_sold

metrics.ctr

metrics.gross_profit_margin

ad_group_ad