metrics

metrics.absolute_top_impression_percentage

Field descriptionThe percent of your ad impressions that are shown as the very first ad above the organic search results.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.active_view_cpm

Field descriptionAverage cost of viewable impressions (`active_view_impressions`).
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.active_view_ctr

Field descriptionActive view measurable clicks divided by active view viewable impressions. This metric is reported only for display network.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.active_view_impressions

Field descriptionA measurement of how often your ad has become viewable on a Display Network site.
CategoryMETRIC
Data Type INT64
Type URLgoogle.protobuf.Int64Value
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.active_view_measurability

Field descriptionThe ratio of impressions that could be measured by Active View over the number of served impressions.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.active_view_measurable_cost_micros

Field descriptionThe cost of the impressions you received that were measurable by Active View.
CategoryMETRIC
Data Type INT64
Type URLgoogle.protobuf.Int64Value
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.active_view_measurable_impressions

Field descriptionThe number of times your ads are appearing on placements in positions where they can be seen.
CategoryMETRIC
Data Type INT64
Type URLgoogle.protobuf.Int64Value
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.active_view_viewability

Field descriptionThe percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions).
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.all_conversions

Field descriptionThe total number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.all_conversions_from_click_to_call

Field descriptionThe number of times people clicked the "Call" button to call a store during or after clicking an ad. This number doesn't include whether or not calls were connected, or the duration of any calls. This metric applies to feed items only.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.all_conversions_from_directions

Field descriptionThe number of times people clicked a "Get directions" button to navigate to a store after clicking an ad. This metric applies to feed items only.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.all_conversions_from_interactions_rate

Field descriptionAll conversions from interactions (as oppose to view through conversions) divided by the number of ad interactions.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.all_conversions_from_interactions_value_per_interaction

Field descriptionThe value of all conversions from interactions divided by the total number of interactions.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.all_conversions_from_menu

Field descriptionThe number of times people clicked a link to view a store's menu after clicking an ad. This metric applies to feed items only.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.all_conversions_from_order

Field descriptionThe number of times people placed an order at a store after clicking an ad. This metric applies to feed items only.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.all_conversions_from_other_engagement

Field descriptionThe number of other conversions (for example, posting a review or saving a location for a store) that occurred after people clicked an ad. This metric applies to feed items only.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.all_conversions_from_store_visit

Field descriptionEstimated number of times people visited a store after clicking an ad. This metric applies to feed items only.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.all_conversions_from_store_website

Field descriptionThe number of times that people were taken to a store's URL after clicking an ad. This metric applies to feed items only.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.all_conversions_value

Field descriptionThe total value of all conversions.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.all_conversions_value_per_cost

Field descriptionThe value of all conversions divided by the total cost of ad interactions (such as clicks for text ads or views for video ads).
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.average_cost

Field descriptionThe average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.average_cpc

Field descriptionThe total cost of all clicks divided by the total number of clicks received.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.average_cpe

Field descriptionThe 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.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.average_cpm

Field descriptionAverage cost-per-thousand impressions (CPM).
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.average_cpv

Field descriptionThe 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.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.average_frequency

Field descriptionAverage number of times a unique cookie was exposed to your ad over a given time period. Imported from Google Analytics.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.average_page_views

Field descriptionAverage number of pages viewed per session.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.average_position

Field descriptionYour ad's position relative to those of other advertisers.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.average_time_on_site

Field descriptionTotal duration of all sessions (in seconds) / number of sessions. Imported from Google Analytics.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.benchmark_average_max_cpc

Field descriptionAn indication of how other advertisers are bidding on similar products.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.benchmark_ctr

Field descriptionAn indication on how other advertisers' Shopping ads for similar products are performing based on how often people who see their ad click on it.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.bounce_rate

Field descriptionPercentage of clicks where the user only visited a single page on your site. Imported from Google Analytics.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.clicks

Field descriptionThe number of clicks.
CategoryMETRIC
Data Type INT64
Type URLgoogle.protobuf.Int64Value
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.combined_clicks

