Google Ads Reference Fields
  • 160 Minutes to read
  • Dark
    Light

Google Ads Reference Fields

  • Dark
    Light

Article Summary

Video Reports

Dataddo LabelGoogle Ads LabelField Description
Video - Channel IDvideo.channel_idOutput only. The owner channel id of the video.
Video - IDvideo.idOutput only. The ID of the video.
Video - Duration Millisecondsvideo.duration_millisOutput only. The duration of the video in milliseconds.
Video - Resource Namevideo.resource_nameOutput only. The resource name of the video. Video resource names have the form: customers/{customer_id}/videos/{video_id}
Video - Titlevideo.titleOutput only. The title of the video.
Customer - IDcustomer.idOutput only. The ID of the customer.
Customer - Currency Codecustomer.currency_codeImmutable. The currency in which the account operates. A subset of the currency codes from the ISO 4217 standard is supported.
Customer - Statuscustomer.statusOutput only. The status of the customer.
Customer - Descriptive Namecustomer.descriptive_nameOptional, non-unique descriptive name of the customer.
Customer - Time Zonecustomer.time_zoneImmutable. The local timezone ID of the customer.
All Conversionsmetrics.all_conversionsThe total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric.
All Conversions From Interactions Ratemetrics.all_conversions_from_interactions_rateAll conversions from interactions (as oppose to view through conversions) divided by the number of ad interactions.
All Conversions Valuemetrics.all_conversions_valueThe value of all conversions.
Average CPCmetrics.average_cpcThe total cost of all clicks divided by the total number of clicks received.
Average CPEmetrics.average_cpeThe 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.
Average CPMmetrics.average_cpmAverage cost-per-thousand impressions (CPM).
Average Cpvmetrics.average_cpvThe average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views.
Clicksmetrics.clicksThe number of clicks.
Conversionsmetrics.conversionsThe 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.
Conversions From Interactions Ratemetrics.conversions_from_interactions_rateConversions 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.
Conversions From Interactions Value Per Interactionmetrics.conversions_from_interactions_value_per_interactionThe 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.
Conversions Valuemetrics.conversions_valueThe 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.
Conversions Value Per Costmetrics.conversions_value_per_costThe 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.
Cost Micros (Spend)metrics.cost_microsThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.
Cost Per All Conversionsmetrics.cost_per_all_conversionsThe cost of ad interactions divided by all conversions.
Cost Per Conversionmetrics.cost_per_conversionThe 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.
Cross Device Conversionsmetrics.cross_device_conversionsConversions 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.
CTRmetrics.ctrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).
Engagement Ratemetrics.engagement_rateHow often people engage with your ad after it's shown to them. This is the number of ad expansions divided by the number of times your ad is shown.
Engagementsmetrics.engagementsThe number of engagements. An engagement occurs when a viewer expands your Lightbox ad. Also in the future other ad types may support engagement metrics.
Impressionsmetrics.impressionsCount of how often your ad has appeared on a search results page or website on the Google Network.
Value Per All Conversionsmetrics.value_per_all_conversionsThe value of all conversions divided by the number of all conversions.
Value Per Conversionmetrics.value_per_conversionThe value of conversions divided by the number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding your bid strategies will optimize for these conversions.
Video Quartile P100_ratemetrics.video_quartile_p100_ratePercentage of impressions where the viewer watched all of your video.
Video Quartile P25_ratemetrics.video_quartile_p25_ratePercentage of impressions where the viewer watched 25% of your video.
Video Quartile P50_ratemetrics.video_quartile_p50_ratePercentage of impressions where the viewer watched 50% of your video.
Video Quartile P75_ratemetrics.video_quartile_p75_ratePercentage of impressions where the viewer watched 75% of your video.
Video View Ratemetrics.video_view_rateThe number of views your TrueView video ad receives divided by its number of impressions including thumbnail impressions for TrueView in-display ads.
Video Viewsmetrics.video_viewsThe number of times your video ads were viewed.
View Through Conversionsmetrics.view_through_conversionsThe total number of view-through conversions. These happen when a customer sees an image or rich media ad then later completes a conversion on your site without interacting with (e.g. clicking on) another ad.
Ad Network Typesegments.ad_network_typeAd network type.
Click Typesegments.click_typeClick type.
Conversion Actionsegments.conversion_actionResource name of the conversion action.
Conversion Action Categorysegments.conversion_action_categoryConversion action category.
Video Conversion Action Namesegments.conversion_action_nameConversion action name.
Datesegments.dateDate to which metrics apply. yyyy-MM-dd format e.g. 2018-04-17.
Day Of The Weeksegments.day_of_weekDay of the week e.g. MONDAY.
Devicesegments.deviceDevice to which metrics apply.
External Conversion Sourcesegments.external_conversion_sourceExternal conversion source.
Monthsegments.monthMonth as represented by the date of the first day of a month. Formatted as yyyy-MM-dd.
Month Of The Yearsegments.month_of_yearMonth of the year e.g. January.
Quartersegments.quarterQuarter as represented by the date of the first day of a quarter. Uses the calendar year for quarters e.g. the second quarter of 2018 starts on 2018-04-01. Formatted as yyyy-MM-dd.
Weeksegments.weekWeek as defined as Monday through Sunday and represented by the date of Monday. Formatted as yyyy-MM-dd.
Yearsegments.yearYear formatted as yyyy.

Campaign Report

Dataddo LabelGoogle Ads LabelField Description
Campaign - Accessible Bidding Strategycampaign.accessible_bidding_strategyOutput 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.
Campaign - Ad Serving Optimization Statuscampaign.ad_serving_optimization_statusThe ad serving optimization status of the campaign.
Campaign - Advertising Channel Sub Typecampaign.advertising_channel_sub_typeImmutable. 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.
Campaign - Advertising Channel Typecampaign.advertising_channel_typeImmutable. 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.
Campaign - App Campaign Setting - App IDcampaign.app_campaign_setting.app_idImmutable. A string that uniquely identifies a mobile application.
Campaign - App Campaign Setting - App Storecampaign.app_campaign_setting.app_storeImmutable. The application store that distributes this specific app.
Campaign - App Campaign Setting - Bidding Strategy Goal Typecampaign.app_campaign_setting.bidding_strategy_goal_typeRepresents the goal which the bidding strategy of this app campaign should optimize towards.
Campaign - Audience Settings - Use Audience Grouped Targetscampaign.audience_setting.use_audience_grouped.targetImmutable. If true, this campaign uses an Audience resource for audience targeting. If false, this campaign may use audience segment criteria instead.
Campaign - Base Campaigncampaign.base_campaignOutput 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.
Campaign - Bidding Strategycampaign.bidding_strategyPortfolio bidding strategy used by campaign.
Campaign - Bidding Strategy Typecampaign.bidding_strategy_typeOutput 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.
Campaign - Campaign Budgetcampaign.campaign_budgetThe budget of the campaign.
Campaign - Commission - Commission Rate Microscampaign.commission.commission_rate_microsCommission 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%).
Campaign - Dynamic Search Ads Setting - Domain Namecampaign.dynamic_search_ads_setting.domain_nameRequired. The Internet domain name that this setting represents, e.g., google.com or www.google.com.
Campaign - Dynamic Search Ads Setting - Language Codecampaign.dynamic_search_ads_setting.language_codeRequired. The language code specifying the language of the domain, e.g., en.
Campaign - Dynamic Search Ads Setting - Feedscampaign.dynamic_search_ads_setting.feedsThe list of page feeds associated with the campaign.
Campaign - Dynamic Search Ads Setting - Use Supplied Urls Onlycampaign.dynamic_search_ads_setting.use_supplied_urls_onlyWhether the campaign uses advertiser supplied URLs exclusively.
Campaign - End Datecampaign.end_dateThe last day of the campaign in serving customer's timezone in YYYY-MM-DD format.
Campaign - Excluded Parent Asset Field Typescampaign.excluded_parent_asset_field_typesThe 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.
Campaign - Experiment Typecampaign.experiment_typeOutput only. The type of campaign: normal, draft, or experiment.
Campaign - Final Url Suffixcampaign.final_url_suffixSuffix used to append query parameters to landing pages that are served with parallel tracking.
Campaign - Frequency Capscampaign.frequency_capsA list that limits how often each user will see this campaign's ads.
Campaign - IDcampaign.idOutput only. The ID of the campaign.
Campaign - Labelscampaign.labelsOutput only. The resource names of labels attached to this campaign.
Campaign - Local Campaign Setting - Location Source Typecampaign.local_campaign_setting.location_source_typeThe location source type for this local campaign.
Campaign - Manual CPC - Enhanced CPC Enabledcampaign.manual_cpc.enhanced_cpc_enabledWhether bids are to be enhanced based on conversion optimizer data.
Campaign - Manual CPMcampaign.manual_cpmStandard Manual CPM bidding strategy. Manual impression-based bidding where user pays per thousand impressions.
Campaign - Manual Cpvcampaign.manual_cpvOutput only. A bidding strategy that pays a configurable amount per video view.
Campaign - Maximize Conversion Value - Target Roascampaign.maximize_conversion_value.target_roasOutput only. 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.
Campaign - Maximize Conversions - Target Cpacampaign.maximize_conversions.target_cpaThe 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.
Campaign - Namecampaign.nameThe 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.
Campaign - Network Settings - Target Content Networkcampaign.network_settings.target_content_networkWhether ads will be served on specified placements in the Google Display Network. Placements are specified using the Placement criterion.
Campaign - Network Settings - Target Search Networkcampaign.network_settings.target_search_networkWhether ads will be served on partner sites in the Google Search Network (requires target_google_search to also be true).
Campaign - Network Settings - Target Partner Search Networkcampaign.network_settings.target_partner_search_networkWhether ads will be served on the Google Partner Network. This is available only to some select Google partner accounts.
Campaign - Network Settings - Target Google Searchcampaign.network_settings.target_google_searchWhether ads will be served with google.com search results.
Campaign - Optimization Goal Setting - Optimization Goal Typescampaign.optimization_goal_setting.optimization_goal_typesThe list of optimization goal types.
Campaign - Optimization Scorecampaign.optimization_scoreOutput 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.
Campaign - Payment Modecampaign.payment_modePayment mode for the campaign.
Campaign - Percent CPC - CPC Bid Ceiling Microscampaign.percent_cpc.cpc_bid_ceiling_microsMaximum 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.
Campaign - Percent CPC - Enhanced CPC Enabledcampaign.percent_cpc.enhanced_cpc_enabledAdjusts 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.
Campaign - Real Time Bidding Setting - Opt Incampaign.real_time_bidding_setting.opt_inWhether the campaign is opted in to real-time bidding.
Campaign - Resource Namecampaign.resource_nameImmutable. The resource name of the campaign. Campaign resource names have the form: customers/{customer_id}/campaigns/{campaign_id}
Campaign - Selective Optimization - Conversion Actionscampaign.selective_optimization.conversion_actionsThe selected set of conversion actions for optimizing this campaign.
Campaign - Serving Statuscampaign.serving_statusOutput only. The ad serving status of the campaign.
Campaign - Shopping Setting - Campaign Prioritycampaign.shopping_setting.campaign_priorityPriority 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.
Campaign - Shopping Setting - Enable Localcampaign.shopping_setting.enable_localWhether to include local products.
Campaign - Shopping Setting - Merchant IDcampaign.shopping_setting.merchant_idImmutable. ID of the Merchant Center account. This field is required for create operations. This field is immutable for Shopping campaigns.
Campaign - Shopping Setting - Sales Countrycampaign.shopping_setting.sales_countrySales country of products to include in the campaign. This field is required for Shopping campaigns. This field is optional for non-Shopping campaigns, but it must be equal to 'ZZ' if set.
Campaign - Shopping Setting - Use Vehicle Inventorycampaign.shopping_setting.use_vehicle_inventoryImmutable. Whether to target Vehicle Listing inventory.
Campaign - Start Datecampaign.start_dateThe date when campaign started in serving customer's timezone in YYYY-MM-DD format.
Campaign - Statuscampaign.statusThe status of the campaign. When a new campaign is added, the status defaults to ENABLED.
Campaign - Target Cpa - CPC Bid Ceiling Microscampaign.target_cpa.cpc_bid_ceiling_microsMaximum 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.
Campaign - Target Cpa - Target Cpa Microscampaign.target_cpa.target_cpa_microsOutput only. Average CPA target. This target should be greater than or equal to minimum billable unit based on the currency for the account.
Campaign - Target CPMcampaign.target_cpmA bidding strategy that automatically optimizes cost per thousand impressions.
Campaign - Target Impression Share - CPC Bid Ceiling Microscampaign.target_impression_share.cpc_bid_ceiling_microsThe 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.
Campaign - Target Cpa - CPC Bid Floor Microscampaign.target_cpa.cpc_bid_floor_microsMinimum 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.
Camkpaign - Target Cpa - Target Cpa Microscampaign.target_cpa.target_cpa_microsOutput only. Average CPA target. This target should be greater than or equal to minimum billable unit based on the currency for the account.
Campaign - Target Impressions Share - CPC Bid Ceiling Microscampaign.target_impression_share.cpc_bid_ceiling_microsThe 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.
Campaign - Target Impression Share - Locationcampaign.target_impression_share.locationThe targeted location on the search results page.
Campaign - Target Impression Share - Location Fraction Microscampaign.target_impression_share.location_fraction_microsThe desired fraction of ads to be shown in the targeted location in micros. E.g. 1% equals 10,000.
Campaign - Target Roas - CPC Bid Ceiling Microscampaign.target_roas.cpc_bid_ceiling_microsMaximum 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.
Campaign - Target Roas - CPC Bid Floor Microscampaign.target_roas.cpc_bid_floor_microsMinimum 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.
Campaign - Target Spend - CPC Bid Floor Microscampaign.target_spend.cpc_bid_floor_micros#N/A
Campaign - Target Roas - Target Roascampaign.target_roas.target_roasRequired. The desired revenue (based on conversion data) per unit of spend. Value must be between 0.01 and 1000.0, inclusive.
Campaign - Target Spend - CPC Bid Ceiling Microscampaign.target_spend.cpc_bid_ceiling_microsMaximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy.
Campaign - Target Spend - Target Spend Microscampaign.target_spend.target_spend_microsThe 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.
Campaign - Targeting Setting - Target Restrictionscampaign.targeting_setting.target_restrictionsThe per-targeting-dimension setting to restrict the reach of your campaign or ad group.
Campaign - Tracking Setting - Tracking Urlcampaign.tracking_setting.tracking_urlOutput only. The url used for dynamic tracking.
Campaign - Tracking Url Templatecampaign.tracking_url_templateThe URL template for constructing a tracking URL.
Campaign - Url Custom Parameterscampaign.url_custom_parametersThe list of mappings used to substitute custom parameter tags in a tracking_url_template, final_urls, or mobile_final_urls.
Campaign - Url Expansion Opt Outcampaign.url_expansion_opt_outRepresents opting out of URL expansion to more targeted URLs. If opted out (true), only the final URLs in the asset group or URLs specified in the advertiser's Google Merchant Center or business data feeds are targeted. If opted in (false), the entire domain will be targeted. This field can only be set for Performance Max campaigns, where the default value is false.
Campaign - Vanity Pharma - Vanity Pharma Display Url Modecampaign.vanity_pharma.vanity_pharma_display_url_modeThe display mode for vanity pharma URLs.
Campaign - Vanity Pharma - Vanity Pharma Textcampaign.vanity_pharma.vanity_pharma_textThe text that will be displayed in display URL of the text ad when website description is the selected display mode for vanity pharma URLs.
Campaign - Video Brand Safety Suitabilitycampaign.video_brand_safety_suitabilityOutput only. 3-Tier Brand Safety setting for the campaign.
Customer - IDcustomer.idOutput only. The ID of the customer.
Customer - Currency Codecustomer.currency_codeImmutable. The currency in which the account operates. A subset of the currency codes from the ISO 4217 standard is supported.
Customer - Statuscustomer.statusOutput only. The status of the customer.
Customer - Descriptive Namecustomer.descriptive_nameOptional, non-unique descriptive name of the customer.
Customer - Time Zonecustomer.time_zoneImmutable. The local timezone ID of the customer.
Bidding Strategy - IDbidding_strategy.idOutput only. The ID of the bidding strategy.
Bidding Strategy - Namebidding_strategy.nameThe name of the bidding strategy. All bidding strategies within an account must be named distinctly. The length of this string should be between 1 and 255, inclusive, in UTF-8 bytes, (trimmed).
Bidding Strategy - Typebidding_strategy.typeOutput only. The type of the bidding strategy. Create a bidding strategy by setting the bidding scheme. This field is read-only.
Bidding Strategy - Statusbidding_strategy.statusOutput only. The status of the bidding strategy. This field is read-only.
Active View CPMmetrics.active_view_cpmAverage cost of viewable impressions (active_view_impressions).
Active View CTRmetrics.active_view_ctrActive view measurable clicks divided by active view viewable impressions. This metric is reported only for display network.
Active View Impressionsmetrics.active_view_impressionsA measurement of how often your ad has become viewable on a Display Network site.
Active View Measurabilitymetrics.active_view_measurabilityThe ratio of impressions that could be measured by Active View over the number of served impressions.
Active View Measurable Cost Microsmetrics.active_view_measurable_cost_microsThe cost of the impressions you received that were measurable by Active View.
Active View Measurable Impressionsmetrics.active_view_measurable_impressionsThe number of times your ads are appearing on placements in positions where they can be seen.
Active View Viewabilitymetrics.active_view_viewabilityThe percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions).
All Conversionsmetrics.all_conversionsThe total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric.
All Conversions By Conversion Datemetrics.all_conversions_by_conversion_dateThe total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009.
All Conversions From Interactions Ratemetrics.all_conversions_from_interactions_rateAll conversions from interactions (as oppose to view through conversions) divided by the number of ad interactions.
All Conversions Valuemetrics.all_conversions_valueThe value of all conversions.
All Conversions Value By Conversion Datemetrics.all_conversions_value_by_conversion_dateThe value of all conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009.
Average Costmetrics.average_costThe average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.
Average CPCmetrics.average_cpcThe total cost of all clicks divided by the total number of clicks received.
Average CPEmetrics.average_cpeThe 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.
Average CPMmetrics.average_cpmAverage cost-per-thousand impressions (CPM).
Average Cpvmetrics.average_cpvThe average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views.
Average Page Viewsmetrics.average_page_viewsAverage number of pages viewed per session.
Average Time On Sitemetrics.average_time_on_siteTotal duration of all sessions (in seconds) / number of sessions. Imported from Google Analytics.
Bounce Ratemetrics.bounce_ratePercentage of clicks where the user only visited a single page on your site. Imported from Google Analytics.
$licksmetrics.clicksThe number of clicks.
Content Budget Lost Impression Sharemetrics.content_budget_lost_impression_shareThe estimated percent of times that your ad was eligible to show on the Display Network but didn't because your budget was too low. Note: Content budget lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001.
Content Impression Sharemetrics.content_impression_shareThe 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.
Content Rank Lost Impression Sharemetrics.content_rank_lost_impression_shareThe 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.
Conversionsmetrics.conversionsThe 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.
Conversions By Conversion Datemetrics.conversions_by_conversion_dateThe number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009.
Conversions From Interactions Ratemetrics.conversions_from_interactions_rateConversions 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.
Conversions From Interactions Value Per Interactionmetrics.conversions_from_interactions_value_per_interactionThe 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.
Conversions Valuemetrics.conversions_valueThe 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.
Conversions Value By Conversion Datemetrics.conversions_value_by_conversion_dateThe value of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009.
Conversions Value Per Costmetrics.conversions_value_per_costThe 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.
Cost Micros (Spend)metrics.cost_microsThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.
Cost Per All Conversionsmetrics.cost_per_all_conversionsThe cost of ad interactions divided by all conversions.
Cost Per Conversionmetrics.cost_per_conversionThe 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.
Cost Per Current Model Attributed Conversionmetrics.cost_per_current_model_attributed_conversionThe 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.
Cross Device Conversionsmetrics.cross_device_conversionsConversions 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.
Current Model Attributed Conversionsmetrics.current_model_attributed_conversionsShows 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.
Current Model Attributed Conversions From Interactions Ratemetrics.current_model_attributed_conversions_from_interactions_rateCurrent 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.
Current Model Attributed Conversions From Interactions Value Per Interactionmetrics.current_model_attributed_conversions_from_interactions_value_per_interactionThe 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.
Current Model Attributed Conversions Valuemetrics.current_model_attributed_conversions_valueThe 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.
Current Model Attributed Conversions Value Per Costmetrics.current_model_attributed_conversions_value_per_costThe 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.
Engagement Ratemetrics.engagement_rateHow often people engage with your ad after it's shown to them. This is the number of ad expansions divided by the number of times your ad is shown.
Engagementsmetrics.engagementsThe number of engagements. An engagement occurs when a viewer expands your Lightbox ad. Also, in the future, other ad types may support engagement metrics.
Gmail Forwardsmetrics.gmail_forwardsThe number of times the ad was forwarded to someone else as a message.
Gmail Savesmetrics.gmail_savesThe number of times someone has saved your Gmail ad to their inbox as a message.
Gmail Secondary Clicksmetrics.gmail_secondary_clicksThe number of clicks to the landing page on the expanded state of Gmail ads.
Impressionsmetrics.impressionsCount of how often your ad has appeared on a search results page or website on the Google Network.
Interaction Event Typesmetrics.interaction_event_typesThe types of payable and free interactions.
Interaction Ratemetrics.interaction_rateHow often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown.
Interactionsmetrics.interactionsThe 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.
Invalid Click Ratemetrics.invalid_click_rateThe percentage of clicks filtered out of your total number of clicks (filtered + non-filtered clicks) during the reporting period.
Invalid Clicksmetrics.invalid_clicksNumber of clicks Google considers illegitimate and doesn't charge you for.
Optimization Score Upliftmetrics.optimization_score_upliftTotal optimization score uplift of all recommendations.
Optimization Score Urlmetrics.optimization_score_urlURL 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.
Percent New Visitorsmetrics.percent_new_visitorsPercentage of first-time sessions (from people who had never visited your site before). Imported from Google Analytics.
Phone Callsmetrics.phone_callsNumber of offline phone calls.
Phone Impressionsmetrics.phone_impressionsNumber of offline phone impressions.
Phone Through Ratemetrics.phone_through_rateNumber of phone calls received (phone_calls) divided by the number of times your phone number is shown (phone_impressions).
Relative CTRmetrics.relative_ctrYour 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.
Search Absolute Top Impression Sharemetrics.search_absolute_top_impression_shareThe percentage of the customer's Shopping or Search ad impressions that are shown in the most prominent Shopping position. See https://support.google.com/google-ads/answer/7501826 for details. Any value below 0.1 is reported as 0.0999.
Search Budget Lost Absolute Top Impression Sharemetrics.search_budget_lost_absolute_top_impression_shareThe number estimating how often your ad wasn't the very first ad above the organic search results due to a low budget. Note: Search budget lost absolute top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001.
Search Budget Lost Impression Sharemetrics.search_budget_lost_impression_shareThe estimated percent of times that your ad was eligible to show on the Search Network but didn't because your budget was too low. Note: Search budget lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001.
Search Budget Lost Top Impression Sharemetrics.search_budget_lost_top_impression_shareThe number estimating how often your ad didn't show anywhere above the organic search results due to a low budget. Note: Search budget lost top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001.
Search Click Sharemetrics.search_click_shareThe 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.
Search Exact Match Impression Sharemetrics.search_exact_match_impression_shareThe 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.
Search Impression Sharemetrics.search_impression_shareThe 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.
Search Rank Lost Absolute Top Impression Sharemetrics.search_rank_lost_absolute_top_impression_shareThe number estimating how often your ad wasn't the very first ad above the organic search results due to poor Ad Rank. Note: Search rank lost absolute top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001.
Search Rank Lost Impression Sharemetrics.search_rank_lost_impression_shareThe 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.
Search Rank Lost Top Impression Sharemetrics.search_rank_lost_top_impression_shareThe number estimating how often your ad didn't show anywhere above the organic search results due to poor Ad Rank. Note: Search rank lost top impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001.
Search Top Impression Sharemetrics.search_top_impression_shareThe impressions you've received in the top location (anywhere above the organic search results) compared to the estimated number of impressions you were eligible to receive in the top location. Note: Search top impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999.
Sk Ad Network Conversionsmetrics.sk_ad_network_conversionsThe number of iOS Store Kit Ad Network conversions.
Top Impression Percentagemetrics.top_impression_percentageThe percent of your ad impressions that are shown anywhere above the organic search results.
Value Per All Conversionsmetrics.value_per_all_conversionsThe value of all conversions divided by the number of all conversions.
Value Per All Conversions By Conversion Datemetrics.value_per_all_conversions_by_conversion_dateThe value of all conversions divided by the number of all conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009.
Value Per Conversionmetrics.value_per_conversionThe value of conversions divided by the number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
Value Per Conversions By Conversion Datemetrics.value_per_conversions_by_conversion_dateThe value of conversions divided by the number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009.
Value Per Current Model Attributed Conversionmetrics.value_per_current_model_attributed_conversionThe value of current model attributed conversions divided by the number of the conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
Video Quartile P100_ratemetrics.video_quartile_p100_ratePercentage of impressions where the viewer watched all of your video.
Video Quartile P25_ratemetrics.video_quartile_p25_ratePercentage of impressions where the viewer watched 25% of your video.
Video Quartile P50_ratemetrics.video_quartile_p50_ratePercentage of impressions where the viewer watched 50% of your video.
Video Quartile P75_ratemetrics.video_quartile_p75_ratePercentage of impressions where the viewer watched 75% of your video.
Video View Ratemetrics.video_view_rateThe number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads.
Video Viewsmetrics.video_viewsThe number of times your video ads were viewed.
View Through Conversionsmetrics.view_through_conversionsThe total number of view-through conversions. These happen when a customer sees an image or rich media ad, then later completes a conversion on your site without interacting with (e.g., clicking on) another ad.
Ad Destination Typesegments.ad_destination_typeAd Destination type.
Ad Network Typesegments.ad_network_typeAd network type.
Click Typesegments.click_typeClick type.
Conversion Actionsegments.conversion_actionResource name of the conversion action.
Conversion Action Categorysegments.conversion_action_categoryConversion action category.
Campaign Conversion Action Namesegments.conversion_action_nameConversion action name.
Conversion Lag Bucketsegments.conversion_lag_bucketAn enum value representing the number of days between the impression and the conversion.
Conversion Or Adjustment Lag Bucketsegments.conversion_or_adjustment_lag_bucketAn enum value representing the number of days between the impression and the conversion or between the impression and adjustments to the conversion.
Conversion Value Rule Primary Dimensionsegments.conversion_value_rule_primary_dimensionPrimary 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 show the net adjustment after value rules were applied.
Datesegments.dateDate to which metrics apply. yyyy-MM-dd format, e.g., 2018-04-17.
Day Of The Week, e.g., Mondaysegments.day_of_weekDay of the week, e.g., MONDAY.
Device To Which Metrics Applysegments.deviceDevice to which metrics apply.
External Conversion Sourcesegments.external_conversion_sourceExternal conversion source.
Hour Of Daysegments.hourHour of day as a number between 0 and 23, inclusive.
Monthsegments.monthMonth as represented by the date of the first day of a month. Formatted as yyyy-MM-dd.
Month Of The Yearsegments.month_of_yearMonth of the year, e.g., January.
Quartersegments.quarterQuarter as represented by the date of the first day of a quarter. Uses the calendar year for quarters, e.g., the second quarter of 2018 starts on 2018-04-01. Formatted as yyyy-MM-dd.
Recommendation Typesegments.recommendation_typeRecommendation type.
IOS Store Kit Ad Network Ad Event Typesegments.sk_ad_network_ad_event_typeiOS Store Kit Ad Network ad event type.
IOS Store Conversion Valuesegments.sk_ad_network_conversion_valueiOS Store Kit Ad Network conversion value. Null value means this segment is not applicable, e.g. non-iOS campaign.
Source App IDsegments.sk_ad_network_source_app.sk_ad_network_source_app_idApp id where the ad that drove the iOS Store Kit Ad Network install was shown.
IOS Store User Typesegments.sk_ad_network_user_typeiOS Store Kit Ad Network user type.
Positionsegments.slotPosition of the ad.
Week By The Date Of Mondaysegments.weekWeek as defined as Monday through Sunday, and represented by the date of Monday. Formatted as yyyy-MM-dd.
Yearsegments.yearYear, formatted as yyyy.

