Datapipe
Campaign performance
A Google Ads report of campaign performance.
Coming soon
Google Ads for agencies and in-house teams
Paid media teams use Google Ads in Datapipe to see spend, clicks, impressions, and conversions by campaign once Google Ads approves the app.
What connects
The same Google sign-in, but the adwords scope is not on the first Allow screen. It is requested only when someone adds Google Ads. Access is granted per Cloud project. A developer token is not sent. Developer tokens were retired on 9 September 2026.
What you can report on
- Campaign (dimension). Campaign name, once the project is allowed to run reports. Until then the report stays on sample rows.
- Impressions (metric). Impressions from a campaign report. Not pulled live until the project has Ads access.
- Clicks (metric). Clicks from that report.
- Cost (metric). Cost in account currency. The API field is cost_micros.
What you set up
- Enable the Google Ads API on the Cloud project that owns the OAuth client.
- Add Google Ads from Connections. That asks for the adwords scope on a later consent, not the first one.
- Until the project can run reports, leave the sample report labeled Coming soon.
Limitations
Accounts can be listed before they can be pulled. Live campaign metrics stay off until Google grants the project access. No developer token header is sent. The huge field list on this page is the Google Ads catalog, not a live report.
Last reviewed 2026-10-29. Owner: Datapipe.
Connection
Coming soon
Coming soon. Google Ads access is granted per Cloud project. A developer token is not used. Sample numbers stay labeled.
Fields
Google Ads API metrics, segments, and attributes for customer, campaign, ad group, ad, keyword view, and geographic view. Other resources such as assets and billing are not included. Access is granted per Cloud project. A developer token is not used. Source: https://developers.google.com/google-ads/api/fields/v18/metrics. Read on 2026-10-27. 993 fields.
Synced today
- Date
segments.date - Campaign
campaign.name - Channel
campaign.channel - Impressions
metrics.impressions - Clicks
metrics.clicks - Cost
metrics.cost - Conversions
metrics.conversions - Conv. value
metrics.conversion_value
Advertising
| Name | API field | Description | Type | Group | Cross-channel |
|---|---|---|---|---|---|
| absolute top impression percentage | metrics.absolute_top_impression_percentage | Search absolute top impression share is the percentage of your Search ad impressions that are shown in the absolute top Search position. | metric · number | Advertising | |
| active view audibility invalid givt measurable impressions rate | metrics.active_view_audibility_invalid_givt_measurable_impressions_rate | The number of impressions for which Active View could measure audibility, but that were filtered out by traffic quality filters, divided by the total number of impressions measurable for audibility. Only includes GIVT (general invalid traffic) impressions. | metric · number | Advertising | |
| active view audibility invalid measurable impressions rate | metrics.active_view_audibility_invalid_measurable_impressions_rate | The number of impressions for which Active View could measure audibility, but that were filtered out by traffic quality filters, divided by the total number of impressions measurable for audibility. | metric · number | Advertising | |
| active view audibility measurable impressions | metrics.active_view_audibility_measurable_impressions | The number of impressions for which Active View could measure if the ad was audible. | metric · integer | Advertising | |
| active view audibility measurable impressions rate | metrics.active_view_audibility_measurable_impressions_rate | The number of impressions for which Active View could measure if the ad was audible, divided by the total number of impressions with Active View audio enabled. | metric · number | Advertising | |
| active view audible impressions | metrics.active_view_audible_impressions | The number of impressions that were audible (volume > 0%) at any point during the ad playback. | metric · integer | Advertising | |
| active view audible impressions rate | metrics.active_view_audible_impressions_rate | The number of impressions that were audible (volume > 0%) at any point during the ad playback, divided by the total number of impressions measurable for audibility. | metric · number | Advertising | |
| active view audible quartile p100 rate | metrics.active_view_audible_quartile_p100_rate | The number of impressions that were audible at the fourth quartile of the ad playback, divided by the total number of impressions measurable for audibility. | metric · number | Advertising | |
| active view audible quartile p25 rate | metrics.active_view_audible_quartile_p25_rate | The number of impressions that were audible at the first quartile of the ad playback, divided by the total number of impressions measurable for audibility. | metric · number | Advertising | |
| active view audible quartile p50 rate | metrics.active_view_audible_quartile_p50_rate | The number of impressions that were audible at the second quartile of the ad playback, divided by the total number of impressions measurable for audibility. | metric · number | Advertising | |
| active view audible quartile p75 rate | metrics.active_view_audible_quartile_p75_rate | The number of impressions that were audible at the third quartile of the ad playback, divided by the total number of impressions measurable for audibility. | metric · number | Advertising | |
| active view audible thirty seconds impressions | metrics.active_view_audible_thirty_seconds_impressions | The number of impressions that were audible for at least 30 seconds (cumulative). | metric · integer | Advertising | |
| active view audible thirty seconds impressions rate | metrics.active_view_audible_thirty_seconds_impressions_rate | The number of impressions that were audible for at least 30 seconds (cumulative), divided by the total number of impressions measurable for audibility. | metric · number | Advertising | |
| active view audible two seconds impressions | metrics.active_view_audible_two_seconds_impressions | The number of impressions that were audible for at least 2 seconds (cumulative). | metric · integer | Advertising | |
| active view audible two seconds impressions rate | metrics.active_view_audible_two_seconds_impressions_rate | The number of impressions that were audible for at least 2 seconds (cumulative), divided by the total number of impressions measurable for audibility. | metric · number | Advertising | |
| active view cpm | metrics.active_view_cpm | Average cost of viewable impressions (active_view_impressions). | metric · number | Advertising | |
| active view ctr | metrics.active_view_ctr | Active view measurable clicks divided by active view viewable impressions. This metric is reported only for the Display Network. | metric · number | Advertising | |
| active view impressions | metrics.active_view_impressions | A measurement of the number of times your ad has become viewable on a Display Network site. | metric · integer | Advertising | |
| active view measurability | metrics.active_view_measurability | The ratio of impressions that were eligible to be measured by Active View over the number of served impressions. | metric · number | Advertising | |
| active view measurable impressions | metrics.active_view_measurable_impressions | The number of times your ads are appearing on placements in positions where they can be seen. | metric · integer | Advertising | |
| active view viewability | metrics.active_view_viewability | The percentage of times when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions). | metric · number | Advertising | |
| auction insight search absolute top impression percentage | metrics.auction_insight_search_absolute_top_impression_percentage | This metric is part of the Auction Insights report, and tells the percentage of times the ads of another participant showed in the absolute top position (Position 1) on the search results page. This percentage is computed only over the auctions that you appeared in the page. This metric is not publicly available. | metric · number | Advertising | |
| auction insight search impression share | metrics.auction_insight_search_impression_share | This metric is part of the Auction Insights report, and tells the percentage of impressions that another participant obtained, over the total number of impressions that your ads were eligible for. Any value below 0.1 is reported as 0.0999. This metric is not publicly available. | metric · number | Advertising | |
| auction insight search top impression percentage | metrics.auction_insight_search_top_impression_percentage | This metric is part of the Auction Insights report, and tells the percentage of times the ads of another participant showed adjacent to the top organic search results. This percentage is computed only over the auctions that you appeared in the page. This metric is not publicly available. | metric · number | Advertising | |
| average cpc | metrics.average_cpc | The total cost of all clicks divided by the total number of clicks received. | metric · number | Advertising | |
| average cpm | metrics.average_cpm | Average cost-per-thousand impressions (CPM). | metric · number | Advertising | |
| average video watch time duration millis | metrics.average_video_watch_time_duration_millis | Average video watch time duration in milliseconds for video impressions that started playing. | metric · integer | Advertising | |
| benchmark average max cpc | metrics.benchmark_average_max_cpc | An indication of how other advertisers are bidding on similar products. | metric · number | Advertising | |
| benchmark ctr | metrics.benchmark_ctr | An indication on how other advertisers' Shopping ads for similar products are performing based on the frequency with which people who see their ad click on it. | metric · number | Advertising | |
| clicks · Synced today | metrics.clicks | The number of clicks. | metric · integer | Advertising | Clicks |
| clicks margin of error | metrics.clicks_margin_of_error | The margin of error when estimating the experiment's effect on clicks. Together with clicks_point_estimate, they describe a confidence interval with a prescribed confidence level for the difference being estimated. The quantity being estimated is (treatment / control - 1). This field specifies the radius of the confidence interval, which is centered at clicks_point_estimate. | metric · number | Advertising | |
| clicks p value | metrics.clicks_p_value | The p-value for the null hypothesis that the experiment has no effect on clicks. Ranges from 0 to 1. Say if the p-value is 0.03, that means the probability of observing the data, if the experiment has no effect on clicks, is 3%. | metric · number | Advertising | |
| clicks point estimate | metrics.clicks_point_estimate | The point estimate when estimating the experiment's effect on clicks. Together with clicks_margin_of_error, they describe a confidence interval with a prescribed confidence level for the difference being estimated. The quantity being estimated is (treatment / control - 1). This field specifies the point estimate, which is the center of the confidence interval: (clicks_point_estimate - clicks_margin_of_error, clicks_point_estimate + clicks_margin_of_error). | metric · number | Advertising | |
| combined clicks | metrics.combined_clicks | The number of times your ad or your site's listing in the unpaid results was clicked. See About measuring paid and organic search results. | metric · integer | Advertising | |
| control clicks | metrics.control_clicks | The number of clicks on the control arm of an experiment. The treatment clicks value can be selected by using clicks. | metric · integer | Advertising | |
| control impressions | metrics.control_impressions | The impressions metric on the control arm of the experiment. The treatment impressions value can be selected by using impressions. | metric · integer | Advertising | |
| coviewed impressions | metrics.coviewed_impressions | All co-viewed impressions represent the total number of people who saw your ad. This includes people who are signed into their Google Account, as well as other people who are watching the same ad on a connected TV. This metric is only available for the Campaign resource with adjusted_age_range and adjusted_gender segments. These segmentations are mandatory to get the all coviewed impressions. | metric · integer | Advertising | |
| ctr | metrics.ctr | The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). | metric · number | Advertising | |
| general invalid click rate | metrics.general_invalid_click_rate | The percentage of clicks that have been filtered out of your total number of clicks (filtered + non-filtered clicks) due to being general invalid clicks. These are clicks Google considers illegitimate that are detected through routine means of filtration (that is, known invalid data-center traffic, bots and spiders or other crawlers, irregular patterns, etc). You're not charged for them, and they don't affect your account statistics. See Filtering invalid traffic to ensure quality. | metric · number | Advertising | |
| general invalid clicks | metrics.general_invalid_clicks | Number of general invalid clicks. These are a subset of your invalid clicks that are detected through routine means of filtration (such as known invalid data-center traffic, bots and spiders or other crawlers, irregular patterns, etc.). You're not charged for them, and they don't affect your account statistics. See Filtering invalid traffic to ensure quality. | metric · integer | Advertising | |
| gmail secondary clicks | metrics.gmail_secondary_clicks | The number of clicks to the landing page on the expanded state of Gmail ads. | metric · integer | Advertising | |
| historical search predicted ctr | metrics.historical_search_predicted_ctr | The historical search predicted clickthrough rate (CTR). | metric · string | Advertising | |
| hotel eligible impressions | metrics.hotel_eligible_impressions | The number of impressions that hotel partners could have had given their feed performance. | metric · integer | Advertising | |
| impressions · Synced today | metrics.impressions | The number of times your ad has appeared on a search results page or website on the Google Network. | metric · integer | Advertising | Impressions |
| impressions from store reach | metrics.impressions_from_store_reach | The number of times a business's location-based ad was shown. This metric applies to feed items only. | metric · integer | Advertising | |
| impressions margin of error | metrics.impressions_margin_of_error | The margin of error when estimating the experiment's effect on impressions. Together with impressions_point_estimate, they describe a confidence interval with a prescribed confidence level for the difference being estimated. The quantity being estimated is (treatment / control - 1). This field specifies the radius of the confidence interval, which is centered at impressions_point_estimate. | metric · number | Advertising | |
| impressions p value | metrics.impressions_p_value | The p-value for the null hypothesis that the experiment has no effect on impressions. Ranges from 0 to 1. Say if the p-value is 0.03, that means the probability of observing the data, if the experiment has no effect on impressions, is 3%. | metric · number | Advertising | |
| impressions point estimate | metrics.impressions_point_estimate | The point estimate when estimating the experiment's effect on impressions. Together with impressions_margin_of_error, they describe a confidence interval with a prescribed confidence level for the difference being estimated. The quantity being estimated is (treatment / control - 1). This field specifies the point estimate, which is the center of the confidence interval: (impressions_point_estimate - impressions_margin_of_error, impressions_point_estimate + impressions_margin_of_error). | metric · number | Advertising | |
| invalid click rate | metrics.invalid_click_rate | The percentage of clicks filtered out of your total number of clicks (filtered + non-filtered clicks) during the reporting period. | metric · number | Advertising | |
| invalid clicks | metrics.invalid_clicks | Number of clicks Google considers illegitimate and doesn't charge you for. | metric · integer | Advertising | |
| message impressions | metrics.message_impressions | Number of Click To Message impressions that were message tracking eligible. | metric · integer | Advertising | |
| normalized incremental searches per impression | metrics.normalized_incremental_searches_per_impression | The estimated number of incremental search queries generated per ad impression. Measures the effectiveness of each ad exposure in driving search behavior. Only reported when lift is statistically positive. | metric · number | Advertising | |
| normalized incremental searches per impression p90 lower bound | metrics.normalized_incremental_searches_per_impression_p90_lower_bound | The lower bound of the 90% confidence interval for normalized incremental searches per impression. | metric · number | Advertising | |
| normalized incremental searches per impression p90 upper bound | metrics.normalized_incremental_searches_per_impression_p90_upper_bound | The upper bound of the 90% confidence interval for normalized incremental searches per impression. | metric · number | Advertising | |
| organic clicks | metrics.organic_clicks | The number of times someone clicked your site's listing in the unpaid results for a particular query. See About measuring paid and organic search results. | metric · integer | Advertising | |
| organic impressions | metrics.organic_impressions | The number of listings for your site in the unpaid search results. See About measuring paid and organic search results. | metric · integer | Advertising | |
| phone impressions | metrics.phone_impressions | Number of offline phone impressions. | metric · integer | Advertising | |
| primary impressions | metrics.primary_impressions | Primary impression is counted each time your ad is served. This metric is only available for the Campaign resource with adjusted_age_range and adjusted_gender segments. These segmentations are mandatory to get the primary impressions. | metric · integer | Advertising | |
| publisher organic clicks | metrics.publisher_organic_clicks | Clicks from properties for which the traffic the publisher has not paid for or acquired through incentivized activity | metric · integer | Advertising | |
| publisher unknown clicks | metrics.publisher_unknown_clicks | Clicks from traffic which is not identified as "Publisher Purchased" or "Publisher Organic" | metric · integer | Advertising | |
| relative ctr | metrics.relative_ctr | Your 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. | metric · number | Advertising | |
| search absolute top impression share | metrics.search_absolute_top_impression_share | The percentage of the customer's Shopping or Search ad impressions that are shown in the absolute top position (Position 1). See About top and absolute top metrics for details. Any value below 0.1 is reported as 0.0999. | metric · number | Advertising | |
| search click share | metrics.search_click_share | The 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. | metric · number | Advertising | |
| search exact match impression share | metrics.search_exact_match_impression_share | The 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. | metric · number | Advertising | |
| search impression share | metrics.search_impression_share | The 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. | metric · number | Advertising | |
| search lift impressions | metrics.search_lift_impressions | The total number of ad impressions served for this Search Lift measurement slice during the study flight. | metric · integer | Advertising | |
| search top impression share | metrics.search_top_impression_share | The impressions you've received among the top ads compared to the estimated number of impressions you were eligible to receive among the top ads. 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. Top ads are typically above the top organic results, although they may show below the top organic results on certain queries. | metric · number | Advertising | |
| top impression percentage | metrics.top_impression_percentage | The percentage of your ad impressions that are shown adjacent to the top organic search results. | metric · number | Advertising | |
| trueview average cpv | metrics.trueview_average_cpv | 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 TrueView views. | metric · number | Advertising | |
| vertical ads potential impressions | metrics.vertical_ads_potential_impressions | Potential impressions representing the total view-capped eligible impressions available across the query context. | metric · integer | Advertising | |
| video quartile p100 rate | metrics.video_quartile_p100_rate | Percentage of impressions where the viewer watched all of your video. | metric · number | Advertising | |
| video quartile p25 rate | metrics.video_quartile_p25_rate | Percentage of impressions where the viewer watched 25% of your video. | metric · number | Advertising | |
| video quartile p50 rate | metrics.video_quartile_p50_rate | Percentage of impressions where the viewer watched 50% of your video. | metric · number | Advertising | |
| video quartile p75 rate | metrics.video_quartile_p75_rate | Percentage of impressions where the viewer watched 75% of your video. | metric · number | Advertising | |
| video trueview view rate | metrics.video_trueview_view_rate | The number of TrueView views your video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads. | metric · number | Advertising | |
| video trueview view rate in stream | metrics.video_trueview_view_rate_in_stream | The number of TrueView views divided by number of impressions that can potentially lead to TrueView views for in-stream formats. | metric · number | Advertising | |
| video trueview view rate shorts | metrics.video_trueview_view_rate_shorts | The number of TrueView views divided by number of impressions that can potentially lead to TrueView views for Shorts ads. | metric · number | Advertising | |
| video trueview views | metrics.video_trueview_views | The number of TrueView views your video ads received. | metric · integer | Advertising | |
| video watch time duration millis | metrics.video_watch_time_duration_millis | Total watch time duration in milliseconds for video impressions that started playing. For a small percentage of impressions, we may not be able to measure the watch time accurately. In such cases, we adjust the total time to account for any unmeasured time by applying the average watch time of impressions that were measured. | metric · integer | Advertising | |
| ad using video | segments.ad_using_video | Indicates whether an ad is using a video asset. This segment is only available for PMax campaigns and will not return data when any other campaign type is selected. | dimension · boolean | Advertising | |
| click type | segments.click_type | Click type. | dimension · string | Advertising | |
| effective target cpc | ad_group.effective_target_cpc | Output only. The effective target CPC (cost-per-click). This field is read-only. | dimension · integer | Advertising | |
| step id | ad_group.video_ad_group_settings.video_ad_sequence.step_id | The ID of this sequence step from an existing campaign.video_campaign_settings.video_ad_sequence definition. Only one Ad Group can point to a given step_id. | dimension · integer | Advertising | |
| video brand safety suitability | customer.video_brand_safety_suitability | Brand Safety setting at the account level. Allows for selecting an inventory type to show your ads on content that is the right fit for your brand. See https://support.google.com/google-ads/answer/7515513. | dimension · string | Advertising | |
| brand lift integration partners | customer.video_customer.third_party_integration_partners.brand_lift_integration_partners | Allowed third party integration partners for Brand Lift verification. | dimension · string | Advertising | |
| brand safety integration partners | customer.video_customer.third_party_integration_partners.brand_safety_integration_partners | Allowed third party integration partners for brand safety verification. | dimension · string | Advertising | |
| reach integration partners | customer.video_customer.third_party_integration_partners.reach_integration_partners | Allowed third party integration partners for reach verification. | dimension · string | Advertising | |
| viewability integration partners | customer.video_customer.third_party_integration_partners.viewability_integration_partners | Allowed third party integration partners for YouTube viewability verification. | dimension · string | Advertising | |
| breadcrumb1 | ad_group_ad.ad.demand_gen_video_responsive_ad.breadcrumb1 | First part of text that appears in the ad with the displayed URL. | dimension · string | Advertising | |
| breadcrumb2 | ad_group_ad.ad.demand_gen_video_responsive_ad.breadcrumb2 | Second part of text that appears in the ad with the displayed URL. | dimension · string | Advertising | |
| business name | ad_group_ad.ad.demand_gen_video_responsive_ad.business_name | Required. The advertiser/brand name. | dimension · string | Advertising | |
| call to actions | ad_group_ad.ad.demand_gen_video_responsive_ad.call_to_actions | Assets of type CallToActionAsset used for the "Call To Action" button. | dimension · string | Advertising | |
| asset | ad_group_ad.ad.demand_gen_video_responsive_ad.call_to_actions.asset | The Asset resource name of this call to action asset. | dimension · string | Advertising | |
| companion banners | ad_group_ad.ad.demand_gen_video_responsive_ad.companion_banners | List of image assets used for the companion banner. Currently, only a single value for the companion banner asset is supported. | dimension · string | Advertising | |
| asset | ad_group_ad.ad.demand_gen_video_responsive_ad.companion_banners.asset | The Asset resource name of this image. | dimension · string | Advertising | |
| descriptions | ad_group_ad.ad.demand_gen_video_responsive_ad.descriptions | List of text assets used for the description. | dimension · string | Advertising | |
| headlines | ad_group_ad.ad.demand_gen_video_responsive_ad.headlines | List of text assets used for the short headline. | dimension · string | Advertising | |
| logo images | ad_group_ad.ad.demand_gen_video_responsive_ad.logo_images | 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%). | dimension · string | Advertising | |
| asset | ad_group_ad.ad.demand_gen_video_responsive_ad.logo_images.asset | The Asset resource name of this image. | dimension · string | Advertising | |
| long headlines | ad_group_ad.ad.demand_gen_video_responsive_ad.long_headlines | List of text assets used for the long headline. | dimension · string | Advertising | |
| preview pixel height | ad_group_ad.ad.image_ad.preview_pixel_height | Height in pixels of the preview size image. | dimension · integer | Advertising | |
| preview pixel width | ad_group_ad.ad.image_ad.preview_pixel_width | Width in pixels of the preview size image. | dimension · integer | Advertising | |
| enable autogen video | ad_group_ad.ad.responsive_display_ad.control_spec.enable_autogen_video | Whether the advertiser has opted into auto-gen video feature. | dimension · boolean | Advertising | |
| audio | ad_group_ad.ad.video_ad.audio | YouTube Audio ad format. | dimension · string | Advertising | |
| action button label | ad_group_ad.ad.video_ad.bumper.action_button_label | Label on the "Call To Action" button taking the user to the video ad's final URL. | dimension · string | Advertising | |
| action headline | ad_group_ad.ad.video_ad.bumper.action_headline | Additional text displayed with the CTA (call-to-action) button to give context and encourage clicking on the button. | dimension · string | Advertising | |
| asset | ad_group_ad.ad.video_ad.bumper.companion_banner.asset | The Asset resource name of this image. | dimension · string | Advertising | |
| action button label | ad_group_ad.ad.video_ad.in_stream.action_button_label | 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. | dimension · string | Advertising | |
| action headline | ad_group_ad.ad.video_ad.in_stream.action_headline | Additional text displayed with the CTA (call-to-action) button to give context and encourage clicking on the button. | dimension · string | Advertising | |
| asset | ad_group_ad.ad.video_ad.in_stream.companion_banner.asset | The Asset resource name of this image. | dimension · string | Advertising | |
| action button label | ad_group_ad.ad.video_ad.non_skippable.action_button_label | Label on the "Call To Action" button taking the user to the video ad's final URL. | dimension · string | Advertising | |
| action headline | ad_group_ad.ad.video_ad.non_skippable.action_headline | Additional text displayed with the "Call To Action" button to give context and encourage clicking on the button. | dimension · string | Advertising | |
| asset | ad_group_ad.ad.video_ad.non_skippable.companion_banner.asset | The Asset resource name of this image. | dimension · string | Advertising | |
| description | ad_group_ad.ad.video_ad.out_stream.description | The description line. | dimension · string | Advertising | |
| headline | ad_group_ad.ad.video_ad.out_stream.headline | The headline of the ad. | dimension · string | Advertising | |
| asset | ad_group_ad.ad.video_ad.video.asset | The Asset resource name of this video. | dimension · string | Advertising | |
| breadcrumb1 | ad_group_ad.ad.video_responsive_ad.breadcrumb1 | First part of text that appears in the ad with the displayed URL. | dimension · string | Advertising | |
| breadcrumb2 | ad_group_ad.ad.video_responsive_ad.breadcrumb2 | Second part of text that appears in the ad with the displayed URL. | dimension · string | Advertising | |
| business name | ad_group_ad.ad.video_responsive_ad.business_name | Required. Advertiser/brand name. Maximum display width is 25 characters. | dimension · string | Advertising | |
| call to actions | ad_group_ad.ad.video_responsive_ad.call_to_actions | 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. | dimension · string | Advertising | |
| companion banners | ad_group_ad.ad.video_responsive_ad.companion_banners | List of image assets used for the companion banner. Currently, only a single value for the companion banner asset is supported. | dimension · string | Advertising | |
| asset | ad_group_ad.ad.video_responsive_ad.companion_banners.asset | The Asset resource name of this image. | dimension · string | Advertising | |
| descriptions | ad_group_ad.ad.video_responsive_ad.descriptions | List of text assets used for the description. Currently, only a single value for the description is supported. | dimension · string | Advertising | |
| headlines | ad_group_ad.ad.video_responsive_ad.headlines | List of text assets used for the short headline. Currently, only a single value for the short headline is supported. | dimension · string | Advertising | |
| logo images | ad_group_ad.ad.video_responsive_ad.logo_images | Required. Logo image to be used in the ad. The minimum size is 128x128 and the aspect ratio must be 1:1(+-1%). | dimension · string | Advertising | |
| asset | ad_group_ad.ad.video_responsive_ad.logo_images.asset | The Asset resource name of this image. | dimension · string | Advertising | |
| long headlines | ad_group_ad.ad.video_responsive_ad.long_headlines | List of text assets used for the long headline. Currently, only a single value for the long headline is supported. | dimension · string | Advertising | |
| review status | ad_group_ad.policy_summary.review_status | Output only. Where in the review process this ad is. | dimension · string | Advertising |
Audience
| Name | API field | Description | Type | Group | Cross-channel |
|---|---|---|---|---|---|
| average impression frequency per user | metrics.average_impression_frequency_per_user | The average number of times a unique user saw your ad during the requested time period. This metric cannot be aggregated, and can only be requested for date ranges of 92 days or less. This metric is available for following campaign types - Display, Video, Discovery and App. | metric · number | Audience | |
| bounce rate | metrics.bounce_rate | Percentage of clicks where the user only visited a single page on your site. Imported from Google Analytics. | metric · number | Audience | |
| unique users | metrics.unique_users | The number of unique users who saw your ad during the requested time period. This metric cannot be aggregated, and can only be requested for date ranges of 92 days or less. This metric is available for following campaign types - Display, Video, Discovery and App. | metric · integer | Audience | |
| unique users five plus | metrics.unique_users_five_plus | This metric counts the unique individuals who were shown your video ad five or more times within the selected date range. This metric cannot be aggregated, and can only be requested for date ranges of 31 days or less. | metric · integer | Audience | |
| unique users four plus | metrics.unique_users_four_plus | This metric counts the unique individuals who were shown your video ad four or more times within the selected date range. This metric cannot be aggregated, and can only be requested for date ranges of 31 days or less. | metric · integer | Audience | |
| unique users ten plus | metrics.unique_users_ten_plus | This metric counts the unique individuals who were shown your video ad ten or more times within the selected date range. This metric cannot be aggregated, and can only be requested for date ranges of 31 days or less. | metric · integer | Audience | |
| unique users three plus | metrics.unique_users_three_plus | This metric counts the unique individuals who were shown your video ad three or more times within the selected date range. This metric cannot be aggregated, and can only be requested for date ranges of 31 days or less. | metric · integer | Audience | |
| unique users two plus | metrics.unique_users_two_plus | This metric counts the unique individuals who were shown your video ad two or more times within the selected date range. This metric cannot be aggregated, and can only be requested for date ranges of 31 days or less. | metric · integer | Audience | |
| sk ad network user type | segments.sk_ad_network_user_type | iOS Store Kit Ad Network user type. | dimension · string | Audience | |
| vertical ads listing user rating | segments.vertical_ads_listing_user_rating | Integer value specifying the user rating of the vertical ads listing as a number from 1 to 5, where 5 is the best. The value will always be within this range. | dimension · integer | Audience | |
| use audience grouped | ad_group.audience_setting.use_audience_grouped | Immutable. If true, this ad group uses an Audience resource for audience targeting. If false, this ad group may use audience segment criteria instead. | dimension · boolean | Audience |
Content
| Name | API field | Description | Type | Group | Cross-channel |
|---|---|---|---|---|---|
| average page views | metrics.average_page_views | Average number of pages viewed per session. | metric · number | Content | |
| content impression share | metrics.content_impression_share | The 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. | metric · number | Content | |
| historical landing page quality score | metrics.historical_landing_page_quality_score | The quality of historical landing page experience. | metric · string | Content | |
| optimization score url | metrics.optimization_score_url | URL for the optimization score page in the Google Ads web interface. This metric can be selected from customer or campaign, and can be segmented by segments.recommendation_type. For example, SELECT metrics.optimization_score_url, segments.recommendation_type FROM customer will return a URL for each unique (customer, recommendation_type) combination. | metric · string | Content | |
| search engine results page type | segments.search_engine_results_page_type | Type of the search engine results page. | dimension · string | Content | |
| webpage | segments.webpage | Resource name of the ad group criterion that represents webpage criterion. | dimension · string | Content | |
| final url suffix | ad_group.final_url_suffix | URL template for appending params to Final URL. | dimension · string | Content | |
| tracking url template | ad_group.tracking_url_template | The URL template for constructing a tracking URL. | dimension · string | Content | |
| url custom parameters | ad_group.url_custom_parameters | The list of mappings used to substitute custom parameter tags in a tracking_url_template, final_urls, or mobile_final_urls. | dimension · string | Content | |
| final url suffix | customer.final_url_suffix | The URL template for appending params to the final URL. Only mutable in an update operation. | dimension · string | Content | |
| tracking url template | customer.tracking_url_template | The URL template for constructing a tracking URL out of parameters. Only mutable in an update operation. | dimension · string | Content | |
| display url | ad_group_ad.ad.display_url | The URL that appears in the ad description for some ad formats. | dimension · string | Content | |
| path1 | ad_group_ad.ad.expanded_text_ad.path1 | The text that can appear alongside the ad's displayed URL. | dimension · string | Content | |
| path2 | ad_group_ad.ad.expanded_text_ad.path2 | Additional text that can appear alongside the ad's displayed URL. | dimension · string | Content | |
| final app urls | ad_group_ad.ad.final_app_urls | A list of final app URLs that will be used on mobile if the user has the specific app installed. | dimension · string | Content | |
| final url suffix | ad_group_ad.ad.final_url_suffix | The suffix to use when constructing a final URL. | dimension · string | Content | |
| final urls | ad_group_ad.ad.final_urls | The list of possible final URLs after all cross-domain redirects for the ad. | dimension · string | Content | |
| image url | ad_group_ad.ad.image_ad.image_url | URL of the full size image. | dimension · string | Content | |
| preview image url | ad_group_ad.ad.image_ad.preview_image_url | URL of the preview size image. | dimension · string | Content | |
| path1 | ad_group_ad.ad.local_ad.path1 | First part of optional text that can be appended to the URL in the ad. | dimension · string | Content | |
| path2 | ad_group_ad.ad.local_ad.path2 | 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. | dimension · string | Content | |
| path1 | ad_group_ad.ad.responsive_search_ad.path1 | First part of text that can be appended to the URL in the ad. | dimension · string | Content | |
| path2 | ad_group_ad.ad.responsive_search_ad.path2 | 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. | dimension · string | Content | |
| tracking url template | ad_group_ad.ad.tracking_url_template | The URL template for constructing a tracking URL. | dimension · string | Content | |
| url collections | ad_group_ad.ad.url_collections | Additional URLs for the ad that are tagged with a unique identifier that can be referenced from other fields in the ad. | dimension · string | Content | |
| url custom parameters | ad_group_ad.ad.url_custom_parameters | 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. | dimension · string | Content |
Conversions
| Name | API field | Description | Type | Group | Cross-channel |
|---|---|---|---|---|---|
| all conversions | metrics.all_conversions | The total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric. | metric · number | Conversions | |
| all conversions from click to call | metrics.all_conversions_from_click_to_call | The number of times people clicked the "Call" button to call a business 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. | metric · number | Conversions | |
| all conversions from directions | metrics.all_conversions_from_directions | The number of times people clicked a "Get directions" button to navigate to a business after clicking an ad. This metric applies to feed items only. | metric · number | Conversions | |
| all conversions from interactions rate | metrics.all_conversions_from_interactions_rate | All conversions from interactions (as oppose to view through conversions) divided by the number of ad interactions. | metric · number | Conversions | |
| all conversions from interactions value per interaction | metrics.all_conversions_from_interactions_value_per_interaction | The value of all conversions from interactions divided by the total number of interactions. | metric · number | Conversions | |
| all conversions from menu | metrics.all_conversions_from_menu | The number of times people clicked a link to view a business's menu after clicking an ad. This metric applies to feed items only. | metric · number | Conversions | |
| all conversions from other engagement | metrics.all_conversions_from_other_engagement | The number of other conversions (for example, posting a review or saving a location for a business) that occurred after people clicked an ad. This metric applies to feed items only. | metric · number | Conversions | |
| all conversions from store visit | metrics.all_conversions_from_store_visit | Estimated number of times people visited a business after clicking an ad. This metric applies to feed items only. | metric · number | Conversions | |
| all conversions from store website | metrics.all_conversions_from_store_website | The number of times people were taken to a business's URL after clicking an ad. This metric applies to feed items only. | metric · number | Conversions | |
| all conversions value | metrics.all_conversions_value | The value of all conversions. | metric · number | Conversions | |
| all lead units sold | metrics.all_lead_units_sold | All lead units sold is the total number of products sold as a result of advertising the same product. Includes the amount shown in the lead_units_sold metric, plus lead units sold from all your conversion actions, even if your campaigns are not actively optimizing towards them. It's calculated using product info from cart data to give more detail than conversion value alone. | metric · number | Conversions | |
| biddable app install conversions | metrics.biddable_app_install_conversions | Number of app installs. | metric · number | Conversions | |
| control conversion value | metrics.control_conversion_value | The conversion value metric on the control arm of the experiment. The treatment conversion value can be selected by using conversions_value. | metric · number | Conversions | |
| control conversions | metrics.control_conversions | The conversions metric on the control arm of the experiment. The treatment conversions value can be selected by using conversions. | metric · number | Conversions | |
| conversion lift baseline conversion value | metrics.conversion_lift_baseline_conversion_value | Represents the baseline conversion value from users not exposed to the ads. | metric · number | Conversions | |
| conversion lift baseline conversions | metrics.conversion_lift_baseline_conversions | Represents the number of conversions that would have occurred naturally without ad exposure, based on the behavior of the control group. Often referred to as "Control" conversions. | metric · number | Conversions | |
| conversion value change point estimate | metrics.conversion_value_change_point_estimate | The point estimate when estimating the experiment's effect on conversion value change. Together with conversion_value_margin_of_error, they describe a confidence interval with a prescribed confidence level for the difference being estimated. The quantity being estimated is (treatment / control - 1). This field specifies the point estimate, which is the center of the confidence interval: (conversion_value_change_point_estimate - conversion_value_margin_of_error, conversion_value_change_point_estimate + conversion_value_margin_of_error). | metric · number | Conversions | |
| conversion value margin of error | metrics.conversion_value_margin_of_error | The margin of error when estimating the experiment's effect on conversion value. Together with conversion_value_change_point_estimate, they describe a confidence interval with a prescribed confidence level for the difference being estimated. The quantity being estimated is (treatment / control - 1). This field specifies the radius of the confidence interval, which is centered at conversion_value_change_point_estimate. | metric · number | Conversions | |
| conversion value p value | metrics.conversion_value_p_value | The p-value for the null hypothesis that the experiment has no effect on conversion value. Ranges from 0 to 1. Say if the p-value is 0.03, that means the probability of observing the data, if the experiment has no effect on conversion value, is 3%. | metric · number | Conversions | |
| conversions · Synced today | metrics.conversions | 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. | metric · number | Conversions | Conversions |
| conversions absolute change margin of error | metrics.conversions_absolute_change_margin_of_error | The margin of error when estimating the experiment's effect on conversions absolute change. Together with conversions_absolute_change_point_estimate, they describe a confidence interval with a prescribed confidence level for the difference being estimated. The quantity being estimated is (treatment - control). This field specifies the radius of the confidence interval, which is centered at conversions_absolute_change_point_estimate. | metric · number | Conversions | |
| conversions absolute change p value | metrics.conversions_absolute_change_p_value | The p-value for the null hypothesis that the experiment has no effect on conversions absolute change. Ranges from 0 to 1. Say if the p-value is 0.03, that means the probability of observing the data, if the experiment has no effect on conversions absolute change, is 3%. | metric · number | Conversions | |
| conversions absolute change point estimate | metrics.conversions_absolute_change_point_estimate | The point estimate when estimating the experiment's effect on conversions absolute change. Together with conversions_absolute_change_margin_of_error, they describe a confidence interval with a prescribed confidence level for the difference being estimated. The quantity being estimated is (treatment - control). This field specifies the point estimate, which is the center of the confidence interval: (conversions_absolute_change_point_estimate - conversions_absolute_change_margin_of_error, conversions_absolute_change_point_estimate + conversions_absolute_change_margin_of_error). | metric · number | Conversions | |
| conversions from interactions rate | metrics.conversions_from_interactions_rate | 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. | metric · number | Conversions | |
| conversions from interactions value per interaction | metrics.conversions_from_interactions_value_per_interaction | 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. | metric · number | Conversions | |
| conversions value | metrics.conversions_value | 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. | metric · number | Conversions | Revenue |
| current model attributed conversions | metrics.current_model_attributed_conversions | 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. | metric · number | Conversions | |
| current model attributed conversions from interactions rate | metrics.current_model_attributed_conversions_from_interactions_rate | 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. | metric · number | Conversions | |
| current model attributed conversions from interactions value per interaction | metrics.current_model_attributed_conversions_from_interactions_value_per_interaction | 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. | metric · number | Conversions | |
| current model attributed conversions value | metrics.current_model_attributed_conversions_value | 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. | metric · number | Conversions | |
| incremental conversion value | metrics.incremental_conversion_value | The estimated additional conversion value the ads generated. Measures the incremental revenue or value from your campaigns. | metric · number | Conversions | |
| incremental conversion value p90 lower bound | metrics.incremental_conversion_value_p90_lower_bound | The lower bound of the 90% confidence interval for incremental_conversion_value. Shows the minimum amount of extra revenue ($) you can be 90% certain was generated by the campaign. | metric · number | Conversions | |
| incremental conversion value p90 upper bound | metrics.incremental_conversion_value_p90_upper_bound | The upper bound of the 90% confidence interval for incremental_conversion_value. The highest amount of extra revenue ($) likely generated by the campaign. | metric · number | Conversions | |
| incremental conversion value p value | metrics.incremental_conversion_value_p_value | The conversions value p-value provides a measure of the statistical significance for the detected lift in conversions value. It calculates the likelihood that your incremental conversion value was driven by ad performance rather than being a merely random occurrence. | metric · number | Conversions | |
| incremental conversion value winner score | metrics.incremental_conversion_value_winner_score | The probability that this experiment arm is the winner for incremental conversion value. This value is between 0.0 and 1.0. | metric · number | Conversions | |
| incremental conversions | metrics.incremental_conversions | The estimated number of additional conversions directly attributable to the ad campaign. | metric · number | Conversions | |
| incremental conversions p90 lower bound | metrics.incremental_conversions_p90_lower_bound | The lower bound of the 90% confidence interval for incremental_conversions. The "conservative" estimate of your success. It is the minimum number of additional sales you can be 90% sure were caused by your ads. | metric · number | Conversions | |
| incremental conversions p90 upper bound | metrics.incremental_conversions_p90_upper_bound | The upper bound of the 90% confidence interval for incremental_conversions. The "optimistic" estimate of your success. It is the maximum number of additional sales likely driven by your ads. | metric · number | Conversions | |
| incremental conversions p value | metrics.incremental_conversions_p_value | The conversions p-value provides a measure of the statistical significance for the detected lift in conversions. It calculates the likelihood that your incremental conversions were driven by ad performance rather than being a merely random occurrence. | metric · number | Conversions | |
| incremental conversions winner score | metrics.incremental_conversions_winner_score | The probability that this experiment arm is the winner for incremental conversions. This value is between 0.0 and 1.0. | metric · number | Conversions | |
| lead units sold | metrics.lead_units_sold | 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. | metric · number | Conversions | |
| original conversion value | metrics.original_conversion_value | The original conversion value from biddable conversions. This is the unadjusted value of conversions before any value rule adjustments, such as conversion value rules or lifecycle goals adjustments are applied. | metric · number | Conversions | |
| relative conversion lift | metrics.relative_conversion_lift | The percentage increase in conversions in the exposed group compared to the control group. | metric · number | Conversions | |
| relative conversion lift p90 lower bound | metrics.relative_conversion_lift_p90_lower_bound | The lower bound of the 90% confidence interval for relative_conversion_lift. The minimum percentage increase you can be 90% sure occurred. | metric · number | Conversions | |
| relative conversion lift p90 upper bound | metrics.relative_conversion_lift_p90_upper_bound | The upper bound of the 90% confidence interval for relative_conversion_lift. The maximum percentage increase you can be 90% sure occurred. | metric · number | Conversions | |
| relative conversion value lift | metrics.relative_conversion_value_lift | The percentage increase in conversion value in the exposed group compared to the control group. | metric · number | Conversions | |
| relative conversion value lift p90 lower bound | metrics.relative_conversion_value_lift_p90_lower_bound | The lower bound of the 90% confidence interval for relative_conversion_value_lift. The lowest likely percentage of incremental revenue the ads generated. | metric · number | Conversions | |
| relative conversion value lift p90 upper bound | metrics.relative_conversion_value_lift_p90_upper_bound | The upper bound of the 90% confidence interval for relative_conversion_value_lift. The highest likely percentage of incremental revenue the ads generated. | metric · number | Conversions | |
| sk ad network total conversions | metrics.sk_ad_network_total_conversions | The total number of iOS Store Kit Ad Network conversions. | metric · integer | Conversions | |
| store visits last click model attributed conversions | metrics.store_visits_last_click_model_attributed_conversions | The amount of business visits attributed by the last click model. | metric · number | Conversions | |
| value per all conversions | metrics.value_per_all_conversions | The value of all conversions divided by the number of all conversions. | metric · number | Conversions | |
| value per conversion | metrics.value_per_conversion | The value of conversions divided by the number of conversions. This only includes conversion actions for which the include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. | metric · number | Conversions | |
| value per current model attributed conversion | metrics.value_per_current_model_attributed_conversion | The value of current model attributed conversions divided by the number of the conversions. This only includes conversion actions for which the include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. | metric · number | Conversions | |
| view through conversions | metrics.view_through_conversions | 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. | metric · integer | Conversions | |
| conversion action | segments.conversion_action | Resource name of the conversion action. | dimension · string | Conversions | |
| conversion action category | segments.conversion_action_category | Conversion action category. | dimension · string | Conversions | |
| conversion action name | segments.conversion_action_name | Conversion action name. | dimension · string | Conversions | |
| conversion adjustment | segments.conversion_adjustment | 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. | dimension · boolean | Conversions | |
| conversion attribution event type | segments.conversion_attribution_event_type | Conversion attribution event type. | dimension · string | Conversions | |
| conversion lag bucket | segments.conversion_lag_bucket | An enum value representing the number of days between the impression and the conversion. | dimension · string | Conversions | |
| conversion lift conversion category | segments.conversion_lift_conversion_category | Conversion Category for Conversion Lift. | dimension · string | Conversions | |
| conversion lift included conversion action types | segments.conversion_lift_included_conversion_action_types | The specific conversion types that were included in the Conversion Lift measurement for this reporting period. | dimension · string | Conversions | |
| conversion or adjustment lag bucket | segments.conversion_or_adjustment_lag_bucket | An enum value representing the number of days between the impression and the conversion or between the impression and adjustments to the conversion. | dimension · string | Conversions | |
| conversion value rule primary dimension | segments.conversion_value_rule_primary_dimension | Primary dimension of applied conversion value rules. NO_RULE_APPLIED shows the total recorded value of conversions that do not have a value rule applied. ORIGINAL shows the original value of conversions to which a value rule has been applied. GEO_LOCATION, DEVICE, AUDIENCE, ITINERARY show the net adjustment after value rules were applied. | dimension · string | Conversions | |
| sk ad network coarse conversion value | segments.sk_ad_network_coarse_conversion_value | iOS Store Kit Ad Network coarse conversion value. | dimension · string | Conversions | |
| sk ad network fine conversion value | segments.sk_ad_network_fine_conversion_value | iOS Store Kit Ad Network conversion value. Null value means this segment is not applicable, for example, non-iOS campaign. | dimension · integer | Conversions | |
| sk ad network redistributed fine conversion value | segments.sk_ad_network_redistributed_fine_conversion_value | iOS Store Kit Ad Network redistributed fine conversion value. Google uses modeling on observed conversion values(obtained from Apple) to calculate conversions from SKAN postbacks where NULLs are returned. This column represents the sum of the modeled conversion values and the observed conversion values. See https://support.google.com/google-ads/answer/14892597 to lean more. | dimension · integer | Conversions | |
| call conversion action | customer.call_reporting_setting.call_conversion_action | Customer-level call conversion action to attribute a call conversion to. If not set a default conversion action is used. Only in effect when call_conversion_reporting_enabled is set to true. | dimension · string | Conversions | |
| call conversion reporting enabled | customer.call_reporting_setting.call_conversion_reporting_enabled | Whether to enable call conversion reporting. | dimension · boolean | Conversions | |
| accepted customer data terms | customer.conversion_tracking_setting.accepted_customer_data_terms | Output only. Whether the customer has accepted customer data terms. If using cross-account conversion tracking, this value is inherited from the manager. This field is read-only. For more information, see https://support.google.com/adspolicy/answer/7475709. | dimension · boolean | Conversions | |
| conversion tracking id | customer.conversion_tracking_setting.conversion_tracking_id | Output only. The conversion tracking id used for this account. This id doesn't indicate whether the customer uses conversion tracking (conversion_tracking_status does). This field is read-only. | dimension · integer | Conversions | |
| conversion tracking status | customer.conversion_tracking_setting.conversion_tracking_status | Output only. Conversion tracking status. It indicates whether the customer is using conversion tracking, and who is the conversion tracking owner of this customer. If this customer is using cross-account conversion tracking, the value returned will differ based on the login-customer-id of the request. | dimension · string | Conversions | |
| effective enablement setting | customer.conversion_tracking_setting.effective_enablement_setting | Output only. The effective account-level enhanced conversions setting for the customer. If using cross-account conversion tracking, this value is inherited from the manager. This field is read-only. | dimension · string | Conversions | |
| enablement setting | customer.conversion_tracking_setting.enablement_setting | Output only. Account-level setting indicating whether enhanced conversions is enabled for the customer. This field is read-only. | dimension · string | Conversions | |
| google ads conversion customer | customer.conversion_tracking_setting.google_ads_conversion_customer | The resource name of the customer where conversions are created and managed. This field is read-only. | dimension · string | Conversions | |
| accepted lead form terms | customer.customer_agreement_setting.accepted_lead_form_terms | Output only. Whether the customer has accepted lead form term of service. | dimension · boolean | Conversions | |
| pay per conversion eligibility failure reasons | customer.pay_per_conversion_eligibility_failure_reasons | Output only. Reasons why the customer is not eligible to use PaymentMode.CONVERSIONS. If the list is empty, the customer is eligible. This field is read-only. | dimension · string | Conversions | |
| conversion attribution integration partners | customer.video_customer.third_party_integration_partners.conversion_attribution_integration_partners | Allowed third party integration partners for YouTube conversion attribution verification. | dimension · string | Conversions |
Dimensions
| Name | API field | Description | Type | Group | Cross-channel |
|---|---|---|---|---|---|
| activity account id | segments.activity_account_id | Activity account ID. | dimension · integer | Dimensions | |
| activity rating | segments.activity_rating | Activity rating. | dimension · integer | Dimensions | |
| activity state | segments.activity_state | The state where the travel activity is available. | dimension · string | Dimensions | |
| ad destination type | segments.ad_destination_type | Ad Destination type. | dimension · string | Dimensions | |
| ad format type | segments.ad_format_type | Ad Format type. | dimension · string | Dimensions | |
| ad group | segments.ad_group | Resource name of the ad group. | dimension · string | Dimensions | |
| ad network type | segments.ad_network_type | Ad network type. | dimension · string | Dimensions | |
| ad sub format type | segments.ad_sub_format_type | Ad sub format type. Segments YouTube non-skippable instream ads by duration. Has to always be selected together with ad_format_type. | dimension · string | Dimensions | |
| ad sub network type | segments.ad_sub_network_type | Ad sub network type. Currently only available for ads running as part of DemandGen campaigns on YouTube and has to always be selected together with ad_network_type. | dimension · string | Dimensions | |
| adjusted age range | segments.adjusted_age_range | Adjusted age range. This is the age range of the user after applying modeling to get more accurate age and gender information. Currently, both adjusted_age_range and adjusted_gender need to be selected together to get valid reach stats. These segmentations are only available for allowlisted customers. | dimension · string | Dimensions | |
| adjusted gender | segments.adjusted_gender | Adjusted gender. This is the gender of the user after applying modeling to get more accurate age and gender information. Currently, both adjusted_age_range and adjusted_gender need to be selected together to get valid reach stats. These segmentations are only available for allowlisted customers. | dimension · string | Dimensions | |
| advance booking window | segments.advance_booking_window | Advance booking window for the itinerary in days. | dimension · integer | Dimensions | |
| age range | segments.age_range | Age range | dimension · string | Dimensions | |
| asset group | segments.asset_group | Resource name of the asset group. | dimension · string | Dimensions | |
| asset | segments.asset_interaction_target.asset | The asset resource name. | dimension · string | Dimensions | |
| interaction on this asset | segments.asset_interaction_target.interaction_on_this_asset | Only used with CustomerAsset, CampaignAsset and AdGroupAsset metrics. Indicates whether the interaction metrics occurred on the asset itself or a different asset or ad unit. | dimension · boolean | Dimensions | |
| auction insight domain | segments.auction_insight_domain | Domain (visible URL) of a participant in the Auction Insights report. | dimension · string | Dimensions | |
| brand lift measurement type | segments.brand_lift_measurement_type | The brand lift measurement type. | dimension · string | Dimensions | |
| experiment arm | segments.experiment_arm | Experiment arm. | dimension · string | Dimensions | |
| external activity id | segments.external_activity_id | Advertiser supplied activity ID. | dimension · string | Dimensions | |
| gender | segments.gender | Gender | dimension · string | Dimensions | |
| hotel center id | segments.hotel_center_id | Hotel center ID. | dimension · integer | Dimensions | |
| hotel class | segments.hotel_class | Hotel class. | dimension · string | Dimensions | |
| hotel length of stay | segments.hotel_length_of_stay | Hotel length of stay. | dimension · string | Dimensions | |
| hotel rate rule id | segments.hotel_rate_rule_id | Hotel rate rule ID. | dimension · string | Dimensions | |
| hotel rate type | segments.hotel_rate_type | Hotel rate type. | dimension · string | Dimensions | |
| hotel state | segments.hotel_state | Hotel state. | dimension · string | Dimensions | |
| interaction on this extension | segments.interaction_on_this_extension | Only used with feed item metrics. Indicates whether the interaction metrics occurred on the feed item itself or a different extension or ad unit. | dimension · boolean | Dimensions | |
| length of booking | segments.length_of_booking | Length of booking for the itinerary in days. | dimension · integer | Dimensions | |
| loyalty membership | segments.loyalty_membership | The user loyalty membership tier, based on the user belonging to a loyalty program. | dimension · string | Dimensions | |
| match type | segments.match_type | The match type of the keyword that triggered the ad. This segment is for use with keyword_view. For other resources, use search_term_match_type. While match_type is filtered to Broad, Exact, Phrase and Ai Max, search_term_match_type includes variants like Near Exact, Near Phrase. | dimension · string | Dimensions | |
| new versus returning customers | segments.new_versus_returning_customers | 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. | dimension · string | Dimensions | |
| partner hotel id | segments.partner_hotel_id | Partner hotel ID. | dimension · string | Dimensions | |
| quarter | segments.quarter | 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. | dimension · date | Dimensions | |
| recommendation type | segments.recommendation_type | Recommendation type. | dimension · string | Dimensions | |
| search property | segments.search_property | The Search Property where the search happened. | dimension · string | Dimensions | |
| search subcategory | segments.search_subcategory | A search term subcategory. An empty string denotes the catch-all subcategory for search terms that didn't fit into another subcategory. | dimension · string | Dimensions | |
| search term | segments.search_term | A search term. | dimension · string | Dimensions | |
| search term match type | segments.search_term_match_type | Match type of the keyword that triggered the ad. This segment is for use with keyword_view. For other resources, use match_type. While match_type is filtered to Broad, Exact, Phrase and Ai Max, search_term_match_type includes variants like Near Exact and Near Phrase. | dimension · string | Dimensions | |
| search term targeting status | segments.search_term_targeting_status | Indicates whether the search term is currently one of your targeted or excluded keywords. | dimension · string | Dimensions | |
| sk ad network ad event type | segments.sk_ad_network_ad_event_type | iOS Store Kit Ad Network ad event type. | dimension · string | Dimensions | |
| sk ad network attribution credit | segments.sk_ad_network_attribution_credit | iOS Store Kit Ad Network attribution credit | dimension · string | Dimensions | |
| sk ad network version | segments.sk_ad_network_version | The version of the SKAdNetwork API used. | dimension · string | Dimensions | |
| slot | segments.slot | Position of the ad. | dimension · string | Dimensions | |
| vertical ads event participant display names | segments.vertical_ads_event_participant_display_names | The display names of participants in an event listing, like performers, speakers, or teams. | dimension · string | Dimensions | |
| vertical ads hotel class | segments.vertical_ads_hotel_class | The class of the hotel. Generally in the range of 1 to 5 stars, but fully customizable in the hotel feed. | dimension · integer | Dimensions | |
| vertical ads listing | segments.vertical_ads_listing | The listing associated with a listing impression, click or conversion. | dimension · string | Dimensions | |
| vertical ads listing brand | segments.vertical_ads_listing_brand | The brand associated with a specific listing within a Vertical Ads context, for example, the brand of a car rental, a vacation home, or an event. | dimension · string | Dimensions | |
| vertical ads listing venue | segments.vertical_ads_listing_venue | The name of the venue for the vertical ads listing, for example, the venue for a concert event. | dimension · string | Dimensions | |
| vertical ads partner account | segments.vertical_ads_partner_account | A specific partner account within a Partner Center (for example, Hotel Center) that supplies inventory feed data for Vertical Ads. | dimension · integer | Dimensions | |
| vertical ads rate rule id | segments.vertical_ads_rate_rule_id | String identifier corresponding to private or conditional rate rules applied to the bid/impression. | dimension · string | Dimensions | |
| vertical ads rate type | segments.vertical_ads_rate_type | Categorization of the public, private, or conditional rate type. | dimension · string | Dimensions | |
| vertical ads vertical | segments.vertical_ads_vertical | Type of vertical ad, such as Vacation Rentals, Car Rentals, or Events, used to categorize and segment data in the context of Vertical Ads. | dimension · string | Dimensions | |
| ad rotation mode | ad_group.ad_rotation_mode | The ad rotation mode of the ad group. | dimension · string | Dimensions | |
| disable search term matching | ad_group.ai_max_ad_group_setting.disable_search_term_matching | Disable search term matching for this adgroup when AI Max is enabled. Search term matching uses broad match, asset-based, and landing page-based technology to improve reach. | dimension · boolean | Dimensions | |
| base ad group | ad_group.base_ad_group | Output only. For draft or experiment ad groups, this field is the resource name of the base ad group from which this ad group was created. If a draft or experiment ad group does not have a base ad group, then this field is null. For base ad groups, this field equals the ad group resource name. This field is read-only. | dimension · string | Dimensions | |
| display custom bid dimension | ad_group.display_custom_bid_dimension | Lets advertisers specify a targeting dimension on which to place absolute bids. This is only applicable for campaigns that target only the display network and not search. | dimension · string | Dimensions | |
| effective target roas | ad_group.effective_target_roas | Output only. The effective target ROAS (return-on-ad-spend). This field is read-only. | dimension · number | Dimensions | |
| exclude demographic expansion | ad_group.exclude_demographic_expansion | When this value is true, demographics will be excluded from the types of targeting which are expanded when optimized_targeting_enabled is true. When optimized_targeting_enabled is false, this field is ignored. Default is false. | dimension · boolean | Dimensions | |
| excluded parent asset field types | ad_group.excluded_parent_asset_field_types | The asset field types that should be excluded from this ad group. Asset links with these field types will not be inherited by this ad group from the upper levels. | dimension · string | Dimensions | |
| excluded parent asset set types | ad_group.excluded_parent_asset_set_types | The asset set types that should be excluded from this ad group. Asset set links with these types will not be inherited by this ad group from the upper levels. Location group types (GMB_DYNAMIC_LOCATION_GROUP, CHAIN_DYNAMIC_LOCATION_GROUP, and STATIC_LOCATION_GROUP) are child types of LOCATION_SYNC. Therefore, if LOCATION_SYNC is set for this field, all location group asset sets are not allowed to be linked to this ad group, and all Location Extension (LE) and Affiliate Location Extensions (ALE) will not be served under this ad group. Only LOCATION_SYNC is currently supported. | dimension · string | Dimensions | |
| id | ad_group.id | Output only. The ID of the ad group. | dimension · integer | Dimensions | |
| labels | ad_group.labels | Output only. The resource names of labels attached to this ad group. | dimension · string | Dimensions | |
| name | ad_group.name | The name of the ad group. This field is required and should not be empty when creating new ad groups. It must contain fewer than 255 UTF-8 full-width characters. It must not contain any null (code point 0x0), NL line feed (code point 0xA) or carriage return (code point 0xD) characters. | dimension · string | Dimensions | |
| optimized targeting enabled | ad_group.optimized_targeting_enabled | True if optimized targeting is enabled. Optimized Targeting is the replacement for Audience Expansion. | dimension · boolean | Dimensions | |
| primary status | ad_group.primary_status | Output only. Provides aggregated view into why an ad group is not serving or not serving optimally. | dimension · string | Dimensions | |
| primary status reasons | ad_group.primary_status_reasons | Output only. Provides reasons for why an ad group is not serving or not serving optimally. | dimension · string | Dimensions | |
| status | ad_group.status | The status of the ad group. | dimension · string | Dimensions | |
| target roas | ad_group.target_roas | The target ROAS (return-on-ad-spend) for this ad group. This field lets you override the target ROAS specified in the campaign's bidding strategy, but only if the campaign is using a standard (not portfolio) TargetRoas strategy or a standard MaximizeConversionValue strategy with its target_roas field set. If the campaign is using a portfolio bidding strategy, this field cannot be set and attempting to do so will result in an error. For any other bidding strategies, this value is ignored. To see the actual target ROAS being used by the ad group, considering potential overrides, query the effective_target_roas and effective_target_roas_source fields. | dimension · number | Dimensions | |
| target restrictions | ad_group.targeting_setting.target_restrictions | The per-targeting-dimension setting to restrict the reach of your campaign or ad group. | dimension · string | Dimensions | |
| type | ad_group.type | Immutable. The type of the ad group. | dimension · string | Dimensions | |
| disable text ads | ad_group.vertical_ads_format_setting.disable_text_ads | If true, text ads will be disabled for this ad group. | dimension · boolean | Dimensions | |
| enable booking links | ad_group.vertical_ads_format_setting.enable_booking_links | If true, booking links will be enabled for this ad group. | dimension · boolean | Dimensions | |
| enable vertical promotion ads | ad_group.vertical_ads_format_setting.enable_vertical_promotion_ads | If true, vertical promotion ads will be enabled for this ad group. | dimension · boolean | Dimensions | |
| auto tagging enabled | customer.auto_tagging_enabled | Whether auto-tagging is enabled for the customer. Only mutable in an update operation. | dimension · boolean | Dimensions | |
| call reporting enabled | customer.call_reporting_setting.call_reporting_enabled | Enable reporting of phone call events by redirecting them through Google System. | dimension · boolean | Dimensions | |
| contains eu political advertising | customer.contains_eu_political_advertising | Output only. Returns the advertiser self-declaration status of whether this customer contains political advertising content targeted towards the European Union. You can use the Google Ads UI to update this account-level declaration, or use the API to update the self-declaration status of individual campaigns. | dimension · string | Dimensions | |
| currency code | customer.currency_code | Immutable. The currency in which the account operates. A subset of the currency codes from the ISO 4217 standard is supported. | dimension · string | Dimensions | |
| descriptive name | customer.descriptive_name | Optional, non-unique descriptive name of the customer. | dimension · string | Dimensions | |
| has partners badge | customer.has_partners_badge | Output only. Whether the Customer has a Partners program badge. If the Customer is not associated with the Partners program, this will be false. For more information, see https://support.google.com/partners/answer/3125774. | dimension · boolean | Dimensions | |
| id | customer.id | Output only. The ID of the customer. | dimension · integer | Dimensions | |
| image asset auto migration done | customer.image_asset_auto_migration_done | Output only. True if feed based image has been migrated to asset based image. | dimension · boolean | Dimensions | |
| granular insurance statuses | customer.local_services_settings.granular_insurance_statuses | Output only. A read-only list of geo vertical level insurance statuses. | dimension · string | Dimensions | |
| granular license statuses | customer.local_services_settings.granular_license_statuses | Output only. A read-only list of geo vertical level license statuses. | dimension · string | Dimensions | |
| manager | customer.manager | Output only. Whether the customer is a manager. | dimension · boolean | Dimensions | |
| optimization score | customer.optimization_score | Output only. Optimization score of the customer. Optimization score is an estimate of how well a customer's campaigns are set to perform. It ranges from 0% (0.0) to 100% (1.0). This field is null for all manager customers, and for unscored non-manager customers. See "About optimization score" at https://support.google.com/google-ads/answer/9061546. This field is read-only. | dimension · number | Dimensions | |
| optimization score weight | customer.optimization_score_weight | Output only. Optimization score weight of the customer. Optimization score weight can be used to compare/aggregate optimization scores across multiple non-manager customers. The aggregate optimization score of a manager is computed as the sum over all of their customers of Customer.optimization_score * Customer.optimization_score_weight. This field is 0 for all manager customers, and for unscored non-manager customers. This field is read-only. | dimension · number | Dimensions | |
| google global site tag | customer.remarketing_setting.google_global_site_tag | Output only. The Google tag. | dimension · string | Dimensions | |
| status | customer.status | Output only. The status of the customer. | dimension · string | Dimensions | |
| test account | customer.test_account | Output only. Whether the customer is a test account. | dimension · boolean | Dimensions | |
| time zone | customer.time_zone | Immutable. The local timezone ID of the customer. | dimension · string | Dimensions | |
| added by google ads | ad_group_ad.ad.added_by_google_ads | 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. | dimension · boolean | Dimensions | |
| app deep link | ad_group_ad.ad.app_ad.app_deep_link | An app deep link asset that may be used with the ad. | dimension · string | Dimensions | |
| asset | ad_group_ad.ad.app_ad.app_deep_link.asset | The Asset resource name of this app deep link asset. | dimension · string | Dimensions | |
| descriptions | ad_group_ad.ad.app_ad.descriptions | List of text assets for descriptions. When the ad serves the descriptions will be selected from this list. | dimension · string | Dimensions | |
| headlines | ad_group_ad.ad.app_ad.headlines | List of text assets for headlines. When the ad serves the headlines will be selected from this list. | dimension · string | Dimensions | |
| html5 media bundles | ad_group_ad.ad.app_ad.html5_media_bundles | List of media bundle assets that may be used with the ad. | dimension · string | Dimensions | |
| asset | ad_group_ad.ad.app_ad.html5_media_bundles.asset | The Asset resource name of this media bundle. | dimension · string | Dimensions | |
| images | ad_group_ad.ad.app_ad.images | List of image assets that may be displayed with the ad. | dimension · string | Dimensions | |
| asset | ad_group_ad.ad.app_ad.images.asset | The Asset resource name of this image. | dimension · string | Dimensions | |
| mandatory ad text | ad_group_ad.ad.app_ad.mandatory_ad_text | Mandatory ad text. | dimension · string | Dimensions | |
| descriptions | ad_group_ad.ad.app_engagement_ad.descriptions | List of text assets for descriptions. When the ad serves the descriptions will be selected from this list. | dimension · string | Dimensions | |
| headlines | ad_group_ad.ad.app_engagement_ad.headlines | List of text assets for headlines. When the ad serves the headlines will be selected from this list. | dimension · string | Dimensions | |
| images | ad_group_ad.ad.app_engagement_ad.images | List of image assets that may be displayed with the ad. | dimension · string | Dimensions | |
| asset | ad_group_ad.ad.app_engagement_ad.images.asset | The Asset resource name of this image. | dimension · string | Dimensions | |
| descriptions | ad_group_ad.ad.app_pre_registration_ad.descriptions | List of text assets for descriptions. When the ad serves the descriptions will be selected from this list. | dimension · string | Dimensions | |
| headlines | ad_group_ad.ad.app_pre_registration_ad.headlines | List of text assets for headlines. When the ad serves the headlines will be selected from this list. | dimension · string | Dimensions | |
| images | ad_group_ad.ad.app_pre_registration_ad.images | List of image asset IDs whose images may be displayed with the ad. | dimension · string | Dimensions | |
| asset | ad_group_ad.ad.app_pre_registration_ad.images.asset | The Asset resource name of this image. | dimension · string | Dimensions | |
| business name | ad_group_ad.ad.demand_gen_carousel_ad.business_name | Required. The Advertiser/brand name. | dimension · string | Dimensions | |
| call to action text | ad_group_ad.ad.demand_gen_carousel_ad.call_to_action_text | Call to action text. | dimension · string | Dimensions | |
| carousel cards | ad_group_ad.ad.demand_gen_carousel_ad.carousel_cards | Required. Carousel cards that will display with the ad. Min 2 max 10. | dimension · string | Dimensions | |
| asset | ad_group_ad.ad.demand_gen_carousel_ad.carousel_cards.asset | The Asset resource name of this discovery carousel card. | dimension · string | Dimensions | |
| description | ad_group_ad.ad.demand_gen_carousel_ad.description | Required. The descriptive text of the ad. | dimension · string | Dimensions | |
| headline | ad_group_ad.ad.demand_gen_carousel_ad.headline | Required. Headline of the ad. | dimension · string | Dimensions | |
| logo image | ad_group_ad.ad.demand_gen_carousel_ad.logo_image | Required. Logo image to be used in the ad. The minimum size is 128x128 and the aspect ratio must be 1:1 (+-1%). | dimension · string | Dimensions | |
| asset | ad_group_ad.ad.demand_gen_carousel_ad.logo_image.asset | The Asset resource name of this image. | dimension · string | Dimensions | |
| business name | ad_group_ad.ad.demand_gen_multi_asset_ad.business_name | The Advertiser/brand name. Maximum display width is 25. Required. | dimension · string | Dimensions | |
| call to action text | ad_group_ad.ad.demand_gen_multi_asset_ad.call_to_action_text | Call to action text. | dimension · string | Dimensions | |
| classic display images | ad_group_ad.ad.demand_gen_multi_asset_ad.classic_display_images | Classic display image assets to be used in the ad. Valid image types are GIF, JPEG, and PNG. At most 20 classic display images can be specified per ad. | dimension · string | Dimensions | |
| asset | ad_group_ad.ad.demand_gen_multi_asset_ad.classic_display_images.asset | The Asset resource name of this image. | dimension · string | Dimensions | |
| descriptions | ad_group_ad.ad.demand_gen_multi_asset_ad.descriptions | The descriptive text of the ad. Maximum display width is 90. At least 1 and max 5 descriptions can be specified. | dimension · string | Dimensions | |
| headlines | ad_group_ad.ad.demand_gen_multi_asset_ad.headlines | Headline text asset of the ad. Maximum display width is 30. At least 1 and max 5 headlines can be specified. | dimension · string | Dimensions | |
| logo images | ad_group_ad.ad.demand_gen_multi_asset_ad.logo_images | 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. | dimension · string | Dimensions | |
| asset | ad_group_ad.ad.demand_gen_multi_asset_ad.logo_images.asset | The Asset resource name of this image. | dimension · string | Dimensions | |
| marketing images | ad_group_ad.ad.demand_gen_multi_asset_ad.marketing_images | 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, portrait_marketing_images, and tall_portrait_marketing_images the maximum is 20. | dimension · string | Dimensions | |
| asset | ad_group_ad.ad.demand_gen_multi_asset_ad.marketing_images.asset | The Asset resource name of this image. | dimension · string | Dimensions | |
| portrait marketing images | ad_group_ad.ad.demand_gen_multi_asset_ad.portrait_marketing_images | 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, square_marketing_images, and tall_portrait_marketing_images the maximum is 20. | dimension · string | Dimensions | |
| asset | ad_group_ad.ad.demand_gen_multi_asset_ad.portrait_marketing_images.asset | The Asset resource name of this image. | dimension · string | Dimensions | |
| square marketing images | ad_group_ad.ad.demand_gen_multi_asset_ad.square_marketing_images | 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, portrait_marketing_images, and tall_portrait_marketing_images the maximum is 20. | dimension · string | Dimensions | |
| asset | ad_group_ad.ad.demand_gen_multi_asset_ad.square_marketing_images.asset | The Asset resource name of this image. | dimension · string | Dimensions | |
| tall portrait marketing images | ad_group_ad.ad.demand_gen_multi_asset_ad.tall_portrait_marketing_images | Tall portrait marketing image assets to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 600x1067 and the aspect ratio must be 9:16 (+-1%). Combined with marketing_images, square_marketing_images, and portrait_marketing_images, the maximum is 20. | dimension · string | Dimensions | |
| asset | ad_group_ad.ad.demand_gen_multi_asset_ad.tall_portrait_marketing_images.asset | The Asset resource name of this image. | dimension · string | Dimensions | |
| media bundle | ad_group_ad.ad.display_upload_ad.media_bundle | 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. | dimension · string | Dimensions | |
| asset | ad_group_ad.ad.display_upload_ad.media_bundle.asset | The Asset resource name of this media bundle. | dimension · string | Dimensions | |
| description | ad_group_ad.ad.expanded_dynamic_search_ad.description | The description of the ad. | dimension · string | Dimensions | |
| description2 | ad_group_ad.ad.expanded_dynamic_search_ad.description2 | The second description of the ad. | dimension · string | Dimensions | |
| description | ad_group_ad.ad.expanded_text_ad.description | The description of the ad. | dimension · string | Dimensions | |
| description2 | ad_group_ad.ad.expanded_text_ad.description2 | The second description of the ad. | dimension · string | Dimensions | |
| headline part1 | ad_group_ad.ad.expanded_text_ad.headline_part1 | The first part of the ad's headline. | dimension · string | Dimensions | |
| headline part2 | ad_group_ad.ad.expanded_text_ad.headline_part2 | The second part of the ad's headline. | dimension · string | Dimensions | |
| headline part3 | ad_group_ad.ad.expanded_text_ad.headline_part3 | The third part of the ad's headline. | dimension · string | Dimensions | |
| hotel ad | ad_group_ad.ad.hotel_ad | Details pertaining to a hotel ad. | dimension · string | Dimensions | |
| id | ad_group_ad.ad.id | Output only. The ID of the ad. | dimension · integer | Dimensions | |
| asset | ad_group_ad.ad.image_ad.image_asset.asset | The Asset resource name of this image. | dimension · string | Dimensions | |
| mime type | ad_group_ad.ad.image_ad.mime_type | The mime type of the image. | dimension · string | Dimensions | |
| name | ad_group_ad.ad.image_ad.name | 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. | dimension · string | Dimensions | |
| pixel height | ad_group_ad.ad.image_ad.pixel_height | Height in pixels of the full size image. | dimension · integer | Dimensions | |
| pixel width | ad_group_ad.ad.image_ad.pixel_width | Width in pixels of the full size image. | dimension · integer | Dimensions | |
| legacy app install ad | ad_group_ad.ad.legacy_app_install_ad | Immutable. Details pertaining to a legacy app install ad. | dimension · string | Dimensions | |
| accent color | ad_group_ad.ad.legacy_responsive_display_ad.accent_color | 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. | dimension · string | Dimensions | |
| allow flexible color | ad_group_ad.ad.legacy_responsive_display_ad.allow_flexible_color | 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. | dimension · boolean | Dimensions | |
| business name | ad_group_ad.ad.legacy_responsive_display_ad.business_name | The business name in the ad. | dimension · string | Dimensions | |
| call to action text | ad_group_ad.ad.legacy_responsive_display_ad.call_to_action_text | The call-to-action text for the ad. | dimension · string | Dimensions | |
| description | ad_group_ad.ad.legacy_responsive_display_ad.description | The description of the ad. | dimension · string | Dimensions | |
| format setting | ad_group_ad.ad.legacy_responsive_display_ad.format_setting | Specifies which format the ad will be served in. Default is ALL_FORMATS. | dimension · string | Dimensions | |
| logo image | ad_group_ad.ad.legacy_responsive_display_ad.logo_image | The MediaFile resource name of the logo image used in the ad. | dimension · string | Dimensions | |
| long headline | ad_group_ad.ad.legacy_responsive_display_ad.long_headline | The long version of the ad's headline. | dimension · string | Dimensions | |
| main color | ad_group_ad.ad.legacy_responsive_display_ad.main_color | 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. | dimension · string | Dimensions | |
| marketing image | ad_group_ad.ad.legacy_responsive_display_ad.marketing_image | The MediaFile resource name of the marketing image used in the ad. | dimension · string | Dimensions | |
| promo text | ad_group_ad.ad.legacy_responsive_display_ad.promo_text | Promotion text used for dynamic formats of responsive ads. For example 'Free two-day shipping'. | dimension · string | Dimensions | |
| short headline | ad_group_ad.ad.legacy_responsive_display_ad.short_headline | The short version of the ad's headline. | dimension · string | Dimensions | |
| square logo image | ad_group_ad.ad.legacy_responsive_display_ad.square_logo_image | The MediaFile resource name of the square logo image used in the ad. | dimension · string | Dimensions | |
| square marketing image | ad_group_ad.ad.legacy_responsive_display_ad.square_marketing_image | The MediaFile resource name of the square marketing image used in the ad. | dimension · string | Dimensions | |
| call to actions | ad_group_ad.ad.local_ad.call_to_actions | 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. | dimension · string | Dimensions | |
| descriptions | ad_group_ad.ad.local_ad.descriptions | 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. | dimension · string | Dimensions | |
| headlines | ad_group_ad.ad.local_ad.headlines | 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. | dimension · string | Dimensions | |
| logo images | ad_group_ad.ad.local_ad.logo_images | 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. | dimension · string | Dimensions | |
| asset | ad_group_ad.ad.local_ad.logo_images.asset | The Asset resource name of this image. | dimension · string | Dimensions | |
| marketing images | ad_group_ad.ad.local_ad.marketing_images | 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. | dimension · string | Dimensions | |
| asset | ad_group_ad.ad.local_ad.marketing_images.asset | The Asset resource name of this image. | dimension · string | Dimensions | |
| name | ad_group_ad.ad.name | 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, LegacyAppInstallAd, ShoppingComparisonListingAd, VideoAd, VideoResponsiveAd and DemandGen ads. | dimension · string | Dimensions | |
| accent color | ad_group_ad.ad.responsive_display_ad.accent_color | 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. | dimension · string | Dimensions | |
| allow flexible color | ad_group_ad.ad.responsive_display_ad.allow_flexible_color | 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. | dimension · boolean | Dimensions | |
| business name | ad_group_ad.ad.responsive_display_ad.business_name | The advertiser/brand name. Maximum display width is 25. | dimension · string | Dimensions | |
| call to action text | ad_group_ad.ad.responsive_display_ad.call_to_action_text | The call-to-action text for the ad. Maximum display width is 30. | dimension · string | Dimensions | |
| enable asset enhancements | ad_group_ad.ad.responsive_display_ad.control_spec.enable_asset_enhancements | Whether the advertiser has opted into the asset enhancements feature. | dimension · boolean | Dimensions | |
| descriptions | ad_group_ad.ad.responsive_display_ad.descriptions | Descriptive texts for the ad. The maximum length is 90 characters. At least 1 and max 5 headlines can be specified. | dimension · string | Dimensions | |
| format setting | ad_group_ad.ad.responsive_display_ad.format_setting | Specifies which format the ad will be served in. Default is ALL_FORMATS. | dimension · string | Dimensions | |
| headlines | ad_group_ad.ad.responsive_display_ad.headlines | Short format headlines for the ad. The maximum length is 30 characters. At least 1 and max 5 headlines can be specified. | dimension · string | Dimensions | |
| logo images | ad_group_ad.ad.responsive_display_ad.logo_images | 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. | dimension · string | Dimensions | |
| asset | ad_group_ad.ad.responsive_display_ad.logo_images.asset | The Asset resource name of this image. | dimension · string | Dimensions | |
| long headline | ad_group_ad.ad.responsive_display_ad.long_headline | A required long format headline. The maximum length is 90 characters. | dimension · string | Dimensions | |
| main color | ad_group_ad.ad.responsive_display_ad.main_color | 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. | dimension · string | Dimensions | |
| marketing images | ad_group_ad.ad.responsive_display_ad.marketing_images | 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. | dimension · string | Dimensions | |
| asset | ad_group_ad.ad.responsive_display_ad.marketing_images.asset | The Asset resource name of this image. | dimension · string | Dimensions | |
| promo text | ad_group_ad.ad.responsive_display_ad.promo_text | Promotion text used for dynamic formats of responsive ads. For example 'Free two-day shipping'. | dimension · string | Dimensions | |
| square logo images | ad_group_ad.ad.responsive_display_ad.square_logo_images | 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. | dimension · string | Dimensions | |
| asset | ad_group_ad.ad.responsive_display_ad.square_logo_images.asset | The Asset resource name of this image. | dimension · string | Dimensions | |
| square marketing images | ad_group_ad.ad.responsive_display_ad.square_marketing_images | 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. | dimension · string | Dimensions | |
| asset | ad_group_ad.ad.responsive_display_ad.square_marketing_images.asset | The Asset resource name of this image. | dimension · string | Dimensions | |
| descriptions | ad_group_ad.ad.responsive_search_ad.descriptions | List of text assets for descriptions. When the ad serves the descriptions will be selected from this list. | dimension · string | Dimensions | |
| headlines | ad_group_ad.ad.responsive_search_ad.headlines | List of text assets for headlines. When the ad serves the headlines will be selected from this list. | dimension · string | Dimensions | |
| headline | ad_group_ad.ad.shopping_comparison_listing_ad.headline | Headline of the ad. This field is required. Allowed length is between 25 and 45 characters. | dimension · string | Dimensions | |
| shopping smart ad | ad_group_ad.ad.shopping_smart_ad | Details pertaining to a Smart Shopping ad. | dimension · string | Dimensions | |
| description1 | ad_group_ad.ad.text_ad.description1 | The first line of the ad's description. | dimension · string | Dimensions | |
| description2 | ad_group_ad.ad.text_ad.description2 | The second line of the ad's description. | dimension · string | Dimensions | |
| headline | ad_group_ad.ad.text_ad.headline | The headline of the ad. | dimension · string | Dimensions | |
| travel ad | ad_group_ad.ad.travel_ad | Details pertaining to a travel ad. | dimension · string | Dimensions | |
| type | ad_group_ad.ad.type | Output only. The type of ad. | dimension · string | Dimensions | |
| ad group | ad_group_ad.ad_group | Immutable. The ad group to which the ad belongs. | dimension · string | Dimensions | |
| ad group ad asset automation settings | ad_group_ad.ad_group_ad_asset_automation_settings | Settings that control the types of asset automation. See the AssetAutomationTypeEnum documentation for the default opt in/out behavior of each type. | dimension · string | Dimensions | |
| ad strength | ad_group_ad.ad_strength | Output only. Overall ad strength for this ad group ad. | dimension · string | Dimensions | |
| labels | ad_group_ad.labels | Output only. The resource names of labels attached to this ad group ad. | dimension · string | Dimensions | |
| approval status | ad_group_ad.policy_summary.approval_status | Output only. The overall approval status of this ad, calculated based on the status of its individual policy topic entries. | dimension · string | Dimensions | |
| policy topic entries | ad_group_ad.policy_summary.policy_topic_entries | Output only. The list of policy findings for this ad. | dimension · string | Dimensions | |
| primary status | ad_group_ad.primary_status | Output only. Provides aggregated view into why an ad group ad is not serving or not serving optimally. | dimension · string | Dimensions | |
| primary status reasons | ad_group_ad.primary_status_reasons | Output only. Provides reasons for why an ad group ad is not serving or not serving optimally. | dimension · string | Dimensions | |
| status | ad_group_ad.status | The status of the ad. | dimension · string | Dimensions |
Ecommerce
| Name | API field | Description | Type | Group | Cross-channel |
|---|---|---|---|---|---|
| all average cart size | metrics.all_average_cart_size | All average cart size is the average number of products in each order attributed to your ads. Includes the amount from the average_cart_size metric, plus avg. cart size from all your conversion actions, even if your campaigns are not actively optimizing towards them. It's calculated using product info from cart data to give more detail than conversion value alone. | metric · number | Ecommerce | |
| all conversions from order | metrics.all_conversions_from_order | The number of times people placed an order at a business after clicking an ad. This metric applies to feed items only. | metric · number | Ecommerce | |
| all orders | metrics.all_orders | All orders is total number of purchase conversions attributed to your ads. Includes the amount from the orders metric, plus orders from all your conversion actions, even if your campaigns are not actively optimizing towards them. It's calculated using product info from cart data to give more detail than conversion value alone. | metric · number | Ecommerce | |
| average cart size | metrics.average_cart_size | 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. | metric · number | Ecommerce | |
| hotel price difference percentage | metrics.hotel_price_difference_percentage | The average price difference between the price offered by reporting hotel advertiser and the cheapest price offered by the competing advertiser. | metric · number | Ecommerce | |
| orders | metrics.orders | 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. | metric · number | Ecommerce | Conversions |
| publisher purchased clicks | metrics.publisher_purchased_clicks | Clicks from properties not owned by the publisher for which the traffic the publisher has paid for or acquired through incentivized activity | metric · integer | Ecommerce | |
| results conversions purchase | metrics.results_conversions_purchase | The purchase conversion stats for the unified goals results. | metric · number | Ecommerce | |
| vertical ads price difference percentage | metrics.vertical_ads_price_difference_percentage | Percentage delta comparing the advertiser's offered price against the lowest competing price for the same property. | metric · number | Ecommerce | |
| video trueview view rate in feed | metrics.video_trueview_view_rate_in_feed | The number of TrueView views divided by number of impressions that can potentially lead to TrueView views for in-feed formats. | metric · number | Ecommerce | |
| ad using product data | segments.ad_using_product_data | Indicates whether an ad is using product data from a Google Merchant Center feed. This segment is only available for PMax campaigns and will not return data when any other campaign type is selected. | dimension · boolean | Ecommerce | |
| hotel price bucket | segments.hotel_price_bucket | Hotel price bucket. | dimension · string | Ecommerce | |
| product aggregator id | segments.product_aggregator_id | Aggregator ID of the product. | dimension · integer | Ecommerce | |
| product brand | segments.product_brand | Brand of the product. | dimension · string | Ecommerce | |
| product category level1 | segments.product_category_level1 | Category (level 1) of the product. | dimension · string | Ecommerce | |
| product category level2 | segments.product_category_level2 | Category (level 2) of the product. | dimension · string | Ecommerce | |
| product category level3 | segments.product_category_level3 | Category (level 3) of the product. | dimension · string | Ecommerce | |
| product category level4 | segments.product_category_level4 | Category (level 4) of the product. | dimension · string | Ecommerce | |
| product category level5 | segments.product_category_level5 | Category (level 5) of the product. | dimension · string | Ecommerce | |
| product condition | segments.product_condition | Condition of the product. | dimension · string | Ecommerce | |
| product custom attribute0 | segments.product_custom_attribute0 | Custom attribute 0 of the product. | dimension · string | Ecommerce | |
| product custom attribute1 | segments.product_custom_attribute1 | Custom attribute 1 of the product. | dimension · string | Ecommerce | |
| product custom attribute2 | segments.product_custom_attribute2 | Custom attribute 2 of the product. | dimension · string | Ecommerce | |
| product custom attribute3 | segments.product_custom_attribute3 | Custom attribute 3 of the product. | dimension · string | Ecommerce | |
| product custom attribute4 | segments.product_custom_attribute4 | Custom attribute 4 of the product. | dimension · string | Ecommerce | |
| product feed label | segments.product_feed_label | Feed label of the product. | dimension · string | Ecommerce | |
| product item id | segments.product_item_id | Item ID of the product. | dimension · string | Ecommerce | |
| product merchant id | segments.product_merchant_id | Merchant ID of the product. | dimension · integer | Ecommerce | |
| product sold brand | segments.product_sold_brand | Brand of the product sold. | dimension · string | Ecommerce | |
| product sold category level1 | segments.product_sold_category_level1 | Category (level 1) of the product sold. | dimension · string | Ecommerce | |
| product sold category level2 | segments.product_sold_category_level2 | Category (level 2) of the product sold. | dimension · string | Ecommerce | |
| product sold category level3 | segments.product_sold_category_level3 | Category (level 3) of the product sold. | dimension · string | Ecommerce | |
| product sold category level4 | segments.product_sold_category_level4 | Category (level 4) of the product sold. | dimension · string | Ecommerce | |
| product sold category level5 | segments.product_sold_category_level5 | Category (level 5) of the product sold. | dimension · string | Ecommerce | |
| product sold condition | segments.product_sold_condition | Condition of the product sold. | dimension · string | Ecommerce | |
| product sold custom attribute0 | segments.product_sold_custom_attribute0 | Custom attribute 0 of the product sold. | dimension · string | Ecommerce | |
| product sold custom attribute1 | segments.product_sold_custom_attribute1 | Custom attribute 1 of the product sold. | dimension · string | Ecommerce | |
| product sold custom attribute2 | segments.product_sold_custom_attribute2 | Custom attribute 2 of the product sold. | dimension · string | Ecommerce | |
| product sold custom attribute3 | segments.product_sold_custom_attribute3 | Custom attribute 3 of the product sold. | dimension · string | Ecommerce | |
| product sold custom attribute4 | segments.product_sold_custom_attribute4 | Custom attribute 4 of the product sold. | dimension · string | Ecommerce | |
| product sold item id | segments.product_sold_item_id | Item ID of the product sold. | dimension · string | Ecommerce | |
| product sold title | segments.product_sold_title | Title of the product sold. | dimension · string | Ecommerce | |
| product sold type l1 | segments.product_sold_type_l1 | Type (level 1) of the product sold. | dimension · string | Ecommerce | |
| product sold type l2 | segments.product_sold_type_l2 | Type (level 2) of the product sold. | dimension · string | Ecommerce | |
| product sold type l3 | segments.product_sold_type_l3 | Type (level 3) of the product sold. | dimension · string | Ecommerce | |
| product sold type l4 | segments.product_sold_type_l4 | Type (level 4) of the product sold. | dimension · string | Ecommerce | |
| product sold type l5 | segments.product_sold_type_l5 | Type (level 5) of the product sold. | dimension · string | Ecommerce | |
| product store id | segments.product_store_id | Store ID of the product. | dimension · string | Ecommerce | |
| product title | segments.product_title | Title of the product. | dimension · string | Ecommerce | |
| product type l1 | segments.product_type_l1 | Type (level 1) of the product. | dimension · string | Ecommerce | |
| product type l2 | segments.product_type_l2 | Type (level 2) of the product. | dimension · string | Ecommerce | |
| product type l3 | segments.product_type_l3 | Type (level 3) of the product. | dimension · string | Ecommerce | |
| product type l4 | segments.product_type_l4 | Type (level 4) of the product. | dimension · string | Ecommerce | |
| product type l5 | segments.product_type_l5 | Type (level 5) of the product. | dimension · string | Ecommerce | |
| vertical ads price tier | segments.vertical_ads_price_tier | Relative price competitiveness bucket hotel listing (only relevant to hotel campaigns). | dimension · string | Ecommerce | |
| action items | ad_group_ad.action_items | 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.". | dimension · string | Ecommerce | |
| breadcrumb1 | ad_group_ad.ad.demand_gen_product_ad.breadcrumb1 | First part of text that appears in the ad with the displayed URL. | dimension · string | Ecommerce | |
| breadcrumb2 | ad_group_ad.ad.demand_gen_product_ad.breadcrumb2 | Second part of text that appears in the ad with the displayed URL. | dimension · string | Ecommerce | |
| business name | ad_group_ad.ad.demand_gen_product_ad.business_name | Required. The advertiser/brand name. | dimension · string | Ecommerce | |
| call to action | ad_group_ad.ad.demand_gen_product_ad.call_to_action | Asset of type CallToActionAsset used for the "Call To Action" button. | dimension · string | Ecommerce | |
| asset | ad_group_ad.ad.demand_gen_product_ad.call_to_action.asset | The Asset resource name of this call to action asset. | dimension · string | Ecommerce | |
| description | ad_group_ad.ad.demand_gen_product_ad.description | Required. Text asset used for the description. | dimension · string | Ecommerce | |
| headline | ad_group_ad.ad.demand_gen_product_ad.headline | Required. Text asset used for the short headline. | dimension · string | Ecommerce | |
| logo image | ad_group_ad.ad.demand_gen_product_ad.logo_image | 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%). | dimension · string | Ecommerce | |
| asset | ad_group_ad.ad.demand_gen_product_ad.logo_image.asset | The Asset resource name of this image. | dimension · string | Ecommerce | |
| display upload product type | ad_group_ad.ad.display_upload_ad.display_upload_product_type | The product type of this ad. See comments on the enum for details. | dimension · string | Ecommerce | |
| price prefix | ad_group_ad.ad.legacy_responsive_display_ad.price_prefix | Prefix before price. For example, 'as low as'. | dimension · string | Ecommerce | |
| price prefix | ad_group_ad.ad.responsive_display_ad.price_prefix | Prefix before price. For example, 'as low as'. | dimension · string | Ecommerce | |
| shopping product ad | ad_group_ad.ad.shopping_product_ad | Details pertaining to a Shopping product ad. | dimension · string | Ecommerce | |
| description1 | ad_group_ad.ad.video_ad.in_feed.description1 | First text line for the ad. | dimension · string | Ecommerce | |
| description2 | ad_group_ad.ad.video_ad.in_feed.description2 | Second text line for the ad. | dimension · string | Ecommerce | |
| headline | ad_group_ad.ad.video_ad.in_feed.headline | The headline of the ad. | dimension · string | Ecommerce | |
| thumbnail | ad_group_ad.ad.video_ad.in_feed.thumbnail | Video thumbnail image to use. | dimension · string | Ecommerce |
Geography
| Name | API field | Description | Type | Group | Cross-channel |
|---|---|---|---|---|---|
| all conversions from location asset click to call | metrics.all_conversions_from_location_asset_click_to_call | Number of call button clicks on any location surface after a chargeable ad event (click or impression). This measure is coming from Asset based location. | metric · number | Geography | |
| all conversions from location asset directions | metrics.all_conversions_from_location_asset_directions | Number of driving directions clicks on any location surface after a chargeable ad event (click or impression). This measure is coming from Asset based location. | metric · number | Geography | |
| all conversions from location asset menu | metrics.all_conversions_from_location_asset_menu | Number of menu link clicks on any location surface after a chargeable ad event (click or impression). This measure is coming from Asset based location. | metric · number | Geography | |
| all conversions from location asset order | metrics.all_conversions_from_location_asset_order | Number of order clicks on any location surface after a chargeable ad event (click or impression). This measure is coming from Asset based location. | metric · number | Geography | |
| all conversions from location asset other engagement | metrics.all_conversions_from_location_asset_other_engagement | Number of other types of local action clicks on any location surface after a chargeable ad event (click or impression). This measure is coming from Asset based location. | metric · number | Geography | |
| all conversions from location asset store visits | metrics.all_conversions_from_location_asset_store_visits | Estimated number of visits to the business after a chargeable ad event (click or impression). This measure is coming from Asset based location. | metric · number | Geography | |
| all conversions from location asset website | metrics.all_conversions_from_location_asset_website | Number of website URL clicks on any location surface after a chargeable ad event (click or impression). This measure is coming from Asset based location. | metric · number | Geography | |
| eligible impressions from location asset store reach | metrics.eligible_impressions_from_location_asset_store_reach | Number of impressions in which the business location was shown or the location was used for targeting. This measure is coming from Asset based location. | metric · integer | Geography | |
| view through conversions from location asset click to call | metrics.view_through_conversions_from_location_asset_click_to_call | Number of call button clicks on any location surface after an impression. This measure is coming from Asset based location. | metric · number | Geography | |
| view through conversions from location asset directions | metrics.view_through_conversions_from_location_asset_directions | Number of driving directions clicks on any location surface after an impression. This measure is coming from Asset based location. | metric · number | Geography | |
| view through conversions from location asset menu | metrics.view_through_conversions_from_location_asset_menu | Number of menu link clicks on any location surface after an impression. This measure is coming from Asset based location. | metric · number | Geography | |
| view through conversions from location asset order | metrics.view_through_conversions_from_location_asset_order | Number of order clicks on any location surface after an impression. This measure is coming from Asset based location. | metric · number | Geography | |
| view through conversions from location asset other engagement | metrics.view_through_conversions_from_location_asset_other_engagement | Number of other types of local action clicks on any location surface after an impression. This measure is coming from Asset based location. | metric · number | Geography | |
| view through conversions from location asset store visits | metrics.view_through_conversions_from_location_asset_store_visits | Estimated number of visits to the business after an impression. This measure is coming from Asset based location. | metric · number | Geography | |
| view through conversions from location asset website | metrics.view_through_conversions_from_location_asset_website | Number of website URL clicks on any location surface after an impression. This measure is coming from Asset based location. | metric · number | Geography | |
| activity city | segments.activity_city | The city where the travel activity is available. | dimension · string | Geography | |
| activity country | segments.activity_country | The country where the travel activity is available. | dimension · string | Geography | |
| country | segments.country | Resource name of the country | dimension · string | Geography | |
| country localized name | segments.country_localized_name | Localized name of the country. | dimension · string | Geography | |
| geo target airport | segments.geo_target_airport | Resource name of the geo target constant that represents an airport. | dimension · string | Geography | |
| geo target canton | segments.geo_target_canton | Resource name of the geo target constant that represents a canton. | dimension · string | Geography | |
| geo target city | segments.geo_target_city | Resource name of the geo target constant that represents a city. | dimension · string | Geography | |
| geo target country | segments.geo_target_country | Resource name of the geo target constant that represents a country. | dimension · string | Geography | |
| geo target county | segments.geo_target_county | Resource name of the geo target constant that represents a county. | dimension · string | Geography | |
| geo target district | segments.geo_target_district | Resource name of the geo target constant that represents a district. | dimension · string | Geography | |
| geo target metro | segments.geo_target_metro | Resource name of the geo target constant that represents a metro. | dimension · string | Geography | |
| geo target most specific location | segments.geo_target_most_specific_location | Resource name of the geo target constant that represents the most specific location. | dimension · string | Geography | |
| geo target postal code | segments.geo_target_postal_code | Resource name of the geo target constant that represents a postal code. | dimension · string | Geography | |
| geo target province | segments.geo_target_province | Resource name of the geo target constant that represents a province. | dimension · string | Geography | |
| geo target region | segments.geo_target_region | Resource name of the geo target constant that represents a region. | dimension · string | Geography | |
| geo target state | segments.geo_target_state | Resource name of the geo target constant that represents a state. | dimension · string | Geography | |
| hotel city | segments.hotel_city | Hotel city. | dimension · string | Geography | |
| hotel country | segments.hotel_country | Hotel country. | dimension · string | Geography | |
| product country | segments.product_country | Resource name of the geo target constant for the country of sale of the product. | dimension · string | Geography | |
| travel destination city | segments.travel_destination_city | The city the user is searching for at query time. | dimension · string | Geography | |
| travel destination country | segments.travel_destination_country | The country the user is searching for at query time. | dimension · string | Geography | |
| travel destination region | segments.travel_destination_region | The region the user is searching for at query time. | dimension · string | Geography | |
| vertical ads listing city | segments.vertical_ads_listing_city | The city where the vertical ads listing is located. | dimension · string | Geography | |
| vertical ads listing country | segments.vertical_ads_listing_country | The country where the vertical ads listing is located. | dimension · string | Geography | |
| vertical ads listing region | segments.vertical_ads_listing_region | The region where the vertical ads listing is located. | dimension · string | Geography | |
| negative geo target type | campaign.geo_target_type_setting.negative_geo_target_type | The setting used for negative geotargeting in this particular campaign. | dimension · string | Geography | |
| positive geo target type | campaign.geo_target_type_setting.positive_geo_target_type | The setting used for positive geotargeting in this particular campaign. | dimension · string | Geography | |
| location source type | campaign.local_campaign_setting.location_source_type | The location source type for this local campaign. | dimension · string | Geography | |
| country code | campaign.pmax_campaign_settings.local_services_pmax_campaign_settings.country_code | Required. Immutable. Country code of the Local Services Ad. Set once during Ad Creation and used to determine verification requirements and validate location criterion selection; upper-case, two-letter codes as defined by ISO-3166. | dimension · string | Geography | |
| location | campaign.target_impression_share.location | The targeted location on the search results page. | dimension · string | Geography | |
| location fraction micros | campaign.target_impression_share.location_fraction_micros | The chosen fraction of ads to be shown in the targeted location in micros. For example, 1% equals 10,000. | dimension · integer | Geography | |
| location asset auto migration done | customer.location_asset_auto_migration_done | Output only. True if feed based location has been migrated to asset based location. | dimension · boolean | Geography | |
| country criterion id | geographic_view.country_criterion_id | Output only. Criterion Id for the country. | dimension · integer | Geography | |
| location type | geographic_view.location_type | Output only. Type of the geo targeting of the campaign. | dimension · string | Geography | |
| resource name | geographic_view.resource_name | Output only. The resource name of the geographic view. Geographic view resource names have the form: customers/{customer_id}/geographicViews/{country_criterion_id}~{location_type} | dimension · string | Geography |
Metrics
| Name | API field | Description | Type | Group | Cross-channel |
|---|---|---|---|---|---|
| absolute brand lift | metrics.absolute_brand_lift | These metrics estimate the additional brand lift directly attributable to the ad campaign. | metric · number | Metrics | |
| absolute brand lift p90 lower bound | metrics.absolute_brand_lift_p90_lower_bound | Lower bound of the 90% confidence interval for absolute brand lift. The "conservative" estimate of your success. It is the minimum increase you can be 90% sure was caused by your ads. | metric · number | Metrics | |
| absolute brand lift p90 upper bound | metrics.absolute_brand_lift_p90_upper_bound | Upper bound of the 90% confidence interval for absolute brand lift. The "optimistic" estimate of your success. It is the maximum increase likely driven by your ads. | metric · number | Metrics | |
| absolute brand lift p value | metrics.absolute_brand_lift_p_value | The p-value provides a measure of the statistical significance for the detected brand lift. It calculates the likelihood that your incremental lift was driven by ad performance rather than being a merely random occurrence. Achieving a low score of 0.10 indicates 90% confidence that your advertising efforts directly generated the additional lift. | metric · number | Metrics | |
| all new customer lifetime value | metrics.all_new_customer_lifetime_value | 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 About customer lifecycle goals for more details. | metric · number | Metrics | |
| all units sold | metrics.all_units_sold | All units sold is the total number of products sold from orders attributed to your ads. Includes the amount from the units_sold metric, plus units sold from all your conversion actions, even if your campaigns are not actively optimizing towards them. It's calculated using product info from cart data to give more detail than conversion value alone. | metric · number | Metrics | |
| all value adjustment | metrics.all_value_adjustment | The conversion value rule adjustment from all conversions in all conversion categories. | metric · number | Metrics | |
| asset pinned total count | metrics.asset_pinned_total_count | Number of total usages in which the asset is pinned. This metric can only be selected with ChannelAggregateAssetView and CampaignAggregateAssetView. This metric is only supported in Search channel. | metric · integer | Metrics | |
| auction insight search outranking share | metrics.auction_insight_search_outranking_share | This metric is part of the Auction Insights report, and tells the percentage of impressions that your ads outranked (showed above) another participant in the auction, compared to the total number of impressions that your ads were eligible for. Any value below 0.1 is reported as 0.0999. This metric is not publicly available. | metric · number | Metrics | |
| auction insight search overlap rate | metrics.auction_insight_search_overlap_rate | This metric is part of the Auction Insights report, and tells the percentage of times another participant's ad received an impression when your ad also received an impression. This metric is not publicly available. | metric · number | Metrics | |
| average cpe | metrics.average_cpe | 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. | metric · number | Metrics | |
| average target roas | metrics.average_target_roas | The average Target ROAS, or unset if not available (for example, for campaigns that had traffic from portfolio bidding strategies or non-tROAS). | metric · number | Metrics | |
| average time on site | metrics.average_time_on_site | Total duration of all sessions (in seconds) / number of sessions. Imported from Google Analytics. | metric · number | Metrics | |
| brand lift responses suppressed | metrics.brand_lift_responses_suppressed | Brand lift responses suppressed. | metric · number | Metrics | |
| brand lift total responses | metrics.brand_lift_total_responses | The total number of survey responses collected across both the exposed and control groups. | metric · number | Metrics | |
| combined queries | metrics.combined_queries | The number of searches that returned pages from your site in the unpaid results or showed one of your text ads. See About measuring paid and organic search results for details. | metric · integer | Metrics | |
| engagement rate | metrics.engagement_rate | The frequency with which 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. | metric · number | Metrics | |
| engagements | metrics.engagements | 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. | metric · integer | Metrics | |
| fractional lifted cookies | metrics.fractional_lifted_cookies | Estimated number of unique users who were moved to a positive brand state directly by the campaign (that is, lifted users). | metric · number | Metrics | |
| fractional lifted cookies p90 lower bound | metrics.fractional_lifted_cookies_p90_lower_bound | The lower bound of the 90% confidence interval for the fractional_lifted_cookies metric. This value represents a statistically conservative estimate of the minimum number of cookies for whom a positive Brand Lift is attributed to the ad exposure. | metric · number | Metrics | |
| fractional lifted cookies p90 upper bound | metrics.fractional_lifted_cookies_p90_upper_bound | The upper bound of the 90% confidence interval for the fractional_lifted_cookies metric. This value represents a statistically optimistic estimate of the maximum number of cookies that may have experienced a positive Brand Lift. | metric · number | Metrics | |
| gmail forwards | metrics.gmail_forwards | The number of times the ad was forwarded to someone else as a message. | metric · integer | Metrics | |
| gmail saves | metrics.gmail_saves | The number of times someone has saved your Gmail ad to their inbox as a message. | metric · integer | Metrics | |
| headroom brand lift | metrics.headroom_brand_lift | The increase in positive brand responses relative to the total potential growth remaining. | metric · number | Metrics | |
| headroom brand lift p90 lower bound | metrics.headroom_brand_lift_p90_lower_bound | Lower bound of the 90% confidence interval for headroom brand lift. The minimum growth rate relative to remaining brand potential you can be 90% confident was driven by your ads. | metric · number | Metrics | |
| headroom brand lift p90 upper bound | metrics.headroom_brand_lift_p90_upper_bound | Upper bound of the 90% confidence interval for headroom brand lift. The maximum growth rate relative to remaining brand potential likely driven by your ads. | metric · number | Metrics | |
| historical creative quality score | metrics.historical_creative_quality_score | The creative historical quality score. | metric · string | Metrics | |
| historical quality score | metrics.historical_quality_score | The historical quality score. | metric · integer | Metrics | |
| incremental searches p value | metrics.incremental_searches_p_value | The p-value for incremental searches. Represents the statistical probability that the observed increase in search queries occurred by chance rather than being caused by the ad exposure. | metric · number | Metrics | |
| interaction event types | metrics.interaction_event_types | The types of payable and free interactions. | metric · string | Metrics | |
| interaction rate | metrics.interaction_rate | The frequency with which 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. | metric · number | Metrics | |
| interactions | metrics.interactions | 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. | metric · integer | Metrics | |
| linked entities count | metrics.linked_entities_count | Number of linked resources in which the asset is used. This metric can only be selected with ChannelAggregateAssetView and CampaignAggregateAssetView. | metric · integer | Metrics | |
| linked sample entities | metrics.linked_sample_entities | A list of up to 20 sample linked resources in which the asset is used. This metric can only be selected with ChannelAggregateAssetView and CampaignAggregateAssetView. | metric · string | Metrics | |
| message chat rate | metrics.message_chat_rate | Number of message chats initiated (message_chats) divided by the number of message impressions (message_impressions). Rate at which a user initiates a message chat from an ad impression with a messaging option and message tracking enabled. Note that this rate can be more than 1.0 for a given message impression. | metric · number | Metrics | |
| message chats | metrics.message_chats | Number of message chats initiated for Click To Message impressions that were message tracking eligible. | metric · integer | Metrics | |
| new customer lifetime value | metrics.new_customer_lifetime_value | 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 About customer lifecycle goals for more details. | metric · number | Metrics | |
| normalized incremental searches | metrics.normalized_incremental_searches | The estimated number of incremental search queries driven by ad exposure, normalized across exposed and control groups. This metric is only reported when lift is statistically positive. | metric · number | Metrics | |
| normalized incremental searches p90 lower bound | metrics.normalized_incremental_searches_p90_lower_bound | The lower bound of the 90% confidence interval for normalized incremental searches. Represents a statistically conservative estimate of the minimum additional search queries driven by ad exposure. | metric · number | Metrics | |
| normalized incremental searches p90 upper bound | metrics.normalized_incremental_searches_p90_upper_bound | The upper bound of the 90% confidence interval for normalized incremental searches. Represents a statistically optimistic estimate of the maximum additional search queries driven by ad exposure. | metric · number | Metrics | |
| optimization score uplift | metrics.optimization_score_uplift | Total optimization score uplift of all recommendations. | metric · number | Metrics | |
| organic queries | metrics.organic_queries | The total number of searches that returned your site's listing in the unpaid results. See About measuring paid and organic search results for details. | metric · integer | Metrics | |
| percent new visitors | metrics.percent_new_visitors | Percentage of first-time sessions (from people who had never visited your site before). Imported from Google Analytics. | metric · number | Metrics | |
| phone calls | metrics.phone_calls | Number of offline phone calls. | metric · integer | Metrics | |
| phone through rate | metrics.phone_through_rate | Number of phone calls received (phone_calls) divided by the number of times your phone number is shown (phone_impressions). | metric · number | Metrics | |
| relative brand lift | metrics.relative_brand_lift | The percentage increase in positive responses in the exposed group compared to the control group. | metric · number | Metrics | |
| relative brand lift p90 lower bound | metrics.relative_brand_lift_p90_lower_bound | The lower bound of the 90% confidence interval for Relative Brand Lift. Represents the minimum percentage increase in positive brand perception among users who were exposed to the ads, relative to the baseline positive response rate observed in the control group. | metric · number | Metrics | |
| relative brand lift p90 upper bound | metrics.relative_brand_lift_p90_upper_bound | The upper bound of the 90% confidence interval for Relative Brand Lift. Represents the maximum percentage increase in positive brand perception in the ad-exposed group, relative to the control group's baseline positive response rate, at a 90% confidence level. | metric · number | Metrics | |
| relative search lift | metrics.relative_search_lift | The difference in search query volume between the exposed and control groups, expressed as a fraction of search queries in the control group. This indicates the percentage increase in search activity driven by ad exposure. | metric · number | Metrics | |
| relative search lift p90 lower bound | metrics.relative_search_lift_p90_lower_bound | The lower bound of the 90% confidence interval for relative search lift. Represents a statistically conservative estimate of the minimum percentage increase in search activity attributable to ad exposure. | metric · number | Metrics | |
| relative search lift p90 upper bound | metrics.relative_search_lift_p90_upper_bound | The upper bound of the 90% confidence interval for relative search lift. Represents a statistically optimistic estimate of the maximum percentage increase in search activity attributable to ad exposure. | metric · number | Metrics | |
| search volume | metrics.search_volume | Search volume range for a search term insight category. | metric · string | Metrics | |
| sk ad network installs | metrics.sk_ad_network_installs | The number of iOS Store Kit Ad Network conversions. | metric · integer | Metrics | |
| speed score | metrics.speed_score | A 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. | metric · integer | Metrics | |
| svr | metrics.svr | This feature is available to allowlisted accounts only. | metric · integer | Metrics | |
| units sold | metrics.units_sold | 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. | metric · number | Metrics | |
| value adjustment | metrics.value_adjustment | The conversion value rule adjustment from biddable conversions in all conversion categories. | metric · number | Metrics | |
| youtube comments | metrics.youtube_comments | The number of comments on YouTube Shorts videos attributed to ad impressions. | metric · integer | Metrics | |
| youtube likes | metrics.youtube_likes | The number of likes on YouTube Shorts videos attributed to ad impressions. | metric · integer | Metrics | |
| youtube shares | metrics.youtube_shares | The number of shares on YouTube Shorts videos attributed to ad impressions. | metric · integer | Metrics |
Technology
| Name | API field | Description | Type | Group | Cross-channel |
|---|---|---|---|---|---|
| active view measurable cost micros | metrics.active_view_measurable_cost_micros | The cost of the impressions you received that were measurable by Active View. | metric · integer | Technology | |
| all average order value micros | metrics.all_average_order_value_micros | All average order value is the average revenue you made per order attributed to your ads. Includes the amount from the average_order_value metric, plus avg. order value from all your conversion actions, even if your campaigns are not actively optimizing towards them. It's calculated using product info from cart data to give more detail than conversion value alone. | metric · integer | Technology | |
| all conversions value per cost | metrics.all_conversions_value_per_cost | The value of all conversions divided by the total cost of ad interactions (such as clicks for text ads or views for video ads). | metric · number | Technology | |
| all cost of goods sold micros | metrics.all_cost_of_goods_sold_micros | All cost of goods sold is the total cost of the products you sold in orders attributed to your ads. Includes the amount from the cost_of_goods_sold_micros metric, plus cost of goods sold from all conversion actions, even if your campaigns are not actively optimizing towards them. It's calculated using product info from cart data to give more detail than conversion value alone. | metric · integer | Technology | |
| all cross sell cost of goods sold micros | metrics.all_cross_sell_cost_of_goods_sold_micros | All cross-sell cost of goods sold is the total cost of products sold as a result of advertising a different product. Includes the amount from the cross_sell_cost_of_goods_sold_micros metric, plus cross-sell cost of goods sold from all your conversion actions, even if your campaigns are not actively optimizing towards them. It's calculated using product info from cart data to give more detail than conversion value alone. | metric · integer | Technology | |
| all cross sell gross profit micros | metrics.all_cross_sell_gross_profit_micros | All 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). Includes the amount from the cross_sell_gross_profit_micros metric, plus cross-sell gross profit from all your conversion actions, even if your campaigns are not actively optimizing towards them. It's calculated using product info from cart data to give more detail than conversion value alone. | metric · integer | Technology | |
| all cross sell revenue micros | metrics.all_cross_sell_revenue_micros | All cross-sell revenue is the total amount you made from products sold as a result of advertising a different product. Includes the amount from the cross_sell_revenue_micros metric, plus cross-sell revenue from all your conversion actions, even if your campaigns are not actively optimizing towards them. It's calculated using product info from cart data to give more detail than conversion value alone. | metric · integer | Technology | |
| all cross sell units sold | metrics.all_cross_sell_units_sold | All cross-sell units sold is the total number of products sold as a result of advertising a different product. Includes the amount shown in the cross_sell_units_sold metric, plus cross-sell units sold from all your conversion actions, even if your campaigns are not actively optimizing towards them. It's calculated using product info from cart data to give more detail than conversion value alone. | metric · number | Technology | |
| all gross profit margin | metrics.all_gross_profit_margin | All 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). This value is between 0.0 and 1.0, where 1.0 means 100%. Includes the amount from the gross_profit_margin metric, plus gross profit margin across all conversion actions, even if your campaigns are not actively optimizing towards them. It's calculated using product info from cart data to give more detail than conversion value alone. | metric · number | Technology | |
| all gross profit micros | metrics.all_gross_profit_micros | All gross profit is the total profit made from orders attributed to your ads minus the cost of goods sold (COGS). Includes the amount from the gross_profit_micros metric, plus gross profit from all your conversion actions, even if your campaigns are not actively optimizing towards them. It's calculated using product info from cart data to give more detail than conversion value alone. | metric · integer | Technology | |
| all lead cost of goods sold micros | metrics.all_lead_cost_of_goods_sold_micros | All lead cost of goods sold is the total cost of products sold as a result of advertising the same product. Includes the amount shown in the lead_cost_of_goods_sold_micros metric, plus lead cost of goods sold from all your conversion actions, even if your campaigns are not actively optimizing towards them. It's calculated using product info from cart data to give more detail than conversion value alone. | metric · integer | Technology | |
| all lead gross profit micros | metrics.all_lead_gross_profit_micros | All 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). Includes the amount from the lead_gross_profit_micros metric, plus lead gross profit from all your conversion actions, even if your campaigns are not actively optimizing towards them. It's calculated using product info from cart data to give more detail than conversion value alone. | metric · integer | Technology | |
| all lead revenue micros | metrics.all_lead_revenue_micros | All lead revenue is the total amount you made from products sold as a result of advertising the same product. Includes the amount shown in the lead_revenue_micros metric, plus lead revenue from all your conversion actions, even if your campaigns are not actively optimizing towards them. It's calculated using product info from cart data to give more detail than conversion value alone. | metric · integer | Technology | |
| all revenue micros | metrics.all_revenue_micros | All revenue is the total you made from orders attributed to your ads. Includes the amount from the revenue_micros metric, plus revenue from all your conversion actions, even if your campaigns are not actively optimizing towards them. It's calculated using product info from cart data to give more detail than conversion value alone. | metric · integer | Technology | |
| asset pinned as description position one count | metrics.asset_pinned_as_description_position_one_count | Number of entities in which the asset is pinned to description 1. This metric can only be selected with ChannelAggregateAssetView and CampaignAggregateAssetView. This metric is only supported in Search channel. | metric · integer | Technology | |
| asset pinned as description position two count | metrics.asset_pinned_as_description_position_two_count | Number of entities in which the asset is pinned to description 2. This metric can only be selected with ChannelAggregateAssetView and CampaignAggregateAssetView. This metric is only supported in Search channel. | metric · integer | Technology | |
| asset pinned as headline position one count | metrics.asset_pinned_as_headline_position_one_count | Number of entities in which the asset is pinned to headline 1. This metric can only be selected with ChannelAggregateAssetView and CampaignAggregateAssetView. This metric is only supported in Search channel. | metric · integer | Technology | |
| asset pinned as headline position three count | metrics.asset_pinned_as_headline_position_three_count | Number of entities in which the asset is pinned to headline 3. This metric can only be selected with ChannelAggregateAssetView and CampaignAggregateAssetView. This metric is only supported in Search channel. | metric · integer | Technology | |
| asset pinned as headline position two count | metrics.asset_pinned_as_headline_position_two_count | Number of entities in which the asset is pinned to headline 2. This metric can only be selected with ChannelAggregateAssetView and CampaignAggregateAssetView. This metric is only supported in Search channel. | metric · integer | Technology | |
| auction insight search position above rate | metrics.auction_insight_search_position_above_rate | This metric is part of the Auction Insights report, and tells the percentage of times another participant's ad was shown in a higher position than yours, when both of your ads were shown at the same page. This metric is not publicly available. | metric · number | Technology | |
| average cost | metrics.average_cost | The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions. | metric · number | Technology | |
| average order value micros | metrics.average_order_value_micros | 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. | metric · integer | Technology | |
| average target cpa micros | metrics.average_target_cpa_micros | The average Target CPA, or unset if not available (for example, for campaigns that had traffic from portfolio bidding strategies or non-tCPA). | metric · integer | Technology | |
| biddable app post install conversions | metrics.biddable_app_post_install_conversions | Number of in-app actions. | metric · number | Technology | |
| biddable cohort app post install conversions | metrics.biddable_cohort_app_post_install_conversions | Participated in-app actions. The number of in app actions that come directly or indirectly from the campaign. | metric · number | Technology | |
| biddable indirect install first in app conversion micros | metrics.biddable_indirect_install_first_in_app_conversion_micros | The number of biddable first in app conversions where the app install was driven by interaction with a web campaign. | metric · integer | Technology | |
| brand lift baseline positive response rate | metrics.brand_lift_baseline_positive_response_rate | Represents the rate of positive responses that would have occurred naturally without ad exposure, based on the behavior of the control group. Also referred to as "Control" responses. Provides the baseline level of brand perception that occurred naturally. | metric · number | Technology | |
| brand lift baseline positive response rate p90 lower bound | metrics.brand_lift_baseline_positive_response_rate_p90_lower_bound | Lower bound of the 90% confidence interval for the baseline positive response rate. Represents the conservative baseline rate of positive brand responses you could expect naturally without ad exposure. | metric · number | Technology | |
| brand lift baseline positive response rate p90 upper bound | metrics.brand_lift_baseline_positive_response_rate_p90_upper_bound | Upper bound of the 90% confidence interval for the baseline positive response rate. Represents the optimistic baseline rate of positive brand responses expected naturally without ad exposure. | metric · number | Technology | |
| brand lift exposed positive responder fractional cookies | metrics.brand_lift_exposed_positive_responder_fractional_cookies | Estimated unique users showing interest in the exposed group. This value is "fractional" because it represents a statistical estimate rather than a raw headcount. | metric · number | Technology | |
| brand lift exposed positive responder fractional cookies p90 lower bound | metrics.brand_lift_exposed_positive_responder_fractional_cookies_p90_lower_bound | The lower bound of the 90% confidence interval for the estimated number of unique cookies within the ad-exposed group that are estimated to have a positive brand attitude, as measured by the Brand Lift survey. | metric · number | Technology | |
| brand lift exposed positive responder fractional cookies p90 upper bound | metrics.brand_lift_exposed_positive_responder_fractional_cookies_p90_upper_bound | The upper bound of the 90% confidence interval for the estimated number of unique cookies within the ad-exposed group that are estimated to have experienced a positive shift in brand attitude, as measured by the Brand Lift survey. | metric · number | Technology | |
| brand lift exposed positive response rate | metrics.brand_lift_exposed_positive_response_rate | Represents the rate of positive responses from users who were exposed to the ads. Also referred to as "Treatment" responses. Shows total positive response rate when users were exposed to your ads. | metric · number | Technology | |
| brand lift exposed positive response rate p90 lower bound | metrics.brand_lift_exposed_positive_response_rate_p90_lower_bound | Lower bound of the 90% confidence interval for the exposed positive response rate. Represents the conservative estimate of positive brand responses among users exposed to your ads. | metric · number | Technology | |
| brand lift exposed positive response rate p90 upper bound | metrics.brand_lift_exposed_positive_response_rate_p90_upper_bound | Upper bound of the 90% confidence interval for the exposed positive response rate. Represents the maximum estimate of positive brand responses among users exposed to your ads. | metric · number | Technology | |
| brand lift responses exposed | metrics.brand_lift_responses_exposed | The number of survey responses from users who were exposed to the ads. | metric · number | Technology | |
| brand lift suppressed positive responder fractional cookies | metrics.brand_lift_suppressed_positive_responder_fractional_cookies | Estimated unique users showing interest in the control/suppressed group. This value is "fractional" because it represents a statistical estimate. | metric · number | Technology | |
| brand lift suppressed positive responder fractional cookies p90 lower bound | metrics.brand_lift_suppressed_positive_responder_fractional_cookies_p90_lower_bound | Lower bound of the 90% confidence interval for the estimated number of fractional cookies within the control group that are categorized as positive responders. This lower bound provides a statistically supported minimum value for the total fractional cookies in the control group showing a positive brand attitude. | metric · number | Technology | |
| brand lift suppressed positive responder fractional cookies p90 upper bound | metrics.brand_lift_suppressed_positive_responder_fractional_cookies_p90_upper_bound | Represents the upper bound of the 90% confidence interval for the estimated number of fractional cookies within the control group that are categorized as positive responders. This upper bound provides a statistically supported maximum value for the total fractional cookies in the control group showing a positive brand attitude. | metric · number | Technology | |
| content budget lost impression share | metrics.content_budget_lost_impression_share | The estimated percentage 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. | metric · number | Technology | |
| content rank lost impression share | metrics.content_rank_lost_impression_share | The 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. | metric · number | Technology | |
| control conversion value per cost | metrics.control_conversion_value_per_cost | The conversion value per cost metric on the control arm of the experiment. The treatment conversion value per cost value can be selected by using conversions_value_per_cost. | metric · number | Technology | |
| control cost micros | metrics.control_cost_micros | The cost metric on the control arm of the experiment. The treatment cost value can be selected by using cost_micros. | metric · integer | Technology | |
| control cost per conversion | metrics.control_cost_per_conversion | The cost per conversion metric on the control arm of the experiment. The treatment cost per conversion value can be selected by using cost_per_conversion. | metric · number | Technology | |
| conversion lift exposed conversion value | metrics.conversion_lift_exposed_conversion_value | Represents the total conversion value from users exposed to the ads. | metric · number | Technology | |
| conversion lift exposed conversions | metrics.conversion_lift_exposed_conversions | Represents the total conversions from users who were exposed to the ads. Also referred to as "Treatment" conversions. | metric · number | Technology | |
| conversion value per cost change point estimate | metrics.conversion_value_per_cost_change_point_estimate | The point estimate when estimating the experiment's effect on conversion value per cost change. Together with conversion_value_per_cost_margin_of_error, they describe a confidence interval with a prescribed confidence level for the difference being estimated. The quantity being estimated is (treatment / control - 1). This field specifies the point estimate, which is the center of the confidence interval: (conversion_value_per_cost_change_point_estimate - conversion_value_per_cost_margin_of_error, conversion_value_per_cost_change_point_estimate + conversion_value_per_cost_margin_of_error). | metric · number | Technology | |
| conversion value per cost margin of error | metrics.conversion_value_per_cost_margin_of_error | The margin of error when estimating the experiment's effect on conversion value per cost. Together with conversion_value_per_cost_change_point_estimate, they describe a confidence interval with a prescribed confidence level for the difference being estimated. The quantity being estimated is (treatment / control - 1). This field specifies the radius of the confidence interval, which is centered at conversion_value_per_cost_change_point_estimate. | metric · number | Technology | |
| conversion value per cost p value | metrics.conversion_value_per_cost_p_value | The p-value for the null hypothesis that the experiment has no effect on conversion value per cost. Ranges from 0 to 1. Say if the p-value is 0.03, that means the probability of observing the data, if the experiment has no effect on conversion value per cost, is 3%. | metric · number | Technology | |
| conversions value per cost | metrics.conversions_value_per_cost | 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. | metric · number | Technology | |
| cost converted currency per platform comparable conversion | metrics.cost_converted_currency_per_platform_comparable_conversion | The cost of the platform comparable conversion in the currency of the authorized customer. | metric · number | Technology | |
| cost micros | metrics.cost_micros | The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. | metric · integer | Technology | Spend |
| cost micros change point estimate | metrics.cost_micros_change_point_estimate | The point estimate when estimating the experiment's effect on cost change. Together with cost_micros_margin_of_error, they describe a confidence interval with a prescribed confidence level for the difference being estimated. The quantity being estimated is (treatment / control - 1). This field specifies the point estimate, which is the center of the confidence interval: (cost_micros_change_point_estimate - cost_micros_margin_of_error, cost_micros_change_point_estimate + cost_micros_margin_of_error). | metric · number | Technology | |
| cost micros margin of error | metrics.cost_micros_margin_of_error | The margin of error when estimating the experiment's effect on cost. Together with cost_micros_change_point_estimate, they describe a confidence interval with a prescribed confidence level for the difference being estimated. The quantity being estimated is (treatment / control - 1). This field specifies the radius of the confidence interval, which is centered at cost_micros_change_point_estimate. | metric · number | Technology | |
| cost micros p value | metrics.cost_micros_p_value | The p-value for the null hypothesis that the experiment has no effect on cost. Ranges from 0 to 1. Say if the p-value is 0.03, that means the probability of observing the data, if the experiment has no effect on cost, is 3%. | metric · number | Technology | |
| cost of goods sold micros | metrics.cost_of_goods_sold_micros | 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. | metric · integer | Technology | |
| cost per all conversions | metrics.cost_per_all_conversions | The cost of ad interactions divided by all conversions. | metric · number | Technology | |
| cost per conversion | metrics.cost_per_conversion | 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. | metric · number | Technology | |
| cost per conversion change point estimate | metrics.cost_per_conversion_change_point_estimate | The point estimate when estimating the experiment's effect on cost per conversion change. Together with cost_per_conversion_margin_of_error, they describe a confidence interval with a prescribed confidence level for the difference being estimated. The quantity being estimated is (treatment / control - 1). This field specifies the point estimate, which is the center of the confidence interval: (cost_per_conversion_change_point_estimate - cost_per_conversion_margin_of_error, cost_per_conversion_change_point_estimate + cost_per_conversion_margin_of_error). | metric · number | Technology | |
| cost per conversion margin of error | metrics.cost_per_conversion_margin_of_error | The margin of error when estimating the experiment's effect on cost per conversion. Together with cost_per_conversion_change_point_estimate, they describe a confidence interval with a prescribed confidence level for the difference being estimated. The quantity being estimated is (treatment / control - 1). This field specifies the radius of the confidence interval, which is centered at cost_per_conversion_change_point_estimate. | metric · number | Technology | |
| cost per conversion p value | metrics.cost_per_conversion_p_value | The p-value for the null hypothesis that the experiment has no effect on cost per conversion. Ranges from 0 to 1. Say if the p-value is 0.03, that means the probability of observing the data, if the experiment has no effect on cost per conversion, is 3%. | metric · number | Technology | |
| cost per current model attributed conversion | metrics.cost_per_current_model_attributed_conversion | 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. | metric · number | Technology | |
| cost per incremental conversion | metrics.cost_per_incremental_conversion | The estimated cost incurred for each additional conversion generated by the campaign. This is the Incremental Cost Per Acquisition (iCPA). | metric · number | Technology | |
| cost per incremental conversion p90 lower bound | metrics.cost_per_incremental_conversion_p90_lower_bound | The lower bound of the 90% confidence interval for cost_per_incremental_conversion. The lowest likely cost you paid per incremental conversion. | metric · number | Technology | |
| cost per incremental conversion p90 upper bound | metrics.cost_per_incremental_conversion_p90_upper_bound | The upper bound of the 90% confidence interval for cost_per_incremental_conversion. The highest likely cost you paid per incremental conversion. | metric · number | Technology | |
| cost per incremental conversion winner score | metrics.cost_per_incremental_conversion_winner_score | The probability that this experiment arm is the winner for cost per incremental conversion. This value is between 0.0 and 1.0. | metric · number | Technology | |
| cost per lifted cookie | metrics.cost_per_lifted_cookie | The estimated cost incurred for each additional person moved to a positive brand state by the campaign. Helps assess the cost-effectiveness of your ad spend in driving brand growth. | metric · number | Technology | |
| cost per lifted cookie p90 lower bound | metrics.cost_per_lifted_cookie_p90_lower_bound | Lower bound of the 90% confidence interval for the cost per lifted cookie. Represents the optimistic (lowest cost) estimate for moving a user to a positive brand state. | metric · number | Technology | |
| cost per lifted cookie p90 upper bound | metrics.cost_per_lifted_cookie_p90_upper_bound | Upper bound of the 90% confidence interval for the cost per lifted cookie. Represents the conservative (highest cost) estimate for moving a user to a positive brand state. | metric · number | Technology | |
| cost per platform comparable conversion | metrics.cost_per_platform_comparable_conversion | The cost of ad interactions divided by the number of platform comparable conversions. This only includes conversion actions for which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. | metric · number | Technology | |
| cross device conversions | metrics.cross_device_conversions | 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. | metric · number | Technology | |
| cross device conversions value | metrics.cross_device_conversions_value | The sum of the value of cross-device conversions. | metric · number | Technology | |
| cross device conversions value micros | metrics.cross_device_conversions_value_micros | The sum of the value of cross-device conversions, in micros. | metric · integer | Technology | |
| cross sell cost of goods sold micros | metrics.cross_sell_cost_of_goods_sold_micros | 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. | metric · integer | Technology | |
| cross sell gross profit micros | metrics.cross_sell_gross_profit_micros | 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. | metric · integer | Technology | |
| cross sell revenue micros | metrics.cross_sell_revenue_micros | 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. | metric · integer | Technology | |
| cross sell units sold | metrics.cross_sell_units_sold | 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. | metric · number | Technology | |
| current model attributed conversions value per cost | metrics.current_model_attributed_conversions_value_per_cost | 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. | metric · number | Technology | |
| gross profit margin | metrics.gross_profit_margin | 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. | metric · number | Technology | |
| gross profit micros | metrics.gross_profit_micros | 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. | metric · integer | Technology | |
| hotel average lead value micros | metrics.hotel_average_lead_value_micros | Average lead value based on clicks. | metric · number | Technology | |
| hotel commission rate micros | metrics.hotel_commission_rate_micros | Commission bid rate in micros. A 20% commission is represented as 200,000. | metric · integer | Technology | |
| hotel expected commission cost | metrics.hotel_expected_commission_cost | Expected commission cost. The result of multiplying the commission value times the hotel_commission_rate in advertiser currency. | metric · number | Technology | |
| incremental conversion value per cost | metrics.incremental_conversion_value_per_cost | The incremental return on ad spend (iROAS), calculated as the additional conversion value generated per unit of campaign cost. Measures the return on your ad spend in terms of incremental value. | metric · number | Technology | |
| incremental conversion value per cost p90 lower bound | metrics.incremental_conversion_value_per_cost_p90_lower_bound | The lower bound of the 90% confidence interval for incremental conversion value per cost. The "Guaranteed" return. Even if the data is noisy, you can be 90% sure your return was at least this high. | metric · number | Technology | |
| incremental conversion value per cost p90 upper bound | metrics.incremental_conversion_value_per_cost_p90_upper_bound | The upper bound of the 90% confidence interval for incremental conversion value per cost. The "Potential" return. The maximum likely revenue generated for every dollar spent. | metric · number | Technology | |
| incremental conversion value per cost winner score | metrics.incremental_conversion_value_per_cost_winner_score | The probability that this experiment arm is the winner for incremental conversion value per cost. This value is between 0.0 and 1.0. | metric · number | Technology | |
| lead cost of goods sold micros | metrics.lead_cost_of_goods_sold_micros | 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. | metric · integer | Technology | |
| lead gross profit micros | metrics.lead_gross_profit_micros | 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. | metric · integer | Technology | |
| lead revenue micros | metrics.lead_revenue_micros | 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. | metric · integer | Technology | |
| mobile friendly clicks percentage | metrics.mobile_friendly_clicks_percentage | The percentage of mobile clicks that go to a mobile-friendly page. | metric · number | Technology | |
| normalized incremental searches per cost | metrics.normalized_incremental_searches_per_cost | The estimated number of incremental search queries generated per unit of ad spend (in advertiser currency). Measures the cost efficiency of the campaign in driving search behavior. Only reported when lift is statistically positive. | metric · number | Technology | |
| normalized incremental searches per cost p90 lower bound | metrics.normalized_incremental_searches_per_cost_p90_lower_bound | The lower bound of the 90% confidence interval for normalized incremental searches per cost. | metric · number | Technology | |
| normalized incremental searches per cost p90 upper bound | metrics.normalized_incremental_searches_per_cost_p90_upper_bound | The upper bound of the 90% confidence interval for normalized incremental searches per cost. | metric · number | Technology | |
| platform comparable conversions | metrics.platform_comparable_conversions | The number of platform comparable conversions. This only includes conversion actions for which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. | metric · number | Technology | |
| platform comparable conversions from interactions rate | metrics.platform_comparable_conversions_from_interactions_rate | Platform comparable 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 for which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. | metric · number | Technology | |
| platform comparable conversions from interactions value per interaction | metrics.platform_comparable_conversions_from_interactions_value_per_interaction | The value of platform comparable conversions from interactions divided by the number of ad interactions. This only includes conversion actions for which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. | metric · number | Technology | |
| platform comparable conversions value | metrics.platform_comparable_conversions_value | The value of platform comparable 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. | metric · number | Technology | |
| platform comparable conversions value per cost | metrics.platform_comparable_conversions_value_per_cost | The value of conversions divided by the cost of ad interactions. This only includes conversion actions for which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. | metric · number | Technology | |
| revenue micros | metrics.revenue_micros | 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. | metric · integer | Technology | |
| search budget lost absolute top impression share | metrics.search_budget_lost_absolute_top_impression_share | The estimated percentage of times your ad wasn't the very first ad among the top ads in the 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. | metric · number | Technology | |
| search budget lost impression share | metrics.search_budget_lost_impression_share | The estimated percentage 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. | metric · number | Technology | |
| search budget lost top impression share | metrics.search_budget_lost_top_impression_share | The estimated percentage of times that your ad didn't show adjacent to the top 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. | metric · number | Technology | |
| search lift cost micros | metrics.search_lift_cost_micros | The total cost (in micros) of ad impressions served for this Search Lift measurement slice during the study flight. One million is equivalent to one unit of currency. | metric · integer | Technology | |
| search rank lost absolute top impression share | metrics.search_rank_lost_absolute_top_impression_share | The estimated percentage of times your ad wasn't the very first ad among the top ads in the 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. | metric · number | Technology | |
| search rank lost impression share | metrics.search_rank_lost_impression_share | The 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. | metric · number | Technology | |
| search rank lost top impression share | metrics.search_rank_lost_top_impression_share | The estimated percentage of times your ad didn't show adjacent to the top 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. | metric · number | Technology | |
| valid accelerated mobile pages clicks percentage | metrics.valid_accelerated_mobile_pages_clicks_percentage | The percentage of ad clicks to Accelerated Mobile Pages (AMP) landing pages that reach a valid AMP page. | metric · number | Technology | |
| value per platform comparable conversion | metrics.value_per_platform_comparable_conversion | The value of platform comparable conversions divided by the number of platform comparable conversions. This only includes conversion actions for which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. | metric · number | Technology | |
| vertical ads average booking value micros | metrics.vertical_ads_average_booking_value_micros | Click-weighted average daily rate in micros, including taxes and fees, over the total length of stay. | metric · integer | Technology | |
| device | segments.device | Device to which metrics apply. | dimension · string | Technology | |
| mobile device platform | segments.mobile_device_platform | Mobile device platform to which metrics apply. | dimension · string | Technology | |
| product language | segments.product_language | Resource name of the language constant for the language of the product. | dimension · string | Technology | |
| sk ad network postback sequence index | segments.sk_ad_network_postback_sequence_index | iOS Store Kit Ad Network postback sequence index. | dimension · integer | Technology | |
| commission rate micros | campaign.commission.commission_rate_micros | Commission rate defines the portion of the conversion value that the advertiser will be billed. A commission rate of x should be passed into this field as (x * 1,000,000). For example, 106,000 represents a commission rate of 0.106 (10.6%). | dimension · integer | Technology | |
| language code | campaign.dynamic_search_ads_setting.language_code | Required. The language code specifying the language of the domain, for example, "en". | dimension · string | Technology | |
| target cpa micros | campaign.maximize_conversions.target_cpa_micros | The target cost-per-action (CPA) option. This is the average amount that you would like to spend per conversion action specified in micro units of the bidding strategy's currency. If set, the bid strategy will get as many conversions as possible at or below the target cost-per-action. If the target CPA is not set, the bid strategy will aim to achieve the lowest possible CPA given the budget. | dimension · integer | Technology | |
| cpc bid ceiling micros | campaign.percent_cpc.cpc_bid_ceiling_micros | Maximum bid limit that can be set by the bid strategy. This is an optional field entered by the advertiser and specified in local micros. Note: A zero value is interpreted in the same way as having bid_ceiling undefined. | dimension · integer | Technology | |
| cpc bid ceiling micros | campaign.target_cpa.cpc_bid_ceiling_micros | Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies. | dimension · integer | Technology | |
| cpc bid floor micros | campaign.target_cpa.cpc_bid_floor_micros | Minimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies. | dimension · integer | Technology | |
| target cpa micros | campaign.target_cpa.target_cpa_micros | Average CPA target. This target should be greater than or equal to minimum billable unit based on the currency for the account. | dimension · integer | Technology | |
| target cpc micros | campaign.target_cpc.target_cpc_micros | Average CPC target. This target should be greater than or equal to minimum billable unit based on the currency for the account. | dimension · integer | Technology | |
| cpc bid ceiling micros | campaign.target_impression_share.cpc_bid_ceiling_micros | The highest CPC bid the automated bidding system is permitted to specify. This is a required field entered by the advertiser that sets the ceiling and specified in local micros. | dimension · integer | Technology | |
| cpc bid ceiling micros | campaign.target_roas.cpc_bid_ceiling_micros | Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies. | dimension · integer | Technology | |
| cpc bid floor micros | campaign.target_roas.cpc_bid_floor_micros | Minimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies. | dimension · integer | Technology | |
| cpc bid ceiling micros | campaign.target_spend.cpc_bid_ceiling_micros | Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. | dimension · integer | Technology | |
| target spend micros | campaign.target_spend.target_spend_micros | Deprecated: The spend target under which to maximize clicks. A TargetSpend bidder will attempt to spend the smaller of this value or the natural throttling spend amount. If not specified, the budget is used as the spend target. This field is deprecated and should no longer be used. See https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html for details. | dimension · integer | Technology | |
| alcohol | campaign.video_campaign_settings.reservation_ad_category_self_disclosure.alcohol | The campaign is expected to contain alcohol-related ads. | dimension · boolean | Technology | |
| gambling | campaign.video_campaign_settings.reservation_ad_category_self_disclosure.gambling | The campaign is expected to contain gambling-related ads. | dimension · boolean | Technology | |
| politics | campaign.video_campaign_settings.reservation_ad_category_self_disclosure.politics | The campaign is expected to contain politics-related ads. | dimension · boolean | Technology | |
| cpc bid micros | ad_group.cpc_bid_micros | The maximum CPC (cost-per-click) bid. This field is used when the ad group's effective bidding strategy is Manual CPC. This field is not applicable and will be ignored if the ad group's campaign is using a portfolio bidding strategy. | dimension · integer | Technology | |
| cpm bid micros | ad_group.cpm_bid_micros | The maximum CPM (cost-per-thousand viewable impressions) bid. | dimension · integer | Technology | |
| cpv bid micros | ad_group.cpv_bid_micros | The CPV (cost-per-view) bid. | dimension · integer | Technology | |
| effective cpc bid micros | ad_group.effective_cpc_bid_micros | Output only. Value will be same as that of the CPC (cost-per-click) bid value when the bidding strategy is one of manual cpc, enhanced cpc, page one promoted or target outrank share, otherwise the value will be null. | dimension · integer | Technology | |
| effective target cpa micros | ad_group.effective_target_cpa_micros | Output only. The effective target CPA (cost-per-acquisition). This field is read-only. | dimension · integer | Technology | |
| fixed cpm micros | ad_group.fixed_cpm_micros | The fixed amount in micros that the advertiser pays for every thousand impressions of the ad. | dimension · integer | Technology | |
| percent cpc bid micros | ad_group.percent_cpc_bid_micros | The percent cpc bid amount, expressed as a fraction of the advertised price for some good or service. The valid range for the fraction is [0,1) and the value stored here is 1,000,000 * [fraction]. | dimension · integer | Technology | |
| target cpa micros | ad_group.target_cpa_micros | The target CPA (cost-per-acquisition). If the ad group's campaign bidding strategy is TargetCpa or MaximizeConversions (with its target_cpa field set), then this field overrides the target CPA specified in the campaign's bidding strategy. Otherwise, this value is ignored. | dimension · integer | Technology | |
| target cpc micros | ad_group.target_cpc_micros | Average amount in micros that the advertiser is willing to pay for every ad click. Overrides the target CPC configured at the campaign level. | dimension · integer | Technology | |
| target cpm micros | ad_group.target_cpm_micros | Average amount in micros that the advertiser is willing to pay for every thousand times the ad is shown. | dimension · integer | Technology | |
| target cpv micros | ad_group.target_cpv_micros | Average amount in micros that the advertiser is willing to pay for every ad view. | dimension · integer | Technology | |
| cross account conversion tracking id | customer.conversion_tracking_setting.cross_account_conversion_tracking_id | Output only. The conversion tracking id of the customer's manager. This is set when the customer is opted into cross account conversion tracking, and it overrides conversion_tracking_id. This field can only be managed through the Google Ads UI. This field is read-only. | dimension · integer | Technology | |
| youtube videos | ad_group_ad.ad.app_ad.youtube_videos | List of YouTube video assets that may be displayed with the ad. | dimension · string | Technology | |
| asset | ad_group_ad.ad.app_ad.youtube_videos.asset | The Asset resource name of this video. | dimension · string | Technology | |
| videos | ad_group_ad.ad.app_engagement_ad.videos | List of video assets that may be displayed with the ad. | dimension · string | Technology | |
| asset | ad_group_ad.ad.app_engagement_ad.videos.asset | The Asset resource name of this video. | dimension · string | Technology | |
| youtube videos | ad_group_ad.ad.app_pre_registration_ad.youtube_videos | List of YouTube video asset IDs whose videos may be displayed with the ad. | dimension · string | Technology | |
| asset | ad_group_ad.ad.app_pre_registration_ad.youtube_videos.asset | The Asset resource name of this video. | dimension · string | Technology | |
| videos | ad_group_ad.ad.demand_gen_video_responsive_ad.videos | Required. List of YouTube video assets used for the ad. | dimension · string | Technology | |
| asset | ad_group_ad.ad.demand_gen_video_responsive_ad.videos.asset | The Asset resource name of this video. | dimension · string | Technology | |
| device preference | ad_group_ad.ad.device_preference | 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. | dimension · string | Technology | |
| final mobile urls | ad_group_ad.ad.final_mobile_urls | The list of possible final mobile URLs after all cross-domain redirects for the ad. | dimension · string | Technology | |
| videos | ad_group_ad.ad.local_ad.videos | List of YouTube video assets that may be displayed with the ad. At least 1 and at most 20 video assets must be specified. | dimension · string | Technology | |
| asset | ad_group_ad.ad.local_ad.videos.asset | The Asset resource name of this video. | dimension · string | Technology | |
| youtube videos | ad_group_ad.ad.responsive_display_ad.youtube_videos | Optional YouTube videos for the ad. A maximum of 5 videos can be specified. | dimension · string | Technology | |
| asset | ad_group_ad.ad.responsive_display_ad.youtube_videos.asset | The Asset resource name of this video. | dimension · string | Technology | |
| videos | ad_group_ad.ad.video_responsive_ad.videos | Required. List of YouTube video assets used for the ad. Currently, only a single value for the YouTube video asset is supported. | dimension · string | Technology | |
| asset | ad_group_ad.ad.video_responsive_ad.videos.asset | The Asset resource name of this video. | dimension · string | Technology |
Time
| Name | API field | Description | Type | Group | Cross-channel |
|---|---|---|---|---|---|
| all conversions by conversion date | metrics.all_conversions_by_conversion_date | 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 Understand conversions by time with new columns. | metric · number | Time | |
| all conversions value by conversion date | metrics.all_conversions_value_by_conversion_date | 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 Understand conversions by time with new columns. | metric · number | Time | |
| conversion last conversion date | metrics.conversion_last_conversion_date | The date of the most recent conversion for this conversion action. The date is in the customer's time zone. | metric · date | Time | |
| conversion last received request date time | metrics.conversion_last_received_request_date_time | The 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 (for example, 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. | metric · date | Time | |
| conversions by conversion date | metrics.conversions_by_conversion_date | 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 Understand conversions by time with new columns. | metric · number | Time | |
| conversions value by conversion date | metrics.conversions_value_by_conversion_date | 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 Understand conversions by time with new columns. | metric · number | Time | |
| cross device conversions by conversion date | metrics.cross_device_conversions_by_conversion_date | The number of cross-device conversions by conversion date. Details for the by_conversion_date columns are available at Understand conversions by time with new columns | metric · number | Time | |
| cross device conversions value by conversion date | metrics.cross_device_conversions_value_by_conversion_date | The sum of cross-device conversions value by conversion date. Details for the by_conversion_date columns are available at Understand conversions by time with new columns | metric · number | Time | |
| platform comparable conversions by conversion date | metrics.platform_comparable_conversions_by_conversion_date | The number of platform comparable conversions. When this metric is segmented by date, the values in the date segment represent the conversion date. This only includes conversion actions for which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. | metric · number | Time | |
| platform comparable conversions value by conversion date | metrics.platform_comparable_conversions_value_by_conversion_date | The value of platform comparable conversions. When this metric is segmented by date, the values in the date segment represent the conversion date. This only includes conversion actions for which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. | metric · number | Time | |
| value per all conversions by conversion date | metrics.value_per_all_conversions_by_conversion_date | 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 Understand conversions by time with new columns. | metric · number | Time | |
| value per conversions by conversion date | metrics.value_per_conversions_by_conversion_date | The value of conversions divided by the number of conversions. This only includes conversion actions for which the 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 Understand conversions by time with new columns. | metric · number | Time | |
| value per platform comparable conversions by conversion date | metrics.value_per_platform_comparable_conversions_by_conversion_date | The value of platform comparable conversions divided by the number of platform comparable conversions. When this metric is segmented by date, the values in the date segment represent the conversion date. This only includes conversion actions for which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. | metric · number | Time | |
| conversion lift end date | segments.conversion_lift_end_date | The end date of the period for which these Conversion Lift results are calculated. This can differ from the overall Study End Time. | dimension · integer | Time | |
| conversion lift start date | segments.conversion_lift_start_date | The start date of the period for which these Conversion Lift results are calculated. This can differ from the overall Study Start Time. | dimension · integer | Time | |
| date · Synced today | segments.date | Date to which metrics apply. yyyy-MM-dd format, for example, 2018-04-17. | dimension · date | Time | |
| day of week | segments.day_of_week | Day of the week, for example, MONDAY. | dimension · string | Time | |
| hotel booking window days | segments.hotel_booking_window_days | Hotel booking window in days. | dimension · integer | Time | |
| hotel check in date | segments.hotel_check_in_date | Hotel check-in date. Formatted as yyyy-MM-dd. | dimension · date | Time | |
| hotel check in day of week | segments.hotel_check_in_day_of_week | Hotel check-in day of week. | dimension · string | Time | |
| hotel date selection type | segments.hotel_date_selection_type | Hotel date selection type. | dimension · string | Time | |
| hour | segments.hour | Hour of day as a number between 0 and 23, inclusive. | dimension · string | Time | |
| month | segments.month | Month as represented by the date of the first day of a month. Formatted as yyyy-MM-dd. | dimension · date | Time | |
| month of year | segments.month_of_year | Month of the year, for example, January. | dimension · string | Time | |
| start date | segments.start_date | Start date of the booking. Formatted as yyyy-MM-dd. | dimension · date | Time | |
| start day of week | segments.start_day_of_week | Start day of week of the booking. | dimension · string | Time | |
| user set dates | segments.user_set_dates | Indicates whether user-specified dates were selected. | dimension · string | Time | |
| week | segments.week | Week as defined as Monday through Sunday, and represented by the date of Monday. Formatted as yyyy-MM-dd. | dimension · date | Time | |
| year | segments.year | Year, formatted as yyyy. | dimension · string | Time | |
| aca migration date time | campaign.aca_migration_date_time | Output only. The timestamp when the ACA campaign was migrated to AI Max. The timestamp is in the customer's timezone and in "yyyy-MM-dd HH:mm:ss" format. | dimension · date | Time | |
| broad match migration date time | campaign.broad_match_migration_date_time | Output only. The timestamp when the Broad Match campaign was migrated to AI Max. The timestamp is in the customer's timezone and in "yyyy-MM-dd HH:mm:ss" format. | dimension · date | Time | |
| end date time | campaign.end_date_time | The last day and time of the campaign in serving customer's timezone in "yyyy-MM-dd HH:mm:ss" format. Set the time component to 23:59:59 for daily granularity, time granularity is only supported for some campaign types. On create, defaults to running indefinitely. To set an existing campaign to run indefinitely, clear this field. | dimension · date | Time | |
| founding year | campaign.pmax_campaign_settings.local_services_pmax_campaign_settings.founding_year | Founding year of the business. | dimension · integer | Time | |
| start date time | campaign.start_date_time | The date and time when campaign started in serving. The timestamp is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss" format. Set the time component to 00:00:00 for daily granularity, time granularity is only supported for some campaign types. | dimension · date | Time | |
| cancellation date time | campaign.video_campaign_settings.booking_details.cancellation_date_time | Output only. Time when the booked inventory of this campaign will be cancelled or has been cancelled. Available for primary status NOT_ELIGIBLE if the campaign will be cancelled and for primary status reason BOOKING_CANCELLED. Format is "yyyy-MM-dd HH:mm:ss" in the customer's time zone. | dimension · date | Time | |
| hold expiration date time | campaign.video_campaign_settings.booking_details.hold_expiration_date_time | Output only. Time until which booked inventory will be held or has been held for this campaign. Available for status HELD and HOLD_EXPIRED. Format is "yyyy-MM-dd HH:mm:ss" in the customer's time zone. | dimension · date | Time | |
| image asset auto migration done date time | customer.image_asset_auto_migration_done_date_time | Output only. Timestamp of migration from feed based image to asset base image in yyyy-MM-dd HH:mm:ss format. | dimension · date | Time | |
| location asset auto migration done date time | customer.location_asset_auto_migration_done_date_time | Output only. Timestamp of migration from feed based location to asset base location in yyyy-MM-dd HH:mm:ss format. | dimension · date | Time | |
| source | ad_group_ad.ad.synthetic_content_info.advertiser_attestation.source | The source of the synthetic content attestation. | dimension · string | Time | |
| status | ad_group_ad.ad.synthetic_content_info.advertiser_attestation.status | Indicates whether the content is considered synthetic by this source. | dimension · string | Time | |
| source | ad_group_ad.ad.synthetic_content_info.system_attestation.source | The source of the synthetic content attestation. | dimension · string | Time | |
| status | ad_group_ad.ad.synthetic_content_info.system_attestation.status | Indicates whether the content is considered synthetic by this source. | dimension · string | Time | |
| end date time | ad_group_ad.end_date_time | The last day and time when ad group ad serves. This is added on top of the campaign's end date and time, if present, to further restrict the duration of an ad group ad. The timestamp is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss" format. Only supported for some ad types. | dimension · date | Time | |
| start date time | ad_group_ad.start_date_time | The date and time when ad group ad starts serving. This is added on top of the campaign's start date and time, if present, to further restrict the duration of an ad group ad. The timestamp is in the customer's time zone and in "yyyy-MM-dd HH:mm:ss" format. Only supported for some ad types. | dimension · date | Time |
Traffic
| Name | API field | Description | Type | Group | Cross-channel |
|---|---|---|---|---|---|
| clicks unique query clusters | metrics.clicks_unique_query_clusters | Unique query intent cluster count for clicks. | metric · integer | Traffic | |
| combined clicks per query | metrics.combined_clicks_per_query | The number of times your ad or your site's listing in the unpaid results was clicked (combined_clicks) divided by combined_queries. See About measuring paid and organic search results for details. | metric · number | Traffic | |
| conversions unique query clusters | metrics.conversions_unique_query_clusters | Unique query intent cluster count for conversions. | metric · integer | Traffic | |
| impressions unique query clusters | metrics.impressions_unique_query_clusters | Unique query intent cluster count for impressions. | metric · integer | Traffic | |
| organic clicks per query | metrics.organic_clicks_per_query | The 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 About measuring paid and organic search results. | metric · number | Traffic | |
| organic impressions per query | metrics.organic_impressions_per_query | The 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 About measuring paid and organic search results. | metric · number | Traffic | |
| campaign | segments.budget_campaign_association_status.campaign | The campaign resource name. | dimension · string | Traffic | |
| status | segments.budget_campaign_association_status.status | Budget campaign association status. | dimension · string | Traffic | |
| campaign | segments.campaign | Resource name of the campaign. | dimension · string | Traffic | |
| external conversion source | segments.external_conversion_source | External conversion source. | dimension · string | Traffic | |
| ad group criterion | segments.keyword.ad_group_criterion | The AdGroupCriterion resource name. | dimension · string | Traffic | |
| match type | segments.keyword.info.match_type | The match type of the keyword. | dimension · string | Traffic | |
| text | segments.keyword.info.text | The text of the keyword (at most 80 characters and 10 words). | dimension · string | Traffic | |
| landing page source | segments.landing_page_source | The source of a landing page in the landing page report. | dimension · string | Traffic | |
| product channel | segments.product_channel | Channel of the product. | dimension · string | Traffic | |
| product channel exclusivity | segments.product_channel_exclusivity | Channel exclusivity of the product. | dimension · string | Traffic | |
| search lift keyword bundle | segments.search_lift_keyword_bundle | The Search Lift Keyword Bundle resource name. | dimension · string | Traffic | |
| search term match source | segments.search_term_match_source | Specifies the source for how the search term was matched, which reveals the type of ad campaign responsible. Use this to distinguish between automated campaigns (like AI Max, Dynamic Search Ads) and keyword-based campaigns (Standard). | dimension · string | Traffic | |
| sk ad network source app id | segments.sk_ad_network_source_app.sk_ad_network_source_app_id | App id where the ad that drove the iOS Store Kit Ad Network install was shown. | dimension · string | Traffic | |
| sk ad network source domain | segments.sk_ad_network_source_domain | Website where the ad that drove the iOS Store Kit Ad Network install was shown. Null value means this segment is not applicable, for example, non-iOS campaign, or was not present in any postbacks sent by Apple. | dimension · string | Traffic | |
| sk ad network source type | segments.sk_ad_network_source_type | The source type where the ad that drove the iOS Store Kit Ad Network install was shown. Null value means this segment is not applicable, for example, non-iOS campaign, or neither source domain nor source app were present in any postbacks sent by Apple. | dimension · string | Traffic | |
| accessible bidding strategy | campaign.accessible_bidding_strategy | Output only. Resource name of AccessibleBiddingStrategy, a read-only view of the unrestricted attributes of the attached portfolio bidding strategy identified by 'bidding_strategy'. Empty, if the campaign does not use a portfolio strategy. Unrestricted strategy attributes are available to all customers with whom the strategy is shared and are read from the AccessibleBiddingStrategy resource. In contrast, restricted attributes are only available to the owner customer of the strategy and their managers. Restricted attributes can only be read from the BiddingStrategy resource. | dimension · string | Traffic | |
| ad serving optimization status | campaign.ad_serving_optimization_status | The ad serving optimization status of the campaign. | dimension · string | Traffic | |
| advertising channel sub type | campaign.advertising_channel_sub_type | Immutable. Optional refinement to advertising_channel_type. Must be a valid sub-type of the parent channel type. Can be set only when creating campaigns. After campaign is created, the field can not be changed. | dimension · string | Traffic | |
| advertising channel type | campaign.advertising_channel_type | Immutable. The primary serving target for ads within the campaign. The targeting options can be refined in network_settings. This field is required and should not be empty when creating new campaigns. Can be set only when creating campaigns. After the campaign is created, the field can not be changed. | dimension · string | Traffic | |
| bundling required | campaign.ai_max_setting.bundling_required | Output only. Search campaigns only. Indicates whether a campaign has adopted AI Max before, and is required to have AI Max enabled to adopt campaign-level text asset automation and brand list targeting in all API versions. | dimension · string | Traffic | |
| enable ai max | campaign.ai_max_setting.enable_ai_max | Controls whether or not AI Max features are served for this campaign. Individual AI Max features are enabled or disabled by their respective settings. But if enable_ai_max is set to false or cleared, then no AI Max features will serve for this campaign, regardless of the other settings. Supported in Search and Shopping campaigns. For Search campaigns, Search Term Matching is enabled by default when AI Max is enabled, and can be disabled at the ad group level. For Shopping campaigns, Text customization is always enabled when AI Max is enabled. | dimension · boolean | Traffic | |
| app id | campaign.app_campaign_setting.app_id | Immutable. A string that uniquely identifies a mobile application. | dimension · string | Traffic | |
| app store | campaign.app_campaign_setting.app_store | Immutable. The application store that distributes this specific app. | dimension · string | Traffic | |
| bidding strategy goal type | campaign.app_campaign_setting.bidding_strategy_goal_type | Represents the goal which the bidding strategy of this app campaign should optimize towards. | dimension · string | Traffic | |
| asset automation settings | campaign.asset_automation_settings | Contains the opt-in/out status of each AssetAutomationType. See documentation of each asset automation type enum for default opt in/out behavior. | dimension · string | Traffic | |
| use audience grouped | campaign.audience_setting.use_audience_grouped | Immutable. If true, this campaign uses an Audience resource for audience targeting. If false, this campaign may use audience segment criteria instead. | dimension · boolean | Traffic | |
| base campaign | campaign.base_campaign | Output only. The resource name of the base campaign of a draft or experiment campaign. For base campaigns, this is equal to resource_name. This field is read-only. | dimension · string | Traffic | |
| bidding strategy | campaign.bidding_strategy | The resource name of the portfolio bidding strategy used by the campaign. | dimension · string | Traffic | |
| bidding strategy system status | campaign.bidding_strategy_system_status | Output only. The system status of the campaign's bidding strategy. | dimension · string | Traffic | |
| bidding strategy type | campaign.bidding_strategy_type | Output only. The type of bidding strategy. A bidding strategy can be created by setting either the bidding scheme to create a standard bidding strategy or the bidding_strategy field to create a portfolio bidding strategy. This field is read-only. | dimension · string | Traffic | |
| accent color | campaign.brand_guidelines.accent_color | The accent brand color, entered as a hex code (e.g., #00ff00). You must provide the accent_color if you provide a main_color. | dimension · string | Traffic | |
| main color | campaign.brand_guidelines.main_color | The main brand color, entered as a hex code (e.g., #00ff00). You must provide the main_color if you provide an accent_color. | dimension · string | Traffic | |
| predefined font family | campaign.brand_guidelines.predefined_font_family | The brand's font family. Must be one of the following Google Fonts (case sensitive): Open Sans, Roboto, Montserrat, Poppins, Lato, Oswald, Playfair Display, Roboto Slab. | dimension · string | Traffic | |
| brand guidelines enabled | campaign.brand_guidelines_enabled | Immutable. Whether Brand Guidelines are enabled for this Campaign. Only applicable to Performance Max campaigns. If enabled, business name and logo assets must be linked as CampaignAssets instead of AssetGroupAssets. Writable only at campaign creation. Set to true to enable Brand Guidelines when creating a new Performance Max campaign. Immutable after creation. This field cannot be modified using standard update operations after the campaign has been created. For existing campaigns: To enable Brand Guidelines on a campaign after it has been created, use the CampaignService.EnablePMaxBrandGuidelines method, which is a separate operation. It is not possible to disable Brand Guidelines for an existing campaign. Incompatible with Travel Goals: This feature is not supported for Performance Max campaigns with Travel Goals. Attempting to set this field to true for a Travel Goals campaign will result in an error. | dimension · boolean | Traffic | |
| campaign budget | campaign.campaign_budget | The resource name of the campaign budget of the campaign. | dimension · string | Traffic | |
| campaign group | campaign.campaign_group | The resource name of the campaign group that this campaign belongs to. | dimension · string | Traffic | |
| contains eu political advertising | campaign.contains_eu_political_advertising | The advertiser should self-declare whether this campaign contains political advertising content targeted towards the European Union. | dimension · string | Traffic | |
| upgraded targeting | campaign.demand_gen_campaign_settings.upgraded_targeting | Immutable. Specifies whether this campaign uses upgraded targeting options. When this field is set to true, you can use location and language targeting at the ad group level as opposed to the standard campaign-level targeting. This field defaults to true, and can only be set when creating a campaign. | dimension · boolean | Traffic | |
| domain name | campaign.dynamic_search_ads_setting.domain_name | Required. The Internet domain name that this setting represents, for example, "google.com" or "www.google.com". | dimension · string | Traffic | |
| use supplied urls only | campaign.dynamic_search_ads_setting.use_supplied_urls_only | Whether the campaign uses advertiser supplied URLs exclusively. | dimension · boolean | Traffic | |
| excluded parent asset field types | campaign.excluded_parent_asset_field_types | The asset field types that should be excluded from this campaign. Asset links with these field types will not be inherited by this campaign from the upper level. | dimension · string | Traffic | |
| excluded parent asset set types | campaign.excluded_parent_asset_set_types | The asset set types that should be excluded from this campaign. Asset set links with these types will not be inherited by this campaign from the upper level. Location group types (GMB_DYNAMIC_LOCATION_GROUP, CHAIN_DYNAMIC_LOCATION_GROUP, and STATIC_LOCATION_GROUP) are child types of LOCATION_SYNC. Therefore, if LOCATION_SYNC is set for this field, all location group asset sets are not allowed to be linked to this campaign, and all Location Extension (LE) and Affiliate Location Extensions (ALE) will not be served under this campaign. Only LOCATION_SYNC is currently supported. | dimension · string | Traffic | |
| experiment type | campaign.experiment_type | Output only. The type of campaign: normal, draft, or experiment. | dimension · string | Traffic | |
| feed types | campaign.feed_types | Output only. Types of feeds that are attached directly to this campaign. | dimension · string | Traffic | |
| final url suffix | campaign.final_url_suffix | Suffix used to append query parameters to landing pages that are served with parallel tracking. | dimension · string | Traffic | |
| goal | campaign.fixed_cpm.goal | Fixed CPM bidding goal. Determines the exact bidding optimization parameters. | dimension · string | Traffic | |
| target count | campaign.fixed_cpm.target_frequency_info.target_count | Target frequency count represents the number of times an advertiser wants to show the ad to target a single user. | dimension · integer | Traffic | |
| time unit | campaign.fixed_cpm.target_frequency_info.time_unit | Time window expressing the period over which you want to reach the specified target_count. | dimension · string | Traffic | |
| frequency caps | campaign.frequency_caps | A list that limits how often each user will see this campaign's ads. | dimension · string | Traffic | |
| hotel property asset set | campaign.hotel_property_asset_set | Immutable. The resource name for a set of hotel properties for Performance Max for travel goals campaigns. | dimension · string | Traffic | |
| disable hotel setting | campaign.hotel_setting.disable_hotel_setting | Disable the optional hotel setting. This field is currently supported only for Demand Gen campaigns. | dimension · boolean | Traffic | |
| hotel center id | campaign.hotel_setting.hotel_center_id | The linked Hotel Center account. | dimension · integer | Traffic | |
| id | campaign.id | Output only. The ID of the campaign. | dimension · integer | Traffic | |
| keyword match type | campaign.keyword_match_type | Keyword match type of Campaign. Set to BROAD to set broad matching for all keywords in a campaign. | dimension · string | Traffic | |
| labels | campaign.labels | Output only. The resource names of labels attached to this campaign. | dimension · string | Traffic | |
| lift measurement config | campaign.lift_measurement_config | Output only. The resource name of the lift measurement configuration for this campaign. This is the most recently linked configuration, which can be active or inactive. If the campaign has run multiple lift experiments, this corresponds to the most recent one. | dimension · string | Traffic | |
| listing type | campaign.listing_type | Immutable. Listing type of ads served for this campaign. Field is restricted for usage with Performance Max and Shopping campaigns. | dimension · string | Traffic | |
| category bids | campaign.local_services_campaign_settings.category_bids | Categorical level bids associated with MANUAL_CPA bidding strategy. | dimension · string | Traffic | |
| manual cpa | campaign.manual_cpa | Standard Manual CPA bidding strategy. Manual bidding strategy that allows advertiser to set the bid per advertiser-specified action. Supported only for Local Services campaigns. | dimension · string | Traffic | |
| enhanced cpc enabled | campaign.manual_cpc.enhanced_cpc_enabled | Whether bids are to be enhanced based on conversion optimizer data. | dimension · boolean | Traffic | |
| manual cpm | campaign.manual_cpm | Standard Manual CPM bidding strategy. Manual impression-based bidding where user pays per thousand impressions. | dimension · string | Traffic | |
| manual cpv | campaign.manual_cpv | A bidding strategy that pays a configurable amount per video view. | dimension · string | Traffic | |
| target roas | campaign.maximize_conversion_value.target_roas | The target return on ad spend (ROAS) option. If set, the bid strategy will maximize revenue while averaging the target return on ad spend. If the target ROAS is high, the bid strategy may not be able to spend the full budget. If the target ROAS is not set, the bid strategy will aim to achieve the highest possible ROAS for the budget. | dimension · number | Traffic | |
| target roas tolerance percent millis | campaign.maximize_conversion_value.target_roas_tolerance_percent_millis | The percent of ROAS(return on advertising spend) degradation tolerance allowed to increase traffic diversity and conversion volume, specified in millis (for example, 10,000 = 10%). A value of 10,000 means that the advertiser can expect ROAS degradation of up to 10% of the specified target ROAS. | dimension · integer | Traffic | |
| missing eu political advertising declaration | campaign.missing_eu_political_advertising_declaration | Output only. Indicates whether this campaign is missing a declaration about whether it contains political advertising targeted towards the EU and is ineligible for any exemptions. If this field is true, use the contains_eu_political_advertising field to add the required declaration. This field is read-only. | dimension · boolean | Traffic | |
| name · Synced today | campaign.name | The name of the campaign. This field is required and should not be empty when creating new campaigns. It must not contain any null (code point 0x0), NL line feed (code point 0xA) or carriage return (code point 0xD) characters. | dimension · string | Traffic | |
| target content network | campaign.network_settings.target_content_network | Whether ads will be served on specified placements in the Google Display Network. Placements are specified using the Placement criterion. | dimension · boolean | Traffic | |
| target google search | campaign.network_settings.target_google_search | Whether ads will be served with google.com search results. | dimension · boolean | Traffic | |
| target google tv network | campaign.network_settings.target_google_tv_network | Whether ads will be served on the Google TV network. | dimension · boolean | Traffic | |
| target partner search network | campaign.network_settings.target_partner_search_network | Whether ads will be served on the partner network. This is available only to some select partner accounts. Unless you have been instructed to use this field, it likely does not apply to your account. This does not control whether ads will be served on Google Search Partners Network; use target_search_network for that instead. | dimension · boolean | Traffic | |
| target search network | campaign.network_settings.target_search_network | Whether ads will be served on sites in the Google Search Partners Network (requires target_google_search to also be true). | dimension · boolean | Traffic | |
| target youtube | campaign.network_settings.target_youtube | Whether ads will be served on YouTube. | dimension · boolean | Traffic | |
| optimization goal types | campaign.optimization_goal_setting.optimization_goal_types | The list of optimization goal types. | dimension · string | Traffic | |
| optimization score | campaign.optimization_score | Output only. Optimization score of the campaign. Optimization score is an estimate of how well a campaign is set to perform. It ranges from 0% (0.0) to 100% (1.0), with 100% indicating that the campaign is performing at full potential. This field is null for unscored campaigns. See "About optimization score" at https://support.google.com/google-ads/answer/9061546. This field is read-only. | dimension · number | Traffic | |
| payment mode | campaign.payment_mode | Payment mode for the campaign. | dimension · string | Traffic | |
| enhanced cpc enabled | campaign.percent_cpc.enhanced_cpc_enabled | Adjusts the bid for each auction upward or downward, depending on the likelihood of a conversion. Individual bids may exceed cpc_bid_ceiling_micros, but the average bid amount for a campaign should not. | dimension · boolean | Traffic | |
| performance max campaign | campaign.performance_max_upgrade.performance_max_campaign | Output only. The resource name of the Performance Max campaign the campaign is upgraded to. | dimension · string | Traffic | |
| pre upgrade campaign | campaign.performance_max_upgrade.pre_upgrade_campaign | Output only. The resource name of the legacy campaign upgraded to Performance Max. | dimension · string | Traffic | |
| status | campaign.performance_max_upgrade.status | Output only. The upgrade status of a campaign requested to be upgraded to Performance Max. | dimension · string | Traffic | |
| ignore exclusions for shopping ads | campaign.pmax_campaign_settings.brand_targeting_overrides.ignore_exclusions_for_shopping_ads | If true, brand exclusions are ignored for Shopping ads. | dimension · boolean | Traffic | |
| local services enabled | campaign.pmax_campaign_settings.local_services_enabled | Immutable. Indicates whether the Performance Max campaign is a Local Services campaign. | dimension · boolean | Traffic | |
| listing id | campaign.pmax_campaign_settings.local_services_pmax_campaign_settings.listing_id | Required. Immutable. Listing ID of the Business Profile linked to the campaign. | dimension · integer | Traffic | |
| navigational query leads enabled | campaign.pmax_campaign_settings.local_services_pmax_campaign_settings.navigational_query_leads_enabled | Whether to use navigational query filter. | dimension · boolean | Traffic | |
| phone numbers | campaign.pmax_campaign_settings.local_services_pmax_campaign_settings.phone_numbers | List of phone numbers associated with the provider. | dimension · string | Traffic | |
| primary status | campaign.primary_status | Output only. The primary status of the campaign. Provides insight into why a campaign is not serving or not serving optimally. Modification to the campaign and its related entities might take a while to be reflected in this status. | dimension · string | Traffic | |
| primary status reasons | campaign.primary_status_reasons | Output only. The primary status reasons of the campaign. Provides insight into why a campaign is not serving or not serving optimally. These reasons are aggregated to determine an overall CampaignPrimaryStatus. | dimension · string | Traffic | |
| opt in | campaign.real_time_bidding_setting.opt_in | Whether the campaign is opted in to real-time bidding. | dimension · boolean | Traffic | |
| resource name | campaign.resource_name | Immutable. The resource name of the campaign. Campaign resource names have the form: customers/{customer_id}/campaigns/{campaign_id} | dimension · string | Traffic | |
| conversion actions | campaign.selective_optimization.conversion_actions | The selected set of resource names for conversion actions for optimizing this campaign. | dimension · string | Traffic | |
| serving status | campaign.serving_status | Output only. The ad serving status of the campaign. | dimension · string | Traffic | |
| advertising partner ids | campaign.shopping_setting.advertising_partner_ids | The list of Google Ads accounts IDs of advertising partners cooperating within the campaign. This feature is currently available only for accounts having an advertising partner link. Once set, the field is immutable. This feature is currently supported only for Performance Max, Shopping, Search and Demand Gen campaign types. | dimension · integer | Traffic | |
| campaign priority | campaign.shopping_setting.campaign_priority | Priority of the campaign. Campaigns with numerically higher priorities take precedence over those with lower priorities. This field is required for Shopping campaigns, with values between 0 and 2, inclusive. This field is optional for Smart Shopping campaigns, but must be equal to 3 if set. | dimension · string | Traffic | |
| disable product feed | campaign.shopping_setting.disable_product_feed | Disable the optional product feed. This field is currently supported only for Demand Gen campaigns. See https://support.google.com/google-ads/answer/13721750 to learn more about this feature. | dimension · boolean | Traffic | |
| enable local | campaign.shopping_setting.enable_local | Whether to include local products. | dimension · boolean | Traffic | |
| feed label | campaign.shopping_setting.feed_label | Feed label of products to include in the campaign. Valid feed labels may contain a maximum of 20 characters including uppercase letters, numbers, hyphens, and underscores. If you previously used the deprecated sales_country in the two-letter country code (XX) format, the feed_label field should be used instead. For more information see the feed label support article. | dimension · string | Traffic | |
| ignore brand exclusion in shopping ads | campaign.shopping_setting.ignore_brand_exclusion_in_shopping_ads | If true, brand exclusions are ignored for Shopping ads. Only supported for Shopping campaigns. | dimension · boolean | Traffic | |
| merchant id | campaign.shopping_setting.merchant_id | ID of the Merchant Center account. This field is required for create operations. This field is immutable for Shopping campaigns. | dimension · integer | Traffic | |
| use vehicle inventory | campaign.shopping_setting.use_vehicle_inventory | Immutable. Whether to target Vehicle Listing inventory. This field is supported only in Smart Shopping Campaigns. For setting Vehicle Listing inventory in Performance Max campaigns, use listing_type instead. | dimension · boolean | Traffic | |
| status | campaign.status | The status of the campaign. When a new campaign is added, the status defaults to ENABLED. | dimension · string | Traffic | |
| target count | campaign.target_cpm.target_frequency_goal.target_count | Target Frequency count representing how many times you want to reach a single user. | dimension · integer | Traffic | |
| time unit | campaign.target_cpm.target_frequency_goal.time_unit | Time window expressing the period over which you want to reach the specified target_count. | dimension · string | Traffic | |
| target cpv | campaign.target_cpv | An automated bidding strategy that sets bids to optimize performance given the target CPV you set. | dimension · string | Traffic | |
| target roas | campaign.target_roas.target_roas | Required. The chosen revenue (based on conversion data) per unit of spend. Value must be between 0.01 and 1000.0, inclusive. | dimension · number | Traffic | |
| target roas tolerance percent millis | campaign.target_roas.target_roas_tolerance_percent_millis | The percent of ROAS(return on advertising spend) degradation tolerance allowed to increase traffic diversity and conversion volume, specified in millis (for example, 10,000 = 10%). A value of 10,000 means that the advertiser can expect ROAS degradation of up to 10% of the specified target ROAS. This field is only mutable for portfolio bidding strategies. | dimension · integer | Traffic | |
| target restrictions | campaign.targeting_setting.target_restrictions | The per-targeting-dimension setting to restrict the reach of your campaign or ad group. | dimension · string | Traffic | |
| messaging restrictions | campaign.text_guidelines.messaging_restrictions | Freeform instructions that will be used to guide text asset generation using LLM inference. At most 40 restrictions may be provided. | dimension · string | Traffic | |
| term exclusions | campaign.text_guidelines.term_exclusions | Exact words or phrases that will be excluded from generated text assets. At most 25 exclusions may be provided. Valid exclusions may contain a maximum of 30 characters. | dimension · string | Traffic | |
| brand lift integration partners | campaign.third_party_integration_partners.brand_lift_integration_partners | Third party integration partners for Brand Lift verification for this Campaign. | dimension · string | Traffic | |
| brand safety integration partners | campaign.third_party_integration_partners.brand_safety_integration_partners | Third party integration partners for brand safety verification for this Campaign. | dimension · string | Traffic | |
| conversion attribution integration partners | campaign.third_party_integration_partners.conversion_attribution_integration_partners | Third party integration partners for YouTube conversion attribution verification for this Campaign. | dimension · string | Traffic | |
| reach integration partners | campaign.third_party_integration_partners.reach_integration_partners | Third party integration partners for reach verification for this Campaign. | dimension · string | Traffic | |
| viewability integration partners | campaign.third_party_integration_partners.viewability_integration_partners | Third party integration partners for YouTube viewability verification for this Campaign. | dimension · string | Traffic | |
| tracking url | campaign.tracking_setting.tracking_url | Output only. The url used for dynamic tracking. | dimension · string | Traffic | |
| tracking url template | campaign.tracking_url_template | The URL template for constructing a tracking URL. | dimension · string | Traffic | |
| travel account id | campaign.travel_campaign_settings.travel_account_id | Immutable. The Travel account ID associated with the Travel campaign. | dimension · integer | Traffic | |
| url custom parameters | campaign.url_custom_parameters | The list of mappings used to substitute custom parameter tags in a tracking_url_template, final_urls, or mobile_final_urls. | dimension · string | Traffic | |
| vanity pharma display url mode | campaign.vanity_pharma.vanity_pharma_display_url_mode | The display mode for vanity pharma URLs. | dimension · string | Traffic | |
| vanity pharma text | campaign.vanity_pharma.vanity_pharma_text | The text that will be displayed in display URL of the text ad when website description is the selected display mode for vanity pharma URLs. | dimension · string | Traffic | |
| status | campaign.video_campaign_settings.booking_details.status | Output only. The status of the booking. | dimension · string | Traffic | |
| format restriction | campaign.video_campaign_settings.video_ad_format_control.format_restriction | All contained responsive ads are expected to respect this restriction. | dimension · string | Traffic | |
| max duration | campaign.video_campaign_settings.video_ad_format_control.non_skippable_in_stream_restrictions.max_duration | The maximum allowed duration for non-skippable ads. | dimension · string | Traffic | |
| min duration | campaign.video_campaign_settings.video_ad_format_control.non_skippable_in_stream_restrictions.min_duration | The minimum allowed duration for non-skippable ads. | dimension · string | Traffic | |
| allow in feed | campaign.video_campaign_settings.video_ad_inventory_control.allow_in_feed | Determine if video responsive ads can be used for in-feed video ads. | dimension · boolean | Traffic | |
| allow in stream | campaign.video_campaign_settings.video_ad_inventory_control.allow_in_stream | Determine if video responsive ads can be used for in-stream video ads. | dimension · boolean | Traffic | |
| allow non skippable in stream | campaign.video_campaign_settings.video_ad_inventory_control.allow_non_skippable_in_stream | Determine if video responsive ads can be used for non-skippable in-stream ads. This is only available for campaigns that allow mixing of non-skippable with other formats (Video reach campaign with Target Frequency bidding strategy goal). | dimension · boolean | Traffic | |
| allow shorts | campaign.video_campaign_settings.video_ad_inventory_control.allow_shorts | Determine if video responsive ads can be used as shorts format. | dimension · boolean | Traffic | |
| minimum duration | campaign.video_campaign_settings.video_ad_sequence.minimum_duration | Users are eligible to repeat sequence after this period. Defaults to WEEK if not specified. | dimension · string | Traffic | |
| steps | campaign.video_campaign_settings.video_ad_sequence.steps | The list of sequence steps and data associated with them. | dimension · string | Traffic | |
| view through conversion optimization enabled | campaign.view_through_conversion_optimization_enabled | Whether VTC (View-through Conversion) optimization is enabled for this campaign. Only allowed for certain Demand Gen and App Campaigns. | dimension · boolean | Traffic | |
| campaign | ad_group.campaign | Immutable. The campaign to which the ad group belongs. | dimension · string | Traffic | |
| channel config | ad_group.demand_gen_ad_group_settings.channel_controls.channel_config | Output only. Channel configuration reflecting which field in the oneof is populated. | dimension · string | Traffic | |
| channel strategy | ad_group.demand_gen_ad_group_settings.channel_controls.channel_strategy | High level channel strategy. | dimension · string | Traffic | |
| discover | ad_group.demand_gen_ad_group_settings.channel_controls.selected_channels.discover | Whether to enable ads on the Discover channel. | dimension · boolean | Traffic | |
| display | ad_group.demand_gen_ad_group_settings.channel_controls.selected_channels.display | Whether to enable ads on the Display channel. | dimension · boolean | Traffic | |
| gmail | ad_group.demand_gen_ad_group_settings.channel_controls.selected_channels.gmail | Whether to enable ads on the Gmail channel. | dimension · boolean | Traffic | |
| maps | ad_group.demand_gen_ad_group_settings.channel_controls.selected_channels.maps | Whether to enable ads on the Maps channel. | dimension · boolean | Traffic | |
| youtube in feed | ad_group.demand_gen_ad_group_settings.channel_controls.selected_channels.youtube_in_feed | Whether to enable ads on the YouTube In-Feed channel. | dimension · boolean | Traffic | |
| youtube in stream | ad_group.demand_gen_ad_group_settings.channel_controls.selected_channels.youtube_in_stream | Whether to enable ads on the YouTube In-Stream channel. | dimension · boolean | Traffic | |
| youtube shorts | ad_group.demand_gen_ad_group_settings.channel_controls.selected_channels.youtube_shorts | Whether to enable ads on the YouTube Shorts channel. | dimension · boolean | Traffic | |
| effective target cpa source | ad_group.effective_target_cpa_source | Output only. Source of the effective target CPA. This field is read-only. | dimension · string | Traffic | |
| effective target cpc source | ad_group.effective_target_cpc_source | Output only. Source of the effective target CPC. This field is read-only. | dimension · string | Traffic | |
| effective target roas source | ad_group.effective_target_roas_source | Output only. Source of the effective target ROAS. This field is read-only. | dimension · string | Traffic | |
| resource name | ad_group.resource_name | Immutable. The resource name of the ad group. Ad group resource names have the form: customers/{customer_id}/adGroups/{ad_group_id} | dimension · string | Traffic | |
| resource name | customer.resource_name | Immutable. The resource name of the customer. Customer resource names have the form: customers/{customer_id} | dimension · string | Traffic | |
| resource name | ad_group_ad.ad.resource_name | Immutable. The resource name of the ad. Ad resource names have the form: customers/{customer_id}/ads/{ad_id} | dimension · string | Traffic | |
| descriptions | ad_group_ad.ad.smart_campaign_ad.descriptions | 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. | dimension · string | Traffic | |
| headlines | ad_group_ad.ad.smart_campaign_ad.headlines | 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. | dimension · string | Traffic | |
| system managed resource source | ad_group_ad.ad.system_managed_resource_source | Output only. If this ad is system managed, then this field will indicate the source. This field is read-only. | dimension · string | Traffic | |
| resource name | ad_group_ad.resource_name | Immutable. The resource name of the ad. Ad group ad resource names have the form: customers/{customer_id}/adGroupAds/{ad_group_id}~{ad_id} | dimension · string | Traffic | |
| resource name | keyword_view.resource_name | Output only. The resource name of the keyword view. Keyword view resource names have the form: customers/{customer_id}/keywordViews/{ad_group_id}~{criterion_id} | dimension · string | Traffic |
Cross-channel metrics
Spend, Impressions, Clicks, Conversions, and Revenue roll up on All channels when a field maps to them. ROAS is revenue divided by spend. CPA is spend divided by conversions. The Cross-channel column above shows the match.
Example reports
Destinations
Google Ads to Google Sheets
A sheet you can open, share, and refresh.
Included on every plan.
Google Ads to Looker Studio
Charts that read the Google Sheet this integration keeps up to date.
Included on every plan. Looker reads the sheet. There is no separate Looker install.
Google Ads to BigQuery
A warehouse table for the same columns.
Pro and Agency plans.
Google Ads to AI and MCP
Ask a question in plain English, or let another tool read the report through MCP.
Included on every plan. An AI key is optional.
Google Ads to the API
Download the rows as CSV or JSON from the report.
Included on every plan.
Google Ads to Google Drive
CSV, Excel, and an optional JSON file in a Drive folder you pick. Each client gets a Datapipe folder. The file can overwrite itself or keep the date in the name.
Included on every plan. Drive API v3 with the drive.file scope only. Enable the Google Drive API in the GCP project. Hourly, daily, or weekly.
How to connect
- Create a free account.
- Open Connections. This source is marked Coming soon.
- You can still build a sample report so the destination and the schedule are ready.
- The owner turns the live connection on after the platform approves the app.
Refresh by plan
| Plan | Refresh | BigQuery | Price |
|---|---|---|---|
| Free | Daily | No | $0/mo |
| Starter | Daily | No | $15/mo |
| Pro | Hourly | Yes | $49/mo |
| Agency | 15 minutes | Yes | $149/mo |
FAQ
Is the Google Ads connection live?
Coming soon. Google Ads access is granted per Cloud project. A developer token is not used. Sample numbers stay labeled.
Do I have to talk to sales?
No. Create an account, connect the source, and the first report is on Home. Sample numbers stay available when a key is missing.
How often do the numbers refresh?
Free and Starter refresh daily. Pro refreshes hourly. Agency refreshes every 15 minutes on up to 50 accounts and hourly on the rest. We keep the history for you: 90 days on Free, and for as long as you subscribe on paid plans. No warehouse to set up.
Which fields are synced today?
The list marks Synced today on the fields the current connector pulls. The rest of the list is what the platform publishes, so you can see it before you sign up.