Field descriptionThe number of times your ad or your site's listing in the unpaid results was clicked. See the help page at https://support.google.com/google-ads/answer/3097241 for details.
CategoryMETRIC
Data Type INT64
Type URLgoogle.protobuf.Int64Value
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.combined_clicks_per_query

Field descriptionThe number of times your ad or your site's listing in the unpaid results was clicked (combined_clicks) divided by combined_queries. See the help page at https://support.google.com/google-ads/answer/3097241 for details.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.combined_queries

Field descriptionThe number of searches that returned pages from your site in the unpaid results or showed one of your text ads. See the help page at https://support.google.com/google-ads/answer/3097241 for details.
CategoryMETRIC
Data Type INT64
Type URLgoogle.protobuf.Int64Value
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.content_budget_lost_impression_share

Field descriptionThe estimated percent of times that your ad was eligible to show on the Display Network but didn't because your budget was too low. Note: Content budget lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.content_impression_share

Field descriptionThe impressions you've received on the Display Network divided by the estimated number of impressions you were eligible to receive. Note: Content impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.content_rank_lost_impression_share

Field descriptionThe estimated percentage of impressions on the Display Network that your ads didn't receive due to poor Ad Rank. Note: Content rank lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.conversion_last_conversion_date

Field descriptionThe date of the most recent conversion for this conversion action. The date is in the customer's time zone.
CategoryMETRIC
Data Type DATE
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.conversion_last_received_request_date_time

Field descriptionThe last date/time a conversion tag for this conversion action successfully fired and was seen by Google Ads. This firing event may not have been the result of an attributable conversion (e.g. because the tag was fired from a browser that did not previously click an ad from an appropriate advertiser). The date/time is in the customer's time zone.
CategoryMETRIC
Data Type DATE
Type URLgoogle.protobuf.StringValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.conversions

Field descriptionThe number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.conversions_from_interactions_rate

Field descriptionConversions 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.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.conversions_from_interactions_value_per_interaction

Field descriptionThe 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.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.conversions_value

Field descriptionThe total value of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.conversions_value_per_cost

Field descriptionThe 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.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.cost_micros

Field descriptionThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.
CategoryMETRIC
Data Type INT64
Type URLgoogle.protobuf.Int64Value
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.cost_per_all_conversions

Field descriptionThe cost of ad interactions divided by all conversions.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.cost_per_conversion

Field descriptionThe cost of ad interactions divided by conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.cost_per_current_model_attributed_conversion

Field descriptionThe 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.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.cross_device_conversions

Field descriptionConversions 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.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.ctr

Field descriptionThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.current_model_attributed_conversions

Field descriptionShows 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.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.current_model_attributed_conversions_from_interactions_rate

Field descriptionCurrent 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.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.current_model_attributed_conversions_from_interactions_value_per_interaction

Field descriptionThe 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.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.current_model_attributed_conversions_value

Field descriptionThe total value of current model attributed conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.current_model_attributed_conversions_value_per_cost

Field descriptionThe 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.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.engagement_rate

Field descriptionHow 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.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.engagements

Field descriptionThe number of engagements. An engagement occurs when a viewer expands your Lightbox ad. Also, in the future, other ad types may support engagement metrics.
CategoryMETRIC
Data Type INT64
Type URLgoogle.protobuf.Int64Value
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.gmail_forwards

Field descriptionThe number of times the ad was forwarded to someone else as a message.
CategoryMETRIC
Data Type INT64
Type URLgoogle.protobuf.Int64Value
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.gmail_saves

Field descriptionThe number of times someone has saved your Gmail ad to their inbox as a message.
CategoryMETRIC
Data Type INT64
Type URLgoogle.protobuf.Int64Value
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.gmail_secondary_clicks

Field descriptionThe number of clicks to the landing page on the expanded state of Gmail ads.
CategoryMETRIC
Data Type INT64
Type URLgoogle.protobuf.Int64Value
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.historical_creative_quality_score

Field descriptionThe creative historical quality score.
CategoryMETRIC
Data Type
Type URLgoogle.ads.googleads.v1.enums.QualityScoreBucketEnum.QualityScoreBucket
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.historical_landing_page_quality_score