Campaign Budget Report

Dataddo LabelGoogle Ads LabelField Description
Campaign Budget - Amount Microscampaign_budget.amount_microsThe amount of the budget, in the local currency for the account. Amount is specified in micros, where one million is equivalent to one currency unit. Monthly spend is capped at 30.4 times this amount.
Campaign Budget - Delivery Methodcampaign_budget.delivery_methodThe delivery method that determines the rate at which the campaign budget is spent. Defaults to STANDARD if unspecified in a create operation.
Campaign Budget - Explicitly Sharedcampaign_budget.explicitly_sharedSpecifies whether the budget is explicitly shared. Defaults to true if unspecified in a create operation. If true, the budget was created with the purpose of sharing across one or more campaigns. If false, the budget was created with the intention of only being used with a single campaign. The budget's name and status will stay in sync with the campaign's name and status. Attempting to share the budget with a second campaign will result in an error. A non-shared budget can become an explicitly shared. The same operation must also assign the budget a name. A shared campaign budget can never become non-shared.
Campaign Budget - Has Recommended Budgetcampaign_budget.has_recommended_budgetOutput only. Indicates whether there is a recommended budget for this campaign budget. This field is read-only.
Campaign Budget - IDcampaign_budget.idOutput only. The ID of the campaign budget. A campaign budget is created using the CampaignBudgetService create operation and is assigned a budget ID. A budget ID can be shared across different campaigns
Campaign Budget - Namecampaign_budget.nameThe name of the campaign budget. When creating a campaign budget through CampaignBudgetService, every explicitly shared campaign budget must have a non-null, non-empty name. Campaign budgets that are not explicitly shared derive their name from the attached campaign's name. The length of this string must be between 1 and 255, inclusive, in UTF-8 bytes, (trimmed).
Campaign Budget - Periodcampaign_budget.periodImmutable. Period over which to spend the budget. Defaults to DAILY if not specified.
Campaign Budget - Recommended Budget Amount Microscampaign_budget.recommended_budget_amount_microsOutput only. The recommended budget amount. If no recommendation is available, this will be set to the budget amount. Amount is specified in micros, where one million is equivalent to one currency unit. This field is read-only.
Campaign Budget - Recommended Budget Estimated Change Weekly Clickscampaign_budget.recommended_budget_estimated_change_weekly_clicksOutput only. The estimated change in weekly clicks if the recommended budget is applied. This field is read-only.
Campaign Budget - Recommended Budget Estimated Change Weekly Cost Microscampaign_budget.recommended_budget_estimated_change_weekly_cost_microsOutput only. The estimated change in weekly cost in micros if the recommended budget is applied. One million is equivalent to one currency unit. This field is read-only.
Campaign Budget - Recommended Budget Estimated Change Weekly Interactionscampaign_budget.recommended_budget_estimated_change_weekly_interactionsOutput only. The estimated change in weekly interactions if the recommended budget is applied. This field is read-only.
Campaign Budget - Recommended Budget Estimated Change Weekly Viewscampaign_budget.recommended_budget_estimated_change_weekly_viewsOutput only. The estimated change in weekly views if the recommended budget is applied. This field is read-only.
Campaign Budget - Reference Countcampaign_budget.reference_countOutput only. The number of campaigns actively using the budget. This field is read-only.
Campaign Budget - Statuscampaign_budget.statusOutput only. The status of this campaign budget. This field is read-only.
Campaign Budget - Typecampaign_budget.typeImmutable. The type of the campaign budget.
Campaign Budget - Total Amount Microscampaign_budget.total_amount_microsThe lifetime amount of the budget, in the local currency for the account. Amount is specified in micros, where one million is equivalent to one currency unit.
All Conversionsmetrics.all_conversionsThe total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric.
All Conversions Valuemetrics.all_conversions_valueThe value of all conversions.
All Conversions From Interactions Ratemetrics.all_conversions_from_interactions_rateAll conversions from interactions (as oppose to view through conversions) divided by the number of ad interactions.
Average Costmetrics.average_costThe average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.
Average CPCmetrics.average_cpcThe total cost of all clicks divided by the total number of clicks received.
Average CPEmetrics.average_cpeThe 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.
Average CPMmetrics.average_cpmAverage cost-per-thousand impressions (CPM).
Average Cpvmetrics.average_cpvThe average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views.
Clicksmetrics.clicksThe number of clicks.
Conversionsmetrics.conversionsThe 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.
Conversions From Interactions Ratemetrics.conversions_from_interactions_rateConversions 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.
Conversions Valuemetrics.conversions_valueThe 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.
Cost Micros (Spend)metrics.cost_microsThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.
Cost Per Conversionmetrics.cost_per_conversionThe 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.
Cost Per All Conversionsmetrics.cost_per_all_conversionsThe cost of ad interactions divided by all conversions.
Cross Device Conversionsmetrics.cross_device_conversionsConversions 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.
CTRmetrics.ctrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).
Engagement Ratemetrics.engagement_rateHow often people engage with your ad after it's shown to them. This is the number of ad expansions divided by the number of times your ad is shown.
Engagementsmetrics.engagementsThe number of engagements. An engagement occurs when a viewer expands your Lightbox ad. Also, in the future, other ad types may support engagement metrics.
Impressionsmetrics.impressionsCount of how often your ad has appeared on a search results page or website on the Google Network.
Interaction Event Typesmetrics.interaction_event_typesThe types of payable and free interactions.
Interaction Ratemetrics.interaction_rateHow often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown.
Interactionsmetrics.interactionsThe 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.
Value Per All Conversionsmetrics.value_per_all_conversionsThe value of all conversions divided by the number of all conversions.
Value Per Conversionmetrics.value_per_conversionThe value of conversions divided by the number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
Video View Ratemetrics.video_view_rateThe number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads.
Video Viewsmetrics.video_viewsThe number of times your video ads were viewed.
View Through Conversionsmetrics.view_through_conversionsThe total number of view-through conversions. These happen when a customer sees an image or rich media ad, then later completes a conversion on your site without interacting with (e.g., clicking on) another ad.
Campaign Resource Namesegments.budget_campaign_association_status.campaignThe campaign resource name.
Campaign Statussegments.budget_campaign_association_status.statusBudget campaign association status.
Conversion Actionsegments.conversion_actionResource name of the conversion action.
Conversion Action Categorysegments.conversion_action_categoryConversion action category.
Conversion Action Namesegments.conversion_action_nameConversion action name.
Datesegments.dateDate to which metrics apply. yyyy-MM-dd format, e.g., 2018-04-17.
External Conversion Sourcesegments.external_conversion_sourceExternal conversion source.

Ad Group Ad Reports

Dataddo LabelGoogle Ads LabelField Description
Ad Group Ad - Action Itemsad_group_ad.action_itemsOutput only. A list of recommendations to improve the ad strength. For example, a recommendation could be Your headlines are a little too similar. Try adding more distinct headlines..
Ad Group Ad - Ad - Added By Google Adsad_group_ad.ad.added_by_google_adsOutput 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.
Ad Group Ad - Ad - App Ad - Descriptionsad_group_ad.ad.app_ad.descriptionsList of text assets for descriptions. When the ad serves the descriptions will be selected from this list.
Ad Group Ad - Ad - App Ad - Headlinesad_group_ad.ad.app_ad.headlinesList of text assets for headlines. When the ad serves the headlines will be selected from this list.
Ad Group Ad - Ad - App Ad - HTML Media Bundlesad_group_ad.ad.app_ad.html5_media_bundlesList of media bundle assets that may be used with the ad.
Ad Group Ad - Ad - App Ad - HTML Media Bundles - Assetad_group_ad.ad.app_ad.html5_media_bundles.assetThe Asset resource name of this media bundle.
Ad Group Ad - Ad - App Ad - Imagesad_group_ad.ad.app_ad.imagesList of image assets that may be displayed with the ad.
Ad Group Ad - Ad - App Ad - Images - Assetad_group_ad.ad.app_ad.images.assetThe Asset resource name of this image.
Ad Group Ad - Ad - App Ad - Manad_group_ad.ad.app_ad.mandatory_ad_textMandatory ad text.
Ad Group Ad - Ad - App Ad - Youtube Videosad_group_ad.ad.app_ad.youtube_videosList of YouTube video assets that may be displayed with the ad.
Ad Group Ad - Ad - App Ad - Youtube Videos - Assetad_group_ad.ad.app_ad.youtube_videos.assetThe Asset resource name of this video.
Ad Group Ad - Ad - App Engagement Ad - Descriptionsad_group_ad.ad.app_engagement_ad.descriptionsList of text assets for descriptions. When the ad serves the descriptions will be selected from this list.
Ad Group Ad - Ad - App Engagement Ad - Headlinesad_group_ad.ad.app_engagement_ad.headlinesList of text assets for headlines. When the ad serves the headlines will be selected from this list.
Ad Group Ad - Ad - App Engagement Ad - Imagesad_group_ad.ad.app_engagement_ad.imagesList of image assets that may be displayed with the ad.
Ad Group Ad - Ad - App Engagement Ad - Images - Assetad_group_ad.ad.app_engagement_ad.images.assetThe Asset resource name of this image.
Ad Group Ad - Ad - App Engagement Ad - Videosad_group_ad.ad.app_engagement_ad.videosList of video assets that may be displayed with the ad.
Ad Group Ad - Ad - App Engagement Ad - Videos - Assetad_group_ad.ad.app_engagement_ad.videos.assetThe Asset resource name of this video.
Ad Group Ad - Ad - App Pre Registration Ad - Descriptionsad_group_ad.ad.app_pre_registration_ad.descriptionsList of text assets for descriptions. When the ad serves the descriptions will be selected from this list.
Ad Group Ad - Ad - App Pre Registration Ad - Headlinesad_group_ad.ad.app_pre_registration_ad.headlinesList of text assets for headlines. When the ad serves the headlines will be selected from this list.
Ad Group Ad - Ad - App Pre Registration Ad - Imagesad_group_ad.ad.app_pre_registration_ad.imagesList of image asset IDs whose images may be displayed with the ad.
Ad Group Ad - Ad - App Pre Registration Ad - Images - Assetad_group_ad.ad.app_pre_registration_ad.images.assetThe Asset resource name of this image.
Ad Group Ad - Ad - App Pre Registration Ad - Youtube Videosad_group_ad.ad.app_pre_registration_ad.youtube_videosList of YouTube video asset IDs whose videos may be displayed with the ad.
Ad Group Ad - Ad - App Pre Registration Ad - Youtube Videos - Assetad_group_ad.ad.app_pre_registration_ad.youtube_videos.assetThe Asset resource name of this video.
Ad Group Ad - Ad - Call Ad - Business Namead_group_ad.ad.call_ad.business_nameThe business name in the ad.
Ad Group Ad - Ad - Call Ad - Call Trackedad_group_ad.ad.call_ad.call_trackedWhether to enable call tracking for the creative. Enabling call tracking also enables call conversions.
Ad Group Ad - Ad - Call Ad - Conversion Actionad_group_ad.ad.call_ad.conversion_actionThe conversion action to attribute a call conversion to. If not set a default conversion action is used. This field only has effect if call_tracked is set to true. Otherwise this field is ignored.
Ad Group Ad - Ad - Call Ad - Conversion Reporting Statead_group_ad.ad.call_ad.conversion_reporting_stateThe call conversion behavior of this call ad. It can use its own call conversion setting, inherit the account level setting, or be disabled.
Ad Group Ad - Ad - Call Ad - Country Codead_group_ad.ad.call_ad.country_codeThe country code in the ad.
Ad Group Ad - Ad - Call Ad - Descriptionad_group_ad.ad.call_ad.description1The first line of the ad's description.
Ad Group Ad - Ad - Call Ad - Descriptionad_group_ad.ad.call_ad.description2The second line of the ad's description.
Ad Group Ad - Ad - Call Ad - Disable Call Conversionad_group_ad.ad.call_ad.disable_call_conversionWhether to disable call conversion for the creative. If set to true, disables call conversions even when call_tracked is true. If call_tracked is false, this field is ignored.
Ad Group Ad - Ad - Call Ad - Headlinead_group_ad.ad.call_ad.headline1First headline in the ad.
Ad Group Ad - Ad - Call Ad - Headlinead_group_ad.ad.call_ad.headline2Second headline in the ad.
Ad Group Ad - Ad - Call Ad - Pathad_group_ad.ad.call_ad.path1First part of text that can be appended to the URL in the ad. Optional.
Ad Group Ad - Ad - Call Ad - Pathad_group_ad.ad.call_ad.path2Second part of text that can be appended to the URL in the ad. This field can only be set when path1 is also set. Optional.
Ad Group Ad - Ad - Call Ad - Phone Numberad_group_ad.ad.call_ad.phone_numberThe phone number in the ad.
Ad Group Ad - Ad - Call Ad - Phone Number Verification Urlad_group_ad.ad.call_ad.phone_number_verification_urlThe URL to be used for phone number verification.
Ad Group Ad - Ad - Device Preferencead_group_ad.ad.device_preferenceThe 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, e.g. if no other ads are available. If unspecified (no device preference), all devices are targeted. This is only supported by some ad types.
Ad Group Ad - Ad - Display Upload Ad - Display Upload Product Typead_group_ad.ad.display_upload_ad.display_upload_product_typeThe product type of this ad. See comments on the enum for details.
Ad Group Ad - Ad - Display Upload Ad - Media Bundlead_group_ad.ad.display_upload_ad.media_bundleA 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.
Ad Group Ad - Ad - Display Upload Ad - Media Bundle - Assetad_group_ad.ad.display_upload_ad.media_bundle.assetThe Asset resource name of this media bundle.
Ad Group Ad - Ad - Display Urlad_group_ad.ad.display_urlThe URL that appears in the ad description for some ad formats.
Ad Group Ad - Ad - Expanded Dynamic Search Ad - Descriptionad_group_ad.ad.expanded_dynamic_search_ad.descriptionThe description of the ad.
Ad Group Ad - Ad - Expanded Dynamic Search Ad - Descriptionad_group_ad.ad.expanded_dynamic_search_ad.description2The second description of the ad.
Ad Group Ad - Ad - Expanded Text Ad - Descriptionad_group_ad.ad.expanded_text_ad.descriptionThe description of the ad.
Ad Group Ad - Ad - Expanded Text Ad - Descriptionad_group_ad.ad.expanded_text_ad.description2The second description of the ad.
Ad Group Ad - Ad - Expanded Text Ad - Headline Partad_group_ad.ad.expanded_text_ad.headline_part1The first part of the ad's headline.
Ad Group Ad - Ad - Expanded Text Ad - Headline Partad_group_ad.ad.expanded_text_ad.headline_part2The second part of the ad's headline.
Ad Group Ad - Ad - Expanded Text Ad - Headline Partad_group_ad.ad.expanded_text_ad.headline_part3The third part of the ad's headline.
Ad Group Ad - Ad - Expanded Text Ad - Pathad_group_ad.ad.expanded_text_ad.path1The text that can appear alongside the ad's displayed URL.
Ad Group Ad - Ad - Expanded Text Ad - Pathad_group_ad.ad.expanded_text_ad.path2Additional text that can appear alongside the ad's displayed URL.
Ad Group Ad - Ad - Final App Urlsad_group_ad.ad.final_app_urlsA list of final app URLs that will be used on mobile if the user has the specific app installed.
Ad Group Ad - Ad - Final Mobile Urlsad_group_ad.ad.final_mobile_urlsThe list of possible final mobile URLs after all cross-domain redirects for the ad.
Ad Group Ad - Ad - Final Url Suffixad_group_ad.ad.final_url_suffixThe suffix to use when constructing a final URL.
Ad Group Ad - Ad - Final Urlsad_group_ad.ad.final_urlsThe list of possible final URLs after all cross-domain redirects for the ad.
Ad Group Ad - Ad - Gmail Ad - Header Imagead_group_ad.ad.gmail_ad.header_imageThe MediaFile resource name of the header image. Valid image types are GIF, JPEG and PNG. The minimum size is 300x100 pixels and the aspect ratio must be between 3:1 and 5:1 (+-1%).
Ad Group Ad - Ad - Gmail Ad - Marketing Imagead_group_ad.ad.gmail_ad.marketing_imageThe MediaFile resource name of the marketing image. Valid image types are GIF, JPEG and PNG. The image must either be landscape with a minimum size of 600x314 pixels and aspect ratio of 600:314 (+-1%) or square with a minimum size of 300x300 pixels and aspect ratio of 1:1 (+-1%)
Ad Group Ad - Ad - Gmail Ad - Marketing Image Descriptionad_group_ad.ad.gmail_ad.marketing_image_descriptionDescription of the marketing image.
Ad Group Ad - Ad - Gmail Ad - Marketing Image Display Call To_action - Textad_group_ad.ad.gmail_ad.marketing_image_display_call_to_action.textText for the display-call-to-action.
Ad Group Ad - Ad - Gmail Ad - Marketing Image Display Call To Action - Text_colorad_group_ad.ad.gmail_ad.marketing_image_display_call_to_action.text_colorText color for the display-call-to-action in hexadecimal, e.g. #ffffff for white.
Ad Group Ad - Ad - Gmail Ad - Marketing Image Display Call To Action - Url_collection_idad_group_ad.ad.gmail_ad.marketing_image_display_call_to_action.url_collection_idIdentifies the URL collection in the ad.url_collections field. If not set, the URL defaults to final_url.
Ad Group Ad - Ad - Gmail Ad - Marketing Image Headlinead_group_ad.ad.gmail_ad.marketing_image_headlineHeadline of the marketing image.
Ad Group Ad - Ad - Gmail Ad - Product Imagesad_group_ad.ad.gmail_ad.product_imagesProduct images. Up to 15 images are supported.
Ad Group Ad - Ad - Gmail Ad - Product Images - Product Imagead_group_ad.ad.gmail_ad.product_images.product_imageThe MediaFile resource name of the product image. Valid image types are GIF, JPEG and PNG. The minimum size is 300x300 pixels and the aspect ratio must be 1:1 (+-1%).
Ad Group Ad - Ad - Gmail Ad - Product Videosad_group_ad.ad.gmail_ad.product_videosProduct videos. Up to 7 videos are supported. At least one product video or a marketing image must be specified.
Ad Group Ad - Ad - Gmail Ad - Product Videos - Product Videoad_group_ad.ad.gmail_ad.product_videos.product_videoThe MediaFile resource name of a video which must be hosted on YouTube.
Ad Group Ad - Ad - Gmail Ad - Teaser - Business Namead_group_ad.ad.gmail_ad.teaser.business_nameBusiness name of the advertiser.
Ad Group Ad - Ad - Gmail Ad - Teaser - Descriptionad_group_ad.ad.gmail_ad.teaser.descriptionDescription of the teaser.
Ad Group Ad - Ad - Gmail Ad - Teaser - Headlinead_group_ad.ad.gmail_ad.teaser.headlineHeadline of the teaser.
Ad Group Ad - Ad - Gmail Ad - Teaser - Logo Imagead_group_ad.ad.gmail_ad.teaser.logo_imageThe MediaFile resource name of the logo image. Valid image types are GIF, JPEG and PNG. The minimum size is 144x144 pixels and the aspect ratio must be 1:1 (+-1%).
Ad Group Ad - Ad - Hotel Adad_group_ad.ad.hotel_adDetails pertaining to a hotel ad.
Ad Group Ad - Ad - IDad_group_ad.ad.idOutput only. The ID of the ad.
Ad Group Ad - Ad - Image Ad - Image Urlad_group_ad.ad.image_ad.image_urlURL of the full size image.
Ad Group Ad - Ad - Image Ad - Media Filead_group_ad.ad.image_ad.media_fileThe MediaFile resource to use for the image.
Ad Group Ad - Ad - Image Ad - Mime Typead_group_ad.ad.image_ad.mime_typeThe mime type of the image.
Ad Group Ad - Ad - Image Ad - Namead_group_ad.ad.image_ad.nameThe 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.
Ad Group Ad - Ad - Image Ad - Pixel Heightad_group_ad.ad.image_ad.pixel_heightHeight in pixels of the full size image.
Ad Group Ad - Ad - Image Ad - Pixel Widthad_group_ad.ad.image_ad.pixel_widthWidth in pixels of the full size image.
Ad Group Ad - Ad - Image Ad - Preview Image Urlad_group_ad.ad.image_ad.preview_image_urlURL of the preview size image.
Ad Group Ad - Ad - Image Ad - Preview Pixel Heightad_group_ad.ad.image_ad.preview_pixel_heightHeight in pixels of the preview size image.
Ad Group Ad - Ad - Image Ad - Preview Pixel Widthad_group_ad.ad.image_ad.preview_pixel_widthWidth in pixels of the preview size image.
Ad Group Ad - Ad - Legacy App Install Adad_group_ad.ad.legacy_app_install_adImmutable. Details pertaining to a legacy app install ad.
Ad Group Ad - Ad - Legacy Responsive Display Ad - Accent Colorad_group_ad.ad.legacy_responsive_display_ad.accent_colorThe accent color of the ad in hexadecimal, e.g. #ffffff for white. If one of main_color and accent_color is set, the other is required as well.
Ad Group Ad - Ad - Legacy Responsive Display Ad - Allow Flexible Colorad_group_ad.ad.legacy_responsive_display_ad.allow_flexible_colorAdvertiser'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.
Ad Group Ad - Ad - Legacy Responsive Display Ad - Business Namead_group_ad.ad.legacy_responsive_display_ad.business_nameThe business name in the ad.
Ad Group Ad - Ad - Legacy Responsive Display Ad - Call To Action Textad_group_ad.ad.legacy_responsive_display_ad.call_to_action_textThe call-to-action text for the ad.
Ad Group Ad - Ad - Legacy Responsive Display Ad - Descriptionad_group_ad.ad.legacy_responsive_display_ad.descriptionThe description of the ad.
Ad Group Ad - Ad - Legacy Responsive Display Ad - Format Settingad_group_ad.ad.legacy_responsive_display_ad.format_settingSpecifies which format the ad will be served in. Default is ALL_FORMATS.
Ad Group Ad - Ad - Legacy Responsive Display Ad - Logo Imagead_group_ad.ad.legacy_responsive_display_ad.logo_imageThe MediaFile resource name of the logo image used in the ad.
Ad Group Ad - Ad - Legacy Responsive Display Ad - Long Headlinead_group_ad.ad.legacy_responsive_display_ad.long_headlineThe long version of the ad's headline.
Ad Group Ad - Ad - Legacy Responsive Display Ad - Main Colorad_group_ad.ad.legacy_responsive_display_ad.main_colorThe main color of the ad in hexadecimal, e.g. #ffffff for white. If one of main_color and accent_color is set, the other is required as well.
Ad Group Ad - Ad - Legacy Responsive Display Ad - Marketing Imagead_group_ad.ad.legacy_responsive_display_ad.marketing_imageThe MediaFile resource name of the marketing image used in the ad.
Ad Group Ad - Ad - Legacy Responsive Display Ad - Price Prefixad_group_ad.ad.legacy_responsive_display_ad.price_prefixPrefix before price. E.g. 'as low as'.
Ad Group Ad - Ad - Legacy Responsive Display Ad - Promo Textad_group_ad.ad.legacy_responsive_display_ad.promo_textPromotion text used for dynamic formats of responsive ads. For example 'Free two-day shipping'.
Ad Group Ad - Ad - Legacy Responsive Display Ad - Short Headlinead_group_ad.ad.legacy_responsive_display_ad.short_headlineThe short version of the ad's headline.
Ad Group Ad - Ad - Legacy Responsive Display Ad - Square Logo Imagead_group_ad.ad.legacy_responsive_display_ad.square_logo_imageThe MediaFile resource name of the square logo image used in the ad.
Ad Group Ad - Ad - Legacy Responsive Display Ad - Square Marketing Imagead_group_ad.ad.legacy_responsive_display_ad.square_marketing_imageThe MediaFile resource name of the square marketing image used in the ad.
Ad Group Ad - Ad - Local Ad - Call To Actionsad_group_ad.ad.local_ad.call_to_actionsList of text assets for call-to-actions. When the ad serves the call-to-actions will be selected from this list. Call-to-actions are optional and at most 5 can be specified.
Ad Group Ad - Ad - Local Ad - Descriptionsad_group_ad.ad.local_ad.descriptionsList 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.
Ad Group Ad - Ad - Local Ad - Headlinesad_group_ad.ad.local_ad.headlinesList 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.
Ad Group Ad - Ad - Local Ad - Logo Imagesad_group_ad.ad.local_ad.logo_imagesList 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.
Ad Group Ad - Ad - Local Ad - Logo Images - Assetad_group_ad.ad.local_ad.logo_images.assetThe Asset resource name of this image.
Ad Group Ad - Ad - Local Ad - Marketing Imagesad_group_ad.ad.local_ad.marketing_imagesList 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.
Ad Group Ad - Ad - Local Ad - Marketing Images - Assetad_group_ad.ad.local_ad.marketing_images.assetThe Asset resource name of this image.
Ad Group Ad - Ad - Local Ad - Pathad_group_ad.ad.local_ad.path1First part of optional text that can be appended to the URL in the ad.
Ad Group Ad - Ad - Local Ad - Pathad_group_ad.ad.local_ad.path2Second 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.
Ad Group Ad - Ad - Local Ad - Videosad_group_ad.ad.local_ad.videosList of YouTube video assets that may be displayed with the ad. Videos are optional and at most 20 can be specified.
Ad Group Ad - Ad - Local Ad - Videos - Assetad_group_ad.ad.local_ad.videos.assetThe Asset resource name of this video.
Ad Group Ad - Ad - Namead_group_ad.ad.nameImmutable. The name of the ad. This is only used to be able to identify the ad. It does not need to be unique and does not affect the served ad. The name field is currently only supported for DisplayUploadAd, ImageAd, ShoppingComparisonListingAd and VideoAd.
Ad Group Ad - Ad - Resource Namead_group_ad.ad.resource_nameImmutable. The resource name of the ad. Ad resource names have the form: customers/{customer_id}/ads/{ad_id}
Ad Group Ad - Ad - Responsive Display Ad - Accent Colorad_group_ad.ad.responsive_display_ad.accent_colorThe accent color of the ad in hexadecimal, e.g. #ffffff for white. If one of main_color and accent_color is set, the other is required as well.
Ad Group Ad - Ad - Responsive Display Ad - Allow Flexible Colorad_group_ad.ad.responsive_display_ad.allow_flexible_colorAdvertiser'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.
Ad Group Ad - Ad - Responsive Display Ad - Business Namead_group_ad.ad.responsive_display_ad.business_nameThe advertiser/brand name. Maximum display width is 25.
Ad Group Ad - Ad - Responsive Display Ad - Call To Action Textad_group_ad.ad.responsive_display_ad.call_to_action_textThe call-to-action text for the ad. Maximum display width is 30.
Ad Group Ad - Ad - Responsive Display Ad - Control Spec - Enable Asset Enhancementsad_group_ad.ad.responsive_display_ad.control_spec.enable_asset_enhancementsWhether the advertiser has opted into the asset enhancements feature.
Ad Group Ad - Ad - Responsive Display Ad - Control Spec - Enable Autogen Videoad_group_ad.ad.responsive_display_ad.control_spec.enable_autogen_videoWhether the advertiser has opted into auto-gen video feature.
Ad Group Ad - Ad - Responsive Display Ad - Descriptionsad_group_ad.ad.responsive_display_ad.descriptionsDescriptive texts for the ad. The maximum length is 90 characters. At least 1 and max 5 headlines can be specified.
Ad Group Ad - Ad - Responsive Display Ad - Format Settingad_group_ad.ad.responsive_display_ad.format_settingSpecifies which format the ad will be served in. Default is ALL_FORMATS.
Ad Group Ad - Ad - Responsive Display Ad - Headlinesad_group_ad.ad.responsive_display_ad.headlinesShort format headlines for the ad. The maximum length is 30 characters. At least 1 and max 5 headlines can be specified.
Ad Group Ad - Ad - Responsive Display Ad - Logo Imagesad_group_ad.ad.responsive_display_ad.logo_imagesLogo 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.
Ad Group Ad - Ad - Responsive Display Ad - Logo Images - Assetad_group_ad.ad.responsive_display_ad.logo_images.assetThe Asset resource name of this image.
Ad Group Ad - Ad - Responsive Display Ad - Long Headlinead_group_ad.ad.responsive_display_ad.long_headlineA required long format headline. The maximum length is 90 characters.
Ad Group Ad - Ad - Responsive Display Ad - Main Colorad_group_ad.ad.responsive_display_ad.main_colorThe main color of the ad in hexadecimal, e.g. #ffffff for white. If one of main_color and accent_color is set, the other is required as well.
Ad Group Ad - Ad - Responsive Display Ad - Marketing Imagesad_group_ad.ad.responsive_display_ad.marketing_imagesMarketing 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.
Ad Group Ad - Ad - Responsive Display Ad - Marketing Images - Assetad_group_ad.ad.responsive_display_ad.marketing_images.assetThe Asset resource name of this image.
Ad Group Ad - Ad - Responsive Display Ad - Price Prefixad_group_ad.ad.responsive_display_ad.price_prefixPrefix before price. E.g. 'as low as'.
Ad Group Ad - Ad - Responsive Display Ad - Promo Textad_group_ad.ad.responsive_display_ad.promo_textPromotion text used for dynamic formats of responsive ads. For example 'Free two-day shipping'.
Ad Group Ad - Ad - Responsive Display Ad - Square Logo Imagesad_group_ad.ad.responsive_display_ad.square_logo_imagesSquare 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 square_logo_images, the maximum is 5.
Ad Group Ad - Ad - Responsive Display Ad - Square Logo Images - Assetad_group_ad.ad.responsive_display_ad.square_logo_images.assetThe Asset resource name of this image.
Ad Group Ad - Ad - Responsive Display Ad - Square Marketing Imagesad_group_ad.ad.responsive_display_ad.square_marketing_imagesSquare 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.
Ad Group Ad - Ad - Responsive Display Ad - Square Marketing Images - Assetad_group_ad.ad.responsive_display_ad.square_marketing_images.assetThe Asset resource name of this image.
Ad Group Ad - Ad - Responsive Display Ad - Youtube Videosad_group_ad.ad.responsive_display_ad.youtube_videosOptional YouTube videos for the ad. A maximum of 5 videos can be specified.
Ad Group Ad - Ad - Responsive Display Ad - Youtube Videos - Assetad_group_ad.ad.responsive_display_ad.youtube_videos.assetThe Asset resource name of this video.
Ad Group Ad - Ad - Responsive Search Ad - Descriptionsad_group_ad.ad.responsive_search_ad.descriptionsList of text assets for descriptions. When the ad serves the descriptions will be selected from this list.
Ad Group Ad - Ad - Responsive Search Ad - Headlinesad_group_ad.ad.responsive_search_ad.headlinesList of text assets for headlines. When the ad serves the headlines will be selected from this list.
Ad Group Ad - Ad - Responsive Search Ad - Pathad_group_ad.ad.responsive_search_ad.path1First part of text that can be appended to the URL in the ad.
Ad Group Ad - Ad - Responsive Search Ad - Pathad_group_ad.ad.responsive_search_ad.path2Second part of text that can be appended to the URL in the ad. This field can only be set when path1 is also set.
Ad Group Ad - Ad - Shopping Comparison Listing Ad - Headlinead_group_ad.ad.shopping_comparison_listing_ad.headlineHeadline of the ad. This field is required. Allowed length is between 25 and 45 characters.
Ad Group Ad - Ad - Shopping Product Adad_group_ad.ad.shopping_product_adDetails pertaining to a Shopping product ad.
Ad Group Ad - Ad - Shopping Smart Adad_group_ad.ad.shopping_smart_adDetails pertaining to a Smart Shopping ad.
Ad Group Ad - Ad - Smart Campaign Ad - Descriptionsad_group_ad.ad.smart_campaign_ad.descriptionsList of text assets for descriptions. When the ad serves the descriptions will be selected from this list. 2 descriptions must be specified.
Ad Group Ad - Ad - Smart Campaign Ad - Headlinesad_group_ad.ad.smart_campaign_ad.headlinesList of text assets for headlines. When the ad serves the headlines will be selected from this list. 3 headlines must be specified.
Ad Group Ad - Ad - System Managed Resource Sourcead_group_ad.ad.system_managed_resource_sourceOutput only. If this ad is system managed, then this field will indicate the source. This field is read-only.
Ad Group Ad - Ad - Text Ad - Descriptionad_group_ad.ad.text_ad.description1The first line of the ad's description.
Ad Group Ad - Ad - Text Ad - Descriptionad_group_ad.ad.text_ad.description2The second line of the ad's description.
Ad Group Ad - Ad - Text Ad - Headlinead_group_ad.ad.text_ad.headlineThe headline of the ad.
Ad Group Ad - Ad - Tracking Url Templatead_group_ad.ad.tracking_url_templateThe URL template for constructing a tracking URL.
Ad Group Ad - Ad - Typead_group_ad.ad.typeOutput only. The type of ad.
Ad Group Ad - Ad - Url Collectionsad_group_ad.ad.url_collectionsAdditional URLs for the ad that are tagged with a unique identifier that can be referenced from other fields in the ad.
Ad Group Ad - Ad - Url Custom Parametersad_group_ad.ad.url_custom_parametersThe 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, please use url custom parameter operations.
Ad Group Ad Ad Video Adad_group_ad.ad.video_ad.bumper.companion_banner.assetThe Asset resource name of this image.
Ad Group Ad - Ad - Video Ad - In Feed - Descriptionad_group_ad.ad.video_ad.in_feed.description1First text line for the ad.
Ad Group Ad - Ad - Video Ad - In Feed - Descriptionad_group_ad.ad.video_ad.in_feed.description2Second text line for the ad.
Ad Group Ad - Ad - Video Ad - In Feed - Headlinead_group_ad.ad.video_ad.in_feed.headlineThe headline of the ad.
Ad Group Ad - Ad - Video Ad - In Feed - Thumbnailad_group_ad.ad.video_ad.in_feed.thumbnailVideo thumbnail image to use.
Ad Group Ad - Ad - Video Ad - In Stream - Action Button Labelad_group_ad.ad.video_ad.in_stream.action_button_labelLabel 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.
Ad Group Ad - Ad - Video Ad - In Stream - Action Headlinead_group_ad.ad.video_ad.in_stream.action_headlineAdditional text displayed with the CTA (call-to-action) button to give context and encourage clicking on the button.
Ad Group Ad Ad Video Adad_group_ad.ad.video_ad.in_stream.companion_banner.assetThe Asset resource name of this image.
Ad Group Ad - Ad - Video Ad - Non Skippable - Action Button Labelad_group_ad.ad.video_ad.non_skippable.action_button_labelLabel on the Call To Action button taking the user to the video ad's final URL.
Ad Group Ad - Ad - Video Ad - Non Skippable - Action Headlinead_group_ad.ad.video_ad.non_skippable.action_headlineAdditional text displayed with the Call To Action button to give context and encourage clicking on the button.
Ad Group Ad Ad Video Adad_group_ad.ad.video_ad.non_skippable.companion_banner.assetThe Asset resource name of this image.
Ad Group Ad - Ad - Video Ad - Out Stream - Descriptionad_group_ad.ad.video_ad.out_stream.descriptionThe description line.
Ad Group Ad - Ad - Video Ad - Out Stream - Headlinead_group_ad.ad.video_ad.out_stream.headlineThe headline of the ad.
Ad Group Ad - Ad - Video Ad - Video - Assetad_group_ad.ad.video_ad.video.assetThe Asset resource name of this video.
Ad Group Ad - Ad - Video Responsive Ad - Call To Actionsad_group_ad.ad.video_responsive_ad.call_to_actionsList of text assets used for the button, e.g. the Call To Action button. Currently, only a single value for the button is supported.
Ad Group Ad - Ad - Video Responsive Ad - Companion Bannersad_group_ad.ad.video_responsive_ad.companion_bannersList of image assets used for the companion banner. Currently, only a single value for the companion banner asset is supported.
Ad Group Ad - Ad - Video Responsive Ad - Companion Banners - Assetad_group_ad.ad.video_responsive_ad.companion_banners.assetThe Asset resource name of this image.
Ad Group Ad - Ad - Video Responsive Ad - Descriptionsad_group_ad.ad.video_responsive_ad.descriptionsList of text assets used for the description. Currently, only a single value for the description is supported.
Ad Group Ad - Ad - Video Responsive Ad - Headlinesad_group_ad.ad.video_responsive_ad.headlinesList of text assets used for the short headline, e.g. the Call To Action banner. Currently, only a single value for the short headline is supported.
Ad Group Ad - Ad - Video Responsive Ad - Long Headlinesad_group_ad.ad.video_responsive_ad.long_headlinesList of text assets used for the long headline. Currently, only a single value for the long headline is supported.
Ad Group Ad - Ad - Video Responsive Ad - Videosad_group_ad.ad.video_responsive_ad.videosList of YouTube video assets used for the ad. Currently, only a single value for the YouTube video asset is supported.
Ad Group Ad - Ad - Video Responsive Ad - Videos - Assetad_group_ad.ad.video_responsive_ad.videos.assetThe Asset resource name of this video.
Ad Group Ad - Ad Groupad_group_ad.ad_groupImmutable. The ad group to which the ad belongs.
Ad Group Ad - Ad Strengthad_group_ad.ad_strengthOutput only. Overall ad strength for this ad group ad.
Ad Group Ad - Labelsad_group_ad.labelsOutput only. The resource names of labels attached to this ad group ad.
Ad Group Ad - Policy Summary - Approval Statusad_group_ad.policy_summary.approval_statusOutput only. The overall approval status of this ad, calculated based on the status of its individual policy topic entries.
Ad Group Ad - Policy Summary - Policy Topic Entriesad_group_ad.policy_summary.policy_topic_entriesOutput only. The list of policy findings for this ad.
Ad Group Ad - Policy Summary - Review Statusad_group_ad.policy_summary.review_statusOutput only. Where in the review process this ad is.
Ad Group Ad - Resource Namead_group_ad.resource_nameImmutable. The resource name of the ad. Ad group ad resource names have the form: customers/{customer_id}/adGroupAds/{ad_group_id}~{ad_id}
Ad Group Ad - Statusad_group_ad.statusThe status of the ad.
Customer - IDcustomer.idOutput only. The ID of the customer.
Customer - Currency Codecustomer.currency_codeImmutable. The currency in which the account operates. A subset of the currency codes from the ISO 4217 standard is supported.
Customer - Statuscustomer.statusOutput only. The status of the customer.
Customer - Descriptive Namecustomer.descriptive_nameOptional, non-unique descriptive name of the customer.
Customer - Time Zonecustomer.time_zoneImmutable. The local timezone ID of the customer.
Campaign - Accessible Bidding Strategycampaign.accessible_bidding_strategyOutput 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.
Campaign - Ad Serving Optimization Statuscampaign.ad_serving_optimization_statusThe ad serving optimization status of the campaign.
Campaign - Advertising Channel Sub Typecampaign.advertising_channel_sub_typeImmutable. 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.
Campaign - Advertising Channel Typecampaign.advertising_channel_typeImmutable. 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.
Campaign - App Campaign Setting - App IDcampaign.app_campaign_setting.app_idImmutable. A string that uniquely identifies a mobile application.
Campaign - App Campaign Setting - App Storecampaign.app_campaign_setting.app_storeImmutable. The application store that distributes this specific app.
Campaign - App Campaign Setting - Bidding Strategy Goal Typecampaign.app_campaign_setting.bidding_strategy_goal_typeRepresents the goal which the bidding strategy of this app campaign should optimize towards.
Campaign - Audience Settings - Use Audience Grouped Targetscampaign.audience_setting.use_audience_grouped.targetImmutable. If true, this campaign uses an Audience resource for audience targeting. If false, this campaign may use audience segment criteria instead.
Campaign - Base Campaigncampaign.base_campaignOutput 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.
Campaign - Bidding Strategycampaign.bidding_strategyPortfolio bidding strategy used by campaign.
Campaign - Bidding Strategy Typecampaign.bidding_strategy_typeOutput 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.
Campaign - Campaign Budgetcampaign.campaign_budgetThe budget of the campaign.
Campaign - Commission - Commission Rate Microscampaign.commission.commission_rate_microsCommission 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%).
Campaign - Dynamic Search Ads Setting - Domain Namecampaign.dynamic_search_ads_setting.domain_nameRequired. The Internet domain name that this setting represents, e.g., google.com or www.google.com.
Campaign - Dynamic Search Ads Setting - Language Codecampaign.dynamic_search_ads_setting.language_codeRequired. The language code specifying the language of the domain, e.g., en.
Campaign - Dynamic Search Ads Setting - Feedscampaign.dynamic_search_ads_setting.feedsThe list of page feeds associated with the campaign.
Campaign - Dynamic Search Ads Setting - Use Supplied Urls Onlycampaign.dynamic_search_ads_setting.use_supplied_urls_onlyWhether the campaign uses advertiser supplied URLs exclusively.
Campaign - End Datecampaign.end_dateThe last day of the campaign in serving customer's timezone in YYYY-MM-DD format.
Campaign - Excluded Parent Asset Field Typescampaign.excluded_parent_asset_field_typesThe 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.
Campaign - Experiment Typecampaign.experiment_typeOutput only. The type of campaign: normal, draft, or experiment.
Campaign - Final Url Suffixcampaign.final_url_suffixSuffix used to append query parameters to landing pages that are served with parallel tracking.
Campaign - Frequency Capscampaign.frequency_capsA list that limits how often each user will see this campaign's ads.
Campaign - IDcampaign.idOutput only. The ID of the campaign.
Campaign - Labelscampaign.labelsOutput only. The resource names of labels attached to this campaign.
Campaign - Local Campaign Setting - Location Source Typecampaign.local_campaign_setting.location_source_typeThe location source type for this local campaign.
Campaign - Manual CPC - Enhanced CPC Enabledcampaign.manual_cpc.enhanced_cpc_enabledWhether bids are to be enhanced based on conversion optimizer data.
Campaign - Manual CPMcampaign.manual_cpmStandard Manual CPM bidding strategy. Manual impression-based bidding where user pays per thousand impressions.
Campaign - Manual Cpvcampaign.manual_cpvOutput only. A bidding strategy that pays a configurable amount per video view.
Campaign - Maximize Conversion Value - Target Roascampaign.maximize_conversion_value.target_roasOutput only. 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.
Campaign - Maximize Conversions - Target Cpacampaign.maximize_conversions.target_cpaThe 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.
Campaign - Namecampaign.nameThe 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.
Campaign - Network Settings - Target Content Networkcampaign.network_settings.target_content_networkWhether ads will be served on specified placements in the Google Display Network. Placements are specified using the Placement criterion.
Campaign - Network Settings - Target Search Networkcampaign.network_settings.target_search_networkWhether ads will be served on partner sites in the Google Search Network (requires target_google_search to also be true).
Campaign - Network Settings - Target Partner Search Networkcampaign.network_settings.target_partner_search_networkWhether ads will be served on the Google Partner Network. This is available only to some select Google partner accounts.
Campaign - Network Settings - Target Google Searchcampaign.network_settings.target_google_searchWhether ads will be served with google.com search results.
Campaign - Optimization Goal Setting - Optimization Goal Typescampaign.optimization_goal_setting.optimization_goal_typesThe list of optimization goal types.
Campaign - Optimization Scorecampaign.optimization_scoreOutput 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.
Campaign - Payment Modecampaign.payment_modePayment mode for the campaign.
Campaign - Percent CPC - CPC Bid Ceiling Microscampaign.percent_cpc.cpc_bid_ceiling_microsMaximum 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.
Campaign - Percent CPC - Enhanced CPC Enabledcampaign.percent_cpc.enhanced_cpc_enabledAdjusts 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.
Campaign - Real Time Bidding Setting - Opt Incampaign.real_time_bidding_setting.opt_inWhether the campaign is opted in to real-time bidding.
Campaign - Resource Namecampaign.resource_nameImmutable. The resource name of the campaign. Campaign resource names have the form: customers/{customer_id}/campaigns/{campaign_id}
Campaign - Selective Optimization - Conversion Actionscampaign.selective_optimization.conversion_actionsThe selected set of conversion actions for optimizing this campaign.
Campaign - Serving Statuscampaign.serving_statusOutput only. The ad serving status of the campaign.
Campaign - Shopping Setting - Campaign Prioritycampaign.shopping_setting.campaign_priorityPriority 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.
Campaign - Shopping Setting - Enable Localcampaign.shopping_setting.enable_localWhether to include local products.
Campaign - Shopping Setting - Merchant IDcampaign.shopping_setting.merchant_idImmutable. ID of the Merchant Center account. This field is required for create operations. This field is immutable for Shopping campaigns.
Campaign - Shopping Setting - Sales Countrycampaign.shopping_setting.sales_countrySales country of products to include in the campaign. This field is required for Shopping campaigns. This field is optional for non-Shopping campaigns, but it must be equal to 'ZZ' if set.
Campaign - Shopping Setting - Use Vehicle Inventorycampaign.shopping_setting.use_vehicle_inventoryImmutable. Whether to target Vehicle Listing inventory.
Campaign - Start Datecampaign.start_dateThe date when campaign started in serving customer's timezone in YYYY-MM-DD format.
Campaign - Statuscampaign.statusThe status of the campaign. When a new campaign is added, the status defaults to ENABLED.
Campaign - Target Cpa - CPC Bid Ceiling Microscampaign.target_cpa.cpc_bid_ceiling_microsMaximum 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.
Campaign - Target Cpa - Target Cpa Microscampaign.target_cpa.target_cpa_microsOutput only. Average CPA target. This target should be greater than or equal to minimum billable unit based on the currency for the account.
Campaign - Target CPMcampaign.target_cpmA bidding strategy that automatically optimizes cost per thousand impressions.
Campaign - Target Impression Share - CPC Bid Ceiling Microscampaign.target_impression_share.cpc_bid_ceiling_microsThe 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.
Campaign - Target Cpa - CPC Bid Floor Microscampaign.target_cpa.cpc_bid_floor_microsMinimum 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.
Campaign - Target Cpa - Target Cpa Microscampaign.target_cpa.target_cpa_microsOutput only. Average CPA target. This target should be greater than or equal to minimum billable unit based on the currency for the account.
Campaign - Target Impressions Share - CPC Bid Ceiling Microscampaign.target_impression_share.cpc_bid_ceiling_microsThe 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.
Campaign - Target Impression Share - Locationcampaign.target_impression_share.locationThe targeted location on the search results page.
Campaign - Target Impression Share - Location Fraction Microscampaign.target_impression_share.location_fraction_microsThe desired fraction of ads to be shown in the targeted location in micros. E.g. 1% equals 10,000.
Campaign - Target Roas - CPC Bid Ceiling Microscampaign.target_roas.cpc_bid_ceiling_microsMaximum 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.
Campaign - Target Roas - CPC Bid Floor Microscampaign.target_roas.cpc_bid_floor_microsMinimum 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.
Campaign - Target Roas - Target Roascampaign.target_roas.target_roasRequired. The desired revenue (based on conversion data) per unit of spend. Value must be between 0.01 and 1000.0, inclusive.
Campaign - Target Spend - CPC Bid Ceiling Microscampaign.target_spend.cpc_bid_ceiling_microsMaximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy.
Campaign - Target Spend - Target Spend Microscampaign.target_spend.target_spend_microsThe 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.
Campaign - Targeting Setting - Target Restrictionscampaign.targeting_setting.target_restrictionsThe per-targeting-dimension setting to restrict the reach of your campaign or ad group.
Campaign - Tracking Setting - Tracking Urlcampaign.tracking_setting.tracking_urlOutput only. The url used for dynamic tracking.
Campaign - Tracking Url Templatecampaign.tracking_url_templateThe URL template for constructing a tracking URL.
Campaign - Url Custom Parameterscampaign.url_custom_parametersThe list of mappings used to substitute custom parameter tags in a tracking_url_template, final_urls, or mobile_final_urls.
Campaign - Url Expansion Opt Outcampaign.url_expansion_opt_outRepresents opting out of URL expansion to more targeted URLs. If opted out (true), only the final URLs in the asset group or URLs specified in the advertiser's Google Merchant Center or business data feeds are targeted. If opted in (false), the entire domain will be targeted. This field can only be set for Performance Max campaigns, where the default value is false.
Campaign - Vanity Pharma - Vanity Pharma Display Url Modecampaign.vanity_pharma.vanity_pharma_display_url_modeThe display mode for vanity pharma URLs.
Campaign - Vanity Pharma - Vanity Pharma Textcampaign.vanity_pharma.vanity_pharma_textThe text that will be displayed in display URL of the text ad when website description is the selected display mode for vanity pharma URLs.
Campaign - Video Brand Safety Suitabilitycampaign.video_brand_safety_suitabilityOutput only. 3-Tier Brand Safety setting for the campaign.
Active View CPMmetrics.active_view_cpmAverage cost of viewable impressions (active_view_impressions).
Active View CTRmetrics.active_view_ctrActive view measurable clicks divided by active view viewable impressions. This metric is reported only for display network.
Active View Impressionsmetrics.active_view_impressionsA measurement of how often your ad has become viewable on a Display Network site.
Active View Measurabilitymetrics.active_view_measurabilityThe ratio of impressions that could be measured by Active View over the number of served impressions.
Active View Measurable Cost Microsmetrics.active_view_measurable_cost_microsThe cost of the impressions you received that were measurable by Active View.
Active View Measurable Impressionsmetrics.active_view_measurable_impressionsThe number of times your ads are appearing on placements in positions where they can be seen.
Active View Viewabilitymetrics.active_view_viewabilityThe percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions).
All Conversionsmetrics.all_conversionsThe total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric.
All Conversions By Conversion Datemetrics.all_conversions_by_conversion_dateThe total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009.
All Conversions From Interactions Ratemetrics.all_conversions_from_interactions_rateAll conversions from interactions (as oppose to view through conversions) divided by the number of ad interactions.
All Conversions From Interactions Value Per Interactionmetrics.all_conversions_from_interactions_value_per_interactionThe value of all conversions from interactions divided by the total number of interactions.
All Conversions Valuemetrics.all_conversions_valueThe value of all conversions.
All Conversions Value By Conversion Datemetrics.all_conversions_value_by_conversion_dateThe value of all conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009.
All Conversions Value Per Costmetrics.all_conversions_value_per_costThe value of all conversions divided by the total cost of ad interactions (such as clicks for text ads or views for video ads).
Average Costmetrics.average_costThe average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.
Average CPCmetrics.average_cpcThe total cost of all clicks divided by the total number of clicks received.
Average CPEmetrics.average_cpeThe 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.
Average CPMmetrics.average_cpmAverage cost-per-thousand impressions (CPM).
Average Cpvmetrics.average_cpvThe average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views.
Average Page Viewsmetrics.average_page_viewsAverage number of pages viewed per session.
Average Time On Sitemetrics.average_time_on_siteTotal duration of all sessions (in seconds) / number of sessions. Imported from Google Analytics.
Bounce Ratemetrics.bounce_ratePercentage of clicks where the user only visited a single page on your site. Imported from Google Analytics.
Clicksmetrics.clicksThe number of clicks.
Conversionsmetrics.conversionsThe 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.
Conversions By Conversion Datemetrics.conversions_by_conversion_dateThe number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009.
Conversions From Interactions Ratemetrics.conversions_from_interactions_rateConversions 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.
Conversions From Interactions Value Per Interactionmetrics.conversions_from_interactions_value_per_interactionThe 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.
Conversions Valuemetrics.conversions_valueThe 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.
Conversions Value By Conversion Datemetrics.conversions_value_by_conversion_dateThe value of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009.
Conversions Value Per Costmetrics.conversions_value_per_costThe 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.
Cost Micros (Spend)metrics.cost_microsThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.
Cost Per All Conversionsmetrics.cost_per_all_conversionsThe cost of ad interactions divided by all conversions.
Cost Per Conversionmetrics.cost_per_conversionThe 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.
Cost Per Current Model Attributed Conversionmetrics.cost_per_current_model_attributed_conversionThe 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.
Cross Device Conversionsmetrics.cross_device_conversionsConversions 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.
CTRmetrics.ctrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).
Current Model Attributed Conversionsmetrics.current_model_attributed_conversionsShows 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.
Current Moodel Attributed Conversions From Interactions Ratemetrics.current_model_attributed_conversions_from_interactions_rateCurrent 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.
Current Model Attributed Conversions From Interactions Value Per Interactionmetrics.current_model_attributed_conversions_from_interactions_value_per_interactionThe 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.
Current Model Attributed Conversions Valuemetrics.current_model_attributed_conversions_valueThe 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.
Current Model Attributed Conversions Value Per Costmetrics.current_model_attributed_conversions_value_per_costThe 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.
Engagement Ratemetrics.engagement_rateHow often people engage with your ad after it's shown to them. This is the number of ad expansions divided by the number of times your ad is shown.
Engagementsmetrics.engagementsThe number of engagements. An engagement occurs when a viewer expands your Lightbox ad. Also, in the future, other ad types may support engagement metrics.
Gmail Forwardsmetrics.gmail_forwardsThe number of times the ad was forwarded to someone else as a message.
Gmail Savesmetrics.gmail_savesThe number of times someone has saved your Gmail ad to their inbox as a message.
Impressionsmetrics.impressionsCount of how often your ad has appeared on a search results page or website on the Google Network.
Interaction Event Typesmetrics.interaction_event_typesThe types of payable and free interactions.
Interactions Ratemetrics.interaction_rateHow often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown.
Interactionsmetrics.interactionsThe 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.
Percent New Visitorsmetrics.percent_new_visitorsPercentage of first-time sessions (from people who had never visited your site before). Imported from Google Analytics.
Phone Callsmetrics.phone_callsNumber of offline phone calls.
Phone Impressionsmetrics.phone_impressionsNumber of offline phone impressions.
Phone Through Ratemetrics.phone_through_rateNumber of phone calls received (phone_calls) divided by the number of times your phone number is shown (phone_impressions).
Top Impression Percentagemetrics.top_impression_percentageThe percent of your ad impressions that are shown anywhere above the organic search results.
Value Per All Conversionsmetrics.value_per_all_conversionsThe value of all conversions divided by the number of all conversions.
Value Per Conversionmetrics.value_per_conversionThe value of conversions divided by the number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
Video Quartile_100_ratemetrics.video_quartile_p100_ratePercentage of impressions where the viewer watched all of your video.
Video Quartile_25_ratemetrics.video_quartile_p25_ratePercentage of impressions where the viewer watched 25% of your video.
Video Quartile_50_ratemetrics.video_quartile_p50_ratePercentage of impressions where the viewer watched 50% of your video.
Video Quartile_75_ratemetrics.video_quartile_p75_ratePercentage of impressions where the viewer watched 75% of your video.
Video View Ratemetrics.video_view_rateThe number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads.
Video Viewsmetrics.video_viewsThe number of times your video ads were viewed.
View Through Conversionsmetrics.view_through_conversionsThe total number of view-through conversions. These happen when a customer sees an image or rich media ad, then later completes a conversion on your site without interacting with (e.g., clicking on) another ad.
Network Typesegments.ad_network_typeAd network type.
Destination Typesegments.ad_destination_typeAd Destination type.
Click Typesegments.click_typeClick type.
Conversion Actionsegments.conversion_actionResource name of the conversion action.
Conversion Action Categorysegments.conversion_action_categoryConversion action category.
Ad Group Conversion Action Namesegments.conversion_action_nameConversion action name.
Conversion Adjustmentsegments.conversion_adjustmentThis segments your conversion columns by the original conversion and conversion value vs. 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.
Conversion Lag Bucketsegments.conversion_lag_bucketAn enum value representing the number of days between the impression and the conversion.
Conversion Or Adjustment Lag Bucketsegments.conversion_or_adjustment_lag_bucketAn enum value representing the number of days between the impression and the conversion or between the impression and adjustments to the conversion.
Datesegments.dateDate to which metrics apply. yyyy-MM-dd format, e.g., 2018-04-17.
Day Of Weeksegments.day_of_weekDay of the week, e.g., MONDAY.
Devicesegments.deviceDevice to which metrics apply.
Conversion Sourcesegments.external_conversion_sourceExternal conversion source.
Interaction On This Extensionsegments.interaction_on_this_extensionOnly used with feed item metrics. Indicates whether the interaction metrics occurred on the feed item itself or a different extension or ad unit.
Keywordsegments.keyword.ad_group_criterionThe AdGroupCriterion resource name.
Keyword Match Typesegments.keyword.info.match_typeThe match type of the keyword.
Keyword Textsegments.keyword.info.textThe text of the keyword (at most 80 characters and 10 words).
Monthsegments.monthMonth as represented by the date of the first day of a month. Formatted as yyyy-MM-dd.
Month Of Yearsegments.month_of_yearMonth of the year, e.g., January.
Quartersegments.quarterQuarter as represented by the date of the first day of a quarter. Uses the calendar year for quarters, e.g., the second quarter of 2018 starts on 2018-04-01. Formatted as yyyy-MM-dd.
Top Vs. Othersegments.slotPosition of the ad.
Weeksegments.weekWeek as defined as Monday through Sunday, and represented by the date of Monday. Formatted as yyyy-MM-dd.
Yearsegments.yearYear, formatted as yyyy.