Field descriptionThe quality of historical landing page experience.
CategoryMETRIC
Data Type
Type URLgoogle.ads.googleads.v1.enums.QualityScoreBucketEnum.QualityScoreBucket
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.historical_quality_score

Field descriptionThe historical quality score.
CategoryMETRIC
Data Type INT64
Type URLgoogle.protobuf.Int64Value
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.historical_search_predicted_ctr

Field descriptionThe historical search predicted click through rate (CTR).
CategoryMETRIC
Data Type
Type URLgoogle.ads.googleads.v1.enums.QualityScoreBucketEnum.QualityScoreBucket
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.hotel_average_lead_value_micros

Field descriptionAverage lead value of hotel.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.impression_reach

Field descriptionNumber of unique cookies that were exposed to your ad over a given time period.
CategoryMETRIC
Data Type INT64
Type URLgoogle.protobuf.Int64Value
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.impressions

Field descriptionCount of how often your ad has appeared on a search results page or website on the Google Network.
CategoryMETRIC
Data Type INT64
Type URLgoogle.protobuf.Int64Value
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.impressions_from_store_reach

Field descriptionThe number of times a store's location-based ad was shown. This metric applies to feed items only.
CategoryMETRIC
Data Type INT64
Type URLgoogle.protobuf.Int64Value
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

metrics.interaction_event_types

Field descriptionThe types of payable and free interactions.
CategoryMETRIC
Data Type
Type URLgoogle.ads.googleads.v1.enums.InteractionEventTypeEnum.InteractionEventType
FilterableTrue
SelectableTrue
SortableFalse
RepeatedTrue
Selectable With

metrics.interaction_rate

Field descriptionHow 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.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.interactions

Field descriptionThe 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.
CategoryMETRIC
Data Type INT64
Type URLgoogle.protobuf.Int64Value
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.invalid_click_rate

Field descriptionThe percentage of clicks filtered out of your total number of clicks (filtered + non-filtered clicks) during the reporting period.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.invalid_clicks

Field descriptionNumber of clicks Google considers illegitimate and doesn't charge you for.
CategoryMETRIC
Data Type INT64
Type URLgoogle.protobuf.Int64Value
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.mobile_friendly_clicks_percentage

Field descriptionThe percentage of mobile clicks that go to a mobile-friendly page.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.organic_clicks

Field descriptionThe number of times someone clicked your site's listing in the unpaid results for a particular query. See the help page at https://support.google.com/google-ads/answer/3097241 for details.
CategoryMETRIC
Data Type INT64
Type URLgoogle.protobuf.Int64Value
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.organic_clicks_per_query

Field descriptionThe number of times someone clicked your site's listing in the unpaid results (organic_clicks) divided by the total number of searches that returned pages from your site (organic_queries). See the help page at https://support.google.com/google-ads/answer/3097241 for details.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.organic_impressions

Field descriptionThe number of listings for your site in the unpaid search results. See the help page at https://support.google.com/google-ads/answer/3097241 for details.
CategoryMETRIC
Data Type INT64
Type URLgoogle.protobuf.Int64Value
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.organic_impressions_per_query

Field descriptionThe number of times a page from your site was listed in the unpaid search results (organic_impressions) divided by the number of searches returning your site's listing in the unpaid results (organic_queries). See the help page at https://support.google.com/google-ads/answer/3097241 for details.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.organic_queries

Field descriptionThe total number of searches that returned your site's listing in the unpaid results. See the help page at https://support.google.com/google-ads/answer/3097241 for details.
CategoryMETRIC
Data Type INT64
Type URLgoogle.protobuf.Int64Value
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.percent_new_visitors

Field descriptionPercentage of first-time sessions (from people who had never visited your site before). Imported from Google Analytics.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.phone_calls

Field descriptionNumber of offline phone calls.
CategoryMETRIC
Data Type INT64
Type URLgoogle.protobuf.Int64Value
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.phone_impressions

Field descriptionNumber of offline phone impressions.
CategoryMETRIC
Data Type INT64
Type URLgoogle.protobuf.Int64Value
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.phone_through_rate