Age Range View Reports

Dataddo LabelGoogle Ads LabelField Description
Age Range View - Resource Nameage_range_view.resource_nameOutput only. The resource name of the age range view. Age range view resource names have the form: customers/{customer_id}/ageRangeViews/{ad_group_id}~{criterion_id}
Customer - IDcustomer.idOutput only. The ID of the customer.
Customer - Currency Codecustomer.currency_codeImmutable. The currency in which the account operates. A subset of the currency codes from the ISO 4217 standard is supported.
Customer - Statuscustomer.statusOutput only. The status of the customer.
Customer - Descriptive Namecustomer.descriptive_nameOptional, non-unique descriptive name of the customer.
Customer - Time Zonecustomer.time_zoneImmutable. The local timezone ID of the customer.
Campaign - Accessible Bidding Strategycampaign.accessible_bidding_strategyOutput 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.
Campaign - Ad Serving Optimization Statuscampaign.ad_serving_optimization_statusThe ad serving optimization status of the campaign.
Campaign - Advertising Channel Sub Typecampaign.advertising_channel_sub_typeImmutable. 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.
Campaign - Advertising Channel Typecampaign.advertising_channel_typeImmutable. 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.
Campaign - App Campaign Setting - App IDcampaign.app_campaign_setting.app_idImmutable. A string that uniquely identifies a mobile application.
Campaign - App Campaign Setting - App Storecampaign.app_campaign_setting.app_storeImmutable. The application store that distributes this specific app.
Campaign - App Campaign Setting - Bidding Strategy Goal Typecampaign.app_campaign_setting.bidding_strategy_goal_typeRepresents the goal which the bidding strategy of this app campaign should optimize towards.
Campaign - Audience Settings - Use Audience Grouped Targetscampaign.audience_setting.use_audience_grouped.targetImmutable. If true, this campaign uses an Audience resource for audience targeting. If false, this campaign may use audience segment criteria instead.
Campaign - Base Campaigncampaign.base_campaignOutput 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.
Campaign - Bidding Strategycampaign.bidding_strategyPortfolio bidding strategy used by campaign.
Campaign - Bidding Strategy Typecampaign.bidding_strategy_typeOutput 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.
Campaign - Campaign Budgetcampaign.campaign_budgetThe budget of the campaign.
Campaign - Commission - Commission Rate Microscampaign.commission.commission_rate_microsCommission 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%).
Campaign - Dynamic Search Ads Setting - Domain Namecampaign.dynamic_search_ads_setting.domain_nameRequired. The Internet domain name that this setting represents, e.g., google.com or www.google.com.
Campaign - Dynamic Search Ads Setting - Language Codecampaign.dynamic_search_ads_setting.language_codeRequired. The language code specifying the language of the domain, e.g., en.
Campaign - Dynamic Search Ads Setting - Feedscampaign.dynamic_search_ads_setting.feedsThe list of page feeds associated with the campaign.
Campaign - Dynamic Search Ads Setting - Use Supplied Urls Onlycampaign.dynamic_search_ads_setting.use_supplied_urls_onlyWhether the campaign uses advertiser supplied URLs exclusively.
Campaign - End Datecampaign.end_dateThe last day of the campaign in serving customer's timezone in YYYY-MM-DD format.
Campaign - Excluded Parent Asset Field Typescampaign.excluded_parent_asset_field_typesThe 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.
Campaign - Experiment Typecampaign.experiment_typeOutput only. The type of campaign: normal, draft, or experiment.
Campaign - Final Url Suffixcampaign.final_url_suffixSuffix used to append query parameters to landing pages that are served with parallel tracking.
Campaign - Frequency Capscampaign.frequency_capsA list that limits how often each user will see this campaign's ads.
Campaign - IDcampaign.idOutput only. The ID of the campaign.
Campaign - Labelscampaign.labelsOutput only. The resource names of labels attached to this campaign.
Campaign - Local Campaign Setting - Location Source Typecampaign.local_campaign_setting.location_source_typeThe location source type for this local campaign.
Campaign - Manual CPC - Enhanced CPC Enabledcampaign.manual_cpc.enhanced_cpc_enabledWhether bids are to be enhanced based on conversion optimizer data.
Campaign - Manual CPMcampaign.manual_cpmStandard Manual CPM bidding strategy. Manual impression-based bidding where user pays per thousand impressions.
Campaign - Manual Cpvcampaign.manual_cpvOutput only. A bidding strategy that pays a configurable amount per video view.
Campaign - Maximize Conversion Value - Target Roascampaign.maximize_conversion_value.target_roasOutput only. 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.
Campaign - Maximize Conversions - Target Cpacampaign.maximize_conversions.target_cpaThe 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.
Campaign - Namecampaign.nameThe 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.
Campaign - Network Settings - Target Content Networkcampaign.network_settings.target_content_networkWhether ads will be served on specified placements in the Google Display Network. Placements are specified using the Placement criterion.
Campaign - Network Settings - Target Search Networkcampaign.network_settings.target_search_networkWhether ads will be served on partner sites in the Google Search Network (requires target_google_search to also be true).
Campaign - Network Settings - Target Partner Search Networkcampaign.network_settings.target_partner_search_networkWhether ads will be served on the Google Partner Network. This is available only to some select Google partner accounts.
Campaign - Network Settings - Target Google Searchcampaign.network_settings.target_google_searchWhether ads will be served with google.com search results.
Campaign - Optimization Goal Setting - Optimization Goal Typescampaign.optimization_goal_setting.optimization_goal_typesThe list of optimization goal types.
Campaign - Optimization Scorecampaign.optimization_scoreOutput 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.
Campaign - Payment Modecampaign.payment_modePayment mode for the campaign.
Campaign - Percent CPC - CPC Bid Ceiling Microscampaign.percent_cpc.cpc_bid_ceiling_microsMaximum 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.
Campaign - Percent CPC - Enhanced CPC Enabledcampaign.percent_cpc.enhanced_cpc_enabledAdjusts 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.
Campaign - Real Time Bidding Setting - Opt Incampaign.real_time_bidding_setting.opt_inWhether the campaign is opted in to real-time bidding.
Campaign - Resource Namecampaign.resource_nameImmutable. The resource name of the campaign. Campaign resource names have the form: customers/{customer_id}/campaigns/{campaign_id}
Campaign - Selective Optimization - Conversion Actionscampaign.selective_optimization.conversion_actionsThe selected set of conversion actions for optimizing this campaign.
Campaign - Serving Statuscampaign.serving_statusOutput only. The ad serving status of the campaign.
Campaign - Shopping Setting - Campaign Prioritycampaign.shopping_setting.campaign_priorityPriority 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.
Campaign - Shopping Setting - Enable Localcampaign.shopping_setting.enable_localWhether to include local products.
Campaign - Shopping Setting - Merchant IDcampaign.shopping_setting.merchant_idImmutable. ID of the Merchant Center account. This field is required for create operations. This field is immutable for Shopping campaigns.
Campaign - Shopping Setting - Sales Countrycampaign.shopping_setting.sales_countrySales country of products to include in the campaign. This field is required for Shopping campaigns. This field is optional for non-Shopping campaigns, but it must be equal to 'ZZ' if set.
Campaign - Shopping Setting - Use Vehicle Inventorycampaign.shopping_setting.use_vehicle_inventoryImmutable. Whether to target Vehicle Listing inventory.
Campaign - Start Datecampaign.start_dateThe date when campaign started in serving customer's timezone in YYYY-MM-DD format.
Campaign - Statuscampaign.statusThe status of the campaign. When a new campaign is added, the status defaults to ENABLED.
Campaign - Target Cpa - CPC Bid Ceiling Microscampaign.target_cpa.cpc_bid_ceiling_microsMaximum 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.
Campaign - Target Cpa - Target Cpa Microscampaign.target_cpa.target_cpa_microsOutput only. Average CPA target. This target should be greater than or equal to minimum billable unit based on the currency for the account.
Campaign - Target CPMcampaign.target_cpmA bidding strategy that automatically optimizes cost per thousand impressions.
Campaign - Target Impression Share - CPC Bid Ceiling Microscampaign.target_impression_share.cpc_bid_ceiling_microsThe 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.
Campaign - Target Cpa - CPC Bid Floor Microscampaign.target_cpa.cpc_bid_floor_microsMinimum 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.
Camkpaign - Target Cpa - Target Cpa Microscampaign.target_cpa.target_cpa_microsOutput only. Average CPA target. This target should be greater than or equal to minimum billable unit based on the currency for the account.
Campaign - Target Impressions Share - CPC Bid Ceiling Microscampaign.target_impression_share.cpc_bid_ceiling_microsThe 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.
Campaign - Target Impression Share - Locationcampaign.target_impression_share.locationThe targeted location on the search results page.
Campaign - Target Impression Share - Location Fraction Microscampaign.target_impression_share.location_fraction_microsThe desired fraction of ads to be shown in the targeted location in micros. E.g. 1% equals 10,000.
Campaign - Target Roas - CPC Bid Ceiling Microscampaign.target_roas.cpc_bid_ceiling_microsMaximum 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.
Campaign - Target Roas - CPC Bid Floor Microscampaign.target_roas.cpc_bid_floor_microsMinimum 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.
Campaign - Target Roas - Target Roascampaign.target_roas.target_roasRequired. The desired revenue (based on conversion data) per unit of spend. Value must be between 0.01 and 1000.0, inclusive.
Campaign - Target Spend - CPC Bid Ceiling Microscampaign.target_spend.cpc_bid_ceiling_microsMaximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy.
Campaign - Target Spend - Target Spend Microscampaign.target_spend.target_spend_microsThe 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.
Campaign - Targeting Setting - Target Restrictionscampaign.targeting_setting.target_restrictionsThe per-targeting-dimension setting to restrict the reach of your campaign or ad group.
Campaign - Tracking Setting - Tracking Urlcampaign.tracking_setting.tracking_urlOutput only. The url used for dynamic tracking.
Campaign - Tracking Url Templatecampaign.tracking_url_templateThe URL template for constructing a tracking URL.
Campaign - Url Custom Parameterscampaign.url_custom_parametersThe list of mappings used to substitute custom parameter tags in a tracking_url_template, final_urls, or mobile_final_urls.
Campaign - Url Expansion Opt Outcampaign.url_expansion_opt_outRepresents opting out of URL expansion to more targeted URLs. If opted out (true), only the final URLs in the asset group or URLs specified in the advertiser's Google Merchant Center or business data feeds are targeted. If opted in (false), the entire domain will be targeted. This field can only be set for Performance Max campaigns, where the default value is false.
Campaign - Vanity Pharma - Vanity Pharma Display Url Modecampaign.vanity_pharma.vanity_pharma_display_url_modeThe display mode for vanity pharma URLs.
Campaign - Vanity Pharma - Vanity Pharma Textcampaign.vanity_pharma.vanity_pharma_textThe text that will be displayed in display URL of the text ad when website description is the selected display mode for vanity pharma URLs.
Campaign - Video Brand Safety Suitabilitycampaign.video_brand_safety_suitabilityOutput only. 3-Tier Brand Safety setting for the campaign.
Bidding Strategy - IDbidding_strategy.idOutput only. The ID of the bidding strategy.
Bidding Strategy - Namebidding_strategy.nameThe name of the bidding strategy. All bidding strategies within an account must be named distinctly. The length of this string should be between 1 and 255, inclusive, in UTF-8 bytes, (trimmed).
Bidding Strategy - Typebidding_strategy.typeOutput only. The type of the bidding strategy. Create a bidding strategy by setting the bidding scheme. This field is read-only.
Bidding Strategy - Statusbidding_strategy.statusOutput only. The status of the bidding strategy. This field is read-only.
Ad Group Criterion - Criterion IDad_group_criterion.criterion_idOutput only. The ID of the criterion. This field is ignored for mutates.
Ad Group Criterion - Age Range - Typead_group_criterion.age_range.typeType of the age range.
Ad Group Criterion - Approval Statusad_group_criterion.approval_statusOutput only. Approval status of the criterion.
Ad Group Criterion - Audience - Audiencead_group_criterion.audience.audienceThe Audience resource name.
Ad Group Criterion - Typead_group_criterion.typeOutput only. The type of the criterion.
Ad Group Criterion - Statusad_group_criterion.statusThe status of the criterion. This is the status of the ad group criterion entity, set by the client. Note: UI reports may incorporate additional information that affects whether a criterion is eligible to run. In some cases a criterion that's REMOVED in the API can still show as enabled in the UI. For example, campaigns by default show to users of all age ranges unless excluded. The UI will show each age range as enabled, since they're eligible to see the ads
Ad Group Criterion - Gender - Typead_group_criterion.gender.typeType of the gender.
Ad Group Criterion - Keyword - Match Typead_group_criterion.keyword.match_typeThe match type of the keyword.
Ad Group Criterion - Keyword - Textad_group_criterion.keyword.textThe text of the keyword (at most 80 characters and 10 words).
Ad Group Criterion - Negativead_group_criterion.negativeImmutable. Whether to target (false) or exclude (true) the criterion. This field is immutable. To switch a criterion from positive to negative, remove then re-add it.
Ad Group Criterion - Position Estimates - First Page CPC Microsad_group_criterion.position_estimates.first_page_cpc_microsOutput only. The estimate of the CPC bid required for ad to be shown on first page of search results.
Ad Group Criterion - Position Estimates - First Position CPC Microsad_group_criterion.position_estimates.first_position_cpc_microsOutput only. The estimate of the CPC bid required for ad to be displayed in first position, at the top of the first page of search results.
Ad Group Criterion - CPM Bid Microsad_group_criterion.cpm_bid_microsThe CPM (cost-per-thousand viewable impressions) bid.
Ad Group Criterion - Effective CPM Bid Microsad_group_criterion.effective_cpm_bid_microsOutput only. The effective CPM (cost-per-thousand viewable impressions) bid.
Ad Group Criterion - Effective CPM Bid Sourcead_group_criterion.effective_cpm_bid_sourceOutput only. Source of the effective CPM bid.
Ad Group Criterion - CPC Bid Microsad_group_criterion.cpc_bid_microsThe CPC (cost-per-click) bid.
Ad Group Criterion - Effective CPC Bid Microsad_group_criterion.effective_cpc_bid_microsOutput only. The effective CPC (cost-per-click) bid.
Ad Group Criterion - Effective CPC Bid Sourcead_group_criterion.effective_cpc_bid_sourceOutput only. Source of the effective CPC bid.
Ad Group Criterion - Final Mobile Urlsad_group_criterion.final_mobile_urlsThe list of possible final mobile URLs after all cross-domain redirects.
Ad Group Criterion - Final Urlsad_group_criterion.final_urlsThe list of possible final URLs after all cross-domain redirects for the ad.
Ad Group Criterion - Tracking Url Templatead_group_criterion.tracking_url_templateThe URL template for constructing a tracking URL.
Ad Group Criterion - Bid Modifierad_group_criterion.bid_modifierThe modifier for the bid when the criterion matches. The modifier must be in the range: 0.1 - 10.0. Most targetable criteria types support modifiers.
Ad Group Criterion - Url Custom Parametersad_group_criterion.url_custom_parametersThe list of mappings used to substitute custom parameter tags in a tracking_url_template, final_urls, or mobile_final_urls.
Active View CPMmetrics.active_view_cpmAverage cost of viewable impressions (active_view_impressions).
Active View CTRmetrics.active_view_ctrActive view measurable clicks divided by active view viewable impressions. This metric is reported only for display network.
Active View Impressionsmetrics.active_view_impressionsA measurement of how often your ad has become viewable on a Display Network site.
Active View Measurabilitymetrics.active_view_measurabilityThe ratio of impressions that could be measured by Active View over the number of served impressions.
Active View Measurable Cost Microsmetrics.active_view_measurable_cost_microsThe cost of the impressions you received that were measurable by Active View.
Active View Measurable Impressionsmetrics.active_view_measurable_impressionsThe number of times your ads are appearing on placements in positions where they can be seen.
Active View Viewabilitymetrics.active_view_viewabilityThe percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions).
All Conversionsmetrics.all_conversionsThe total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric.
All Conversions Valuemetrics.all_conversions_valueThe value of all conversions.
Average Costmetrics.average_costThe average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.
Average CPCmetrics.average_cpcThe total cost of all clicks divided by the total number of clicks received.
Average CPEmetrics.average_cpeThe 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.
Average CPMmetrics.average_cpmAverage cost-per-thousand impressions (CPM).
Average Cpvmetrics.average_cpvThe average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views.
Clicksmetrics.clicksThe number of clicks.
Conversionsmetrics.conversionsThe 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.
Conversions From Interactions Ratemetrics.conversions_from_interactions_rateConversions 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.
Conversions Valuemetrics.conversions_valueThe 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.
Cost Micros (Spend)metrics.cost_microsThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.
Cost Per Conversionmetrics.cost_per_conversionThe 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.
Cost Per All Conversionsmetrics.cost_per_all_conversionsThe cost of ad interactions divided by all conversions.
Cross Device Conversionsmetrics.cross_device_conversionsConversions 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.
CTRmetrics.ctrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).
Engagement Ratemetrics.engagement_rateHow often people engage with your ad after it's shown to them. This is the number of ad expansions divided by the number of times your ad is shown.
Engagementsmetrics.engagementsThe number of engagements. An engagement occurs when a viewer expands your Lightbox ad. Also, in the future, other ad types may support engagement metrics.
Impressionsmetrics.impressionsCount of how often your ad has appeared on a search results page or website on the Google Network.
Gmail Forwardsmetrics.gmail_forwardsThe number of times the ad was forwarded to someone else as a message.
Gmail Savesmetrics.gmail_savesThe number of times someone has saved your Gmail ad to their inbox as a message.
Gmail Secondary Clicksmetrics.gmail_secondary_clicksThe number of clicks to the landing page on the expanded state of Gmail ads.
Interaction Event Typesmetrics.interaction_event_typesThe types of payable and free interactions.
Interaction Ratemetrics.interaction_rateHow often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown.
Interactionsmetrics.interactionsThe 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.
Value Per All Conversionsmetrics.value_per_all_conversionsThe value of all conversions divided by the number of all conversions.
Value Per Conversionsmetrics.value_per_conversionThe value of conversions divided by the number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
Video Quartile P100_ratemetrics.video_quartile_p100_ratePercentage of impressions where the viewer watched all of your video.
Video Quartile P75_ratemetrics.video_quartile_p75_ratePercentage of impressions where the viewer watched 75% of your video.
Video Quartile P50_ratemetrics.video_quartile_p50_ratePercentage of impressions where the viewer watched 50% of your video.
Video Quartile P25_ratemetrics.video_quartile_p25_ratePercentage of impressions where the viewer watched 25% of your video.
Video View Ratemetrics.video_view_rateThe number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads.
Video Viewsmetrics.video_viewsThe number of times your video ads were viewed.
View Through Conversionsmetrics.view_through_conversionsThe total number of view-through conversions. These happen when a customer sees an image or rich media ad, then later completes a conversion on your site without interacting with (e.g., clicking on) another ad.
Datesegments.dateDate to which metrics apply. yyyy-MM-dd format, e.g., 2018-04-17.
Weeksegments.weekWeek as defined as Monday through Sunday, and represented by the date of Monday. Formatted as yyyy-MM-dd.
Monthsegments.monthMonth as represented by the date of the first day of a month. Formatted as yyyy-MM-dd.
Yearsegments.yearYear, formatted as yyyy.
Devicesegments.deviceDevice to which metrics apply.
Click Typesegments.click_typeClick type.
Ad Network Typesegments.ad_network_typeAd network type.
Conversion Action Categorysegments.conversion_action_categoryConversion action category.
Conversion Actionsegments.conversion_actionResource name of the conversion action.
Conversion Action Namesegments.conversion_action_nameConversion action name.
Day Of Weeksegments.day_of_weekDay of the week, e.g., MONDAY.
Month Of Yearsegments.month_of_yearMonth of the year, e.g., January.
External Conversion Sourcesegments.external_conversion_sourceExternal conversion source.

Keyword View Reports

Dataddo LabelGoogle Ads LabelField Description
Keyword View - Resource Namekeyword_view.resource_nameOutput only. The resource name of the keyword view. Keyword view resource names have the form: customers/{customer_id}/keywordViews/{ad_group_id}~{criterion_id}
Customer - IDcustomer.idOutput only. The ID of the customer.
Customer - Currency Codecustomer.currency_codeImmutable. The currency in which the account operates. A subset of the currency codes from the ISO 4217 standard is supported.
Customer - Statuscustomer.statusOutput only. The status of the customer.
Customer - Descriptive Namecustomer.descriptive_nameOptional, non-unique descriptive name of the customer.
Customer - Time Zonecustomer.time_zoneImmutable. The local timezone ID of the customer.
Campaign - Accessible Bidding Strategycampaign.accessible_bidding_strategyOutput 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.
Campaign - Ad Serving Optimization Statuscampaign.ad_serving_optimization_statusThe ad serving optimization status of the campaign.
Campaign - Advertising Channel Sub Typecampaign.advertising_channel_sub_typeImmutable. 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.
Campaign - Advertising Channel Typecampaign.advertising_channel_typeImmutable. 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.
Campaign - App Campaign Setting - App IDcampaign.app_campaign_setting.app_idImmutable. A string that uniquely identifies a mobile application.
Campaign - App Campaign Setting - App Storecampaign.app_campaign_setting.app_storeImmutable. The application store that distributes this specific app.
Campaign - App Campaign Setting - Bidding Strategy Goal Typecampaign.app_campaign_setting.bidding_strategy_goal_typeRepresents the goal which the bidding strategy of this app campaign should optimize towards.
Campaign - Audience Settings - Use Audience Grouped Targetscampaign.audience_setting.use_audience_grouped.targetImmutable. If true, this campaign uses an Audience resource for audience targeting. If false, this campaign may use audience segment criteria instead.
Campaign - Base Campaigncampaign.base_campaignOutput 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.
Campaign - Bidding Strategycampaign.bidding_strategyPortfolio bidding strategy used by campaign.
Campaign - Bidding Strategy Typecampaign.bidding_strategy_typeOutput 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.
Campaign - Campaign Budgetcampaign.campaign_budgetThe budget of the campaign.
Campaign - Commission - Commission Rate Microscampaign.commission.commission_rate_microsCommission 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%).
Campaign - Dynamic Search Ads Setting - Domain Namecampaign.dynamic_search_ads_setting.domain_nameRequired. The Internet domain name that this setting represents, e.g., google.com or www.google.com.
Campaign - Dynamic Search Ads Setting - Language Codecampaign.dynamic_search_ads_setting.language_codeRequired. The language code specifying the language of the domain, e.g., en.
Campaign - Dynamic Search Ads Setting - Feedscampaign.dynamic_search_ads_setting.feedsThe list of page feeds associated with the campaign.
Campaign - Dynamic Search Ads Setting - Use Supplied Urls Onlycampaign.dynamic_search_ads_setting.use_supplied_urls_onlyWhether the campaign uses advertiser supplied URLs exclusively.
Campaign - End Datecampaign.end_dateThe last day of the campaign in serving customer's timezone in YYYY-MM-DD format.
Campaign - Excluded Parent Asset Field Typescampaign.excluded_parent_asset_field_typesThe 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.
Campaign - Experiment Typecampaign.experiment_typeOutput only. The type of campaign: normal, draft, or experiment.
Campaign - Final Url Suffixcampaign.final_url_suffixSuffix used to append query parameters to landing pages that are served with parallel tracking.
Campaign - Frequency Capscampaign.frequency_capsA list that limits how often each user will see this campaign's ads.
Campaign - IDcampaign.idOutput only. The ID of the campaign.
Campaign - Labelscampaign.labelsOutput only. The resource names of labels attached to this campaign.
Campaign - Local Campaign Setting - Location Source Typecampaign.local_campaign_setting.location_source_typeThe location source type for this local campaign.
Campaign - Manual CPC - Enhanced CPC Enabledcampaign.manual_cpc.enhanced_cpc_enabledWhether bids are to be enhanced based on conversion optimizer data.
Campaign - Manual CPMcampaign.manual_cpmStandard Manual CPM bidding strategy. Manual impression-based bidding where user pays per thousand impressions.
Campaign - Manual Cpvcampaign.manual_cpvOutput only. A bidding strategy that pays a configurable amount per video view.
Campaign - Maximize Conversion Value - Target Roascampaign.maximize_conversion_value.target_roasOutput only. 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.
Campaign - Maximize Conversions - Target Cpacampaign.maximize_conversions.target_cpaThe 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.
Campaign - Namecampaign.nameThe 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.
Campaign - Network Settings - Target Content Networkcampaign.network_settings.target_content_networkWhether ads will be served on specified placements in the Google Display Network. Placements are specified using the Placement criterion.
Campaign - Network Settings - Target Search Networkcampaign.network_settings.target_search_networkWhether ads will be served on partner sites in the Google Search Network (requires target_google_search to also be true).
Campaign - Network Settings - Target Partner Search Networkcampaign.network_settings.target_partner_search_networkWhether ads will be served on the Google Partner Network. This is available only to some select Google partner accounts.
Campaign - Network Settings - Target Google Searchcampaign.network_settings.target_google_searchWhether ads will be served with google.com search results.
Campaign - Optimization Goal Setting - Optimization Goal Typescampaign.optimization_goal_setting.optimization_goal_typesThe list of optimization goal types.
Campaign - Optimization Scorecampaign.optimization_scoreOutput 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.
Campaign - Payment Modecampaign.payment_modePayment mode for the campaign.
Campaign - Percent CPC - CPC Bid Ceiling Microscampaign.percent_cpc.cpc_bid_ceiling_microsMaximum 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.
Campaign - Percent CPC - Enhanced CPC Enabledcampaign.percent_cpc.enhanced_cpc_enabledAdjusts 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.
Campaign - Real Time Bidding Setting - Opt Incampaign.real_time_bidding_setting.opt_inWhether the campaign is opted in to real-time bidding.
Campaign - Resource Namecampaign.resource_nameImmutable. The resource name of the campaign. Campaign resource names have the form: customers/{customer_id}/campaigns/{campaign_id}
Campaign - Selective Optimization - Conversion Actionscampaign.selective_optimization.conversion_actionsThe selected set of conversion actions for optimizing this campaign.
Campaign - Serving Statuscampaign.serving_statusOutput only. The ad serving status of the campaign.
Campaign - Shopping Setting - Campaign Prioritycampaign.shopping_setting.campaign_priorityPriority 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.
Campaign - Shopping Setting - Enable Localcampaign.shopping_setting.enable_localWhether to include local products.
Campaign - Shopping Setting - Merchant IDcampaign.shopping_setting.merchant_idImmutable. ID of the Merchant Center account. This field is required for create operations. This field is immutable for Shopping campaigns.
Campaign - Shopping Setting - Sales Countrycampaign.shopping_setting.sales_countrySales country of products to include in the campaign. This field is required for Shopping campaigns. This field is optional for non-Shopping campaigns, but it must be equal to 'ZZ' if set.
Campaign - Shopping Setting - Use Vehicle Inventorycampaign.shopping_setting.use_vehicle_inventoryImmutable. Whether to target Vehicle Listing inventory.
Campaign - Start Datecampaign.start_dateThe date when campaign started in serving customer's timezone in YYYY-MM-DD format.
Campaign - Statuscampaign.statusThe status of the campaign. When a new campaign is added, the status defaults to ENABLED.
Campaign - Target Cpa - CPC Bid Ceiling Microscampaign.target_cpa.cpc_bid_ceiling_microsMaximum 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.
Campaign - Target Cpa - Target Cpa Microscampaign.target_cpa.target_cpa_microsOutput only. Average CPA target. This target should be greater than or equal to minimum billable unit based on the currency for the account.
Campaign - Target CPMcampaign.target_cpmA bidding strategy that automatically optimizes cost per thousand impressions.
Campaign - Target Impression Share - CPC Bid Ceiling Microscampaign.target_impression_share.cpc_bid_ceiling_microsThe 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.
Campaign - Target Cpa - CPC Bid Floor Microscampaign.target_cpa.cpc_bid_floor_microsMinimum 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.
Camkpaign - Target Cpa - Target Cpa Microscampaign.target_cpa.target_cpa_microsOutput only. Average CPA target. This target should be greater than or equal to minimum billable unit based on the currency for the account.
Campaign - Target Impressions Share - CPC Bid Ceiling Microscampaign.target_impression_share.cpc_bid_ceiling_microsThe 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.
Campaign - Target Impression Share - Locationcampaign.target_impression_share.locationThe targeted location on the search results page.
Campaign - Target Impression Share - Location Fraction Microscampaign.target_impression_share.location_fraction_microsThe desired fraction of ads to be shown in the targeted location in micros. E.g. 1% equals 10,000.
Campaign - Target Roas - CPC Bid Ceiling Microscampaign.target_roas.cpc_bid_ceiling_microsMaximum 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.
Campaign - Target Roas - CPC Bid Floor Microscampaign.target_roas.cpc_bid_floor_microsMinimum 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.
Campaign - Target Spend - CPC Bid Floor Microscampaign.target_spend.cpc_bid_floor_micros#N/A
Campaign - Target Roas - Target Roascampaign.target_roas.target_roasRequired. The desired revenue (based on conversion data) per unit of spend. Value must be between 0.01 and 1000.0, inclusive.
Campaign - Target Spend - CPC Bid Ceiling Microscampaign.target_spend.cpc_bid_ceiling_microsMaximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy.
Campaign - Target Spend - Target Spend Microscampaign.target_spend.target_spend_microsThe 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.
Campaign - Targeting Setting - Target Restrictionscampaign.targeting_setting.target_restrictionsThe per-targeting-dimension setting to restrict the reach of your campaign or ad group.
Campaign - Tracking Setting - Tracking Urlcampaign.tracking_setting.tracking_urlOutput only. The url used for dynamic tracking.
Campaign - Tracking Url Templatecampaign.tracking_url_templateThe URL template for constructing a tracking URL.
Campaign - Url Custom Parameterscampaign.url_custom_parametersThe list of mappings used to substitute custom parameter tags in a tracking_url_template, final_urls, or mobile_final_urls.
Campaign - Url Expansion Opt Outcampaign.url_expansion_opt_outRepresents opting out of URL expansion to more targeted URLs. If opted out (true), only the final URLs in the asset group or URLs specified in the advertiser's Google Merchant Center or business data feeds are targeted. If opted in (false), the entire domain will be targeted. This field can only be set for Performance Max campaigns, where the default value is false.
Campaign - Vanity Pharma - Vanity Pharma Display Url Modecampaign.vanity_pharma.vanity_pharma_display_url_modeThe display mode for vanity pharma URLs.
Campaign - Vanity Pharma - Vanity Pharma Textcampaign.vanity_pharma.vanity_pharma_textThe text that will be displayed in display URL of the text ad when website description is the selected display mode for vanity pharma URLs.
Campaign - Video Brand Safety Suitabilitycampaign.video_brand_safety_suitabilityOutput only. 3-Tier Brand Safety setting for the campaign.
Ad Group Criterion - Criterion IDad_group_criterion.criterion_idOutput only. The ID of the criterion. This field is ignored for mutates.
Ad Group Criterion - Age Range - Typead_group_criterion.age_range.typeType of the age range.
Ad Group Criterion - Approval Statusad_group_criterion.approval_statusOutput only. Approval status of the criterion.
Ad Group Criterion - Audience - Audiencead_group_criterion.audience.audienceThe Audience resource name.
Ad Group Criterion - Typead_group_criterion.typeOutput only. The type of the criterion.
Ad Group Criterion - Statusad_group_criterion.statusThe status of the criterion. This is the status of the ad group criterion entity, set by the client. Note: UI reports may incorporate additional information that affects whether a criterion is eligible to run. In some cases a criterion that's REMOVED in the API can still show as enabled in the UI. For example, campaigns by default show to users of all age ranges unless excluded. The UI will show each age range as enabled, since they're eligible to see the ads
Ad Group Criterion - Gender - Typead_group_criterion.gender.typeType of the gender.
Ad Group Criterion - Keyword - Match Typead_group_criterion.keyword.match_typeThe match type of the keyword.
Ad Group Criterion - Keyword - Textad_group_criterion.keyword.textThe text of the keyword (at most 80 characters and 10 words).
Ad Group Criterion - Negativead_group_criterion.negativeImmutable. Whether to target (false) or exclude (true) the criterion. This field is immutable. To switch a criterion from positive to negative, remove then re-add it.
Ad Group Criterion - Position Estimates - First Page CPC Microsad_group_criterion.position_estimates.first_page_cpc_microsOutput only. The estimate of the CPC bid required for ad to be shown on first page of search results.
Ad Group Criterion - Position Estimates - First Position CPC Microsad_group_criterion.position_estimates.first_position_cpc_microsOutput only. The estimate of the CPC bid required for ad to be displayed in first position, at the top of the first page of search results.
Ad Group Criterion - CPM Bid Microsad_group_criterion.cpm_bid_microsThe CPM (cost-per-thousand viewable impressions) bid.
Ad Group Criterion - Effective CPM Bid Microsad_group_criterion.effective_cpm_bid_microsOutput only. The effective CPM (cost-per-thousand viewable impressions) bid.
Ad Group Criterion - Effective CPM Bid Sourcead_group_criterion.effective_cpm_bid_sourceOutput only. Source of the effective CPM bid.
Ad Group Criterion - CPC Bid Microsad_group_criterion.cpc_bid_microsThe CPC (cost-per-click) bid.
Ad Group Criterion - Effective CPC Bid Microsad_group_criterion.effective_cpc_bid_microsOutput only. The effective CPC (cost-per-click) bid.
Ad Group Criterion - Effective CPC Bid Sourcead_group_criterion.effective_cpc_bid_sourceOutput only. Source of the effective CPC bid.
Ad Group Criterion - Final Mobile Urlsad_group_criterion.final_mobile_urlsThe list of possible final mobile URLs after all cross-domain redirects.
Ad Group Criterion - Final Urlsad_group_criterion.final_urlsThe list of possible final URLs after all cross-domain redirects for the ad.
Ad Group Criterion - Tracking Url Templatead_group_criterion.tracking_url_templateThe URL template for constructing a tracking URL.
Ad Group Criterion - Bid Modifierad_group_criterion.bid_modifierThe modifier for the bid when the criterion matches. The modifier must be in the range: 0.1 - 10.0. Most targetable criteria types support modifiers.
Ad Group Criterion - Url Custom Parametersad_group_criterion.url_custom_parametersThe list of mappings used to substitute custom parameter tags in a tracking_url_template, final_urls, or mobile_final_urls.
Active View CPMmetrics.active_view_cpmAverage cost of viewable impressions (active_view_impressions).
Active View CTRmetrics.active_view_ctrActive view measurable clicks divided by active view viewable impressions. This metric is reported only for display network.
Active View Impressionsmetrics.active_view_impressionsA measurement of how often your ad has become viewable on a Display Network site.
Active View Measurabilitymetrics.active_view_measurabilityThe ratio of impressions that could be measured by Active View over the number of served impressions.
Active View Measurable Cost Microsmetrics.active_view_measurable_cost_microsThe cost of the impressions you received that were measurable by Active View.
Active View Measurable Impressionsmetrics.active_view_measurable_impressionsThe number of times your ads are appearing on placements in positions where they can be seen.
Active View Viewabilitymetrics.active_view_viewabilityThe percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions).
All Conversionsmetrics.all_conversionsThe total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric.
All Conversions Valuemetrics.all_conversions_valueThe value of all conversions.
Average Costmetrics.average_costThe average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.
Average CPCmetrics.average_cpcThe total cost of all clicks divided by the total number of clicks received.
Average CPEmetrics.average_cpeThe 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.
Average CPMmetrics.average_cpmAverage cost-per-thousand impressions (CPM).
Average Cpvmetrics.average_cpvThe average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views.
Average Page Viewsmetrics.average_page_viewsAverage number of pages viewed per session.
Average Time On Sitemetrics.average_time_on_siteTotal duration of all sessions (in seconds) / number of sessions. Imported from Google Analytics.
Bounce Ratemetrics.bounce_ratePercentage of clicks where the user only visited a single page on your site. Imported from Google Analytics.
Clicksmetrics.clicksThe number of clicks.
Conversionsmetrics.conversionsThe 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.
Conversions From Interactions Ratemetrics.conversions_from_interactions_rateConversions 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.
Conversions Valuemetrics.conversions_valueThe 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.
Cost Micros (Spend)metrics.cost_microsThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.
Cost Per Conversionmetrics.cost_per_conversionThe 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.
CTRmetrics.ctrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).
Engagement Ratemetrics.engagement_rateHow often people engage with your ad after it's shown to them. This is the number of ad expansions divided by the number of times your ad is shown.
Engagementsmetrics.engagementsThe number of engagements. An engagement occurs when a viewer expands your Lightbox ad. Also, in the future, other ad types may support engagement metrics.
Impressionsmetrics.impressionsCount of how often your ad has appeared on a search results page or website on the Google Network.
Datesegments.dateDate to which metrics apply. yyyy-MM-dd format, e.g., 2018-04-17.
Weeksegments.weekWeek as defined as Monday through Sunday, and represented by the date of Monday. Formatted as yyyy-MM-dd.
Monthsegments.monthMonth as represented by the date of the first day of a month. Formatted as yyyy-MM-dd.
Yearsegments.yearYear, formatted as yyyy.
Devicesegments.deviceDevice to which metrics apply.
Click Typesegments.click_typeClick type.
Ad Network Typesegments.ad_network_typeAd network type.
Conversion Action Categorysegments.conversion_action_categoryConversion action category.
Conversion Actionsegments.conversion_actionResource name of the conversion action.
Conversion Action Namesegments.conversion_action_nameConversion action name.
Day Of Weeksegments.day_of_weekDay of the week, e.g., MONDAY.
Month Of Yearsegments.month_of_yearMonth of the year, e.g., January.
External Conversion Sourcesegments.external_conversion_sourceExternal conversion source.