Field descriptionNumber of phone calls received (phone_calls) divided by the number of times your phone number is shown (phone_impressions).
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.relative_ctr

Field descriptionYour clickthrough rate (Ctr) divided by the average clickthrough rate of all advertisers on the websites that show your ads. Measures how your ads perform on Display Network sites compared to other ads on the same sites.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.search_absolute_top_impression_share

Field descriptionThe percentage of the customer's Shopping or Search ad impressions that are shown in the most prominent Shopping position. See this Merchant Center article for details. Any value below 0.1 is reported as 0.0999.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.search_budget_lost_absolute_top_impression_share

Field descriptionThe number estimating how often your ad wasn't the very first ad above the organic search results due to a low budget. Note: Search budget lost absolute top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.search_budget_lost_impression_share

Field descriptionThe estimated percent of times that your ad was eligible to show on the Search Network but didn't because your budget was too low. Note: Search budget lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.search_budget_lost_top_impression_share

Field descriptionThe number estimating how often your ad didn't show anywhere above the organic search results due to a low budget. Note: Search budget lost top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.search_click_share

Field descriptionThe number of clicks you've received on the Search Network divided by the estimated number of clicks you were eligible to receive. Note: Search click share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.search_exact_match_impression_share

Field descriptionThe impressions you've received divided by the estimated number of impressions you were eligible to receive on the Search Network for search terms that matched your keywords exactly (or were close variants of your keyword), regardless of your keyword match types. Note: Search exact match impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.search_impression_share

Field descriptionThe impressions you've received on the Search Network divided by the estimated number of impressions you were eligible to receive. Note: Search impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.search_rank_lost_absolute_top_impression_share

Field descriptionThe number estimating how often your ad wasn't the very first ad above the organic search results due to poor Ad Rank. Note: Search rank lost absolute top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.search_rank_lost_impression_share

Field descriptionThe estimated percentage of impressions on the Search Network that your ads didn't receive due to poor Ad Rank. Note: Search rank lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.search_rank_lost_top_impression_share

Field descriptionThe number estimating how often your ad didn't show anywhere above the organic search results due to poor Ad Rank. Note: Search rank lost top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.search_top_impression_share

Field descriptionThe impressions you've received in the top location (anywhere above the organic search results) compared to the estimated number of impressions you were eligible to receive in the top location. Note: Search top impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.speed_score

Field descriptionA measure of how quickly your page loads after clicks on your mobile ads. The score is a range from 1 to 10, 10 being the fastest.
CategoryMETRIC
Data Type INT64
Type URLgoogle.protobuf.Int64Value
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.top_impression_percentage

Field descriptionThe percent of your ad impressions that are shown anywhere above the organic search results.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.valid_accelerated_mobile_pages_clicks_percentage

Field descriptionThe percentage of ad clicks to Accelerated Mobile Pages (AMP) landing pages that reach a valid AMP page.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.value_per_all_conversions

Field descriptionThe value of all conversions divided by the number of all conversions.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.value_per_conversion

Field descriptionThe value of conversions divided by the number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.value_per_current_model_attributed_conversion

Field descriptionThe 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.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.video_quartile_100_rate

Field descriptionPercentage of impressions where the viewer watched all of your video.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.video_quartile_25_rate

Field descriptionPercentage of impressions where the viewer watched 25% of your video.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.video_quartile_50_rate

Field descriptionPercentage of impressions where the viewer watched 50% of your video.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.video_quartile_75_rate

Field descriptionPercentage of impressions where the viewer watched 75% of your video.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.video_view_rate

Field descriptionThe number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads.
CategoryMETRIC
Data Type DOUBLE
Type URLgoogle.protobuf.DoubleValue
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.video_views

Field descriptionThe number of times your video ads were viewed.
CategoryMETRIC
Data Type INT64
Type URLgoogle.protobuf.Int64Value
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

metrics.view_through_conversions

Field descriptionThe 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 (e.g., clicking on) another ad.
CategoryMETRIC
Data Type INT64
Type URLgoogle.protobuf.Int64Value
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse
Selectable With

Send feedback about...

Google Ads API
Google Ads API
Need help? Visit our support page.