Shopping Performance View

Dataddo LabelGoogle Ads LabelField Description
Shopping Performance View - Resource Nameshopping_performance_view.resource_nameOutput only. The resource name of the Shopping performance view. Shopping performance view resource names have the form: customers/{customer_id}/shoppingPerformanceView
Customer - IDcustomer.idOutput only. The ID of the customer.
Customer - Currency Codecustomer.currency_codeImmutable. The currency in which the account operates. A subset of the currency codes from the ISO 4217 standard is supported.
Customer - Statuscustomer.statusOutput only. The status of the customer.
Customer - Descriptive Namecustomer.descriptive_nameOptional, non-unique descriptive name of the customer.
Customer - Time Zonecustomer.time_zoneImmutable. The local timezone ID of the customer.
Campaign - Accessible Bidding Strategycampaign.accessible_bidding_strategyOutput 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.
Campaign - Ad Serving Optimization Statuscampaign.ad_serving_optimization_statusThe ad serving optimization status of the campaign.
Campaign - Advertising Channel Sub Typecampaign.advertising_channel_sub_typeImmutable. 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.
Campaign - Advertising Channel Typecampaign.advertising_channel_typeImmutable. 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.
Campaign - App Campaign Setting - App IDcampaign.app_campaign_setting.app_idImmutable. A string that uniquely identifies a mobile application.
Campaign - App Campaign Setting - App Storecampaign.app_campaign_setting.app_storeImmutable. The application store that distributes this specific app.
Campaign - App Campaign Setting - Bidding Strategy Goal Typecampaign.app_campaign_setting.bidding_strategy_goal_typeRepresents the goal which the bidding strategy of this app campaign should optimize towards.
Campaign - Audience Settings - Use Audience Grouped Targetscampaign.audience_setting.use_audience_grouped.targetImmutable. If true, this campaign uses an Audience resource for audience targeting. If false, this campaign may use audience segment criteria instead.
Campaign - Base Campaigncampaign.base_campaignOutput 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.
Campaign - Bidding Strategycampaign.bidding_strategyPortfolio bidding strategy used by campaign.
Campaign - Bidding Strategy Typecampaign.bidding_strategy_typeOutput 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.
Campaign - Campaign Budgetcampaign.campaign_budgetThe budget of the campaign.
Campaign - Commission - Commission Rate Microscampaign.commission.commission_rate_microsCommission 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%).
Campaign - Dynamic Search Ads Setting - Domain Namecampaign.dynamic_search_ads_setting.domain_nameRequired. The Internet domain name that this setting represents, e.g., google.com or www.google.com.
Campaign - Dynamic Search Ads Setting - Language Codecampaign.dynamic_search_ads_setting.language_codeRequired. The language code specifying the language of the domain, e.g., en.
Campaign - Dynamic Search Ads Setting - Feedscampaign.dynamic_search_ads_setting.feedsThe list of page feeds associated with the campaign.
Campaign - Dynamic Search Ads Setting - Use Supplied Urls Onlycampaign.dynamic_search_ads_setting.use_supplied_urls_onlyWhether the campaign uses advertiser supplied URLs exclusively.
Campaign - End Datecampaign.end_dateThe last day of the campaign in serving customer's timezone in YYYY-MM-DD format.
Campaign - Excluded Parent Asset Field Typescampaign.excluded_parent_asset_field_typesThe 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.
Campaign - Experiment Typecampaign.experiment_typeOutput only. The type of campaign: normal, draft, or experiment.
Campaign - Final Url Suffixcampaign.final_url_suffixSuffix used to append query parameters to landing pages that are served with parallel tracking.
Campaign - Frequency Capscampaign.frequency_capsA list that limits how often each user will see this campaign's ads.
Campaign - IDcampaign.idOutput only. The ID of the campaign.
Campaign - Labelscampaign.labelsOutput only. The resource names of labels attached to this campaign.
Campaign - Local Campaign Setting - Location Source Typecampaign.local_campaign_setting.location_source_typeThe location source type for this local campaign.
Campaign - Manual CPC - Enhanced CPC Enabledcampaign.manual_cpc.enhanced_cpc_enabledWhether bids are to be enhanced based on conversion optimizer data.
Campaign - Manual CPMcampaign.manual_cpmStandard Manual CPM bidding strategy. Manual impression-based bidding where user pays per thousand impressions.
Campaign - Manual Cpvcampaign.manual_cpvOutput only. A bidding strategy that pays a configurable amount per video view.
Campaign - Maximize Conversion Value - Target Roascampaign.maximize_conversion_value.target_roasOutput only. 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.
Campaign - Maximize Conversions - Target Cpacampaign.maximize_conversions.target_cpaThe 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.
Campaign - Namecampaign.nameThe 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.
Campaign - Network Settings - Target Content Networkcampaign.network_settings.target_content_networkWhether ads will be served on specified placements in the Google Display Network. Placements are specified using the Placement criterion.
Campaign - Network Settings - Target Search Networkcampaign.network_settings.target_search_networkWhether ads will be served on partner sites in the Google Search Network (requires target_google_search to also be true).
Campaign - Network Settings - Target Partner Search Networkcampaign.network_settings.target_partner_search_networkWhether ads will be served on the Google Partner Network. This is available only to some select Google partner accounts.
Campaign - Network Settings - Target Google Searchcampaign.network_settings.target_google_searchWhether ads will be served with google.com search results.
Campaign - Optimization Goal Setting - Optimization Goal Typescampaign.optimization_goal_setting.optimization_goal_typesThe list of optimization goal types.
Campaign - Optimization Scorecampaign.optimization_scoreOutput 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.
Campaign - Payment Modecampaign.payment_modePayment mode for the campaign.
Campaign - Percent CPC - CPC Bid Ceiling Microscampaign.percent_cpc.cpc_bid_ceiling_microsMaximum 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.
Campaign - Percent CPC - Enhanced CPC Enabledcampaign.percent_cpc.enhanced_cpc_enabledAdjusts 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.
Campaign - Real Time Bidding Setting - Opt Incampaign.real_time_bidding_setting.opt_inWhether the campaign is opted in to real-time bidding.
Campaign - Resource Namecampaign.resource_nameImmutable. The resource name of the campaign. Campaign resource names have the form: customers/{customer_id}/campaigns/{campaign_id}
Campaign - Selective Optimization - Conversion Actionscampaign.selective_optimization.conversion_actionsThe selected set of conversion actions for optimizing this campaign.
Campaign - Serving Statuscampaign.serving_statusOutput only. The ad serving status of the campaign.
Campaign - Shopping Setting - Campaign Prioritycampaign.shopping_setting.campaign_priorityPriority 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.
Campaign - Shopping Setting - Enable Localcampaign.shopping_setting.enable_localWhether to include local products.
Campaign - Shopping Setting - Merchant IDcampaign.shopping_setting.merchant_idImmutable. ID of the Merchant Center account. This field is required for create operations. This field is immutable for Shopping campaigns.
Campaign - Shopping Setting - Sales Countrycampaign.shopping_setting.sales_countrySales country of products to include in the campaign. This field is required for Shopping campaigns. This field is optional for non-Shopping campaigns, but it must be equal to 'ZZ' if set.
Campaign - Shopping Setting - Use Vehicle Inventorycampaign.shopping_setting.use_vehicle_inventoryImmutable. Whether to target Vehicle Listing inventory.
Campaign - Start Datecampaign.start_dateThe date when campaign started in serving customer's timezone in YYYY-MM-DD format.
Campaign - Statuscampaign.statusThe status of the campaign. When a new campaign is added, the status defaults to ENABLED.
Campaign - Target Cpa - CPC Bid Ceiling Microscampaign.target_cpa.cpc_bid_ceiling_microsMaximum 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.
Campaign - Target Cpa - Target Cpa Microscampaign.target_cpa.target_cpa_microsOutput only. Average CPA target. This target should be greater than or equal to minimum billable unit based on the currency for the account.
Campaign - Target CPMcampaign.target_cpmA bidding strategy that automatically optimizes cost per thousand impressions.
Campaign - Target Impression Share - CPC Bid Ceiling Microscampaign.target_impression_share.cpc_bid_ceiling_microsThe 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.
Campaign - Target Cpa - CPC Bid Floor Microscampaign.target_cpa.cpc_bid_floor_microsMinimum 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.
Campaign - Target Cpa - Target Cpa Microscampaign.target_cpa.target_cpa_microsOutput only. Average CPA target. This target should be greater than or equal to minimum billable unit based on the currency for the account.
Campaign - Target Impressions Share - CPC Bid Ceiling Microscampaign.target_impression_share.cpc_bid_ceiling_microsThe 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.
Campaign - Target Impression Share - Locationcampaign.target_impression_share.locationThe targeted location on the search results page.
Campaign - Target Impression Share - Location Fraction Microscampaign.target_impression_share.location_fraction_microsThe desired fraction of ads to be shown in the targeted location in micros. E.g. 1% equals 10,000.
Campaign - Target Roas - CPC Bid Ceiling Microscampaign.target_roas.cpc_bid_ceiling_microsMaximum 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.
Campaign - Target Roas - CPC Bid Floor Microscampaign.target_roas.cpc_bid_floor_microsMinimum 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.
Campaign - Target Spend - CPC Bid Floor Microscampaign.target_spend.cpc_bid_floor_micros#N/A
Campaign - Target Roas - Target Roascampaign.target_roas.target_roasRequired. The desired revenue (based on conversion data) per unit of spend. Value must be between 0.01 and 1000.0, inclusive.
Campaign - Target Spend - CPC Bid Ceiling Microscampaign.target_spend.cpc_bid_ceiling_microsMaximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy.
Campaign - Target Spend - Target Spend Microscampaign.target_spend.target_spend_microsThe 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.
Campaign - Targeting Setting - Target Restrictionscampaign.targeting_setting.target_restrictionsThe per-targeting-dimension setting to restrict the reach of your campaign or ad group.
Campaign - Tracking Setting - Tracking Urlcampaign.tracking_setting.tracking_urlOutput only. The url used for dynamic tracking.
Campaign - Tracking Url Templatecampaign.tracking_url_templateThe URL template for constructing a tracking URL.
Campaign - Url Custom Parameterscampaign.url_custom_parametersThe list of mappings used to substitute custom parameter tags in a tracking_url_template, final_urls, or mobile_final_urls.
Campaign - Url Expansion Opt Outcampaign.url_expansion_opt_outRepresents opting out of URL expansion to more targeted URLs. If opted out (true), only the final URLs in the asset group or URLs specified in the advertiser's Google Merchant Center or business data feeds are targeted. If opted in (false), the entire domain will be targeted. This field can only be set for Performance Max campaigns, where the default value is false.
Campaign - Vanity Pharma - Vanity Pharma Display Url Modecampaign.vanity_pharma.vanity_pharma_display_url_modeThe display mode for vanity pharma URLs.
Campaign - Vanity Pharma - Vanity Pharma Textcampaign.vanity_pharma.vanity_pharma_textThe text that will be displayed in display URL of the text ad when website description is the selected display mode for vanity pharma URLs.
Campaign - Video Brand Safety Suitabilitycampaign.video_brand_safety_suitabilityOutput only. 3-Tier Brand Safety setting for the campaign.
All Conversionsmetrics.all_conversionsThe total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric.
All Conversions Valuemetrics.all_conversions_valueThe value of all conversions.
All Conversions From Interactions Ratemetrics.all_conversions_from_interactions_rateAll conversions from interactions (as oppose to view through conversions) divided by the number of ad interactions.
Average CPCmetrics.average_cpcThe total cost of all clicks divided by the total number of clicks received.
Clicksmetrics.clicksThe number of clicks.
Conversionsmetrics.conversionsThe 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.
Conversions From Interactions Ratemetrics.conversions_from_interactions_rateConversions 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.
Conversions Valuemetrics.conversions_valueThe 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.
Cost Micros (Spend)metrics.cost_microsThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.
Cost Per Conversionmetrics.cost_per_conversionThe 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.
Cost Per All Conversionsmetrics.cost_per_all_conversionsThe cost of ad interactions divided by all conversions.
CTRmetrics.ctrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).
Impressionsmetrics.impressionsCount of how often your ad has appeared on a search results page or website on the Google Network.
Search Absolute Top Impressions Sharemetrics.search_absolute_top_impression_shareThe percentage of the customer's Shopping or Search ad impressions that are shown in the most prominent Shopping position. See https://support.google.com/google-ads/answer/7501826 for details. Any value below 0.1 is reported as 0.0999.
Search Click Sharemetrics.search_click_shareThe 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.
Search Impression Sharemetrics.search_impression_shareThe 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.
Value Per All Conversionsmetrics.value_per_all_conversionsThe value of all conversions divided by the number of all conversions.
Value Per Conversionmetrics.value_per_conversionThe value of conversions divided by the number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
Datesegments.dateDate to which metrics apply. yyyy-MM-dd format, e.g., 2018-04-17.
Weeksegments.weekWeek as defined as Monday through Sunday, and represented by the date of Monday. Formatted as yyyy-MM-dd.
Monthsegments.monthMonth as represented by the date of the first day of a month. Formatted as yyyy-MM-dd.
Yearsegments.yearYear, formatted as yyyy.
Devicesegments.deviceDevice to which metrics apply.
Click Typesegments.click_typeClick type.
Ad Network Typesegments.ad_network_typeAd network type.
Conversion Action Categorysegments.conversion_action_categoryConversion action category.
Conversion Actionsegments.conversion_actionResource name of the conversion action.
Conversion Action Namesegments.conversion_action_nameConversion action name.
Day Of Weeksegments.day_of_weekDay of the week, e.g., MONDAY.
Month Of Yearsegments.month_of_yearMonth of the year, e.g., January.
External Conversion Sourcesegments.external_conversion_sourceExternal conversion source.
Aggregator IDsegments.product_aggregator_idAggregator ID of the product.
Bidding Category Level 1segments.product_bidding_category_level1Bidding category (level 1) of the product.
Bidding Category Level 2segments.product_bidding_category_level2Bidding category (level 2) of the product.
Bidding Category Level 3segments.product_bidding_category_level3Bidding category (level 3) of the product.
Bidding Category Level 4segments.product_bidding_category_level4Bidding category (level 4) of the product.
Bidding Category Level 5segments.product_bidding_category_level5Bidding category (level 5) of the product.
Brandsegments.product_brandBrand of the product.
Channelsegments.product_channelChannel of the product.
Channel Exclusivitysegments.product_channel_exclusivityChannel exclusivity of the product.
Conditionsegments.product_conditionCondition of the product.
Countrysegments.product_countryResource name of the geo target constant for the country of sale of the product.
Custom Attriubte 0segments.product_custom_attribute0Custom attribute 0 of the product.
Custom Attriubte 1segments.product_custom_attribute1Custom attribute 1 of the product.
Custom Attriubte 2segments.product_custom_attribute2Custom attribute 2 of the product.
Custom Attriubte 3segments.product_custom_attribute3Custom attribute 3 of the product.
Custom Attriubte 4segments.product_custom_attribute4Custom attribute 4 of the product.
Item IDsegments.product_item_idItem ID of the product.
Languagesegments.product_languageResource name of the language constant for the language of the product.
Merchant IDsegments.product_merchant_idMerchant ID of the product.
Store IDsegments.product_store_idStore ID of the product.
Titlesegments.product_titleTitle of the product.
Product Type Level 1segments.product_type_l1Type (level 1) of the product.
Product Type Level 2segments.product_type_l2Type (level 2) of the product.
Product Type Level 3segments.product_type_l3Type (level 3) of the product.
Product Type Level 4segments.product_type_l4Type (level 4) of the product.
Product Type Level 5segments.product_type_l5Type (level 5) of the product.

Search Term View Report

Dataddo LabelGoogle Ads LabelField Description
Search Term View - Ad Groupsearch_term_view.ad_groupOutput only. The ad group the search term served in.
Search Term View - Resource Namesearch_term_view.resource_nameOutput only. The resource name of the search term view. Search term view resource names have the form: customers/{customer_id}/searchTermViews/{campaign_id}~{ad_group_id}~{URL-base64_search_term}
Search Term View - Search Termsearch_term_view.search_termOutput only. The search term.
Search Term View - Statussearch_term_view.statusOutput only. Indicates whether the search term is currently one of your targeted or excluded keywords.
Customer - IDcustomer.idOutput only. The ID of the customer.
Customer - Currency Codecustomer.currency_codeImmutable. The currency in which the account operates. A subset of the currency codes from the ISO 4217 standard is supported.
Customer - Statuscustomer.statusOutput only. The status of the customer.
Customer - Descriptive Namecustomer.descriptive_nameOptional, non-unique descriptive name of the customer.
Customer - Time Zonecustomer.time_zoneImmutable. The local timezone ID of the customer.
Campaign - Accessible Bidding Strategycampaign.accessible_bidding_strategyOutput 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.
Campaign - Ad Serving Optimization Statuscampaign.ad_serving_optimization_statusThe ad serving optimization status of the campaign.
Campaign - Advertising Channel Sub Typecampaign.advertising_channel_sub_typeImmutable. 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.
Campaign - Advertising Channel Typecampaign.advertising_channel_typeImmutable. 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.
Campaign - App Campaign Setting - App IDcampaign.app_campaign_setting.app_idImmutable. A string that uniquely identifies a mobile application.
Campaign - App Campaign Setting - App Storecampaign.app_campaign_setting.app_storeImmutable. The application store that distributes this specific app.
Campaign - App Campaign Setting - Bidding Strategy Goal Typecampaign.app_campaign_setting.bidding_strategy_goal_typeRepresents the goal which the bidding strategy of this app campaign should optimize towards.
Campaign - Audience Settings - Use Audience Grouped Targetscampaign.audience_setting.use_audience_grouped.targetImmutable. If true, this campaign uses an Audience resource for audience targeting. If false, this campaign may use audience segment criteria instead.
Campaign - Base Campaigncampaign.base_campaignOutput 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.
Campaign - Bidding Strategycampaign.bidding_strategyPortfolio bidding strategy used by campaign.
Campaign - Bidding Strategy Typecampaign.bidding_strategy_typeOutput 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.
Campaign - Campaign Budgetcampaign.campaign_budgetThe budget of the campaign.
Campaign - Commission - Commission Rate Microscampaign.commission.commission_rate_microsCommission 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%).
Campaign - Dynamic Search Ads Setting - Domain Namecampaign.dynamic_search_ads_setting.domain_nameRequired. The Internet domain name that this setting represents, e.g., google.com or www.google.com.
Campaign - Dynamic Search Ads Setting - Language Codecampaign.dynamic_search_ads_setting.language_codeRequired. The language code specifying the language of the domain, e.g., en.
Campaign - Dynamic Search Ads Setting - Feedscampaign.dynamic_search_ads_setting.feedsThe list of page feeds associated with the campaign.
Campaign - Dynamic Search Ads Setting - Use Supplied Urls Onlycampaign.dynamic_search_ads_setting.use_supplied_urls_onlyWhether the campaign uses advertiser supplied URLs exclusively.
Campaign - End Datecampaign.end_dateThe last day of the campaign in serving customer's timezone in YYYY-MM-DD format.
Campaign - Excluded Parent Asset Field Typescampaign.excluded_parent_asset_field_typesThe 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.
Campaign - Experiment Typecampaign.experiment_typeOutput only. The type of campaign: normal, draft, or experiment.
Campaign - Final Url Suffixcampaign.final_url_suffixSuffix used to append query parameters to landing pages that are served with parallel tracking.
Campaign - Frequency Capscampaign.frequency_capsA list that limits how often each user will see this campaign's ads.
Campaign - IDcampaign.idOutput only. The ID of the campaign.
Campaign - Labelscampaign.labelsOutput only. The resource names of labels attached to this campaign.
Campaign - Local Campaign Setting - Location Source Typecampaign.local_campaign_setting.location_source_typeThe location source type for this local campaign.
Campaign - Manual CPC - Enhanced CPC Enabledcampaign.manual_cpc.enhanced_cpc_enabledWhether bids are to be enhanced based on conversion optimizer data.
Campaign - Manual CPMcampaign.manual_cpmStandard Manual CPM bidding strategy. Manual impression-based bidding where user pays per thousand impressions.
Campaign - Manual Cpvcampaign.manual_cpvOutput only. A bidding strategy that pays a configurable amount per video view.
Campaign - Maximize Conversion Value - Target Roascampaign.maximize_conversion_value.target_roasOutput only. 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.
Campaign - Maximize Conversions - Target Cpacampaign.maximize_conversions.target_cpaThe 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.
Campaign - Namecampaign.nameThe 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.
Campaign - Network Settings - Target Content Networkcampaign.network_settings.target_content_networkWhether ads will be served on specified placements in the Google Display Network. Placements are specified using the Placement criterion.
Campaign - Network Settings - Target Search Networkcampaign.network_settings.target_search_networkWhether ads will be served on partner sites in the Google Search Network (requires target_google_search to also be true).
Campaign - Network Settings - Target Partner Search Networkcampaign.network_settings.target_partner_search_networkWhether ads will be served on the Google Partner Network. This is available only to some select Google partner accounts.
Campaign - Network Settings - Target Google Searchcampaign.network_settings.target_google_searchWhether ads will be served with google.com search results.
Campaign - Optimization Goal Setting - Optimization Goal Typescampaign.optimization_goal_setting.optimization_goal_typesThe list of optimization goal types.
Campaign - Optimization Scorecampaign.optimization_scoreOutput 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.
Campaign - Payment Modecampaign.payment_modePayment mode for the campaign.
Campaign - Percent CPC - CPC Bid Ceiling Microscampaign.percent_cpc.cpc_bid_ceiling_microsMaximum 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.
Campaign - Percent CPC - Enhanced CPC Enabledcampaign.percent_cpc.enhanced_cpc_enabledAdjusts 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.
Campaign - Real Time Bidding Setting - Opt Incampaign.real_time_bidding_setting.opt_inWhether the campaign is opted in to real-time bidding.
Campaign - Resource Namecampaign.resource_nameImmutable. The resource name of the campaign. Campaign resource names have the form: customers/{customer_id}/campaigns/{campaign_id}
Campaign - Selective Optimization - Conversion Actionscampaign.selective_optimization.conversion_actionsThe selected set of conversion actions for optimizing this campaign.
Campaign - Serving Statuscampaign.serving_statusOutput only. The ad serving status of the campaign.
Campaign - Shopping Setting - Campaign Prioritycampaign.shopping_setting.campaign_priorityPriority 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.
Campaign - Shopping Setting - Enable Localcampaign.shopping_setting.enable_localWhether to include local products.
Campaign - Shopping Setting - Merchant IDcampaign.shopping_setting.merchant_idImmutable. ID of the Merchant Center account. This field is required for create operations. This field is immutable for Shopping campaigns.
Campaign - Shopping Setting - Sales Countrycampaign.shopping_setting.sales_countrySales country of products to include in the campaign. This field is required for Shopping campaigns. This field is optional for non-Shopping campaigns, but it must be equal to 'ZZ' if set.
Campaign - Shopping Setting - Use Vehicle Inventorycampaign.shopping_setting.use_vehicle_inventoryImmutable. Whether to target Vehicle Listing inventory.
Campaign - Start Datecampaign.start_dateThe date when campaign started in serving customer's timezone in YYYY-MM-DD format.
Campaign - Statuscampaign.statusThe status of the campaign. When a new campaign is added, the status defaults to ENABLED.
Campaign - Target Cpa - CPC Bid Ceiling Microscampaign.target_cpa.cpc_bid_ceiling_microsMaximum 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.
Campaign - Target Cpa - Target Cpa Microscampaign.target_cpa.target_cpa_microsOutput only. Average CPA target. This target should be greater than or equal to minimum billable unit based on the currency for the account.
Campaign - Target CPMcampaign.target_cpmA bidding strategy that automatically optimizes cost per thousand impressions.
Campaign - Target Impression Share - CPC Bid Ceiling Microscampaign.target_impression_share.cpc_bid_ceiling_microsThe 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.
Campaign - Target Cpa - CPC Bid Floor Microscampaign.target_cpa.cpc_bid_floor_microsMinimum 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.
Camkpaign - Target Cpa - Target Cpa Microscampaign.target_cpa.target_cpa_microsOutput only. Average CPA target. This target should be greater than or equal to minimum billable unit based on the currency for the account.
Campaign - Target Impressions Share - CPC Bid Ceiling Microscampaign.target_impression_share.cpc_bid_ceiling_microsThe 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.
Campaign - Target Impression Share - Locationcampaign.target_impression_share.locationThe targeted location on the search results page.
Campaign - Target Impression Share - Location Fraction Microscampaign.target_impression_share.location_fraction_microsThe desired fraction of ads to be shown in the targeted location in micros. E.g. 1% equals 10,000.
Campaign - Target Roas - CPC Bid Ceiling Microscampaign.target_roas.cpc_bid_ceiling_microsMaximum 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.
Campaign - Target Roas - CPC Bid Floor Microscampaign.target_roas.cpc_bid_floor_microsMinimum 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.
Campaign - Target Spend - CPC Bid Floor Microscampaign.target_spend.cpc_bid_floor_micros#N/A
Campaign - Target Roas - Target Roascampaign.target_roas.target_roasRequired. The desired revenue (based on conversion data) per unit of spend. Value must be between 0.01 and 1000.0, inclusive.
Campaign - Target Spend - CPC Bid Ceiling Microscampaign.target_spend.cpc_bid_ceiling_microsMaximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy.
Campaign - Target Spend - Target Spend Microscampaign.target_spend.target_spend_microsThe 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.
Campaign - Targeting Setting - Target Restrictionscampaign.targeting_setting.target_restrictionsThe per-targeting-dimension setting to restrict the reach of your campaign or ad group.
Campaign - Tracking Setting - Tracking Urlcampaign.tracking_setting.tracking_urlOutput only. The url used for dynamic tracking.
Campaign - Tracking Url Templatecampaign.tracking_url_templateThe URL template for constructing a tracking URL.
Campaign - Url Custom Parameterscampaign.url_custom_parametersThe list of mappings used to substitute custom parameter tags in a tracking_url_template, final_urls, or mobile_final_urls.
Campaign - Url Expansion Opt Outcampaign.url_expansion_opt_outRepresents opting out of URL expansion to more targeted URLs. If opted out (true), only the final URLs in the asset group or URLs specified in the advertiser's Google Merchant Center or business data feeds are targeted. If opted in (false), the entire domain will be targeted. This field can only be set for Performance Max campaigns, where the default value is false.
Campaign - Vanity Pharma - Vanity Pharma Display Url Modecampaign.vanity_pharma.vanity_pharma_display_url_modeThe display mode for vanity pharma URLs.
Campaign - Vanity Pharma - Vanity Pharma Textcampaign.vanity_pharma.vanity_pharma_textThe text that will be displayed in display URL of the text ad when website description is the selected display mode for vanity pharma URLs.
Campaign - Video Brand Safety Suitabilitycampaign.video_brand_safety_suitabilityOutput only. 3-Tier Brand Safety setting for the campaign.
Absolute Top Impression Percentagemetrics.absolute_top_impression_percentageThe percent of your ad impressions that are shown as the very first ad above the organic search results.
All Conversionsmetrics.all_conversionsThe total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric.
All Conversions From Interactions Ratemetrics.all_conversions_from_interactions_rateAll conversions from interactions (as oppose to view through conversions) divided by the number of ad interactions.
All Conversions From Interactions Value Per Interactionmetrics.all_conversions_from_interactions_value_per_interactionThe value of all conversions from interactions divided by the total number of interactions.
All Conversions Valuemetrics.all_conversions_valueThe value of all conversions.
All Conversions Value Per Costmetrics.all_conversions_value_per_costThe value of all conversions divided by the total cost of ad interactions (such as clicks for text ads or views for video ads).
Average Costmetrics.average_costThe average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.
Average CPCmetrics.average_cpcThe total cost of all clicks divided by the total number of clicks received.
Average CPEmetrics.average_cpeThe 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.
Average CPMmetrics.average_cpmAverage cost-per-thousand impressions (CPM).
Average Cpvmetrics.average_cpvThe average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views.
Clicksmetrics.clicksThe number of clicks.
Conversionsmetrics.conversionsThe 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.
Conversions From Interactions Ratemetrics.conversions_from_interactions_rateConversions 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.
Conversions From Interactions Value Per Interactionmetrics.conversions_from_interactions_value_per_interactionThe 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.
Conversions Valuemetrics.conversions_valueThe 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.
Conversions Value Per Costmetrics.conversions_value_per_costThe 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.
Cost Micros (Spend)metrics.cost_microsThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.
Cost Per All Conversionsmetrics.cost_per_all_conversionsThe cost of ad interactions divided by all conversions.
Cost Per Conversionmetrics.cost_per_conversionThe 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.
Cross Device Conversionsmetrics.cross_device_conversionsConversions 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.
CTRmetrics.ctrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).
Engagement Ratemetrics.engagement_rateHow often people engage with your ad after it's shown to them. This is the number of ad expansions divided by the number of times your ad is shown.
Engagementsmetrics.engagementsThe number of engagements. An engagement occurs when a viewer expands your Lightbox ad. Also, in the future, other ad types may support engagement metrics.
Impressionsmetrics.impressionsCount of how often your ad has appeared on a search results page or website on the Google Network.
Interaction Event Typesmetrics.interaction_event_typesThe types of payable and free interactions.
Interaction Ratemetrics.interaction_rateHow often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown.
Interactionsmetrics.interactionsThe 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.
Top Impression Percentagemetrics.top_impression_percentageThe percent of your ad impressions that are shown anywhere above the organic search results.
Value Per All Conversionsmetrics.value_per_all_conversionsThe value of all conversions divided by the number of all conversions.
Value Per Conversionmetrics.value_per_conversionThe value of conversions divided by the number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
Video Quartile P100_ratemetrics.video_quartile_p100_ratePercentage of impressions where the viewer watched all of your video.
Video Quartile P25_ratemetrics.video_quartile_p25_ratePercentage of impressions where the viewer watched 25% of your video.
Video Quartile P50_ratemetrics.video_quartile_p50_ratePercentage of impressions where the viewer watched 50% of your video.
Video Quartile P75_ratemetrics.video_quartile_p75_ratePercentage of impressions where the viewer watched 75% of your video.
Video View Ratemetrics.video_view_rateThe number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads.
Video Viewsmetrics.video_viewsThe number of times your video ads were viewed.
View Through Conversionsmetrics.view_through_conversionsThe total number of view-through conversions. These happen when a customer sees an image or rich media ad, then later completes a conversion on your site without interacting with (e.g., clicking on) another ad.
Ad Network Typesegments.ad_network_typeAd network type.
Conversion Actionsegments.conversion_actionResource name of the conversion action.
Conversion Action Categorysegments.conversion_action_categoryConversion action category.
Conversion Action Namesegments.conversion_action_nameConversion action name.
Datesegments.dateDate to which metrics apply. yyyy-MM-dd format, e.g., 2018-04-17.
Day Of Weeksegments.day_of_weekDay of the week, e.g., MONDAY.
Devicesegments.deviceDevice to which metrics apply.
External Conversion Sourcesegments.external_conversion_sourceExternal conversion source.
Keyword Criteriasegments.keyword.ad_group_criterionThe AdGroupCriterion resource name.
Keyword Match Typesegments.keyword.info.match_typeThe match type of the keyword.
Keyword Textsegments.keyword.info.textThe text of the keyword (at most 80 characters and 10 words).
Monthsegments.monthMonth as represented by the date of the first day of a month. Formatted as yyyy-MM-dd.
Month Of Yearsegments.month_of_yearMonth of the year, e.g., January.
Quartersegments.quarterQuarter as represented by the date of the first day of a quarter. Uses the calendar year for quarters, e.g., the second quarter of 2018 starts on 2018-04-01. Formatted as yyyy-MM-dd.
Search Term Match Typesegments.search_term_match_typeMatch type of the keyword that triggered the ad, including variants.
Weeksegments.weekWeek as defined as Monday through Sunday, and represented by the date of Monday. Formatted as yyyy-MM-dd.
Yearsegments.yearYear, formatted as yyyy.

Gender View Report

Dataddo LabelGoogle Ads LabelField Description
Gender View - Resource Namegender_view.resource_nameOutput only. The resource name of the gender view. Gender view resource names have the form: customers/{customer_id}/genderViews/{ad_group_id}~{criterion_id}
Customer - IDcustomer.idOutput only. The ID of the customer.
Customer - Currency Codecustomer.currency_codeImmutable. The currency in which the account operates. A subset of the currency codes from the ISO 4217 standard is supported.
Customer - Statuscustomer.statusOutput only. The status of the customer.
Customer - Descriptive Namecustomer.descriptive_nameOptional, non-unique descriptive name of the customer.
Customer - Time Zonecustomer.time_zoneImmutable. The local timezone ID of the customer.
Campaign - Accessible Bidding Strategycampaign.accessible_bidding_strategyOutput 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.
Campaign - Ad Serving Optimization Statuscampaign.ad_serving_optimization_statusThe ad serving optimization status of the campaign.
Campaign - Advertising Channel Sub Typecampaign.advertising_channel_sub_typeImmutable. 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.
Campaign - Advertising Channel Typecampaign.advertising_channel_typeImmutable. 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.
Campaign - App Campaign Setting - App IDcampaign.app_campaign_setting.app_idImmutable. A string that uniquely identifies a mobile application.
Campaign - App Campaign Setting - App Storecampaign.app_campaign_setting.app_storeImmutable. The application store that distributes this specific app.
Campaign - App Campaign Setting - Bidding Strategy Goal Typecampaign.app_campaign_setting.bidding_strategy_goal_typeRepresents the goal which the bidding strategy of this app campaign should optimize towards.
Campaign - Audience Settings - Use Audience Grouped Targetscampaign.audience_setting.use_audience_grouped.targetImmutable. If true, this campaign uses an Audience resource for audience targeting. If false, this campaign may use audience segment criteria instead.
Campaign - Base Campaigncampaign.base_campaignOutput 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.
Campaign - Bidding Strategycampaign.bidding_strategyPortfolio bidding strategy used by campaign.
Campaign - Bidding Strategy Typecampaign.bidding_strategy_typeOutput 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.
Campaign - Campaign Budgetcampaign.campaign_budgetThe budget of the campaign.
Campaign - Commission - Commission Rate Microscampaign.commission.commission_rate_microsCommission 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%).
Campaign - Dynamic Search Ads Setting - Domain Namecampaign.dynamic_search_ads_setting.domain_nameRequired. The Internet domain name that this setting represents, e.g., google.com or www.google.com.
Campaign - Dynamic Search Ads Setting - Language Codecampaign.dynamic_search_ads_setting.language_codeRequired. The language code specifying the language of the domain, e.g., en.
Campaign - Dynamic Search Ads Setting - Feedscampaign.dynamic_search_ads_setting.feedsThe list of page feeds associated with the campaign.
Campaign - Dynamic Search Ads Setting - Use Supplied Urls Onlycampaign.dynamic_search_ads_setting.use_supplied_urls_onlyWhether the campaign uses advertiser supplied URLs exclusively.
Campaign - End Datecampaign.end_dateThe last day of the campaign in serving customer's timezone in YYYY-MM-DD format.
Campaign - Excluded Parent Asset Field Typescampaign.excluded_parent_asset_field_typesThe 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.
Campaign - Experiment Typecampaign.experiment_typeOutput only. The type of campaign: normal, draft, or experiment.
Campaign - Final Url Suffixcampaign.final_url_suffixSuffix used to append query parameters to landing pages that are served with parallel tracking.
Campaign - Frequency Capscampaign.frequency_capsA list that limits how often each user will see this campaign's ads.
Campaign - IDcampaign.idOutput only. The ID of the campaign.
Campaign - Labelscampaign.labelsOutput only. The resource names of labels attached to this campaign.
Campaign - Local Campaign Setting - Location Source Typecampaign.local_campaign_setting.location_source_typeThe location source type for this local campaign.
Campaign - Manual CPC - Enhanced CPC Enabledcampaign.manual_cpc.enhanced_cpc_enabledWhether bids are to be enhanced based on conversion optimizer data.
Campaign - Manual CPMcampaign.manual_cpmStandard Manual CPM bidding strategy. Manual impression-based bidding where user pays per thousand impressions.
Campaign - Manual Cpvcampaign.manual_cpvOutput only. A bidding strategy that pays a configurable amount per video view.
Campaign - Maximize Conversion Value - Target Roascampaign.maximize_conversion_value.target_roasOutput only. 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.
Campaign - Maximize Conversions - Target Cpacampaign.maximize_conversions.target_cpaThe 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.
Campaign - Namecampaign.nameThe 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.
Campaign - Network Settings - Target Content Networkcampaign.network_settings.target_content_networkWhether ads will be served on specified placements in the Google Display Network. Placements are specified using the Placement criterion.
Campaign - Network Settings - Target Search Networkcampaign.network_settings.target_search_networkWhether ads will be served on partner sites in the Google Search Network (requires target_google_search to also be true).
Campaign - Network Settings - Target Partner Search Networkcampaign.network_settings.target_partner_search_networkWhether ads will be served on the Google Partner Network. This is available only to some select Google partner accounts.
Campaign - Network Settings - Target Google Searchcampaign.network_settings.target_google_searchWhether ads will be served with google.com search results.
Campaign - Optimization Goal Setting - Optimization Goal Typescampaign.optimization_goal_setting.optimization_goal_typesThe list of optimization goal types.
Campaign - Optimization Scorecampaign.optimization_scoreOutput 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.
Campaign - Payment Modecampaign.payment_modePayment mode for the campaign.
Campaign - Percent CPC - CPC Bid Ceiling Microscampaign.percent_cpc.cpc_bid_ceiling_microsMaximum 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.
Campaign - Percent CPC - Enhanced CPC Enabledcampaign.percent_cpc.enhanced_cpc_enabledAdjusts 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.
Campaign - Real Time Bidding Setting - Opt Incampaign.real_time_bidding_setting.opt_inWhether the campaign is opted in to real-time bidding.
Campaign - Resource Namecampaign.resource_nameImmutable. The resource name of the campaign. Campaign resource names have the form: customers/{customer_id}/campaigns/{campaign_id}
Campaign - Selective Optimization - Conversion Actionscampaign.selective_optimization.conversion_actionsThe selected set of conversion actions for optimizing this campaign.
Campaign - Serving Statuscampaign.serving_statusOutput only. The ad serving status of the campaign.
Campaign - Shopping Setting - Campaign Prioritycampaign.shopping_setting.campaign_priorityPriority 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.
Campaign - Shopping Setting - Enable Localcampaign.shopping_setting.enable_localWhether to include local products.
Campaign - Shopping Setting - Merchant IDcampaign.shopping_setting.merchant_idImmutable. ID of the Merchant Center account. This field is required for create operations. This field is immutable for Shopping campaigns.
Campaign - Shopping Setting - Sales Countrycampaign.shopping_setting.sales_countrySales country of products to include in the campaign. This field is required for Shopping campaigns. This field is optional for non-Shopping campaigns, but it must be equal to 'ZZ' if set.
Campaign - Shopping Setting - Use Vehicle Inventorycampaign.shopping_setting.use_vehicle_inventoryImmutable. Whether to target Vehicle Listing inventory.
Campaign - Start Datecampaign.start_dateThe date when campaign started in serving customer's timezone in YYYY-MM-DD format.
Campaign - Statuscampaign.statusThe status of the campaign. When a new campaign is added, the status defaults to ENABLED.
Campaign - Target Cpa - CPC Bid Ceiling Microscampaign.target_cpa.cpc_bid_ceiling_microsMaximum 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.
Campaign - Target Cpa - Target Cpa Microscampaign.target_cpa.target_cpa_microsOutput only. Average CPA target. This target should be greater than or equal to minimum billable unit based on the currency for the account.
Campaign - Target CPMcampaign.target_cpmA bidding strategy that automatically optimizes cost per thousand impressions.
Campaign - Target Impression Share - CPC Bid Ceiling Microscampaign.target_impression_share.cpc_bid_ceiling_microsThe 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.
Campaign - Target Cpa - CPC Bid Floor Microscampaign.target_cpa.cpc_bid_floor_microsMinimum 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.
Camkpaign - Target Cpa - Target Cpa Microscampaign.target_cpa.target_cpa_microsOutput only. Average CPA target. This target should be greater than or equal to minimum billable unit based on the currency for the account.
Campaign - Target Impressions Share - CPC Bid Ceiling Microscampaign.target_impression_share.cpc_bid_ceiling_microsThe 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.
Campaign - Target Impression Share - Locationcampaign.target_impression_share.locationThe targeted location on the search results page.
Campaign - Target Impression Share - Location Fraction Microscampaign.target_impression_share.location_fraction_microsThe desired fraction of ads to be shown in the targeted location in micros. E.g. 1% equals 10,000.
Campaign - Target Roas - CPC Bid Ceiling Microscampaign.target_roas.cpc_bid_ceiling_microsMaximum 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.
Campaign - Target Roas - CPC Bid Floor Microscampaign.target_roas.cpc_bid_floor_microsMinimum 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.
Campaign - Target Spend - CPC Bid Floor Microscampaign.target_spend.cpc_bid_floor_micros#N/A
Campaign - Target Roas - Target Roascampaign.target_roas.target_roasRequired. The desired revenue (based on conversion data) per unit of spend. Value must be between 0.01 and 1000.0, inclusive.
Campaign - Target Spend - CPC Bid Ceiling Microscampaign.target_spend.cpc_bid_ceiling_microsMaximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy.
Campaign - Target Spend - Target Spend Microscampaign.target_spend.target_spend_microsThe 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.
Campaign - Targeting Setting - Target Restrictionscampaign.targeting_setting.target_restrictionsThe per-targeting-dimension setting to restrict the reach of your campaign or ad group.
Campaign - Tracking Setting - Tracking Urlcampaign.tracking_setting.tracking_urlOutput only. The url used for dynamic tracking.
Campaign - Tracking Url Templatecampaign.tracking_url_templateThe URL template for constructing a tracking URL.
Campaign - Url Custom Parameterscampaign.url_custom_parametersThe list of mappings used to substitute custom parameter tags in a tracking_url_template, final_urls, or mobile_final_urls.
Campaign - Url Expansion Opt Outcampaign.url_expansion_opt_outRepresents opting out of URL expansion to more targeted URLs. If opted out (true), only the final URLs in the asset group or URLs specified in the advertiser's Google Merchant Center or business data feeds are targeted. If opted in (false), the entire domain will be targeted. This field can only be set for Performance Max campaigns, where the default value is false.
Campaign - Vanity Pharma - Vanity Pharma Display Url Modecampaign.vanity_pharma.vanity_pharma_display_url_modeThe display mode for vanity pharma URLs.
Campaign - Vanity Pharma - Vanity Pharma Textcampaign.vanity_pharma.vanity_pharma_textThe text that will be displayed in display URL of the text ad when website description is the selected display mode for vanity pharma URLs.
Campaign - Video Brand Safety Suitabilitycampaign.video_brand_safety_suitabilityOutput only. 3-Tier Brand Safety setting for the campaign.
Bidding Strategy - IDbidding_strategy.idOutput only. The ID of the bidding strategy.
Bidding Strategy - Namebidding_strategy.nameThe name of the bidding strategy. All bidding strategies within an account must be named distinctly. The length of this string should be between 1 and 255, inclusive, in UTF-8 bytes, (trimmed).
Bidding Strategy - Typebidding_strategy.typeOutput only. The type of the bidding strategy. Create a bidding strategy by setting the bidding scheme. This field is read-only.
Bidding Strategy - Statusbidding_strategy.statusOutput only. The status of the bidding strategy. This field is read-only.
Ad Group Criterion - Criterion IDad_group_criterion.criterion_idOutput only. The ID of the criterion. This field is ignored for mutates.
Ad Group Criterion - Age Range - Typead_group_criterion.age_range.typeType of the age range.
Ad Group Criterion - Approval Statusad_group_criterion.approval_statusOutput only. Approval status of the criterion.
Ad Group Criterion - Audience - Audiencead_group_criterion.audience.audienceThe Audience resource name.
Ad Group Criterion - Typead_group_criterion.typeOutput only. The type of the criterion.
Ad Group Criterion - Statusad_group_criterion.statusThe status of the criterion. This is the status of the ad group criterion entity, set by the client. Note: UI reports may incorporate additional information that affects whether a criterion is eligible to run. In some cases a criterion that's REMOVED in the API can still show as enabled in the UI. For example, campaigns by default show to users of all age ranges unless excluded. The UI will show each age range as enabled, since they're eligible to see the ads
Ad Group Criterion - Gender - Typead_group_criterion.gender.typeType of the gender.
Ad Group Criterion - Keyword - Match Typead_group_criterion.keyword.match_typeThe match type of the keyword.
Ad Group Criterion - Keyword - Textad_group_criterion.keyword.textThe text of the keyword (at most 80 characters and 10 words).
Ad Group Criterion - Negativead_group_criterion.negativeImmutable. Whether to target (false) or exclude (true) the criterion. This field is immutable. To switch a criterion from positive to negative, remove then re-add it.
Ad Group Criterion - Position Estimates - First Page CPC Microsad_group_criterion.position_estimates.first_page_cpc_microsOutput only. The estimate of the CPC bid required for ad to be shown on first page of search results.
Ad Group Criterion - Position Estimates - First Position CPC Microsad_group_criterion.position_estimates.first_position_cpc_microsOutput only. The estimate of the CPC bid required for ad to be displayed in first position, at the top of the first page of search results.
Ad Group Criterion - CPM Bid Microsad_group_criterion.cpm_bid_microsThe CPM (cost-per-thousand viewable impressions) bid.
Ad Group Criterion - Effective CPM Bid Microsad_group_criterion.effective_cpm_bid_microsOutput only. The effective CPM (cost-per-thousand viewable impressions) bid.
Ad Group Criterion - Effective CPM Bid Sourcead_group_criterion.effective_cpm_bid_sourceOutput only. Source of the effective CPM bid.
Ad Group Criterion - CPC Bid Microsad_group_criterion.cpc_bid_microsThe CPC (cost-per-click) bid.
Ad Group Criterion - Effective CPC Bid Microsad_group_criterion.effective_cpc_bid_microsOutput only. The effective CPC (cost-per-click) bid.
Ad Group Criterion - Effective CPC Bid Sourcead_group_criterion.effective_cpc_bid_sourceOutput only. Source of the effective CPC bid.
Ad Group Criterion - Final Mobile Urlsad_group_criterion.final_mobile_urlsThe list of possible final mobile URLs after all cross-domain redirects.
Ad Group Criterion - Final Urlsad_group_criterion.final_urlsThe list of possible final URLs after all cross-domain redirects for the ad.
Ad Group Criterion - Tracking Url Templatead_group_criterion.tracking_url_templateThe URL template for constructing a tracking URL.
Ad Group Criterion - Bid Modifierad_group_criterion.bid_modifierThe modifier for the bid when the criterion matches. The modifier must be in the range: 0.1 - 10.0. Most targetable criteria types support modifiers.
Ad Group Criterion - Url Custom Parametersad_group_criterion.url_custom_parametersThe list of mappings used to substitute custom parameter tags in a tracking_url_template, final_urls, or mobile_final_urls.
Active View CPMmetrics.active_view_cpmAverage cost of viewable impressions (active_view_impressions).
Active View CTRmetrics.active_view_ctrActive view measurable clicks divided by active view viewable impressions. This metric is reported only for display network.
Active View Impressionsmetrics.active_view_impressionsA measurement of how often your ad has become viewable on a Display Network site.
Active View Measurabilitymetrics.active_view_measurabilityThe ratio of impressions that could be measured by Active View over the number of served impressions.
Active View Measurable Cost Microsmetrics.active_view_measurable_cost_microsThe cost of the impressions you received that were measurable by Active View.
Active View Measurable Impressionsmetrics.active_view_measurable_impressionsThe number of times your ads are appearing on placements in positions where they can be seen.
Active View Viewabilitymetrics.active_view_viewabilityThe percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions).
All Conversionsmetrics.all_conversionsThe total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric.
All Conversions Valuemetrics.all_conversions_valueThe value of all conversions.
Average Costmetrics.average_costThe average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions.
Average CPCmetrics.average_cpcThe total cost of all clicks divided by the total number of clicks received.
Average CPEmetrics.average_cpeThe 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.
Average CPMmetrics.average_cpmAverage cost-per-thousand impressions (CPM).
Average Cpvmetrics.average_cpvThe average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views.
Clicksmetrics.clicksThe number of clicks.
Conversionsmetrics.conversionsThe 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.
Conversions From Interactions Ratemetrics.conversions_from_interactions_rateConversions 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.
Conversions Valuemetrics.conversions_valueThe 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.
Cost Micros (Spend)metrics.cost_microsThe sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period.
Cost Per Conversionmetrics.cost_per_conversionThe 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.
Cost Per All Conversionsmetrics.cost_per_all_conversionsThe cost of ad interactions divided by all conversions.
Cross Device Conversionsmetrics.cross_device_conversionsConversions 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.
CTRmetrics.ctrThe number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions).
Engagement Ratemetrics.engagement_rateHow often people engage with your ad after it's shown to them. This is the number of ad expansions divided by the number of times your ad is shown.
Engagementsmetrics.engagementsThe number of engagements. An engagement occurs when a viewer expands your Lightbox ad. Also, in the future, other ad types may support engagement metrics.
Impressionsmetrics.impressionsCount of how often your ad has appeared on a search results page or website on the Google Network.
Gmail Forwardsmetrics.gmail_forwardsThe number of times the ad was forwarded to someone else as a message.
Gmail Savesmetrics.gmail_savesThe number of times someone has saved your Gmail ad to their inbox as a message.
Gmail Secondary Clicksmetrics.gmail_secondary_clicksThe number of clicks to the landing page on the expanded state of Gmail ads.
Interaction Event Typesmetrics.interaction_event_typesThe types of payable and free interactions.
Interaction Ratemetrics.interaction_rateHow often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown.
Interactionsmetrics.interactionsThe 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.
Value Per All Conversionsmetrics.value_per_all_conversionsThe value of all conversions divided by the number of all conversions.
Value Per Conversionmetrics.value_per_conversionThe value of conversions divided by the number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions.
Video Quartile P100_ratemetrics.video_quartile_p100_ratePercentage of impressions where the viewer watched all of your video.
Video Quartile P75_ratemetrics.video_quartile_p75_ratePercentage of impressions where the viewer watched 75% of your video.
Video Quartile P50_ratemetrics.video_quartile_p50_ratePercentage of impressions where the viewer watched 50% of your video.
Video Quartile P25_ratemetrics.video_quartile_p25_ratePercentage of impressions where the viewer watched 25% of your video.
Video View Ratemetrics.video_view_rateThe number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads.
Video Viewsmetrics.video_viewsThe number of times your video ads were viewed.
View Through Conversionsmetrics.view_through_conversionsThe total number of view-through conversions. These happen when a customer sees an image or rich media ad, then later completes a conversion on your site without interacting with (e.g., clicking on) another ad.
Datesegments.dateDate to which metrics apply. yyyy-MM-dd format, e.g., 2018-04-17.
Weeksegments.weekWeek as defined as Monday through Sunday, and represented by the date of Monday. Formatted as yyyy-MM-dd.
Monthsegments.monthMonth as represented by the date of the first day of a month. Formatted as yyyy-MM-dd.
Yearsegments.yearYear, formatted as yyyy.
Devicesegments.deviceDevice to which metrics apply.
Click Typesegments.click_typeClick type.
Ad Network Typesegments.ad_network_typeAd network type.
Conversion Action Categorysegments.conversion_action_categoryConversion action category.
Conversion Actionsegments.conversion_actionResource name of the conversion action.
Conversion Action Namesegments.conversion_action_nameConversion action name.
Day Of Weeksegments.day_of_weekDay of the week, e.g., MONDAY.
Month Of Yearsegments.month_of_yearMonth of the year, e.g., January.
External Conversion Sourcesegments.external_conversion_sourceExternal conversion source.

Was this article helpful?