Google Ads Reference Fields
- 160 Minutes to read
- DarkLight
Google Ads Reference Fields
- 160 Minutes to read
- DarkLight
Article summary
Did you find this summary helpful?
Thank you for your feedback
Video Reports
Dataddo Label | Google Ads Label | Field Description |
---|---|---|
Video - Channel ID | video.channel_id | Output only. The owner channel id of the video. |
Video - ID | video.id | Output only. The ID of the video. |
Video - Duration Milliseconds | video.duration_millis | Output only. The duration of the video in milliseconds. |
Video - Resource Name | video.resource_name | Output only. The resource name of the video. Video resource names have the form: customers/{customer_id}/videos/{video_id} |
Video - Title | video.title | Output only. The title of the video. |
Customer - ID | customer.id | Output only. The ID of the customer. |
Customer - Currency Code | customer.currency_code | Immutable. The currency in which the account operates. A subset of the currency codes from the ISO 4217 standard is supported. |
Customer - Status | customer.status | Output only. The status of the customer. |
Customer - Descriptive Name | customer.descriptive_name | Optional, non-unique descriptive name of the customer. |
Customer - Time Zone | customer.time_zone | Immutable. The local timezone ID of the customer. |
All Conversions | metrics.all_conversions | The total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric. |
All Conversions From Interactions Rate | metrics.all_conversions_from_interactions_rate | All conversions from interactions (as oppose to view through conversions) divided by the number of ad interactions. |
All Conversions Value | metrics.all_conversions_value | The value of all conversions. |
Average CPC | metrics.average_cpc | The total cost of all clicks divided by the total number of clicks received. |
Average CPE | metrics.average_cpe | The average amount that you've been charged for an ad engagement. This amount is the total cost of all ad engagements divided by the total number of ad engagements. |
Average CPM | metrics.average_cpm | Average cost-per-thousand impressions (CPM). |
Average Cpv | metrics.average_cpv | The average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views. |
Clicks | metrics.clicks | The number of clicks. |
Conversions | metrics.conversions | The number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding your bid strategies will optimize for these conversions. |
Conversions From Interactions Rate | metrics.conversions_from_interactions_rate | Conversions from interactions divided by the number of ad interactions (such as clicks for text ads or views for video ads). This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding your bid strategies will optimize for these conversions. |
Conversions From Interactions Value Per Interaction | metrics.conversions_from_interactions_value_per_interaction | The value of conversions from interactions divided by the number of ad interactions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding your bid strategies will optimize for these conversions. |
Conversions Value | metrics.conversions_value | The value of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding your bid strategies will optimize for these conversions. |
Conversions Value Per Cost | metrics.conversions_value_per_cost | The value of conversions divided by the cost of ad interactions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding your bid strategies will optimize for these conversions. |
Cost Micros (Spend) | metrics.cost_micros | The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. |
Cost Per All Conversions | metrics.cost_per_all_conversions | The cost of ad interactions divided by all conversions. |
Cost Per Conversion | metrics.cost_per_conversion | The cost of ad interactions divided by conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding your bid strategies will optimize for these conversions. |
Cross Device Conversions | metrics.cross_device_conversions | Conversions from when a customer clicks on a Google Ads ad on one device then converts on a different device or browser. Cross-device conversions are already included in all_conversions. |
CTR | metrics.ctr | The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). |
Engagement Rate | metrics.engagement_rate | How often people engage with your ad after it's shown to them. This is the number of ad expansions divided by the number of times your ad is shown. |
Engagements | metrics.engagements | The number of engagements. An engagement occurs when a viewer expands your Lightbox ad. Also in the future other ad types may support engagement metrics. |
Impressions | metrics.impressions | Count of how often your ad has appeared on a search results page or website on the Google Network. |
Value Per All Conversions | metrics.value_per_all_conversions | The value of all conversions divided by the number of all conversions. |
Value Per Conversion | metrics.value_per_conversion | The value of conversions divided by the number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding your bid strategies will optimize for these conversions. |
Video Quartile P100_rate | metrics.video_quartile_p100_rate | Percentage of impressions where the viewer watched all of your video. |
Video Quartile P25_rate | metrics.video_quartile_p25_rate | Percentage of impressions where the viewer watched 25% of your video. |
Video Quartile P50_rate | metrics.video_quartile_p50_rate | Percentage of impressions where the viewer watched 50% of your video. |
Video Quartile P75_rate | metrics.video_quartile_p75_rate | Percentage of impressions where the viewer watched 75% of your video. |
Video View Rate | metrics.video_view_rate | The number of views your TrueView video ad receives divided by its number of impressions including thumbnail impressions for TrueView in-display ads. |
Video Views | metrics.video_views | The number of times your video ads were viewed. |
View Through Conversions | metrics.view_through_conversions | The total number of view-through conversions. These happen when a customer sees an image or rich media ad then later completes a conversion on your site without interacting with (e.g. clicking on) another ad. |
Ad Network Type | segments.ad_network_type | Ad network type. |
Click Type | segments.click_type | Click type. |
Conversion Action | segments.conversion_action | Resource name of the conversion action. |
Conversion Action Category | segments.conversion_action_category | Conversion action category. |
Video Conversion Action Name | segments.conversion_action_name | Conversion action name. |
Date | segments.date | Date to which metrics apply. yyyy-MM-dd format e.g. 2018-04-17. |
Day Of The Week | segments.day_of_week | Day of the week e.g. MONDAY. |
Device | segments.device | Device to which metrics apply. |
External Conversion Source | segments.external_conversion_source | External conversion source. |
Month | segments.month | Month as represented by the date of the first day of a month. Formatted as yyyy-MM-dd. |
Month Of The Year | segments.month_of_year | Month of the year e.g. January. |
Quarter | segments.quarter | Quarter 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. |
Week | segments.week | Week as defined as Monday through Sunday and represented by the date of Monday. Formatted as yyyy-MM-dd. |
Year | segments.year | Year formatted as yyyy. |
Campaign Report
Dataddo Label | Google Ads Label | Field Description |
---|---|---|
Campaign - Accessible Bidding Strategy | campaign.accessible_bidding_strategy | Output only. Resource name of AccessibleBiddingStrategy, a read-only view of the unrestricted attributes of the attached portfolio bidding strategy identified by 'bidding_strategy'. Empty, if the campaign does not use a portfolio strategy. Unrestricted strategy attributes are available to all customers with whom the strategy is shared and are read from the AccessibleBiddingStrategy resource. In contrast, restricted attributes are only available to the owner customer of the strategy and their managers. Restricted attributes can only be read from the BiddingStrategy resource. |
Campaign - Ad Serving Optimization Status | campaign.ad_serving_optimization_status | The ad serving optimization status of the campaign. |
Campaign - Advertising Channel Sub Type | campaign.advertising_channel_sub_type | Immutable. Optional refinement to advertising_channel_type. Must be a valid sub-type of the parent channel type. Can be set only when creating campaigns. After campaign is created, the field can not be changed. |
Campaign - Advertising Channel Type | campaign.advertising_channel_type | Immutable. The primary serving target for ads within the campaign. The targeting options can be refined in network_settings. This field is required and should not be empty when creating new campaigns. Can be set only when creating campaigns. After the campaign is created, the field can not be changed. |
Campaign - App Campaign Setting - App ID | campaign.app_campaign_setting.app_id | Immutable. A string that uniquely identifies a mobile application. |
Campaign - App Campaign Setting - App Store | campaign.app_campaign_setting.app_store | Immutable. The application store that distributes this specific app. |
Campaign - App Campaign Setting - Bidding Strategy Goal Type | campaign.app_campaign_setting.bidding_strategy_goal_type | Represents the goal which the bidding strategy of this app campaign should optimize towards. |
Campaign - Audience Settings - Use Audience Grouped Targets | campaign.audience_setting.use_audience_grouped.target | Immutable. If true, this campaign uses an Audience resource for audience targeting. If false, this campaign may use audience segment criteria instead. |
Campaign - Base Campaign | campaign.base_campaign | Output only. The resource name of the base campaign of a draft or experiment campaign. For base campaigns, this is equal to resource_name. This field is read-only. |
Campaign - Bidding Strategy | campaign.bidding_strategy | Portfolio bidding strategy used by campaign. |
Campaign - Bidding Strategy Type | campaign.bidding_strategy_type | Output only. The type of bidding strategy. A bidding strategy can be created by setting either the bidding scheme to create a standard bidding strategy or the bidding_strategy field to create a portfolio bidding strategy. This field is read-only. |
Campaign - Campaign Budget | campaign.campaign_budget | The budget of the campaign. |
Campaign - Commission - Commission Rate Micros | campaign.commission.commission_rate_micros | Commission rate defines the portion of the conversion value that the advertiser will be billed. A commission rate of x should be passed into this field as (x \* 1,000,000). For example, 106,000 represents a commission rate of 0.106 (10.6%). |
Campaign - Dynamic Search Ads Setting - Domain Name | campaign.dynamic_search_ads_setting.domain_name | Required. The Internet domain name that this setting represents, e.g., google.com or www.google.com. |
Campaign - Dynamic Search Ads Setting - Language Code | campaign.dynamic_search_ads_setting.language_code | Required. The language code specifying the language of the domain, e.g., en. |
Campaign - Dynamic Search Ads Setting - Feeds | campaign.dynamic_search_ads_setting.feeds | The list of page feeds associated with the campaign. |
Campaign - Dynamic Search Ads Setting - Use Supplied Urls Only | campaign.dynamic_search_ads_setting.use_supplied_urls_only | Whether the campaign uses advertiser supplied URLs exclusively. |
Campaign - End Date | campaign.end_date | The last day of the campaign in serving customer's timezone in YYYY-MM-DD format. |
Campaign - Excluded Parent Asset Field Types | campaign.excluded_parent_asset_field_types | The asset field types that should be excluded from this campaign. Asset links with these field types will not be inherited by this campaign from the upper level. |
Campaign - Experiment Type | campaign.experiment_type | Output only. The type of campaign: normal, draft, or experiment. |
Campaign - Final Url Suffix | campaign.final_url_suffix | Suffix used to append query parameters to landing pages that are served with parallel tracking. |
Campaign - Frequency Caps | campaign.frequency_caps | A list that limits how often each user will see this campaign's ads. |
Campaign - ID | campaign.id | Output only. The ID of the campaign. |
Campaign - Labels | campaign.labels | Output only. The resource names of labels attached to this campaign. |
Campaign - Local Campaign Setting - Location Source Type | campaign.local_campaign_setting.location_source_type | The location source type for this local campaign. |
Campaign - Manual CPC - Enhanced CPC Enabled | campaign.manual_cpc.enhanced_cpc_enabled | Whether bids are to be enhanced based on conversion optimizer data. |
Campaign - Manual CPM | campaign.manual_cpm | Standard Manual CPM bidding strategy. Manual impression-based bidding where user pays per thousand impressions. |
Campaign - Manual Cpv | campaign.manual_cpv | Output only. A bidding strategy that pays a configurable amount per video view. |
Campaign - Maximize Conversion Value - Target Roas | campaign.maximize_conversion_value.target_roas | Output 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 Cpa | campaign.maximize_conversions.target_cpa | The target cost-per-action (CPA) option. This is the average amount that you would like to spend per conversion action specified in micro units of the bidding strategy's currency. If set, the bid strategy will get as many conversions as possible at or below the target cost-per-action. If the target CPA is not set, the bid strategy will aim to achieve the lowest possible CPA given the budget. |
Campaign - Name | campaign.name | The name of the campaign. This field is required and should not be empty when creating new campaigns. It must not contain any null (code point 0x0), NL line feed (code point 0xA) or carriage return (code point 0xD) characters. |
Campaign - Network Settings - Target Content Network | campaign.network_settings.target_content_network | Whether ads will be served on specified placements in the Google Display Network. Placements are specified using the Placement criterion. |
Campaign - Network Settings - Target Search Network | campaign.network_settings.target_search_network | Whether 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 Network | campaign.network_settings.target_partner_search_network | Whether ads will be served on the Google Partner Network. This is available only to some select Google partner accounts. |
Campaign - Network Settings - Target Google Search | campaign.network_settings.target_google_search | Whether ads will be served with google.com search results. |
Campaign - Optimization Goal Setting - Optimization Goal Types | campaign.optimization_goal_setting.optimization_goal_types | The list of optimization goal types. |
Campaign - Optimization Score | campaign.optimization_score | Output only. Optimization score of the campaign. Optimization score is an estimate of how well a campaign is set to perform. It ranges from 0% (0.0) to 100% (1.0), with 100% indicating that the campaign is performing at full potential. This field is null for unscored campaigns. See About optimization score at https://support.google.com/google-ads/answer/9061546. This field is read-only. |
Campaign - Payment Mode | campaign.payment_mode | Payment mode for the campaign. |
Campaign - Percent CPC - CPC Bid Ceiling Micros | campaign.percent_cpc.cpc_bid_ceiling_micros | Maximum bid limit that can be set by the bid strategy. This is an optional field entered by the advertiser and specified in local micros. Note: A zero value is interpreted in the same way as having bid_ceiling undefined. |
Campaign - Percent CPC - Enhanced CPC Enabled | campaign.percent_cpc.enhanced_cpc_enabled | Adjusts the bid for each auction upward or downward, depending on the likelihood of a conversion. Individual bids may exceed cpc_bid_ceiling_micros, but the average bid amount for a campaign should not. |
Campaign - Real Time Bidding Setting - Opt In | campaign.real_time_bidding_setting.opt_in | Whether the campaign is opted in to real-time bidding. |
Campaign - Resource Name | campaign.resource_name | Immutable. The resource name of the campaign. Campaign resource names have the form: customers/{customer_id}/campaigns/{campaign_id} |
Campaign - Selective Optimization - Conversion Actions | campaign.selective_optimization.conversion_actions | The selected set of conversion actions for optimizing this campaign. |
Campaign - Serving Status | campaign.serving_status | Output only. The ad serving status of the campaign. |
Campaign - Shopping Setting - Campaign Priority | campaign.shopping_setting.campaign_priority | Priority of the campaign. Campaigns with numerically higher priorities take precedence over those with lower priorities. This field is required for Shopping campaigns, with values between 0 and 2, inclusive. This field is optional for Smart Shopping campaigns, but must be equal to 3 if set. |
Campaign - Shopping Setting - Enable Local | campaign.shopping_setting.enable_local | Whether to include local products. |
Campaign - Shopping Setting - Merchant ID | campaign.shopping_setting.merchant_id | Immutable. ID of the Merchant Center account. This field is required for create operations. This field is immutable for Shopping campaigns. |
Campaign - Shopping Setting - Sales Country | campaign.shopping_setting.sales_country | Sales 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 Inventory | campaign.shopping_setting.use_vehicle_inventory | Immutable. Whether to target Vehicle Listing inventory. |
Campaign - Start Date | campaign.start_date | The date when campaign started in serving customer's timezone in YYYY-MM-DD format. |
Campaign - Status | campaign.status | The status of the campaign. When a new campaign is added, the status defaults to ENABLED. |
Campaign - Target Cpa - CPC Bid Ceiling Micros | campaign.target_cpa.cpc_bid_ceiling_micros | Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies. |
Campaign - Target Cpa - Target Cpa Micros | campaign.target_cpa.target_cpa_micros | Output 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 CPM | campaign.target_cpm | A bidding strategy that automatically optimizes cost per thousand impressions. |
Campaign - Target Impression Share - CPC Bid Ceiling Micros | campaign.target_impression_share.cpc_bid_ceiling_micros | The highest CPC bid the automated bidding system is permitted to specify. This is a required field entered by the advertiser that sets the ceiling and specified in local micros. |
Campaign - Target Cpa - CPC Bid Floor Micros | campaign.target_cpa.cpc_bid_floor_micros | Minimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies. |
Camkpaign - Target Cpa - Target Cpa Micros | campaign.target_cpa.target_cpa_micros | Output 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 Micros | campaign.target_impression_share.cpc_bid_ceiling_micros | The highest CPC bid the automated bidding system is permitted to specify. This is a required field entered by the advertiser that sets the ceiling and specified in local micros. |
Campaign - Target Impression Share - Location | campaign.target_impression_share.location | The targeted location on the search results page. |
Campaign - Target Impression Share - Location Fraction Micros | campaign.target_impression_share.location_fraction_micros | The 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 Micros | campaign.target_roas.cpc_bid_ceiling_micros | Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies. |
Campaign - Target Roas - CPC Bid Floor Micros | campaign.target_roas.cpc_bid_floor_micros | Minimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies. |
Campaign - Target Spend - CPC Bid Floor Micros | campaign.target_spend.cpc_bid_floor_micros | #N/A |
Campaign - Target Roas - Target Roas | campaign.target_roas.target_roas | Required. 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 Micros | campaign.target_spend.cpc_bid_ceiling_micros | Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. |
Campaign - Target Spend - Target Spend Micros | campaign.target_spend.target_spend_micros | The spend target under which to maximize clicks. A TargetSpend bidder will attempt to spend the smaller of this value or the natural throttling spend amount. If not specified, the budget is used as the spend target. This field is deprecated and should no longer be used. See https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html for details. |
Campaign - Targeting Setting - Target Restrictions | campaign.targeting_setting.target_restrictions | The per-targeting-dimension setting to restrict the reach of your campaign or ad group. |
Campaign - Tracking Setting - Tracking Url | campaign.tracking_setting.tracking_url | Output only. The url used for dynamic tracking. |
Campaign - Tracking Url Template | campaign.tracking_url_template | The URL template for constructing a tracking URL. |
Campaign - Url Custom Parameters | campaign.url_custom_parameters | The list of mappings used to substitute custom parameter tags in a tracking_url_template, final_urls, or mobile_final_urls. |
Campaign - Url Expansion Opt Out | campaign.url_expansion_opt_out | Represents 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 Mode | campaign.vanity_pharma.vanity_pharma_display_url_mode | The display mode for vanity pharma URLs. |
Campaign - Vanity Pharma - Vanity Pharma Text | campaign.vanity_pharma.vanity_pharma_text | The text that will be displayed in display URL of the text ad when website description is the selected display mode for vanity pharma URLs. |
Campaign - Video Brand Safety Suitability | campaign.video_brand_safety_suitability | Output only. 3-Tier Brand Safety setting for the campaign. |
Customer - ID | customer.id | Output only. The ID of the customer. |
Customer - Currency Code | customer.currency_code | Immutable. The currency in which the account operates. A subset of the currency codes from the ISO 4217 standard is supported. |
Customer - Status | customer.status | Output only. The status of the customer. |
Customer - Descriptive Name | customer.descriptive_name | Optional, non-unique descriptive name of the customer. |
Customer - Time Zone | customer.time_zone | Immutable. The local timezone ID of the customer. |
Bidding Strategy - ID | bidding_strategy.id | Output only. The ID of the bidding strategy. |
Bidding Strategy - Name | bidding_strategy.name | The 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 - Type | bidding_strategy.type | Output only. The type of the bidding strategy. Create a bidding strategy by setting the bidding scheme. This field is read-only. |
Bidding Strategy - Status | bidding_strategy.status | Output only. The status of the bidding strategy. This field is read-only. |
Active View CPM | metrics.active_view_cpm | Average cost of viewable impressions (active_view_impressions). |
Active View CTR | metrics.active_view_ctr | Active view measurable clicks divided by active view viewable impressions. This metric is reported only for display network. |
Active View Impressions | metrics.active_view_impressions | A measurement of how often your ad has become viewable on a Display Network site. |
Active View Measurability | metrics.active_view_measurability | The ratio of impressions that could be measured by Active View over the number of served impressions. |
Active View Measurable Cost Micros | metrics.active_view_measurable_cost_micros | The cost of the impressions you received that were measurable by Active View. |
Active View Measurable Impressions | metrics.active_view_measurable_impressions | The number of times your ads are appearing on placements in positions where they can be seen. |
Active View Viewability | metrics.active_view_viewability | The percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions). |
All Conversions | metrics.all_conversions | The total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric. |
All Conversions By Conversion Date | metrics.all_conversions_by_conversion_date | The total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009. |
All Conversions From Interactions Rate | metrics.all_conversions_from_interactions_rate | All conversions from interactions (as oppose to view through conversions) divided by the number of ad interactions. |
All Conversions Value | metrics.all_conversions_value | The value of all conversions. |
All Conversions Value By Conversion Date | metrics.all_conversions_value_by_conversion_date | The value of all conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009. |
Average Cost | metrics.average_cost | The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions. |
Average CPC | metrics.average_cpc | The total cost of all clicks divided by the total number of clicks received. |
Average CPE | metrics.average_cpe | The average amount that you've been charged for an ad engagement. This amount is the total cost of all ad engagements divided by the total number of ad engagements. |
Average CPM | metrics.average_cpm | Average cost-per-thousand impressions (CPM). |
Average Cpv | metrics.average_cpv | The average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views. |
Average Page Views | metrics.average_page_views | Average number of pages viewed per session. |
Average Time On Site | metrics.average_time_on_site | Total duration of all sessions (in seconds) / number of sessions. Imported from Google Analytics. |
Bounce Rate | metrics.bounce_rate | Percentage of clicks where the user only visited a single page on your site. Imported from Google Analytics. |
$licks | metrics.clicks | The number of clicks. |
Content Budget Lost Impression Share | metrics.content_budget_lost_impression_share | The 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 Share | metrics.content_impression_share | The impressions you've received on the Display Network divided by the estimated number of impressions you were eligible to receive. Note: Content impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999. |
Content Rank Lost Impression Share | metrics.content_rank_lost_impression_share | The estimated percentage of impressions on the Display Network that your ads didn't receive due to poor Ad Rank. Note: Content rank lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
Conversions | metrics.conversions | The number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Conversions By Conversion Date | metrics.conversions_by_conversion_date | The number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009. |
Conversions From Interactions Rate | metrics.conversions_from_interactions_rate | Conversions from interactions divided by the number of ad interactions (such as clicks for text ads or views for video ads). This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Conversions From Interactions Value Per Interaction | metrics.conversions_from_interactions_value_per_interaction | The value of conversions from interactions divided by the number of ad interactions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Conversions Value | metrics.conversions_value | The value of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Conversions Value By Conversion Date | metrics.conversions_value_by_conversion_date | The value of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009. |
Conversions Value Per Cost | metrics.conversions_value_per_cost | The value of conversions divided by the cost of ad interactions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Cost Micros (Spend) | metrics.cost_micros | The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. |
Cost Per All Conversions | metrics.cost_per_all_conversions | The cost of ad interactions divided by all conversions. |
Cost Per Conversion | metrics.cost_per_conversion | The cost of ad interactions divided by conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Cost Per Current Model Attributed Conversion | metrics.cost_per_current_model_attributed_conversion | The cost of ad interactions divided by current model attributed conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Cross Device Conversions | metrics.cross_device_conversions | Conversions from when a customer clicks on a Google Ads ad on one device, then converts on a different device or browser. Cross-device conversions are already included in all_conversions. |
Current Model Attributed Conversions | metrics.current_model_attributed_conversions | Shows how your historic conversions data would look under the attribution model you've currently selected. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Current Model Attributed Conversions From Interactions Rate | metrics.current_model_attributed_conversions_from_interactions_rate | Current model attributed conversions from interactions divided by the number of ad interactions (such as clicks for text ads or views for video ads). This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Current Model Attributed Conversions From Interactions Value Per Interaction | metrics.current_model_attributed_conversions_from_interactions_value_per_interaction | The value of current model attributed conversions from interactions divided by the number of ad interactions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Current Model Attributed Conversions Value | metrics.current_model_attributed_conversions_value | The value of current model attributed conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Current Model Attributed Conversions Value Per Cost | metrics.current_model_attributed_conversions_value_per_cost | The value of current model attributed conversions divided by the cost of ad interactions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Engagement Rate | metrics.engagement_rate | How often people engage with your ad after it's shown to them. This is the number of ad expansions divided by the number of times your ad is shown. |
Engagements | metrics.engagements | The number of engagements. An engagement occurs when a viewer expands your Lightbox ad. Also, in the future, other ad types may support engagement metrics. |
Gmail Forwards | metrics.gmail_forwards | The number of times the ad was forwarded to someone else as a message. |
Gmail Saves | metrics.gmail_saves | The number of times someone has saved your Gmail ad to their inbox as a message. |
Gmail Secondary Clicks | metrics.gmail_secondary_clicks | The number of clicks to the landing page on the expanded state of Gmail ads. |
Impressions | metrics.impressions | Count of how often your ad has appeared on a search results page or website on the Google Network. |
Interaction Event Types | metrics.interaction_event_types | The types of payable and free interactions. |
Interaction Rate | metrics.interaction_rate | How often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown. |
Interactions | metrics.interactions | The number of interactions. An interaction is the main user action associated with an ad format-clicks for text and shopping ads, views for video ads, and so on. |
Invalid Click Rate | metrics.invalid_click_rate | The percentage of clicks filtered out of your total number of clicks (filtered + non-filtered clicks) during the reporting period. |
Invalid Clicks | metrics.invalid_clicks | Number of clicks Google considers illegitimate and doesn't charge you for. |
Optimization Score Uplift | metrics.optimization_score_uplift | Total optimization score uplift of all recommendations. |
Optimization Score Url | metrics.optimization_score_url | URL for the optimization score page in the Google Ads web interface. This metric can be selected from customer or campaign, and can be segmented by segments.recommendation_type. For example, SELECT metrics.optimization_score_url, segments.recommendation_type FROM customer will return a URL for each unique (customer, recommendation_type) combination. |
Percent New Visitors | metrics.percent_new_visitors | Percentage of first-time sessions (from people who had never visited your site before). Imported from Google Analytics. |
Phone Calls | metrics.phone_calls | Number of offline phone calls. |
Phone Impressions | metrics.phone_impressions | Number of offline phone impressions. |
Phone Through Rate | metrics.phone_through_rate | Number of phone calls received (phone_calls) divided by the number of times your phone number is shown (phone_impressions). |
Relative CTR | metrics.relative_ctr | Your clickthrough rate (Ctr) divided by the average clickthrough rate of all advertisers on the websites that show your ads. Measures how your ads perform on Display Network sites compared to other ads on the same sites. |
Search Absolute Top Impression Share | metrics.search_absolute_top_impression_share | The percentage of the customer's Shopping or Search ad impressions that are shown in the 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 Share | metrics.search_budget_lost_absolute_top_impression_share | The 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 Share | metrics.search_budget_lost_impression_share | The 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 Share | metrics.search_budget_lost_top_impression_share | The 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 Share | metrics.search_click_share | The number of clicks you've received on the Search Network divided by the estimated number of clicks you were eligible to receive. Note: Search click share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999. |
Search Exact Match Impression Share | metrics.search_exact_match_impression_share | The impressions you've received divided by the estimated number of impressions you were eligible to receive on the Search Network for search terms that matched your keywords exactly (or were close variants of your keyword), regardless of your keyword match types. Note: Search exact match impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999. |
Search Impression Share | metrics.search_impression_share | The impressions you've received on the Search Network divided by the estimated number of impressions you were eligible to receive. Note: Search impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999. |
Search Rank Lost Absolute Top Impression Share | metrics.search_rank_lost_absolute_top_impression_share | The 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 Share | metrics.search_rank_lost_impression_share | The estimated percentage of impressions on the Search Network that your ads didn't receive due to poor Ad Rank. Note: Search rank lost impression share is reported in the range of 0 to 0.9. Any value above 0.9 is reported as 0.9001. |
Search Rank Lost Top Impression Share | metrics.search_rank_lost_top_impression_share | The 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 Share | metrics.search_top_impression_share | The 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 Conversions | metrics.sk_ad_network_conversions | The number of iOS Store Kit Ad Network conversions. |
Top Impression Percentage | metrics.top_impression_percentage | The percent of your ad impressions that are shown anywhere above the organic search results. |
Value Per All Conversions | metrics.value_per_all_conversions | The value of all conversions divided by the number of all conversions. |
Value Per All Conversions By Conversion Date | metrics.value_per_all_conversions_by_conversion_date | The value of all conversions divided by the number of all conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009. |
Value Per Conversion | metrics.value_per_conversion | The value of conversions divided by the number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Value Per Conversions By Conversion Date | metrics.value_per_conversions_by_conversion_date | The value of conversions divided by the number of conversions. This only includes conversion actions 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 Conversion | metrics.value_per_current_model_attributed_conversion | The value of current model attributed conversions divided by the number of the conversions. This only includes conversion actions 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_rate | metrics.video_quartile_p100_rate | Percentage of impressions where the viewer watched all of your video. |
Video Quartile P25_rate | metrics.video_quartile_p25_rate | Percentage of impressions where the viewer watched 25% of your video. |
Video Quartile P50_rate | metrics.video_quartile_p50_rate | Percentage of impressions where the viewer watched 50% of your video. |
Video Quartile P75_rate | metrics.video_quartile_p75_rate | Percentage of impressions where the viewer watched 75% of your video. |
Video View Rate | metrics.video_view_rate | The number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads. |
Video Views | metrics.video_views | The number of times your video ads were viewed. |
View Through Conversions | metrics.view_through_conversions | The total number of view-through conversions. These happen when a customer sees an image or rich media ad, then later completes a conversion on your site without interacting with (e.g., clicking on) another ad. |
Ad Destination Type | segments.ad_destination_type | Ad Destination type. |
Ad Network Type | segments.ad_network_type | Ad network type. |
Click Type | segments.click_type | Click type. |
Conversion Action | segments.conversion_action | Resource name of the conversion action. |
Conversion Action Category | segments.conversion_action_category | Conversion action category. |
Campaign Conversion Action Name | segments.conversion_action_name | Conversion action name. |
Conversion Lag Bucket | segments.conversion_lag_bucket | An enum value representing the number of days between the impression and the conversion. |
Conversion Or Adjustment Lag Bucket | segments.conversion_or_adjustment_lag_bucket | An enum value representing the number of days between the impression and the conversion or between the impression and adjustments to the conversion. |
Conversion Value Rule Primary Dimension | segments.conversion_value_rule_primary_dimension | Primary dimension of applied conversion value rules. NO_RULE_APPLIED shows the total recorded value of conversions that do not have a value rule applied. ORIGINAL shows the original value of conversions to which a value rule has been applied. GEO_LOCATION, DEVICE, AUDIENCE show the net adjustment after value rules were applied. |
Date | segments.date | Date to which metrics apply. yyyy-MM-dd format, e.g., 2018-04-17. |
Day Of The Week, e.g., Monday | segments.day_of_week | Day of the week, e.g., MONDAY. |
Device To Which Metrics Apply | segments.device | Device to which metrics apply. |
External Conversion Source | segments.external_conversion_source | External conversion source. |
Hour Of Day | segments.hour | Hour of day as a number between 0 and 23, inclusive. |
Month | segments.month | Month as represented by the date of the first day of a month. Formatted as yyyy-MM-dd. |
Month Of The Year | segments.month_of_year | Month of the year, e.g., January. |
Quarter | segments.quarter | Quarter 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 Type | segments.recommendation_type | Recommendation type. |
IOS Store Kit Ad Network Ad Event Type | segments.sk_ad_network_ad_event_type | iOS Store Kit Ad Network ad event type. |
IOS Store Conversion Value | segments.sk_ad_network_conversion_value | iOS Store Kit Ad Network conversion value. Null value means this segment is not applicable, e.g. non-iOS campaign. |
Source App ID | segments.sk_ad_network_source_app.sk_ad_network_source_app_id | App id where the ad that drove the iOS Store Kit Ad Network install was shown. |
IOS Store User Type | segments.sk_ad_network_user_type | iOS Store Kit Ad Network user type. |
Position | segments.slot | Position of the ad. |
Week By The Date Of Monday | segments.week | Week as defined as Monday through Sunday, and represented by the date of Monday. Formatted as yyyy-MM-dd. |
Year | segments.year | Year, formatted as yyyy. |
Campaign Budget Report
Dataddo Label | Google Ads Label | Field Description |
---|---|---|
Campaign Budget - Amount Micros | campaign_budget.amount_micros | The 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 Method | campaign_budget.delivery_method | The 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 Shared | campaign_budget.explicitly_shared | Specifies 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 Budget | campaign_budget.has_recommended_budget | Output only. Indicates whether there is a recommended budget for this campaign budget. This field is read-only. |
Campaign Budget - ID | campaign_budget.id | Output 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 - Name | campaign_budget.name | The 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 - Period | campaign_budget.period | Immutable. Period over which to spend the budget. Defaults to DAILY if not specified. |
Campaign Budget - Recommended Budget Amount Micros | campaign_budget.recommended_budget_amount_micros | Output 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 Clicks | campaign_budget.recommended_budget_estimated_change_weekly_clicks | Output 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 Micros | campaign_budget.recommended_budget_estimated_change_weekly_cost_micros | Output 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 Interactions | campaign_budget.recommended_budget_estimated_change_weekly_interactions | Output 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 Views | campaign_budget.recommended_budget_estimated_change_weekly_views | Output only. The estimated change in weekly views if the recommended budget is applied. This field is read-only. |
Campaign Budget - Reference Count | campaign_budget.reference_count | Output only. The number of campaigns actively using the budget. This field is read-only. |
Campaign Budget - Status | campaign_budget.status | Output only. The status of this campaign budget. This field is read-only. |
Campaign Budget - Type | campaign_budget.type | Immutable. The type of the campaign budget. |
Campaign Budget - Total Amount Micros | campaign_budget.total_amount_micros | The 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 Conversions | metrics.all_conversions | The total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric. |
All Conversions Value | metrics.all_conversions_value | The value of all conversions. |
All Conversions From Interactions Rate | metrics.all_conversions_from_interactions_rate | All conversions from interactions (as oppose to view through conversions) divided by the number of ad interactions. |
Average Cost | metrics.average_cost | The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions. |
Average CPC | metrics.average_cpc | The total cost of all clicks divided by the total number of clicks received. |
Average CPE | metrics.average_cpe | The average amount that you've been charged for an ad engagement. This amount is the total cost of all ad engagements divided by the total number of ad engagements. |
Average CPM | metrics.average_cpm | Average cost-per-thousand impressions (CPM). |
Average Cpv | metrics.average_cpv | The average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views. |
Clicks | metrics.clicks | The number of clicks. |
Conversions | metrics.conversions | The number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Conversions From Interactions Rate | metrics.conversions_from_interactions_rate | Conversions from interactions divided by the number of ad interactions (such as clicks for text ads or views for video ads). This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Conversions Value | metrics.conversions_value | The value of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Cost Micros (Spend) | metrics.cost_micros | The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. |
Cost Per Conversion | metrics.cost_per_conversion | The cost of ad interactions divided by conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Cost Per All Conversions | metrics.cost_per_all_conversions | The cost of ad interactions divided by all conversions. |
Cross Device Conversions | metrics.cross_device_conversions | Conversions from when a customer clicks on a Google Ads ad on one device, then converts on a different device or browser. Cross-device conversions are already included in all_conversions. |
CTR | metrics.ctr | The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). |
Engagement Rate | metrics.engagement_rate | How often people engage with your ad after it's shown to them. This is the number of ad expansions divided by the number of times your ad is shown. |
Engagements | metrics.engagements | The number of engagements. An engagement occurs when a viewer expands your Lightbox ad. Also, in the future, other ad types may support engagement metrics. |
Impressions | metrics.impressions | Count of how often your ad has appeared on a search results page or website on the Google Network. |
Interaction Event Types | metrics.interaction_event_types | The types of payable and free interactions. |
Interaction Rate | metrics.interaction_rate | How often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown. |
Interactions | metrics.interactions | The number of interactions. An interaction is the main user action associated with an ad format-clicks for text and shopping ads, views for video ads, and so on. |
Value Per All Conversions | metrics.value_per_all_conversions | The value of all conversions divided by the number of all conversions. |
Value Per Conversion | metrics.value_per_conversion | The value of conversions divided by the number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Video View Rate | metrics.video_view_rate | The number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads. |
Video Views | metrics.video_views | The number of times your video ads were viewed. |
View Through Conversions | metrics.view_through_conversions | The total number of view-through conversions. These happen when a customer sees an image or rich media ad, then later completes a conversion on your site without interacting with (e.g., clicking on) another ad. |
Campaign Resource Name | segments.budget_campaign_association_status.campaign | The campaign resource name. |
Campaign Status | segments.budget_campaign_association_status.status | Budget campaign association status. |
Conversion Action | segments.conversion_action | Resource name of the conversion action. |
Conversion Action Category | segments.conversion_action_category | Conversion action category. |
Conversion Action Name | segments.conversion_action_name | Conversion action name. |
Date | segments.date | Date to which metrics apply. yyyy-MM-dd format, e.g., 2018-04-17. |
External Conversion Source | segments.external_conversion_source | External conversion source. |
Ad Group Ad Reports
Dataddo Label | Google Ads Label | Field Description |
---|---|---|
Ad Group Ad - Action Items | ad_group_ad.action_items | Output 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 Ads | ad_group_ad.ad.added_by_google_ads | Output only. Indicates if this ad was automatically added by Google Ads and not by a user. For example, this could happen when ads are automatically created as suggestions for new ads based on knowledge of how existing ads are performing. |
Ad Group Ad - Ad - App Ad - Descriptions | ad_group_ad.ad.app_ad.descriptions | List of text assets for descriptions. When the ad serves the descriptions will be selected from this list. |
Ad Group Ad - Ad - App Ad - Headlines | ad_group_ad.ad.app_ad.headlines | List of text assets for headlines. When the ad serves the headlines will be selected from this list. |
Ad Group Ad - Ad - App Ad - HTML Media Bundles | ad_group_ad.ad.app_ad.html5_media_bundles | List of media bundle assets that may be used with the ad. |
Ad Group Ad - Ad - App Ad - HTML Media Bundles - Asset | ad_group_ad.ad.app_ad.html5_media_bundles.asset | The Asset resource name of this media bundle. |
Ad Group Ad - Ad - App Ad - Images | ad_group_ad.ad.app_ad.images | List of image assets that may be displayed with the ad. |
Ad Group Ad - Ad - App Ad - Images - Asset | ad_group_ad.ad.app_ad.images.asset | The Asset resource name of this image. |
Ad Group Ad - Ad - App Ad - Man | ad_group_ad.ad.app_ad.mandatory_ad_text | Mandatory ad text. |
Ad Group Ad - Ad - App Ad - Youtube Videos | ad_group_ad.ad.app_ad.youtube_videos | List of YouTube video assets that may be displayed with the ad. |
Ad Group Ad - Ad - App Ad - Youtube Videos - Asset | ad_group_ad.ad.app_ad.youtube_videos.asset | The Asset resource name of this video. |
Ad Group Ad - Ad - App Engagement Ad - Descriptions | ad_group_ad.ad.app_engagement_ad.descriptions | List of text assets for descriptions. When the ad serves the descriptions will be selected from this list. |
Ad Group Ad - Ad - App Engagement Ad - Headlines | ad_group_ad.ad.app_engagement_ad.headlines | List of text assets for headlines. When the ad serves the headlines will be selected from this list. |
Ad Group Ad - Ad - App Engagement Ad - Images | ad_group_ad.ad.app_engagement_ad.images | List of image assets that may be displayed with the ad. |
Ad Group Ad - Ad - App Engagement Ad - Images - Asset | ad_group_ad.ad.app_engagement_ad.images.asset | The Asset resource name of this image. |
Ad Group Ad - Ad - App Engagement Ad - Videos | ad_group_ad.ad.app_engagement_ad.videos | List of video assets that may be displayed with the ad. |
Ad Group Ad - Ad - App Engagement Ad - Videos - Asset | ad_group_ad.ad.app_engagement_ad.videos.asset | The Asset resource name of this video. |
Ad Group Ad - Ad - App Pre Registration Ad - Descriptions | ad_group_ad.ad.app_pre_registration_ad.descriptions | List of text assets for descriptions. When the ad serves the descriptions will be selected from this list. |
Ad Group Ad - Ad - App Pre Registration Ad - Headlines | ad_group_ad.ad.app_pre_registration_ad.headlines | List of text assets for headlines. When the ad serves the headlines will be selected from this list. |
Ad Group Ad - Ad - App Pre Registration Ad - Images | ad_group_ad.ad.app_pre_registration_ad.images | List of image asset IDs whose images may be displayed with the ad. |
Ad Group Ad - Ad - App Pre Registration Ad - Images - Asset | ad_group_ad.ad.app_pre_registration_ad.images.asset | The Asset resource name of this image. |
Ad Group Ad - Ad - App Pre Registration Ad - Youtube Videos | ad_group_ad.ad.app_pre_registration_ad.youtube_videos | List of YouTube video asset IDs whose videos may be displayed with the ad. |
Ad Group Ad - Ad - App Pre Registration Ad - Youtube Videos - Asset | ad_group_ad.ad.app_pre_registration_ad.youtube_videos.asset | The Asset resource name of this video. |
Ad Group Ad - Ad - Call Ad - Business Name | ad_group_ad.ad.call_ad.business_name | The business name in the ad. |
Ad Group Ad - Ad - Call Ad - Call Tracked | ad_group_ad.ad.call_ad.call_tracked | Whether to enable call tracking for the creative. Enabling call tracking also enables call conversions. |
Ad Group Ad - Ad - Call Ad - Conversion Action | ad_group_ad.ad.call_ad.conversion_action | The conversion action to attribute a call conversion to. If not set a default conversion action is used. This field only has effect if call_tracked is set to true. Otherwise this field is ignored. |
Ad Group Ad - Ad - Call Ad - Conversion Reporting State | ad_group_ad.ad.call_ad.conversion_reporting_state | The 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 Code | ad_group_ad.ad.call_ad.country_code | The country code in the ad. |
Ad Group Ad - Ad - Call Ad - Description | ad_group_ad.ad.call_ad.description1 | The first line of the ad's description. |
Ad Group Ad - Ad - Call Ad - Description | ad_group_ad.ad.call_ad.description2 | The second line of the ad's description. |
Ad Group Ad - Ad - Call Ad - Disable Call Conversion | ad_group_ad.ad.call_ad.disable_call_conversion | Whether to disable call conversion for the creative. If set to true, disables call conversions even when call_tracked is true. If call_tracked is false, this field is ignored. |
Ad Group Ad - Ad - Call Ad - Headline | ad_group_ad.ad.call_ad.headline1 | First headline in the ad. |
Ad Group Ad - Ad - Call Ad - Headline | ad_group_ad.ad.call_ad.headline2 | Second headline in the ad. |
Ad Group Ad - Ad - Call Ad - Path | ad_group_ad.ad.call_ad.path1 | First part of text that can be appended to the URL in the ad. Optional. |
Ad Group Ad - Ad - Call Ad - Path | ad_group_ad.ad.call_ad.path2 | Second part of text that can be appended to the URL in the ad. This field can only be set when path1 is also set. Optional. |
Ad Group Ad - Ad - Call Ad - Phone Number | ad_group_ad.ad.call_ad.phone_number | The phone number in the ad. |
Ad Group Ad - Ad - Call Ad - Phone Number Verification Url | ad_group_ad.ad.call_ad.phone_number_verification_url | The URL to be used for phone number verification. |
Ad Group Ad - Ad - Device Preference | ad_group_ad.ad.device_preference | The device preference for the ad. You can only specify a preference for mobile devices. When this preference is set the ad will be preferred over other ads when being displayed on a mobile device. The ad can still be displayed on other device types, 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 Type | ad_group_ad.ad.display_upload_ad.display_upload_product_type | The product type of this ad. See comments on the enum for details. |
Ad Group Ad - Ad - Display Upload Ad - Media Bundle | ad_group_ad.ad.display_upload_ad.media_bundle | A media bundle asset to be used in the ad. For information about the media bundle for HTML5_UPLOAD_AD, see https://support.google.com/google-ads/answer/1722096 Media bundles that are part of dynamic product types use a special format that needs to be created through the Google Web Designer. See https://support.google.com/webdesigner/answer/7543898 for more information. |
Ad Group Ad - Ad - Display Upload Ad - Media Bundle - Asset | ad_group_ad.ad.display_upload_ad.media_bundle.asset | The Asset resource name of this media bundle. |
Ad Group Ad - Ad - Display Url | ad_group_ad.ad.display_url | The URL that appears in the ad description for some ad formats. |
Ad Group Ad - Ad - Expanded Dynamic Search Ad - Description | ad_group_ad.ad.expanded_dynamic_search_ad.description | The description of the ad. |
Ad Group Ad - Ad - Expanded Dynamic Search Ad - Description | ad_group_ad.ad.expanded_dynamic_search_ad.description2 | The second description of the ad. |
Ad Group Ad - Ad - Expanded Text Ad - Description | ad_group_ad.ad.expanded_text_ad.description | The description of the ad. |
Ad Group Ad - Ad - Expanded Text Ad - Description | ad_group_ad.ad.expanded_text_ad.description2 | The second description of the ad. |
Ad Group Ad - Ad - Expanded Text Ad - Headline Part | ad_group_ad.ad.expanded_text_ad.headline_part1 | The first part of the ad's headline. |
Ad Group Ad - Ad - Expanded Text Ad - Headline Part | ad_group_ad.ad.expanded_text_ad.headline_part2 | The second part of the ad's headline. |
Ad Group Ad - Ad - Expanded Text Ad - Headline Part | ad_group_ad.ad.expanded_text_ad.headline_part3 | The third part of the ad's headline. |
Ad Group Ad - Ad - Expanded Text Ad - Path | ad_group_ad.ad.expanded_text_ad.path1 | The text that can appear alongside the ad's displayed URL. |
Ad Group Ad - Ad - Expanded Text Ad - Path | ad_group_ad.ad.expanded_text_ad.path2 | Additional text that can appear alongside the ad's displayed URL. |
Ad Group Ad - Ad - Final App Urls | ad_group_ad.ad.final_app_urls | A list of final app URLs that will be used on mobile if the user has the specific app installed. |
Ad Group Ad - Ad - Final Mobile Urls | ad_group_ad.ad.final_mobile_urls | The list of possible final mobile URLs after all cross-domain redirects for the ad. |
Ad Group Ad - Ad - Final Url Suffix | ad_group_ad.ad.final_url_suffix | The suffix to use when constructing a final URL. |
Ad Group Ad - Ad - Final Urls | ad_group_ad.ad.final_urls | The list of possible final URLs after all cross-domain redirects for the ad. |
Ad Group Ad - Ad - Gmail Ad - Header Image | ad_group_ad.ad.gmail_ad.header_image | The 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 Image | ad_group_ad.ad.gmail_ad.marketing_image | The 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 Description | ad_group_ad.ad.gmail_ad.marketing_image_description | Description of the marketing image. |
Ad Group Ad - Ad - Gmail Ad - Marketing Image Display Call To_action - Text | ad_group_ad.ad.gmail_ad.marketing_image_display_call_to_action.text | Text for the display-call-to-action. |
Ad Group Ad - Ad - Gmail Ad - Marketing Image Display Call To Action - Text_color | ad_group_ad.ad.gmail_ad.marketing_image_display_call_to_action.text_color | Text 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_id | ad_group_ad.ad.gmail_ad.marketing_image_display_call_to_action.url_collection_id | Identifies 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 Headline | ad_group_ad.ad.gmail_ad.marketing_image_headline | Headline of the marketing image. |
Ad Group Ad - Ad - Gmail Ad - Product Images | ad_group_ad.ad.gmail_ad.product_images | Product images. Up to 15 images are supported. |
Ad Group Ad - Ad - Gmail Ad - Product Images - Product Image | ad_group_ad.ad.gmail_ad.product_images.product_image | The 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 Videos | ad_group_ad.ad.gmail_ad.product_videos | Product 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 Video | ad_group_ad.ad.gmail_ad.product_videos.product_video | The MediaFile resource name of a video which must be hosted on YouTube. |
Ad Group Ad - Ad - Gmail Ad - Teaser - Business Name | ad_group_ad.ad.gmail_ad.teaser.business_name | Business name of the advertiser. |
Ad Group Ad - Ad - Gmail Ad - Teaser - Description | ad_group_ad.ad.gmail_ad.teaser.description | Description of the teaser. |
Ad Group Ad - Ad - Gmail Ad - Teaser - Headline | ad_group_ad.ad.gmail_ad.teaser.headline | Headline of the teaser. |
Ad Group Ad - Ad - Gmail Ad - Teaser - Logo Image | ad_group_ad.ad.gmail_ad.teaser.logo_image | The 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 Ad | ad_group_ad.ad.hotel_ad | Details pertaining to a hotel ad. |
Ad Group Ad - Ad - ID | ad_group_ad.ad.id | Output only. The ID of the ad. |
Ad Group Ad - Ad - Image Ad - Image Url | ad_group_ad.ad.image_ad.image_url | URL of the full size image. |
Ad Group Ad - Ad - Image Ad - Media File | ad_group_ad.ad.image_ad.media_file | The MediaFile resource to use for the image. |
Ad Group Ad - Ad - Image Ad - Mime Type | ad_group_ad.ad.image_ad.mime_type | The mime type of the image. |
Ad Group Ad - Ad - Image Ad - Name | ad_group_ad.ad.image_ad.name | The name of the image. If the image was created from a MediaFile, this is the MediaFile's name. If the image was created from bytes, this is empty. |
Ad Group Ad - Ad - Image Ad - Pixel Height | ad_group_ad.ad.image_ad.pixel_height | Height in pixels of the full size image. |
Ad Group Ad - Ad - Image Ad - Pixel Width | ad_group_ad.ad.image_ad.pixel_width | Width in pixels of the full size image. |
Ad Group Ad - Ad - Image Ad - Preview Image Url | ad_group_ad.ad.image_ad.preview_image_url | URL of the preview size image. |
Ad Group Ad - Ad - Image Ad - Preview Pixel Height | ad_group_ad.ad.image_ad.preview_pixel_height | Height in pixels of the preview size image. |
Ad Group Ad - Ad - Image Ad - Preview Pixel Width | ad_group_ad.ad.image_ad.preview_pixel_width | Width in pixels of the preview size image. |
Ad Group Ad - Ad - Legacy App Install Ad | ad_group_ad.ad.legacy_app_install_ad | Immutable. Details pertaining to a legacy app install ad. |
Ad Group Ad - Ad - Legacy Responsive Display Ad - Accent Color | ad_group_ad.ad.legacy_responsive_display_ad.accent_color | The 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 Color | ad_group_ad.ad.legacy_responsive_display_ad.allow_flexible_color | Advertiser's consent to allow flexible color. When true, the ad may be served with different color if necessary. When false, the ad will be served with the specified colors or a neutral color. The default value is true. Must be true if main_color and accent_color are not set. |
Ad Group Ad - Ad - Legacy Responsive Display Ad - Business Name | ad_group_ad.ad.legacy_responsive_display_ad.business_name | The business name in the ad. |
Ad Group Ad - Ad - Legacy Responsive Display Ad - Call To Action Text | ad_group_ad.ad.legacy_responsive_display_ad.call_to_action_text | The call-to-action text for the ad. |
Ad Group Ad - Ad - Legacy Responsive Display Ad - Description | ad_group_ad.ad.legacy_responsive_display_ad.description | The description of the ad. |
Ad Group Ad - Ad - Legacy Responsive Display Ad - Format Setting | ad_group_ad.ad.legacy_responsive_display_ad.format_setting | Specifies which format the ad will be served in. Default is ALL_FORMATS. |
Ad Group Ad - Ad - Legacy Responsive Display Ad - Logo Image | ad_group_ad.ad.legacy_responsive_display_ad.logo_image | The MediaFile resource name of the logo image used in the ad. |
Ad Group Ad - Ad - Legacy Responsive Display Ad - Long Headline | ad_group_ad.ad.legacy_responsive_display_ad.long_headline | The long version of the ad's headline. |
Ad Group Ad - Ad - Legacy Responsive Display Ad - Main Color | ad_group_ad.ad.legacy_responsive_display_ad.main_color | The 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 Image | ad_group_ad.ad.legacy_responsive_display_ad.marketing_image | The MediaFile resource name of the marketing image used in the ad. |
Ad Group Ad - Ad - Legacy Responsive Display Ad - Price Prefix | ad_group_ad.ad.legacy_responsive_display_ad.price_prefix | Prefix before price. E.g. 'as low as'. |
Ad Group Ad - Ad - Legacy Responsive Display Ad - Promo Text | ad_group_ad.ad.legacy_responsive_display_ad.promo_text | Promotion text used for dynamic formats of responsive ads. For example 'Free two-day shipping'. |
Ad Group Ad - Ad - Legacy Responsive Display Ad - Short Headline | ad_group_ad.ad.legacy_responsive_display_ad.short_headline | The short version of the ad's headline. |
Ad Group Ad - Ad - Legacy Responsive Display Ad - Square Logo Image | ad_group_ad.ad.legacy_responsive_display_ad.square_logo_image | The MediaFile resource name of the square logo image used in the ad. |
Ad Group Ad - Ad - Legacy Responsive Display Ad - Square Marketing Image | ad_group_ad.ad.legacy_responsive_display_ad.square_marketing_image | The MediaFile resource name of the square marketing image used in the ad. |
Ad Group Ad - Ad - Local Ad - Call To Actions | ad_group_ad.ad.local_ad.call_to_actions | List of text assets for call-to-actions. When the ad serves the call-to-actions will be selected from this list. Call-to-actions are optional and at most 5 can be specified. |
Ad Group Ad - Ad - Local Ad - Descriptions | ad_group_ad.ad.local_ad.descriptions | List of text assets for descriptions. When the ad serves the descriptions will be selected from this list. At least 1 and at most 5 descriptions must be specified. |
Ad Group Ad - Ad - Local Ad - Headlines | ad_group_ad.ad.local_ad.headlines | List of text assets for headlines. When the ad serves the headlines will be selected from this list. At least 1 and at most 5 headlines must be specified. |
Ad Group Ad - Ad - Local Ad - Logo Images | ad_group_ad.ad.local_ad.logo_images | List of logo image assets that may be displayed with the ad. The images must be 128x128 pixels and not larger than 120KB. At least 1 and at most 5 image assets must be specified. |
Ad Group Ad - Ad - Local Ad - Logo Images - Asset | ad_group_ad.ad.local_ad.logo_images.asset | The Asset resource name of this image. |
Ad Group Ad - Ad - Local Ad - Marketing Images | ad_group_ad.ad.local_ad.marketing_images | List of marketing image assets that may be displayed with the ad. The images must be 314x600 pixels or 320x320 pixels. At least 1 and at most 20 image assets must be specified. |
Ad Group Ad - Ad - Local Ad - Marketing Images - Asset | ad_group_ad.ad.local_ad.marketing_images.asset | The Asset resource name of this image. |
Ad Group Ad - Ad - Local Ad - Path | ad_group_ad.ad.local_ad.path1 | First part of optional text that can be appended to the URL in the ad. |
Ad Group Ad - Ad - Local Ad - Path | ad_group_ad.ad.local_ad.path2 | Second part of optional text that can be appended to the URL in the ad. This field can only be set when path1 is also set. |
Ad Group Ad - Ad - Local Ad - Videos | ad_group_ad.ad.local_ad.videos | List 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 - Asset | ad_group_ad.ad.local_ad.videos.asset | The Asset resource name of this video. |
Ad Group Ad - Ad - Name | ad_group_ad.ad.name | Immutable. The name of the ad. This is only used to be able to identify the ad. It does not need to be unique and does not affect the served ad. The name field is currently only supported for DisplayUploadAd, ImageAd, ShoppingComparisonListingAd and VideoAd. |
Ad Group Ad - Ad - Resource Name | ad_group_ad.ad.resource_name | Immutable. The resource name of the ad. Ad resource names have the form: customers/{customer_id}/ads/{ad_id} |
Ad Group Ad - Ad - Responsive Display Ad - Accent Color | ad_group_ad.ad.responsive_display_ad.accent_color | The 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 Color | ad_group_ad.ad.responsive_display_ad.allow_flexible_color | Advertiser's consent to allow flexible color. When true, the ad may be served with different color if necessary. When false, the ad will be served with the specified colors or a neutral color. The default value is true. Must be true if main_color and accent_color are not set. |
Ad Group Ad - Ad - Responsive Display Ad - Business Name | ad_group_ad.ad.responsive_display_ad.business_name | The advertiser/brand name. Maximum display width is 25. |
Ad Group Ad - Ad - Responsive Display Ad - Call To Action Text | ad_group_ad.ad.responsive_display_ad.call_to_action_text | The call-to-action text for the ad. Maximum display width is 30. |
Ad Group Ad - Ad - Responsive Display Ad - Control Spec - Enable Asset Enhancements | ad_group_ad.ad.responsive_display_ad.control_spec.enable_asset_enhancements | Whether the advertiser has opted into the asset enhancements feature. |
Ad Group Ad - Ad - Responsive Display Ad - Control Spec - Enable Autogen Video | ad_group_ad.ad.responsive_display_ad.control_spec.enable_autogen_video | Whether the advertiser has opted into auto-gen video feature. |
Ad Group Ad - Ad - Responsive Display Ad - Descriptions | ad_group_ad.ad.responsive_display_ad.descriptions | Descriptive texts for the ad. The maximum length is 90 characters. At least 1 and max 5 headlines can be specified. |
Ad Group Ad - Ad - Responsive Display Ad - Format Setting | ad_group_ad.ad.responsive_display_ad.format_setting | Specifies which format the ad will be served in. Default is ALL_FORMATS. |
Ad Group Ad - Ad - Responsive Display Ad - Headlines | ad_group_ad.ad.responsive_display_ad.headlines | Short format headlines for the ad. The maximum length is 30 characters. At least 1 and max 5 headlines can be specified. |
Ad Group Ad - Ad - Responsive Display Ad - Logo Images | ad_group_ad.ad.responsive_display_ad.logo_images | Logo images to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 512x128 and the aspect ratio must be 4:1 (+-1%). Combined with square_logo_images, the maximum is 5. |
Ad Group Ad - Ad - Responsive Display Ad - Logo Images - Asset | ad_group_ad.ad.responsive_display_ad.logo_images.asset | The Asset resource name of this image. |
Ad Group Ad - Ad - Responsive Display Ad - Long Headline | ad_group_ad.ad.responsive_display_ad.long_headline | A required long format headline. The maximum length is 90 characters. |
Ad Group Ad - Ad - Responsive Display Ad - Main Color | ad_group_ad.ad.responsive_display_ad.main_color | The 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 Images | ad_group_ad.ad.responsive_display_ad.marketing_images | Marketing images to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 600x314 and the aspect ratio must be 1.91:1 (+-1%). At least one marketing_image is required. Combined with square_marketing_images, the maximum is 15. |
Ad Group Ad - Ad - Responsive Display Ad - Marketing Images - Asset | ad_group_ad.ad.responsive_display_ad.marketing_images.asset | The Asset resource name of this image. |
Ad Group Ad - Ad - Responsive Display Ad - Price Prefix | ad_group_ad.ad.responsive_display_ad.price_prefix | Prefix before price. E.g. 'as low as'. |
Ad Group Ad - Ad - Responsive Display Ad - Promo Text | ad_group_ad.ad.responsive_display_ad.promo_text | Promotion text used for dynamic formats of responsive ads. For example 'Free two-day shipping'. |
Ad Group Ad - Ad - Responsive Display Ad - Square Logo Images | ad_group_ad.ad.responsive_display_ad.square_logo_images | Square logo images to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 128x128 and the aspect ratio must be 1:1 (+-1%). Combined with square_logo_images, the maximum is 5. |
Ad Group Ad - Ad - Responsive Display Ad - Square Logo Images - Asset | ad_group_ad.ad.responsive_display_ad.square_logo_images.asset | The Asset resource name of this image. |
Ad Group Ad - Ad - Responsive Display Ad - Square Marketing Images | ad_group_ad.ad.responsive_display_ad.square_marketing_images | Square marketing images to be used in the ad. Valid image types are GIF, JPEG, and PNG. The minimum size is 300x300 and the aspect ratio must be 1:1 (+-1%). At least one square marketing_image is required. Combined with marketing_images, the maximum is 15. |
Ad Group Ad - Ad - Responsive Display Ad - Square Marketing Images - Asset | ad_group_ad.ad.responsive_display_ad.square_marketing_images.asset | The Asset resource name of this image. |
Ad Group Ad - Ad - Responsive Display Ad - Youtube Videos | ad_group_ad.ad.responsive_display_ad.youtube_videos | Optional YouTube videos for the ad. A maximum of 5 videos can be specified. |
Ad Group Ad - Ad - Responsive Display Ad - Youtube Videos - Asset | ad_group_ad.ad.responsive_display_ad.youtube_videos.asset | The Asset resource name of this video. |
Ad Group Ad - Ad - Responsive Search Ad - Descriptions | ad_group_ad.ad.responsive_search_ad.descriptions | List of text assets for descriptions. When the ad serves the descriptions will be selected from this list. |
Ad Group Ad - Ad - Responsive Search Ad - Headlines | ad_group_ad.ad.responsive_search_ad.headlines | List of text assets for headlines. When the ad serves the headlines will be selected from this list. |
Ad Group Ad - Ad - Responsive Search Ad - Path | ad_group_ad.ad.responsive_search_ad.path1 | First part of text that can be appended to the URL in the ad. |
Ad Group Ad - Ad - Responsive Search Ad - Path | ad_group_ad.ad.responsive_search_ad.path2 | Second part of text that can be appended to the URL in the ad. This field can only be set when path1 is also set. |
Ad Group Ad - Ad - Shopping Comparison Listing Ad - Headline | ad_group_ad.ad.shopping_comparison_listing_ad.headline | Headline of the ad. This field is required. Allowed length is between 25 and 45 characters. |
Ad Group Ad - Ad - Shopping Product Ad | ad_group_ad.ad.shopping_product_ad | Details pertaining to a Shopping product ad. |
Ad Group Ad - Ad - Shopping Smart Ad | ad_group_ad.ad.shopping_smart_ad | Details pertaining to a Smart Shopping ad. |
Ad Group Ad - Ad - Smart Campaign Ad - Descriptions | ad_group_ad.ad.smart_campaign_ad.descriptions | List 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 - Headlines | ad_group_ad.ad.smart_campaign_ad.headlines | List 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 Source | ad_group_ad.ad.system_managed_resource_source | Output only. If this ad is system managed, then this field will indicate the source. This field is read-only. |
Ad Group Ad - Ad - Text Ad - Description | ad_group_ad.ad.text_ad.description1 | The first line of the ad's description. |
Ad Group Ad - Ad - Text Ad - Description | ad_group_ad.ad.text_ad.description2 | The second line of the ad's description. |
Ad Group Ad - Ad - Text Ad - Headline | ad_group_ad.ad.text_ad.headline | The headline of the ad. |
Ad Group Ad - Ad - Tracking Url Template | ad_group_ad.ad.tracking_url_template | The URL template for constructing a tracking URL. |
Ad Group Ad - Ad - Type | ad_group_ad.ad.type | Output only. The type of ad. |
Ad Group Ad - Ad - Url Collections | ad_group_ad.ad.url_collections | Additional URLs for the ad that are tagged with a unique identifier that can be referenced from other fields in the ad. |
Ad Group Ad - Ad - Url Custom Parameters | ad_group_ad.ad.url_custom_parameters | The list of mappings that can be used to substitute custom parameter tags in a tracking_url_template, final_urls, or mobile_final_urls. For mutates, please use url custom parameter operations. |
Ad Group Ad Ad Video Ad | ad_group_ad.ad.video_ad.bumper.companion_banner.asset | The Asset resource name of this image. |
Ad Group Ad - Ad - Video Ad - In Feed - Description | ad_group_ad.ad.video_ad.in_feed.description1 | First text line for the ad. |
Ad Group Ad - Ad - Video Ad - In Feed - Description | ad_group_ad.ad.video_ad.in_feed.description2 | Second text line for the ad. |
Ad Group Ad - Ad - Video Ad - In Feed - Headline | ad_group_ad.ad.video_ad.in_feed.headline | The headline of the ad. |
Ad Group Ad - Ad - Video Ad - In Feed - Thumbnail | ad_group_ad.ad.video_ad.in_feed.thumbnail | Video thumbnail image to use. |
Ad Group Ad - Ad - Video Ad - In Stream - Action Button Label | ad_group_ad.ad.video_ad.in_stream.action_button_label | Label on the CTA (call-to-action) button taking the user to the video ad's final URL. Required for TrueView for action campaigns, optional otherwise. |
Ad Group Ad - Ad - Video Ad - In Stream - Action Headline | ad_group_ad.ad.video_ad.in_stream.action_headline | Additional text displayed with the CTA (call-to-action) button to give context and encourage clicking on the button. |
Ad Group Ad Ad Video Ad | ad_group_ad.ad.video_ad.in_stream.companion_banner.asset | The Asset resource name of this image. |
Ad Group Ad - Ad - Video Ad - Non Skippable - Action Button Label | ad_group_ad.ad.video_ad.non_skippable.action_button_label | Label on the Call To Action button taking the user to the video ad's final URL. |
Ad Group Ad - Ad - Video Ad - Non Skippable - Action Headline | ad_group_ad.ad.video_ad.non_skippable.action_headline | Additional text displayed with the Call To Action button to give context and encourage clicking on the button. |
Ad Group Ad Ad Video Ad | ad_group_ad.ad.video_ad.non_skippable.companion_banner.asset | The Asset resource name of this image. |
Ad Group Ad - Ad - Video Ad - Out Stream - Description | ad_group_ad.ad.video_ad.out_stream.description | The description line. |
Ad Group Ad - Ad - Video Ad - Out Stream - Headline | ad_group_ad.ad.video_ad.out_stream.headline | The headline of the ad. |
Ad Group Ad - Ad - Video Ad - Video - Asset | ad_group_ad.ad.video_ad.video.asset | The Asset resource name of this video. |
Ad Group Ad - Ad - Video Responsive Ad - Call To Actions | ad_group_ad.ad.video_responsive_ad.call_to_actions | List 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 Banners | ad_group_ad.ad.video_responsive_ad.companion_banners | List of image assets used for the companion banner. Currently, only a single value for the companion banner asset is supported. |
Ad Group Ad - Ad - Video Responsive Ad - Companion Banners - Asset | ad_group_ad.ad.video_responsive_ad.companion_banners.asset | The Asset resource name of this image. |
Ad Group Ad - Ad - Video Responsive Ad - Descriptions | ad_group_ad.ad.video_responsive_ad.descriptions | List of text assets used for the description. Currently, only a single value for the description is supported. |
Ad Group Ad - Ad - Video Responsive Ad - Headlines | ad_group_ad.ad.video_responsive_ad.headlines | List 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 Headlines | ad_group_ad.ad.video_responsive_ad.long_headlines | List of text assets used for the long headline. Currently, only a single value for the long headline is supported. |
Ad Group Ad - Ad - Video Responsive Ad - Videos | ad_group_ad.ad.video_responsive_ad.videos | List 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 - Asset | ad_group_ad.ad.video_responsive_ad.videos.asset | The Asset resource name of this video. |
Ad Group Ad - Ad Group | ad_group_ad.ad_group | Immutable. The ad group to which the ad belongs. |
Ad Group Ad - Ad Strength | ad_group_ad.ad_strength | Output only. Overall ad strength for this ad group ad. |
Ad Group Ad - Labels | ad_group_ad.labels | Output only. The resource names of labels attached to this ad group ad. |
Ad Group Ad - Policy Summary - Approval Status | ad_group_ad.policy_summary.approval_status | Output only. The overall approval status of this ad, calculated based on the status of its individual policy topic entries. |
Ad Group Ad - Policy Summary - Policy Topic Entries | ad_group_ad.policy_summary.policy_topic_entries | Output only. The list of policy findings for this ad. |
Ad Group Ad - Policy Summary - Review Status | ad_group_ad.policy_summary.review_status | Output only. Where in the review process this ad is. |
Ad Group Ad - Resource Name | ad_group_ad.resource_name | Immutable. The resource name of the ad. Ad group ad resource names have the form: customers/{customer_id}/adGroupAds/{ad_group_id}~{ad_id} |
Ad Group Ad - Status | ad_group_ad.status | The status of the ad. |
Customer - ID | customer.id | Output only. The ID of the customer. |
Customer - Currency Code | customer.currency_code | Immutable. The currency in which the account operates. A subset of the currency codes from the ISO 4217 standard is supported. |
Customer - Status | customer.status | Output only. The status of the customer. |
Customer - Descriptive Name | customer.descriptive_name | Optional, non-unique descriptive name of the customer. |
Customer - Time Zone | customer.time_zone | Immutable. The local timezone ID of the customer. |
Campaign - Accessible Bidding Strategy | campaign.accessible_bidding_strategy | Output only. Resource name of AccessibleBiddingStrategy, a read-only view of the unrestricted attributes of the attached portfolio bidding strategy identified by 'bidding_strategy'. Empty, if the campaign does not use a portfolio strategy. Unrestricted strategy attributes are available to all customers with whom the strategy is shared and are read from the AccessibleBiddingStrategy resource. In contrast, restricted attributes are only available to the owner customer of the strategy and their managers. Restricted attributes can only be read from the BiddingStrategy resource. |
Campaign - Ad Serving Optimization Status | campaign.ad_serving_optimization_status | The ad serving optimization status of the campaign. |
Campaign - Advertising Channel Sub Type | campaign.advertising_channel_sub_type | Immutable. Optional refinement to advertising_channel_type. Must be a valid sub-type of the parent channel type. Can be set only when creating campaigns. After campaign is created, the field can not be changed. |
Campaign - Advertising Channel Type | campaign.advertising_channel_type | Immutable. The primary serving target for ads within the campaign. The targeting options can be refined in network_settings. This field is required and should not be empty when creating new campaigns. Can be set only when creating campaigns. After the campaign is created, the field can not be changed. |
Campaign - App Campaign Setting - App ID | campaign.app_campaign_setting.app_id | Immutable. A string that uniquely identifies a mobile application. |
Campaign - App Campaign Setting - App Store | campaign.app_campaign_setting.app_store | Immutable. The application store that distributes this specific app. |
Campaign - App Campaign Setting - Bidding Strategy Goal Type | campaign.app_campaign_setting.bidding_strategy_goal_type | Represents the goal which the bidding strategy of this app campaign should optimize towards. |
Campaign - Audience Settings - Use Audience Grouped Targets | campaign.audience_setting.use_audience_grouped.target | Immutable. If true, this campaign uses an Audience resource for audience targeting. If false, this campaign may use audience segment criteria instead. |
Campaign - Base Campaign | campaign.base_campaign | Output only. The resource name of the base campaign of a draft or experiment campaign. For base campaigns, this is equal to resource_name. This field is read-only. |
Campaign - Bidding Strategy | campaign.bidding_strategy | Portfolio bidding strategy used by campaign. |
Campaign - Bidding Strategy Type | campaign.bidding_strategy_type | Output only. The type of bidding strategy. A bidding strategy can be created by setting either the bidding scheme to create a standard bidding strategy or the bidding_strategy field to create a portfolio bidding strategy. This field is read-only. |
Campaign - Campaign Budget | campaign.campaign_budget | The budget of the campaign. |
Campaign - Commission - Commission Rate Micros | campaign.commission.commission_rate_micros | Commission rate defines the portion of the conversion value that the advertiser will be billed. A commission rate of x should be passed into this field as (x \* 1,000,000). For example, 106,000 represents a commission rate of 0.106 (10.6%). |
Campaign - Dynamic Search Ads Setting - Domain Name | campaign.dynamic_search_ads_setting.domain_name | Required. The Internet domain name that this setting represents, e.g., google.com or www.google.com. |
Campaign - Dynamic Search Ads Setting - Language Code | campaign.dynamic_search_ads_setting.language_code | Required. The language code specifying the language of the domain, e.g., en. |
Campaign - Dynamic Search Ads Setting - Feeds | campaign.dynamic_search_ads_setting.feeds | The list of page feeds associated with the campaign. |
Campaign - Dynamic Search Ads Setting - Use Supplied Urls Only | campaign.dynamic_search_ads_setting.use_supplied_urls_only | Whether the campaign uses advertiser supplied URLs exclusively. |
Campaign - End Date | campaign.end_date | The last day of the campaign in serving customer's timezone in YYYY-MM-DD format. |
Campaign - Excluded Parent Asset Field Types | campaign.excluded_parent_asset_field_types | The asset field types that should be excluded from this campaign. Asset links with these field types will not be inherited by this campaign from the upper level. |
Campaign - Experiment Type | campaign.experiment_type | Output only. The type of campaign: normal, draft, or experiment. |
Campaign - Final Url Suffix | campaign.final_url_suffix | Suffix used to append query parameters to landing pages that are served with parallel tracking. |
Campaign - Frequency Caps | campaign.frequency_caps | A list that limits how often each user will see this campaign's ads. |
Campaign - ID | campaign.id | Output only. The ID of the campaign. |
Campaign - Labels | campaign.labels | Output only. The resource names of labels attached to this campaign. |
Campaign - Local Campaign Setting - Location Source Type | campaign.local_campaign_setting.location_source_type | The location source type for this local campaign. |
Campaign - Manual CPC - Enhanced CPC Enabled | campaign.manual_cpc.enhanced_cpc_enabled | Whether bids are to be enhanced based on conversion optimizer data. |
Campaign - Manual CPM | campaign.manual_cpm | Standard Manual CPM bidding strategy. Manual impression-based bidding where user pays per thousand impressions. |
Campaign - Manual Cpv | campaign.manual_cpv | Output only. A bidding strategy that pays a configurable amount per video view. |
Campaign - Maximize Conversion Value - Target Roas | campaign.maximize_conversion_value.target_roas | Output 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 Cpa | campaign.maximize_conversions.target_cpa | The target cost-per-action (CPA) option. This is the average amount that you would like to spend per conversion action specified in micro units of the bidding strategy's currency. If set, the bid strategy will get as many conversions as possible at or below the target cost-per-action. If the target CPA is not set, the bid strategy will aim to achieve the lowest possible CPA given the budget. |
Campaign - Name | campaign.name | The name of the campaign. This field is required and should not be empty when creating new campaigns. It must not contain any null (code point 0x0), NL line feed (code point 0xA) or carriage return (code point 0xD) characters. |
Campaign - Network Settings - Target Content Network | campaign.network_settings.target_content_network | Whether ads will be served on specified placements in the Google Display Network. Placements are specified using the Placement criterion. |
Campaign - Network Settings - Target Search Network | campaign.network_settings.target_search_network | Whether 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 Network | campaign.network_settings.target_partner_search_network | Whether ads will be served on the Google Partner Network. This is available only to some select Google partner accounts. |
Campaign - Network Settings - Target Google Search | campaign.network_settings.target_google_search | Whether ads will be served with google.com search results. |
Campaign - Optimization Goal Setting - Optimization Goal Types | campaign.optimization_goal_setting.optimization_goal_types | The list of optimization goal types. |
Campaign - Optimization Score | campaign.optimization_score | Output only. Optimization score of the campaign. Optimization score is an estimate of how well a campaign is set to perform. It ranges from 0% (0.0) to 100% (1.0), with 100% indicating that the campaign is performing at full potential. This field is null for unscored campaigns. See About optimization score at https://support.google.com/google-ads/answer/9061546. This field is read-only. |
Campaign - Payment Mode | campaign.payment_mode | Payment mode for the campaign. |
Campaign - Percent CPC - CPC Bid Ceiling Micros | campaign.percent_cpc.cpc_bid_ceiling_micros | Maximum bid limit that can be set by the bid strategy. This is an optional field entered by the advertiser and specified in local micros. Note: A zero value is interpreted in the same way as having bid_ceiling undefined. |
Campaign - Percent CPC - Enhanced CPC Enabled | campaign.percent_cpc.enhanced_cpc_enabled | Adjusts the bid for each auction upward or downward, depending on the likelihood of a conversion. Individual bids may exceed cpc_bid_ceiling_micros, but the average bid amount for a campaign should not. |
Campaign - Real Time Bidding Setting - Opt In | campaign.real_time_bidding_setting.opt_in | Whether the campaign is opted in to real-time bidding. |
Campaign - Resource Name | campaign.resource_name | Immutable. The resource name of the campaign. Campaign resource names have the form: customers/{customer_id}/campaigns/{campaign_id} |
Campaign - Selective Optimization - Conversion Actions | campaign.selective_optimization.conversion_actions | The selected set of conversion actions for optimizing this campaign. |
Campaign - Serving Status | campaign.serving_status | Output only. The ad serving status of the campaign. |
Campaign - Shopping Setting - Campaign Priority | campaign.shopping_setting.campaign_priority | Priority of the campaign. Campaigns with numerically higher priorities take precedence over those with lower priorities. This field is required for Shopping campaigns, with values between 0 and 2, inclusive. This field is optional for Smart Shopping campaigns, but must be equal to 3 if set. |
Campaign - Shopping Setting - Enable Local | campaign.shopping_setting.enable_local | Whether to include local products. |
Campaign - Shopping Setting - Merchant ID | campaign.shopping_setting.merchant_id | Immutable. ID of the Merchant Center account. This field is required for create operations. This field is immutable for Shopping campaigns. |
Campaign - Shopping Setting - Sales Country | campaign.shopping_setting.sales_country | Sales 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 Inventory | campaign.shopping_setting.use_vehicle_inventory | Immutable. Whether to target Vehicle Listing inventory. |
Campaign - Start Date | campaign.start_date | The date when campaign started in serving customer's timezone in YYYY-MM-DD format. |
Campaign - Status | campaign.status | The status of the campaign. When a new campaign is added, the status defaults to ENABLED. |
Campaign - Target Cpa - CPC Bid Ceiling Micros | campaign.target_cpa.cpc_bid_ceiling_micros | Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies. |
Campaign - Target Cpa - Target Cpa Micros | campaign.target_cpa.target_cpa_micros | Output 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 CPM | campaign.target_cpm | A bidding strategy that automatically optimizes cost per thousand impressions. |
Campaign - Target Impression Share - CPC Bid Ceiling Micros | campaign.target_impression_share.cpc_bid_ceiling_micros | The highest CPC bid the automated bidding system is permitted to specify. This is a required field entered by the advertiser that sets the ceiling and specified in local micros. |
Campaign - Target Cpa - CPC Bid Floor Micros | campaign.target_cpa.cpc_bid_floor_micros | Minimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies. |
Campaign - Target Cpa - Target Cpa Micros | campaign.target_cpa.target_cpa_micros | Output 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 Micros | campaign.target_impression_share.cpc_bid_ceiling_micros | The highest CPC bid the automated bidding system is permitted to specify. This is a required field entered by the advertiser that sets the ceiling and specified in local micros. |
Campaign - Target Impression Share - Location | campaign.target_impression_share.location | The targeted location on the search results page. |
Campaign - Target Impression Share - Location Fraction Micros | campaign.target_impression_share.location_fraction_micros | The 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 Micros | campaign.target_roas.cpc_bid_ceiling_micros | Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies. |
Campaign - Target Roas - CPC Bid Floor Micros | campaign.target_roas.cpc_bid_floor_micros | Minimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies. |
Campaign - Target Roas - Target Roas | campaign.target_roas.target_roas | Required. 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 Micros | campaign.target_spend.cpc_bid_ceiling_micros | Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. |
Campaign - Target Spend - Target Spend Micros | campaign.target_spend.target_spend_micros | The spend target under which to maximize clicks. A TargetSpend bidder will attempt to spend the smaller of this value or the natural throttling spend amount. If not specified, the budget is used as the spend target. This field is deprecated and should no longer be used. See https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html for details. |
Campaign - Targeting Setting - Target Restrictions | campaign.targeting_setting.target_restrictions | The per-targeting-dimension setting to restrict the reach of your campaign or ad group. |
Campaign - Tracking Setting - Tracking Url | campaign.tracking_setting.tracking_url | Output only. The url used for dynamic tracking. |
Campaign - Tracking Url Template | campaign.tracking_url_template | The URL template for constructing a tracking URL. |
Campaign - Url Custom Parameters | campaign.url_custom_parameters | The list of mappings used to substitute custom parameter tags in a tracking_url_template, final_urls, or mobile_final_urls. |
Campaign - Url Expansion Opt Out | campaign.url_expansion_opt_out | Represents 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 Mode | campaign.vanity_pharma.vanity_pharma_display_url_mode | The display mode for vanity pharma URLs. |
Campaign - Vanity Pharma - Vanity Pharma Text | campaign.vanity_pharma.vanity_pharma_text | The text that will be displayed in display URL of the text ad when website description is the selected display mode for vanity pharma URLs. |
Campaign - Video Brand Safety Suitability | campaign.video_brand_safety_suitability | Output only. 3-Tier Brand Safety setting for the campaign. |
Active View CPM | metrics.active_view_cpm | Average cost of viewable impressions (active_view_impressions). |
Active View CTR | metrics.active_view_ctr | Active view measurable clicks divided by active view viewable impressions. This metric is reported only for display network. |
Active View Impressions | metrics.active_view_impressions | A measurement of how often your ad has become viewable on a Display Network site. |
Active View Measurability | metrics.active_view_measurability | The ratio of impressions that could be measured by Active View over the number of served impressions. |
Active View Measurable Cost Micros | metrics.active_view_measurable_cost_micros | The cost of the impressions you received that were measurable by Active View. |
Active View Measurable Impressions | metrics.active_view_measurable_impressions | The number of times your ads are appearing on placements in positions where they can be seen. |
Active View Viewability | metrics.active_view_viewability | The percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions). |
All Conversions | metrics.all_conversions | The total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric. |
All Conversions By Conversion Date | metrics.all_conversions_by_conversion_date | The total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009. |
All Conversions From Interactions Rate | metrics.all_conversions_from_interactions_rate | All conversions from interactions (as oppose to view through conversions) divided by the number of ad interactions. |
All Conversions From Interactions Value Per Interaction | metrics.all_conversions_from_interactions_value_per_interaction | The value of all conversions from interactions divided by the total number of interactions. |
All Conversions Value | metrics.all_conversions_value | The value of all conversions. |
All Conversions Value By Conversion Date | metrics.all_conversions_value_by_conversion_date | The value of all conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009. |
All Conversions Value Per Cost | metrics.all_conversions_value_per_cost | The value of all conversions divided by the total cost of ad interactions (such as clicks for text ads or views for video ads). |
Average Cost | metrics.average_cost | The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions. |
Average CPC | metrics.average_cpc | The total cost of all clicks divided by the total number of clicks received. |
Average CPE | metrics.average_cpe | The average amount that you've been charged for an ad engagement. This amount is the total cost of all ad engagements divided by the total number of ad engagements. |
Average CPM | metrics.average_cpm | Average cost-per-thousand impressions (CPM). |
Average Cpv | metrics.average_cpv | The average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views. |
Average Page Views | metrics.average_page_views | Average number of pages viewed per session. |
Average Time On Site | metrics.average_time_on_site | Total duration of all sessions (in seconds) / number of sessions. Imported from Google Analytics. |
Bounce Rate | metrics.bounce_rate | Percentage of clicks where the user only visited a single page on your site. Imported from Google Analytics. |
Clicks | metrics.clicks | The number of clicks. |
Conversions | metrics.conversions | The number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Conversions By Conversion Date | metrics.conversions_by_conversion_date | The number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009. |
Conversions From Interactions Rate | metrics.conversions_from_interactions_rate | Conversions from interactions divided by the number of ad interactions (such as clicks for text ads or views for video ads). This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Conversions From Interactions Value Per Interaction | metrics.conversions_from_interactions_value_per_interaction | The value of conversions from interactions divided by the number of ad interactions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Conversions Value | metrics.conversions_value | The value of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Conversions Value By Conversion Date | metrics.conversions_value_by_conversion_date | The value of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. When this column is selected with date, the values in date column means the conversion date. Details for the by_conversion_date columns are available at https://support.google.com/google-ads/answer/9549009. |
Conversions Value Per Cost | metrics.conversions_value_per_cost | The value of conversions divided by the cost of ad interactions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Cost Micros (Spend) | metrics.cost_micros | The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. |
Cost Per All Conversions | metrics.cost_per_all_conversions | The cost of ad interactions divided by all conversions. |
Cost Per Conversion | metrics.cost_per_conversion | The cost of ad interactions divided by conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Cost Per Current Model Attributed Conversion | metrics.cost_per_current_model_attributed_conversion | The cost of ad interactions divided by current model attributed conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Cross Device Conversions | metrics.cross_device_conversions | Conversions from when a customer clicks on a Google Ads ad on one device, then converts on a different device or browser. Cross-device conversions are already included in all_conversions. |
CTR | metrics.ctr | The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). |
Current Model Attributed Conversions | metrics.current_model_attributed_conversions | Shows how your historic conversions data would look under the attribution model you've currently selected. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Current Moodel Attributed Conversions From Interactions Rate | metrics.current_model_attributed_conversions_from_interactions_rate | Current model attributed conversions from interactions divided by the number of ad interactions (such as clicks for text ads or views for video ads). This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Current Model Attributed Conversions From Interactions Value Per Interaction | metrics.current_model_attributed_conversions_from_interactions_value_per_interaction | The value of current model attributed conversions from interactions divided by the number of ad interactions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Current Model Attributed Conversions Value | metrics.current_model_attributed_conversions_value | The value of current model attributed conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Current Model Attributed Conversions Value Per Cost | metrics.current_model_attributed_conversions_value_per_cost | The value of current model attributed conversions divided by the cost of ad interactions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Engagement Rate | metrics.engagement_rate | How often people engage with your ad after it's shown to them. This is the number of ad expansions divided by the number of times your ad is shown. |
Engagements | metrics.engagements | The number of engagements. An engagement occurs when a viewer expands your Lightbox ad. Also, in the future, other ad types may support engagement metrics. |
Gmail Forwards | metrics.gmail_forwards | The number of times the ad was forwarded to someone else as a message. |
Gmail Saves | metrics.gmail_saves | The number of times someone has saved your Gmail ad to their inbox as a message. |
Impressions | metrics.impressions | Count of how often your ad has appeared on a search results page or website on the Google Network. |
Interaction Event Types | metrics.interaction_event_types | The types of payable and free interactions. |
Interactions Rate | metrics.interaction_rate | How often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown. |
Interactions | metrics.interactions | The number of interactions. An interaction is the main user action associated with an ad format-clicks for text and shopping ads, views for video ads, and so on. |
Percent New Visitors | metrics.percent_new_visitors | Percentage of first-time sessions (from people who had never visited your site before). Imported from Google Analytics. |
Phone Calls | metrics.phone_calls | Number of offline phone calls. |
Phone Impressions | metrics.phone_impressions | Number of offline phone impressions. |
Phone Through Rate | metrics.phone_through_rate | Number of phone calls received (phone_calls) divided by the number of times your phone number is shown (phone_impressions). |
Top Impression Percentage | metrics.top_impression_percentage | The percent of your ad impressions that are shown anywhere above the organic search results. |
Value Per All Conversions | metrics.value_per_all_conversions | The value of all conversions divided by the number of all conversions. |
Value Per Conversion | metrics.value_per_conversion | The value of conversions divided by the number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Video Quartile_100_rate | metrics.video_quartile_p100_rate | Percentage of impressions where the viewer watched all of your video. |
Video Quartile_25_rate | metrics.video_quartile_p25_rate | Percentage of impressions where the viewer watched 25% of your video. |
Video Quartile_50_rate | metrics.video_quartile_p50_rate | Percentage of impressions where the viewer watched 50% of your video. |
Video Quartile_75_rate | metrics.video_quartile_p75_rate | Percentage of impressions where the viewer watched 75% of your video. |
Video View Rate | metrics.video_view_rate | The number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads. |
Video Views | metrics.video_views | The number of times your video ads were viewed. |
View Through Conversions | metrics.view_through_conversions | The total number of view-through conversions. These happen when a customer sees an image or rich media ad, then later completes a conversion on your site without interacting with (e.g., clicking on) another ad. |
Network Type | segments.ad_network_type | Ad network type. |
Destination Type | segments.ad_destination_type | Ad Destination type. |
Click Type | segments.click_type | Click type. |
Conversion Action | segments.conversion_action | Resource name of the conversion action. |
Conversion Action Category | segments.conversion_action_category | Conversion action category. |
Ad Group Conversion Action Name | segments.conversion_action_name | Conversion action name. |
Conversion Adjustment | segments.conversion_adjustment | This 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 Bucket | segments.conversion_lag_bucket | An enum value representing the number of days between the impression and the conversion. |
Conversion Or Adjustment Lag Bucket | segments.conversion_or_adjustment_lag_bucket | An enum value representing the number of days between the impression and the conversion or between the impression and adjustments to the conversion. |
Date | segments.date | Date to which metrics apply. yyyy-MM-dd format, e.g., 2018-04-17. |
Day Of Week | segments.day_of_week | Day of the week, e.g., MONDAY. |
Device | segments.device | Device to which metrics apply. |
Conversion Source | segments.external_conversion_source | External conversion source. |
Interaction On This Extension | segments.interaction_on_this_extension | Only used with feed item metrics. Indicates whether the interaction metrics occurred on the feed item itself or a different extension or ad unit. |
Keyword | segments.keyword.ad_group_criterion | The AdGroupCriterion resource name. |
Keyword Match Type | segments.keyword.info.match_type | The match type of the keyword. |
Keyword Text | segments.keyword.info.text | The text of the keyword (at most 80 characters and 10 words). |
Month | segments.month | Month as represented by the date of the first day of a month. Formatted as yyyy-MM-dd. |
Month Of Year | segments.month_of_year | Month of the year, e.g., January. |
Quarter | segments.quarter | Quarter 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. Other | segments.slot | Position of the ad. |
Week | segments.week | Week as defined as Monday through Sunday, and represented by the date of Monday. Formatted as yyyy-MM-dd. |
Year | segments.year | Year, formatted as yyyy. |
Age Range View Reports
Dataddo Label | Google Ads Label | Field Description |
---|---|---|
Age Range View - Resource Name | age_range_view.resource_name | Output 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 - ID | customer.id | Output only. The ID of the customer. |
Customer - Currency Code | customer.currency_code | Immutable. The currency in which the account operates. A subset of the currency codes from the ISO 4217 standard is supported. |
Customer - Status | customer.status | Output only. The status of the customer. |
Customer - Descriptive Name | customer.descriptive_name | Optional, non-unique descriptive name of the customer. |
Customer - Time Zone | customer.time_zone | Immutable. The local timezone ID of the customer. |
Campaign - Accessible Bidding Strategy | campaign.accessible_bidding_strategy | Output only. Resource name of AccessibleBiddingStrategy, a read-only view of the unrestricted attributes of the attached portfolio bidding strategy identified by 'bidding_strategy'. Empty, if the campaign does not use a portfolio strategy. Unrestricted strategy attributes are available to all customers with whom the strategy is shared and are read from the AccessibleBiddingStrategy resource. In contrast, restricted attributes are only available to the owner customer of the strategy and their managers. Restricted attributes can only be read from the BiddingStrategy resource. |
Campaign - Ad Serving Optimization Status | campaign.ad_serving_optimization_status | The ad serving optimization status of the campaign. |
Campaign - Advertising Channel Sub Type | campaign.advertising_channel_sub_type | Immutable. Optional refinement to advertising_channel_type. Must be a valid sub-type of the parent channel type. Can be set only when creating campaigns. After campaign is created, the field can not be changed. |
Campaign - Advertising Channel Type | campaign.advertising_channel_type | Immutable. The primary serving target for ads within the campaign. The targeting options can be refined in network_settings. This field is required and should not be empty when creating new campaigns. Can be set only when creating campaigns. After the campaign is created, the field can not be changed. |
Campaign - App Campaign Setting - App ID | campaign.app_campaign_setting.app_id | Immutable. A string that uniquely identifies a mobile application. |
Campaign - App Campaign Setting - App Store | campaign.app_campaign_setting.app_store | Immutable. The application store that distributes this specific app. |
Campaign - App Campaign Setting - Bidding Strategy Goal Type | campaign.app_campaign_setting.bidding_strategy_goal_type | Represents the goal which the bidding strategy of this app campaign should optimize towards. |
Campaign - Audience Settings - Use Audience Grouped Targets | campaign.audience_setting.use_audience_grouped.target | Immutable. If true, this campaign uses an Audience resource for audience targeting. If false, this campaign may use audience segment criteria instead. |
Campaign - Base Campaign | campaign.base_campaign | Output only. The resource name of the base campaign of a draft or experiment campaign. For base campaigns, this is equal to resource_name. This field is read-only. |
Campaign - Bidding Strategy | campaign.bidding_strategy | Portfolio bidding strategy used by campaign. |
Campaign - Bidding Strategy Type | campaign.bidding_strategy_type | Output only. The type of bidding strategy. A bidding strategy can be created by setting either the bidding scheme to create a standard bidding strategy or the bidding_strategy field to create a portfolio bidding strategy. This field is read-only. |
Campaign - Campaign Budget | campaign.campaign_budget | The budget of the campaign. |
Campaign - Commission - Commission Rate Micros | campaign.commission.commission_rate_micros | Commission rate defines the portion of the conversion value that the advertiser will be billed. A commission rate of x should be passed into this field as (x \* 1,000,000). For example, 106,000 represents a commission rate of 0.106 (10.6%). |
Campaign - Dynamic Search Ads Setting - Domain Name | campaign.dynamic_search_ads_setting.domain_name | Required. The Internet domain name that this setting represents, e.g., google.com or www.google.com. |
Campaign - Dynamic Search Ads Setting - Language Code | campaign.dynamic_search_ads_setting.language_code | Required. The language code specifying the language of the domain, e.g., en. |
Campaign - Dynamic Search Ads Setting - Feeds | campaign.dynamic_search_ads_setting.feeds | The list of page feeds associated with the campaign. |
Campaign - Dynamic Search Ads Setting - Use Supplied Urls Only | campaign.dynamic_search_ads_setting.use_supplied_urls_only | Whether the campaign uses advertiser supplied URLs exclusively. |
Campaign - End Date | campaign.end_date | The last day of the campaign in serving customer's timezone in YYYY-MM-DD format. |
Campaign - Excluded Parent Asset Field Types | campaign.excluded_parent_asset_field_types | The asset field types that should be excluded from this campaign. Asset links with these field types will not be inherited by this campaign from the upper level. |
Campaign - Experiment Type | campaign.experiment_type | Output only. The type of campaign: normal, draft, or experiment. |
Campaign - Final Url Suffix | campaign.final_url_suffix | Suffix used to append query parameters to landing pages that are served with parallel tracking. |
Campaign - Frequency Caps | campaign.frequency_caps | A list that limits how often each user will see this campaign's ads. |
Campaign - ID | campaign.id | Output only. The ID of the campaign. |
Campaign - Labels | campaign.labels | Output only. The resource names of labels attached to this campaign. |
Campaign - Local Campaign Setting - Location Source Type | campaign.local_campaign_setting.location_source_type | The location source type for this local campaign. |
Campaign - Manual CPC - Enhanced CPC Enabled | campaign.manual_cpc.enhanced_cpc_enabled | Whether bids are to be enhanced based on conversion optimizer data. |
Campaign - Manual CPM | campaign.manual_cpm | Standard Manual CPM bidding strategy. Manual impression-based bidding where user pays per thousand impressions. |
Campaign - Manual Cpv | campaign.manual_cpv | Output only. A bidding strategy that pays a configurable amount per video view. |
Campaign - Maximize Conversion Value - Target Roas | campaign.maximize_conversion_value.target_roas | Output 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 Cpa | campaign.maximize_conversions.target_cpa | The target cost-per-action (CPA) option. This is the average amount that you would like to spend per conversion action specified in micro units of the bidding strategy's currency. If set, the bid strategy will get as many conversions as possible at or below the target cost-per-action. If the target CPA is not set, the bid strategy will aim to achieve the lowest possible CPA given the budget. |
Campaign - Name | campaign.name | The name of the campaign. This field is required and should not be empty when creating new campaigns. It must not contain any null (code point 0x0), NL line feed (code point 0xA) or carriage return (code point 0xD) characters. |
Campaign - Network Settings - Target Content Network | campaign.network_settings.target_content_network | Whether ads will be served on specified placements in the Google Display Network. Placements are specified using the Placement criterion. |
Campaign - Network Settings - Target Search Network | campaign.network_settings.target_search_network | Whether 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 Network | campaign.network_settings.target_partner_search_network | Whether ads will be served on the Google Partner Network. This is available only to some select Google partner accounts. |
Campaign - Network Settings - Target Google Search | campaign.network_settings.target_google_search | Whether ads will be served with google.com search results. |
Campaign - Optimization Goal Setting - Optimization Goal Types | campaign.optimization_goal_setting.optimization_goal_types | The list of optimization goal types. |
Campaign - Optimization Score | campaign.optimization_score | Output only. Optimization score of the campaign. Optimization score is an estimate of how well a campaign is set to perform. It ranges from 0% (0.0) to 100% (1.0), with 100% indicating that the campaign is performing at full potential. This field is null for unscored campaigns. See About optimization score at https://support.google.com/google-ads/answer/9061546. This field is read-only. |
Campaign - Payment Mode | campaign.payment_mode | Payment mode for the campaign. |
Campaign - Percent CPC - CPC Bid Ceiling Micros | campaign.percent_cpc.cpc_bid_ceiling_micros | Maximum bid limit that can be set by the bid strategy. This is an optional field entered by the advertiser and specified in local micros. Note: A zero value is interpreted in the same way as having bid_ceiling undefined. |
Campaign - Percent CPC - Enhanced CPC Enabled | campaign.percent_cpc.enhanced_cpc_enabled | Adjusts the bid for each auction upward or downward, depending on the likelihood of a conversion. Individual bids may exceed cpc_bid_ceiling_micros, but the average bid amount for a campaign should not. |
Campaign - Real Time Bidding Setting - Opt In | campaign.real_time_bidding_setting.opt_in | Whether the campaign is opted in to real-time bidding. |
Campaign - Resource Name | campaign.resource_name | Immutable. The resource name of the campaign. Campaign resource names have the form: customers/{customer_id}/campaigns/{campaign_id} |
Campaign - Selective Optimization - Conversion Actions | campaign.selective_optimization.conversion_actions | The selected set of conversion actions for optimizing this campaign. |
Campaign - Serving Status | campaign.serving_status | Output only. The ad serving status of the campaign. |
Campaign - Shopping Setting - Campaign Priority | campaign.shopping_setting.campaign_priority | Priority of the campaign. Campaigns with numerically higher priorities take precedence over those with lower priorities. This field is required for Shopping campaigns, with values between 0 and 2, inclusive. This field is optional for Smart Shopping campaigns, but must be equal to 3 if set. |
Campaign - Shopping Setting - Enable Local | campaign.shopping_setting.enable_local | Whether to include local products. |
Campaign - Shopping Setting - Merchant ID | campaign.shopping_setting.merchant_id | Immutable. ID of the Merchant Center account. This field is required for create operations. This field is immutable for Shopping campaigns. |
Campaign - Shopping Setting - Sales Country | campaign.shopping_setting.sales_country | Sales 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 Inventory | campaign.shopping_setting.use_vehicle_inventory | Immutable. Whether to target Vehicle Listing inventory. |
Campaign - Start Date | campaign.start_date | The date when campaign started in serving customer's timezone in YYYY-MM-DD format. |
Campaign - Status | campaign.status | The status of the campaign. When a new campaign is added, the status defaults to ENABLED. |
Campaign - Target Cpa - CPC Bid Ceiling Micros | campaign.target_cpa.cpc_bid_ceiling_micros | Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies. |
Campaign - Target Cpa - Target Cpa Micros | campaign.target_cpa.target_cpa_micros | Output 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 CPM | campaign.target_cpm | A bidding strategy that automatically optimizes cost per thousand impressions. |
Campaign - Target Impression Share - CPC Bid Ceiling Micros | campaign.target_impression_share.cpc_bid_ceiling_micros | The highest CPC bid the automated bidding system is permitted to specify. This is a required field entered by the advertiser that sets the ceiling and specified in local micros. |
Campaign - Target Cpa - CPC Bid Floor Micros | campaign.target_cpa.cpc_bid_floor_micros | Minimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies. |
Camkpaign - Target Cpa - Target Cpa Micros | campaign.target_cpa.target_cpa_micros | Output 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 Micros | campaign.target_impression_share.cpc_bid_ceiling_micros | The highest CPC bid the automated bidding system is permitted to specify. This is a required field entered by the advertiser that sets the ceiling and specified in local micros. |
Campaign - Target Impression Share - Location | campaign.target_impression_share.location | The targeted location on the search results page. |
Campaign - Target Impression Share - Location Fraction Micros | campaign.target_impression_share.location_fraction_micros | The 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 Micros | campaign.target_roas.cpc_bid_ceiling_micros | Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies. |
Campaign - Target Roas - CPC Bid Floor Micros | campaign.target_roas.cpc_bid_floor_micros | Minimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies. |
Campaign - Target Roas - Target Roas | campaign.target_roas.target_roas | Required. 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 Micros | campaign.target_spend.cpc_bid_ceiling_micros | Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. |
Campaign - Target Spend - Target Spend Micros | campaign.target_spend.target_spend_micros | The spend target under which to maximize clicks. A TargetSpend bidder will attempt to spend the smaller of this value or the natural throttling spend amount. If not specified, the budget is used as the spend target. This field is deprecated and should no longer be used. See https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html for details. |
Campaign - Targeting Setting - Target Restrictions | campaign.targeting_setting.target_restrictions | The per-targeting-dimension setting to restrict the reach of your campaign or ad group. |
Campaign - Tracking Setting - Tracking Url | campaign.tracking_setting.tracking_url | Output only. The url used for dynamic tracking. |
Campaign - Tracking Url Template | campaign.tracking_url_template | The URL template for constructing a tracking URL. |
Campaign - Url Custom Parameters | campaign.url_custom_parameters | The list of mappings used to substitute custom parameter tags in a tracking_url_template, final_urls, or mobile_final_urls. |
Campaign - Url Expansion Opt Out | campaign.url_expansion_opt_out | Represents 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 Mode | campaign.vanity_pharma.vanity_pharma_display_url_mode | The display mode for vanity pharma URLs. |
Campaign - Vanity Pharma - Vanity Pharma Text | campaign.vanity_pharma.vanity_pharma_text | The text that will be displayed in display URL of the text ad when website description is the selected display mode for vanity pharma URLs. |
Campaign - Video Brand Safety Suitability | campaign.video_brand_safety_suitability | Output only. 3-Tier Brand Safety setting for the campaign. |
Bidding Strategy - ID | bidding_strategy.id | Output only. The ID of the bidding strategy. |
Bidding Strategy - Name | bidding_strategy.name | The 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 - Type | bidding_strategy.type | Output only. The type of the bidding strategy. Create a bidding strategy by setting the bidding scheme. This field is read-only. |
Bidding Strategy - Status | bidding_strategy.status | Output only. The status of the bidding strategy. This field is read-only. |
Ad Group Criterion - Criterion ID | ad_group_criterion.criterion_id | Output only. The ID of the criterion. This field is ignored for mutates. |
Ad Group Criterion - Age Range - Type | ad_group_criterion.age_range.type | Type of the age range. |
Ad Group Criterion - Approval Status | ad_group_criterion.approval_status | Output only. Approval status of the criterion. |
Ad Group Criterion - Audience - Audience | ad_group_criterion.audience.audience | The Audience resource name. |
Ad Group Criterion - Type | ad_group_criterion.type | Output only. The type of the criterion. |
Ad Group Criterion - Status | ad_group_criterion.status | The 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 - Type | ad_group_criterion.gender.type | Type of the gender. |
Ad Group Criterion - Keyword - Match Type | ad_group_criterion.keyword.match_type | The match type of the keyword. |
Ad Group Criterion - Keyword - Text | ad_group_criterion.keyword.text | The text of the keyword (at most 80 characters and 10 words). |
Ad Group Criterion - Negative | ad_group_criterion.negative | Immutable. 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 Micros | ad_group_criterion.position_estimates.first_page_cpc_micros | Output 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 Micros | ad_group_criterion.position_estimates.first_position_cpc_micros | Output 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 Micros | ad_group_criterion.cpm_bid_micros | The CPM (cost-per-thousand viewable impressions) bid. |
Ad Group Criterion - Effective CPM Bid Micros | ad_group_criterion.effective_cpm_bid_micros | Output only. The effective CPM (cost-per-thousand viewable impressions) bid. |
Ad Group Criterion - Effective CPM Bid Source | ad_group_criterion.effective_cpm_bid_source | Output only. Source of the effective CPM bid. |
Ad Group Criterion - CPC Bid Micros | ad_group_criterion.cpc_bid_micros | The CPC (cost-per-click) bid. |
Ad Group Criterion - Effective CPC Bid Micros | ad_group_criterion.effective_cpc_bid_micros | Output only. The effective CPC (cost-per-click) bid. |
Ad Group Criterion - Effective CPC Bid Source | ad_group_criterion.effective_cpc_bid_source | Output only. Source of the effective CPC bid. |
Ad Group Criterion - Final Mobile Urls | ad_group_criterion.final_mobile_urls | The list of possible final mobile URLs after all cross-domain redirects. |
Ad Group Criterion - Final Urls | ad_group_criterion.final_urls | The list of possible final URLs after all cross-domain redirects for the ad. |
Ad Group Criterion - Tracking Url Template | ad_group_criterion.tracking_url_template | The URL template for constructing a tracking URL. |
Ad Group Criterion - Bid Modifier | ad_group_criterion.bid_modifier | The 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 Parameters | ad_group_criterion.url_custom_parameters | The list of mappings used to substitute custom parameter tags in a tracking_url_template, final_urls, or mobile_final_urls. |
Active View CPM | metrics.active_view_cpm | Average cost of viewable impressions (active_view_impressions). |
Active View CTR | metrics.active_view_ctr | Active view measurable clicks divided by active view viewable impressions. This metric is reported only for display network. |
Active View Impressions | metrics.active_view_impressions | A measurement of how often your ad has become viewable on a Display Network site. |
Active View Measurability | metrics.active_view_measurability | The ratio of impressions that could be measured by Active View over the number of served impressions. |
Active View Measurable Cost Micros | metrics.active_view_measurable_cost_micros | The cost of the impressions you received that were measurable by Active View. |
Active View Measurable Impressions | metrics.active_view_measurable_impressions | The number of times your ads are appearing on placements in positions where they can be seen. |
Active View Viewability | metrics.active_view_viewability | The percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions). |
All Conversions | metrics.all_conversions | The total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric. |
All Conversions Value | metrics.all_conversions_value | The value of all conversions. |
Average Cost | metrics.average_cost | The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions. |
Average CPC | metrics.average_cpc | The total cost of all clicks divided by the total number of clicks received. |
Average CPE | metrics.average_cpe | The average amount that you've been charged for an ad engagement. This amount is the total cost of all ad engagements divided by the total number of ad engagements. |
Average CPM | metrics.average_cpm | Average cost-per-thousand impressions (CPM). |
Average Cpv | metrics.average_cpv | The average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views. |
Clicks | metrics.clicks | The number of clicks. |
Conversions | metrics.conversions | The number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Conversions From Interactions Rate | metrics.conversions_from_interactions_rate | Conversions from interactions divided by the number of ad interactions (such as clicks for text ads or views for video ads). This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Conversions Value | metrics.conversions_value | The value of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Cost Micros (Spend) | metrics.cost_micros | The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. |
Cost Per Conversion | metrics.cost_per_conversion | The cost of ad interactions divided by conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Cost Per All Conversions | metrics.cost_per_all_conversions | The cost of ad interactions divided by all conversions. |
Cross Device Conversions | metrics.cross_device_conversions | Conversions from when a customer clicks on a Google Ads ad on one device, then converts on a different device or browser. Cross-device conversions are already included in all_conversions. |
CTR | metrics.ctr | The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). |
Engagement Rate | metrics.engagement_rate | How often people engage with your ad after it's shown to them. This is the number of ad expansions divided by the number of times your ad is shown. |
Engagements | metrics.engagements | The number of engagements. An engagement occurs when a viewer expands your Lightbox ad. Also, in the future, other ad types may support engagement metrics. |
Impressions | metrics.impressions | Count of how often your ad has appeared on a search results page or website on the Google Network. |
Gmail Forwards | metrics.gmail_forwards | The number of times the ad was forwarded to someone else as a message. |
Gmail Saves | metrics.gmail_saves | The number of times someone has saved your Gmail ad to their inbox as a message. |
Gmail Secondary Clicks | metrics.gmail_secondary_clicks | The number of clicks to the landing page on the expanded state of Gmail ads. |
Interaction Event Types | metrics.interaction_event_types | The types of payable and free interactions. |
Interaction Rate | metrics.interaction_rate | How often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown. |
Interactions | metrics.interactions | The number of interactions. An interaction is the main user action associated with an ad format-clicks for text and shopping ads, views for video ads, and so on. |
Value Per All Conversions | metrics.value_per_all_conversions | The value of all conversions divided by the number of all conversions. |
Value Per Conversions | metrics.value_per_conversion | The value of conversions divided by the number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Video Quartile P100_rate | metrics.video_quartile_p100_rate | Percentage of impressions where the viewer watched all of your video. |
Video Quartile P75_rate | metrics.video_quartile_p75_rate | Percentage of impressions where the viewer watched 75% of your video. |
Video Quartile P50_rate | metrics.video_quartile_p50_rate | Percentage of impressions where the viewer watched 50% of your video. |
Video Quartile P25_rate | metrics.video_quartile_p25_rate | Percentage of impressions where the viewer watched 25% of your video. |
Video View Rate | metrics.video_view_rate | The number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads. |
Video Views | metrics.video_views | The number of times your video ads were viewed. |
View Through Conversions | metrics.view_through_conversions | The total number of view-through conversions. These happen when a customer sees an image or rich media ad, then later completes a conversion on your site without interacting with (e.g., clicking on) another ad. |
Date | segments.date | Date to which metrics apply. yyyy-MM-dd format, e.g., 2018-04-17. |
Week | segments.week | Week as defined as Monday through Sunday, and represented by the date of Monday. Formatted as yyyy-MM-dd. |
Month | segments.month | Month as represented by the date of the first day of a month. Formatted as yyyy-MM-dd. |
Year | segments.year | Year, formatted as yyyy. |
Device | segments.device | Device to which metrics apply. |
Click Type | segments.click_type | Click type. |
Ad Network Type | segments.ad_network_type | Ad network type. |
Conversion Action Category | segments.conversion_action_category | Conversion action category. |
Conversion Action | segments.conversion_action | Resource name of the conversion action. |
Conversion Action Name | segments.conversion_action_name | Conversion action name. |
Day Of Week | segments.day_of_week | Day of the week, e.g., MONDAY. |
Month Of Year | segments.month_of_year | Month of the year, e.g., January. |
External Conversion Source | segments.external_conversion_source | External conversion source. |
Keyword View Reports
Dataddo Label | Google Ads Label | Field Description |
---|---|---|
Keyword View - Resource Name | keyword_view.resource_name | Output only. The resource name of the keyword view. Keyword view resource names have the form: customers/{customer_id}/keywordViews/{ad_group_id}~{criterion_id} |
Customer - ID | customer.id | Output only. The ID of the customer. |
Customer - Currency Code | customer.currency_code | Immutable. The currency in which the account operates. A subset of the currency codes from the ISO 4217 standard is supported. |
Customer - Status | customer.status | Output only. The status of the customer. |
Customer - Descriptive Name | customer.descriptive_name | Optional, non-unique descriptive name of the customer. |
Customer - Time Zone | customer.time_zone | Immutable. The local timezone ID of the customer. |
Campaign - Accessible Bidding Strategy | campaign.accessible_bidding_strategy | Output only. Resource name of AccessibleBiddingStrategy, a read-only view of the unrestricted attributes of the attached portfolio bidding strategy identified by 'bidding_strategy'. Empty, if the campaign does not use a portfolio strategy. Unrestricted strategy attributes are available to all customers with whom the strategy is shared and are read from the AccessibleBiddingStrategy resource. In contrast, restricted attributes are only available to the owner customer of the strategy and their managers. Restricted attributes can only be read from the BiddingStrategy resource. |
Campaign - Ad Serving Optimization Status | campaign.ad_serving_optimization_status | The ad serving optimization status of the campaign. |
Campaign - Advertising Channel Sub Type | campaign.advertising_channel_sub_type | Immutable. Optional refinement to advertising_channel_type. Must be a valid sub-type of the parent channel type. Can be set only when creating campaigns. After campaign is created, the field can not be changed. |
Campaign - Advertising Channel Type | campaign.advertising_channel_type | Immutable. The primary serving target for ads within the campaign. The targeting options can be refined in network_settings. This field is required and should not be empty when creating new campaigns. Can be set only when creating campaigns. After the campaign is created, the field can not be changed. |
Campaign - App Campaign Setting - App ID | campaign.app_campaign_setting.app_id | Immutable. A string that uniquely identifies a mobile application. |
Campaign - App Campaign Setting - App Store | campaign.app_campaign_setting.app_store | Immutable. The application store that distributes this specific app. |
Campaign - App Campaign Setting - Bidding Strategy Goal Type | campaign.app_campaign_setting.bidding_strategy_goal_type | Represents the goal which the bidding strategy of this app campaign should optimize towards. |
Campaign - Audience Settings - Use Audience Grouped Targets | campaign.audience_setting.use_audience_grouped.target | Immutable. If true, this campaign uses an Audience resource for audience targeting. If false, this campaign may use audience segment criteria instead. |
Campaign - Base Campaign | campaign.base_campaign | Output only. The resource name of the base campaign of a draft or experiment campaign. For base campaigns, this is equal to resource_name. This field is read-only. |
Campaign - Bidding Strategy | campaign.bidding_strategy | Portfolio bidding strategy used by campaign. |
Campaign - Bidding Strategy Type | campaign.bidding_strategy_type | Output only. The type of bidding strategy. A bidding strategy can be created by setting either the bidding scheme to create a standard bidding strategy or the bidding_strategy field to create a portfolio bidding strategy. This field is read-only. |
Campaign - Campaign Budget | campaign.campaign_budget | The budget of the campaign. |
Campaign - Commission - Commission Rate Micros | campaign.commission.commission_rate_micros | Commission rate defines the portion of the conversion value that the advertiser will be billed. A commission rate of x should be passed into this field as (x \* 1,000,000). For example, 106,000 represents a commission rate of 0.106 (10.6%). |
Campaign - Dynamic Search Ads Setting - Domain Name | campaign.dynamic_search_ads_setting.domain_name | Required. The Internet domain name that this setting represents, e.g., google.com or www.google.com. |
Campaign - Dynamic Search Ads Setting - Language Code | campaign.dynamic_search_ads_setting.language_code | Required. The language code specifying the language of the domain, e.g., en. |
Campaign - Dynamic Search Ads Setting - Feeds | campaign.dynamic_search_ads_setting.feeds | The list of page feeds associated with the campaign. |
Campaign - Dynamic Search Ads Setting - Use Supplied Urls Only | campaign.dynamic_search_ads_setting.use_supplied_urls_only | Whether the campaign uses advertiser supplied URLs exclusively. |
Campaign - End Date | campaign.end_date | The last day of the campaign in serving customer's timezone in YYYY-MM-DD format. |
Campaign - Excluded Parent Asset Field Types | campaign.excluded_parent_asset_field_types | The asset field types that should be excluded from this campaign. Asset links with these field types will not be inherited by this campaign from the upper level. |
Campaign - Experiment Type | campaign.experiment_type | Output only. The type of campaign: normal, draft, or experiment. |
Campaign - Final Url Suffix | campaign.final_url_suffix | Suffix used to append query parameters to landing pages that are served with parallel tracking. |
Campaign - Frequency Caps | campaign.frequency_caps | A list that limits how often each user will see this campaign's ads. |
Campaign - ID | campaign.id | Output only. The ID of the campaign. |
Campaign - Labels | campaign.labels | Output only. The resource names of labels attached to this campaign. |
Campaign - Local Campaign Setting - Location Source Type | campaign.local_campaign_setting.location_source_type | The location source type for this local campaign. |
Campaign - Manual CPC - Enhanced CPC Enabled | campaign.manual_cpc.enhanced_cpc_enabled | Whether bids are to be enhanced based on conversion optimizer data. |
Campaign - Manual CPM | campaign.manual_cpm | Standard Manual CPM bidding strategy. Manual impression-based bidding where user pays per thousand impressions. |
Campaign - Manual Cpv | campaign.manual_cpv | Output only. A bidding strategy that pays a configurable amount per video view. |
Campaign - Maximize Conversion Value - Target Roas | campaign.maximize_conversion_value.target_roas | Output 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 Cpa | campaign.maximize_conversions.target_cpa | The target cost-per-action (CPA) option. This is the average amount that you would like to spend per conversion action specified in micro units of the bidding strategy's currency. If set, the bid strategy will get as many conversions as possible at or below the target cost-per-action. If the target CPA is not set, the bid strategy will aim to achieve the lowest possible CPA given the budget. |
Campaign - Name | campaign.name | The name of the campaign. This field is required and should not be empty when creating new campaigns. It must not contain any null (code point 0x0), NL line feed (code point 0xA) or carriage return (code point 0xD) characters. |
Campaign - Network Settings - Target Content Network | campaign.network_settings.target_content_network | Whether ads will be served on specified placements in the Google Display Network. Placements are specified using the Placement criterion. |
Campaign - Network Settings - Target Search Network | campaign.network_settings.target_search_network | Whether 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 Network | campaign.network_settings.target_partner_search_network | Whether ads will be served on the Google Partner Network. This is available only to some select Google partner accounts. |
Campaign - Network Settings - Target Google Search | campaign.network_settings.target_google_search | Whether ads will be served with google.com search results. |
Campaign - Optimization Goal Setting - Optimization Goal Types | campaign.optimization_goal_setting.optimization_goal_types | The list of optimization goal types. |
Campaign - Optimization Score | campaign.optimization_score | Output only. Optimization score of the campaign. Optimization score is an estimate of how well a campaign is set to perform. It ranges from 0% (0.0) to 100% (1.0), with 100% indicating that the campaign is performing at full potential. This field is null for unscored campaigns. See About optimization score at https://support.google.com/google-ads/answer/9061546. This field is read-only. |
Campaign - Payment Mode | campaign.payment_mode | Payment mode for the campaign. |
Campaign - Percent CPC - CPC Bid Ceiling Micros | campaign.percent_cpc.cpc_bid_ceiling_micros | Maximum bid limit that can be set by the bid strategy. This is an optional field entered by the advertiser and specified in local micros. Note: A zero value is interpreted in the same way as having bid_ceiling undefined. |
Campaign - Percent CPC - Enhanced CPC Enabled | campaign.percent_cpc.enhanced_cpc_enabled | Adjusts the bid for each auction upward or downward, depending on the likelihood of a conversion. Individual bids may exceed cpc_bid_ceiling_micros, but the average bid amount for a campaign should not. |
Campaign - Real Time Bidding Setting - Opt In | campaign.real_time_bidding_setting.opt_in | Whether the campaign is opted in to real-time bidding. |
Campaign - Resource Name | campaign.resource_name | Immutable. The resource name of the campaign. Campaign resource names have the form: customers/{customer_id}/campaigns/{campaign_id} |
Campaign - Selective Optimization - Conversion Actions | campaign.selective_optimization.conversion_actions | The selected set of conversion actions for optimizing this campaign. |
Campaign - Serving Status | campaign.serving_status | Output only. The ad serving status of the campaign. |
Campaign - Shopping Setting - Campaign Priority | campaign.shopping_setting.campaign_priority | Priority of the campaign. Campaigns with numerically higher priorities take precedence over those with lower priorities. This field is required for Shopping campaigns, with values between 0 and 2, inclusive. This field is optional for Smart Shopping campaigns, but must be equal to 3 if set. |
Campaign - Shopping Setting - Enable Local | campaign.shopping_setting.enable_local | Whether to include local products. |
Campaign - Shopping Setting - Merchant ID | campaign.shopping_setting.merchant_id | Immutable. ID of the Merchant Center account. This field is required for create operations. This field is immutable for Shopping campaigns. |
Campaign - Shopping Setting - Sales Country | campaign.shopping_setting.sales_country | Sales 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 Inventory | campaign.shopping_setting.use_vehicle_inventory | Immutable. Whether to target Vehicle Listing inventory. |
Campaign - Start Date | campaign.start_date | The date when campaign started in serving customer's timezone in YYYY-MM-DD format. |
Campaign - Status | campaign.status | The status of the campaign. When a new campaign is added, the status defaults to ENABLED. |
Campaign - Target Cpa - CPC Bid Ceiling Micros | campaign.target_cpa.cpc_bid_ceiling_micros | Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies. |
Campaign - Target Cpa - Target Cpa Micros | campaign.target_cpa.target_cpa_micros | Output 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 CPM | campaign.target_cpm | A bidding strategy that automatically optimizes cost per thousand impressions. |
Campaign - Target Impression Share - CPC Bid Ceiling Micros | campaign.target_impression_share.cpc_bid_ceiling_micros | The highest CPC bid the automated bidding system is permitted to specify. This is a required field entered by the advertiser that sets the ceiling and specified in local micros. |
Campaign - Target Cpa - CPC Bid Floor Micros | campaign.target_cpa.cpc_bid_floor_micros | Minimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies. |
Camkpaign - Target Cpa - Target Cpa Micros | campaign.target_cpa.target_cpa_micros | Output 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 Micros | campaign.target_impression_share.cpc_bid_ceiling_micros | The highest CPC bid the automated bidding system is permitted to specify. This is a required field entered by the advertiser that sets the ceiling and specified in local micros. |
Campaign - Target Impression Share - Location | campaign.target_impression_share.location | The targeted location on the search results page. |
Campaign - Target Impression Share - Location Fraction Micros | campaign.target_impression_share.location_fraction_micros | The 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 Micros | campaign.target_roas.cpc_bid_ceiling_micros | Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies. |
Campaign - Target Roas - CPC Bid Floor Micros | campaign.target_roas.cpc_bid_floor_micros | Minimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies. |
Campaign - Target Spend - CPC Bid Floor Micros | campaign.target_spend.cpc_bid_floor_micros | #N/A |
Campaign - Target Roas - Target Roas | campaign.target_roas.target_roas | Required. 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 Micros | campaign.target_spend.cpc_bid_ceiling_micros | Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. |
Campaign - Target Spend - Target Spend Micros | campaign.target_spend.target_spend_micros | The spend target under which to maximize clicks. A TargetSpend bidder will attempt to spend the smaller of this value or the natural throttling spend amount. If not specified, the budget is used as the spend target. This field is deprecated and should no longer be used. See https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html for details. |
Campaign - Targeting Setting - Target Restrictions | campaign.targeting_setting.target_restrictions | The per-targeting-dimension setting to restrict the reach of your campaign or ad group. |
Campaign - Tracking Setting - Tracking Url | campaign.tracking_setting.tracking_url | Output only. The url used for dynamic tracking. |
Campaign - Tracking Url Template | campaign.tracking_url_template | The URL template for constructing a tracking URL. |
Campaign - Url Custom Parameters | campaign.url_custom_parameters | The list of mappings used to substitute custom parameter tags in a tracking_url_template, final_urls, or mobile_final_urls. |
Campaign - Url Expansion Opt Out | campaign.url_expansion_opt_out | Represents 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 Mode | campaign.vanity_pharma.vanity_pharma_display_url_mode | The display mode for vanity pharma URLs. |
Campaign - Vanity Pharma - Vanity Pharma Text | campaign.vanity_pharma.vanity_pharma_text | The text that will be displayed in display URL of the text ad when website description is the selected display mode for vanity pharma URLs. |
Campaign - Video Brand Safety Suitability | campaign.video_brand_safety_suitability | Output only. 3-Tier Brand Safety setting for the campaign. |
Ad Group Criterion - Criterion ID | ad_group_criterion.criterion_id | Output only. The ID of the criterion. This field is ignored for mutates. |
Ad Group Criterion - Age Range - Type | ad_group_criterion.age_range.type | Type of the age range. |
Ad Group Criterion - Approval Status | ad_group_criterion.approval_status | Output only. Approval status of the criterion. |
Ad Group Criterion - Audience - Audience | ad_group_criterion.audience.audience | The Audience resource name. |
Ad Group Criterion - Type | ad_group_criterion.type | Output only. The type of the criterion. |
Ad Group Criterion - Status | ad_group_criterion.status | The 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 - Type | ad_group_criterion.gender.type | Type of the gender. |
Ad Group Criterion - Keyword - Match Type | ad_group_criterion.keyword.match_type | The match type of the keyword. |
Ad Group Criterion - Keyword - Text | ad_group_criterion.keyword.text | The text of the keyword (at most 80 characters and 10 words). |
Ad Group Criterion - Negative | ad_group_criterion.negative | Immutable. 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 Micros | ad_group_criterion.position_estimates.first_page_cpc_micros | Output 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 Micros | ad_group_criterion.position_estimates.first_position_cpc_micros | Output 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 Micros | ad_group_criterion.cpm_bid_micros | The CPM (cost-per-thousand viewable impressions) bid. |
Ad Group Criterion - Effective CPM Bid Micros | ad_group_criterion.effective_cpm_bid_micros | Output only. The effective CPM (cost-per-thousand viewable impressions) bid. |
Ad Group Criterion - Effective CPM Bid Source | ad_group_criterion.effective_cpm_bid_source | Output only. Source of the effective CPM bid. |
Ad Group Criterion - CPC Bid Micros | ad_group_criterion.cpc_bid_micros | The CPC (cost-per-click) bid. |
Ad Group Criterion - Effective CPC Bid Micros | ad_group_criterion.effective_cpc_bid_micros | Output only. The effective CPC (cost-per-click) bid. |
Ad Group Criterion - Effective CPC Bid Source | ad_group_criterion.effective_cpc_bid_source | Output only. Source of the effective CPC bid. |
Ad Group Criterion - Final Mobile Urls | ad_group_criterion.final_mobile_urls | The list of possible final mobile URLs after all cross-domain redirects. |
Ad Group Criterion - Final Urls | ad_group_criterion.final_urls | The list of possible final URLs after all cross-domain redirects for the ad. |
Ad Group Criterion - Tracking Url Template | ad_group_criterion.tracking_url_template | The URL template for constructing a tracking URL. |
Ad Group Criterion - Bid Modifier | ad_group_criterion.bid_modifier | The 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 Parameters | ad_group_criterion.url_custom_parameters | The list of mappings used to substitute custom parameter tags in a tracking_url_template, final_urls, or mobile_final_urls. |
Active View CPM | metrics.active_view_cpm | Average cost of viewable impressions (active_view_impressions). |
Active View CTR | metrics.active_view_ctr | Active view measurable clicks divided by active view viewable impressions. This metric is reported only for display network. |
Active View Impressions | metrics.active_view_impressions | A measurement of how often your ad has become viewable on a Display Network site. |
Active View Measurability | metrics.active_view_measurability | The ratio of impressions that could be measured by Active View over the number of served impressions. |
Active View Measurable Cost Micros | metrics.active_view_measurable_cost_micros | The cost of the impressions you received that were measurable by Active View. |
Active View Measurable Impressions | metrics.active_view_measurable_impressions | The number of times your ads are appearing on placements in positions where they can be seen. |
Active View Viewability | metrics.active_view_viewability | The percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions). |
All Conversions | metrics.all_conversions | The total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric. |
All Conversions Value | metrics.all_conversions_value | The value of all conversions. |
Average Cost | metrics.average_cost | The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions. |
Average CPC | metrics.average_cpc | The total cost of all clicks divided by the total number of clicks received. |
Average CPE | metrics.average_cpe | The average amount that you've been charged for an ad engagement. This amount is the total cost of all ad engagements divided by the total number of ad engagements. |
Average CPM | metrics.average_cpm | Average cost-per-thousand impressions (CPM). |
Average Cpv | metrics.average_cpv | The average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views. |
Average Page Views | metrics.average_page_views | Average number of pages viewed per session. |
Average Time On Site | metrics.average_time_on_site | Total duration of all sessions (in seconds) / number of sessions. Imported from Google Analytics. |
Bounce Rate | metrics.bounce_rate | Percentage of clicks where the user only visited a single page on your site. Imported from Google Analytics. |
Clicks | metrics.clicks | The number of clicks. |
Conversions | metrics.conversions | The number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Conversions From Interactions Rate | metrics.conversions_from_interactions_rate | Conversions from interactions divided by the number of ad interactions (such as clicks for text ads or views for video ads). This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Conversions Value | metrics.conversions_value | The value of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Cost Micros (Spend) | metrics.cost_micros | The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. |
Cost Per Conversion | metrics.cost_per_conversion | The cost of ad interactions divided by conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
CTR | metrics.ctr | The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). |
Engagement Rate | metrics.engagement_rate | How often people engage with your ad after it's shown to them. This is the number of ad expansions divided by the number of times your ad is shown. |
Engagements | metrics.engagements | The number of engagements. An engagement occurs when a viewer expands your Lightbox ad. Also, in the future, other ad types may support engagement metrics. |
Impressions | metrics.impressions | Count of how often your ad has appeared on a search results page or website on the Google Network. |
Date | segments.date | Date to which metrics apply. yyyy-MM-dd format, e.g., 2018-04-17. |
Week | segments.week | Week as defined as Monday through Sunday, and represented by the date of Monday. Formatted as yyyy-MM-dd. |
Month | segments.month | Month as represented by the date of the first day of a month. Formatted as yyyy-MM-dd. |
Year | segments.year | Year, formatted as yyyy. |
Device | segments.device | Device to which metrics apply. |
Click Type | segments.click_type | Click type. |
Ad Network Type | segments.ad_network_type | Ad network type. |
Conversion Action Category | segments.conversion_action_category | Conversion action category. |
Conversion Action | segments.conversion_action | Resource name of the conversion action. |
Conversion Action Name | segments.conversion_action_name | Conversion action name. |
Day Of Week | segments.day_of_week | Day of the week, e.g., MONDAY. |
Month Of Year | segments.month_of_year | Month of the year, e.g., January. |
External Conversion Source | segments.external_conversion_source | External conversion source. |
Shopping Performance View
Dataddo Label | Google Ads Label | Field Description |
---|---|---|
Shopping Performance View - Resource Name | shopping_performance_view.resource_name | Output only. The resource name of the Shopping performance view. Shopping performance view resource names have the form: customers/{customer_id}/shoppingPerformanceView |
Customer - ID | customer.id | Output only. The ID of the customer. |
Customer - Currency Code | customer.currency_code | Immutable. The currency in which the account operates. A subset of the currency codes from the ISO 4217 standard is supported. |
Customer - Status | customer.status | Output only. The status of the customer. |
Customer - Descriptive Name | customer.descriptive_name | Optional, non-unique descriptive name of the customer. |
Customer - Time Zone | customer.time_zone | Immutable. The local timezone ID of the customer. |
Campaign - Accessible Bidding Strategy | campaign.accessible_bidding_strategy | Output only. Resource name of AccessibleBiddingStrategy, a read-only view of the unrestricted attributes of the attached portfolio bidding strategy identified by 'bidding_strategy'. Empty, if the campaign does not use a portfolio strategy. Unrestricted strategy attributes are available to all customers with whom the strategy is shared and are read from the AccessibleBiddingStrategy resource. In contrast, restricted attributes are only available to the owner customer of the strategy and their managers. Restricted attributes can only be read from the BiddingStrategy resource. |
Campaign - Ad Serving Optimization Status | campaign.ad_serving_optimization_status | The ad serving optimization status of the campaign. |
Campaign - Advertising Channel Sub Type | campaign.advertising_channel_sub_type | Immutable. Optional refinement to advertising_channel_type. Must be a valid sub-type of the parent channel type. Can be set only when creating campaigns. After campaign is created, the field can not be changed. |
Campaign - Advertising Channel Type | campaign.advertising_channel_type | Immutable. The primary serving target for ads within the campaign. The targeting options can be refined in network_settings. This field is required and should not be empty when creating new campaigns. Can be set only when creating campaigns. After the campaign is created, the field can not be changed. |
Campaign - App Campaign Setting - App ID | campaign.app_campaign_setting.app_id | Immutable. A string that uniquely identifies a mobile application. |
Campaign - App Campaign Setting - App Store | campaign.app_campaign_setting.app_store | Immutable. The application store that distributes this specific app. |
Campaign - App Campaign Setting - Bidding Strategy Goal Type | campaign.app_campaign_setting.bidding_strategy_goal_type | Represents the goal which the bidding strategy of this app campaign should optimize towards. |
Campaign - Audience Settings - Use Audience Grouped Targets | campaign.audience_setting.use_audience_grouped.target | Immutable. If true, this campaign uses an Audience resource for audience targeting. If false, this campaign may use audience segment criteria instead. |
Campaign - Base Campaign | campaign.base_campaign | Output only. The resource name of the base campaign of a draft or experiment campaign. For base campaigns, this is equal to resource_name. This field is read-only. |
Campaign - Bidding Strategy | campaign.bidding_strategy | Portfolio bidding strategy used by campaign. |
Campaign - Bidding Strategy Type | campaign.bidding_strategy_type | Output only. The type of bidding strategy. A bidding strategy can be created by setting either the bidding scheme to create a standard bidding strategy or the bidding_strategy field to create a portfolio bidding strategy. This field is read-only. |
Campaign - Campaign Budget | campaign.campaign_budget | The budget of the campaign. |
Campaign - Commission - Commission Rate Micros | campaign.commission.commission_rate_micros | Commission rate defines the portion of the conversion value that the advertiser will be billed. A commission rate of x should be passed into this field as (x \* 1,000,000). For example, 106,000 represents a commission rate of 0.106 (10.6%). |
Campaign - Dynamic Search Ads Setting - Domain Name | campaign.dynamic_search_ads_setting.domain_name | Required. The Internet domain name that this setting represents, e.g., google.com or www.google.com. |
Campaign - Dynamic Search Ads Setting - Language Code | campaign.dynamic_search_ads_setting.language_code | Required. The language code specifying the language of the domain, e.g., en. |
Campaign - Dynamic Search Ads Setting - Feeds | campaign.dynamic_search_ads_setting.feeds | The list of page feeds associated with the campaign. |
Campaign - Dynamic Search Ads Setting - Use Supplied Urls Only | campaign.dynamic_search_ads_setting.use_supplied_urls_only | Whether the campaign uses advertiser supplied URLs exclusively. |
Campaign - End Date | campaign.end_date | The last day of the campaign in serving customer's timezone in YYYY-MM-DD format. |
Campaign - Excluded Parent Asset Field Types | campaign.excluded_parent_asset_field_types | The asset field types that should be excluded from this campaign. Asset links with these field types will not be inherited by this campaign from the upper level. |
Campaign - Experiment Type | campaign.experiment_type | Output only. The type of campaign: normal, draft, or experiment. |
Campaign - Final Url Suffix | campaign.final_url_suffix | Suffix used to append query parameters to landing pages that are served with parallel tracking. |
Campaign - Frequency Caps | campaign.frequency_caps | A list that limits how often each user will see this campaign's ads. |
Campaign - ID | campaign.id | Output only. The ID of the campaign. |
Campaign - Labels | campaign.labels | Output only. The resource names of labels attached to this campaign. |
Campaign - Local Campaign Setting - Location Source Type | campaign.local_campaign_setting.location_source_type | The location source type for this local campaign. |
Campaign - Manual CPC - Enhanced CPC Enabled | campaign.manual_cpc.enhanced_cpc_enabled | Whether bids are to be enhanced based on conversion optimizer data. |
Campaign - Manual CPM | campaign.manual_cpm | Standard Manual CPM bidding strategy. Manual impression-based bidding where user pays per thousand impressions. |
Campaign - Manual Cpv | campaign.manual_cpv | Output only. A bidding strategy that pays a configurable amount per video view. |
Campaign - Maximize Conversion Value - Target Roas | campaign.maximize_conversion_value.target_roas | Output 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 Cpa | campaign.maximize_conversions.target_cpa | The target cost-per-action (CPA) option. This is the average amount that you would like to spend per conversion action specified in micro units of the bidding strategy's currency. If set, the bid strategy will get as many conversions as possible at or below the target cost-per-action. If the target CPA is not set, the bid strategy will aim to achieve the lowest possible CPA given the budget. |
Campaign - Name | campaign.name | The name of the campaign. This field is required and should not be empty when creating new campaigns. It must not contain any null (code point 0x0), NL line feed (code point 0xA) or carriage return (code point 0xD) characters. |
Campaign - Network Settings - Target Content Network | campaign.network_settings.target_content_network | Whether ads will be served on specified placements in the Google Display Network. Placements are specified using the Placement criterion. |
Campaign - Network Settings - Target Search Network | campaign.network_settings.target_search_network | Whether 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 Network | campaign.network_settings.target_partner_search_network | Whether ads will be served on the Google Partner Network. This is available only to some select Google partner accounts. |
Campaign - Network Settings - Target Google Search | campaign.network_settings.target_google_search | Whether ads will be served with google.com search results. |
Campaign - Optimization Goal Setting - Optimization Goal Types | campaign.optimization_goal_setting.optimization_goal_types | The list of optimization goal types. |
Campaign - Optimization Score | campaign.optimization_score | Output only. Optimization score of the campaign. Optimization score is an estimate of how well a campaign is set to perform. It ranges from 0% (0.0) to 100% (1.0), with 100% indicating that the campaign is performing at full potential. This field is null for unscored campaigns. See About optimization score at https://support.google.com/google-ads/answer/9061546. This field is read-only. |
Campaign - Payment Mode | campaign.payment_mode | Payment mode for the campaign. |
Campaign - Percent CPC - CPC Bid Ceiling Micros | campaign.percent_cpc.cpc_bid_ceiling_micros | Maximum bid limit that can be set by the bid strategy. This is an optional field entered by the advertiser and specified in local micros. Note: A zero value is interpreted in the same way as having bid_ceiling undefined. |
Campaign - Percent CPC - Enhanced CPC Enabled | campaign.percent_cpc.enhanced_cpc_enabled | Adjusts the bid for each auction upward or downward, depending on the likelihood of a conversion. Individual bids may exceed cpc_bid_ceiling_micros, but the average bid amount for a campaign should not. |
Campaign - Real Time Bidding Setting - Opt In | campaign.real_time_bidding_setting.opt_in | Whether the campaign is opted in to real-time bidding. |
Campaign - Resource Name | campaign.resource_name | Immutable. The resource name of the campaign. Campaign resource names have the form: customers/{customer_id}/campaigns/{campaign_id} |
Campaign - Selective Optimization - Conversion Actions | campaign.selective_optimization.conversion_actions | The selected set of conversion actions for optimizing this campaign. |
Campaign - Serving Status | campaign.serving_status | Output only. The ad serving status of the campaign. |
Campaign - Shopping Setting - Campaign Priority | campaign.shopping_setting.campaign_priority | Priority of the campaign. Campaigns with numerically higher priorities take precedence over those with lower priorities. This field is required for Shopping campaigns, with values between 0 and 2, inclusive. This field is optional for Smart Shopping campaigns, but must be equal to 3 if set. |
Campaign - Shopping Setting - Enable Local | campaign.shopping_setting.enable_local | Whether to include local products. |
Campaign - Shopping Setting - Merchant ID | campaign.shopping_setting.merchant_id | Immutable. ID of the Merchant Center account. This field is required for create operations. This field is immutable for Shopping campaigns. |
Campaign - Shopping Setting - Sales Country | campaign.shopping_setting.sales_country | Sales 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 Inventory | campaign.shopping_setting.use_vehicle_inventory | Immutable. Whether to target Vehicle Listing inventory. |
Campaign - Start Date | campaign.start_date | The date when campaign started in serving customer's timezone in YYYY-MM-DD format. |
Campaign - Status | campaign.status | The status of the campaign. When a new campaign is added, the status defaults to ENABLED. |
Campaign - Target Cpa - CPC Bid Ceiling Micros | campaign.target_cpa.cpc_bid_ceiling_micros | Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies. |
Campaign - Target Cpa - Target Cpa Micros | campaign.target_cpa.target_cpa_micros | Output 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 CPM | campaign.target_cpm | A bidding strategy that automatically optimizes cost per thousand impressions. |
Campaign - Target Impression Share - CPC Bid Ceiling Micros | campaign.target_impression_share.cpc_bid_ceiling_micros | The highest CPC bid the automated bidding system is permitted to specify. This is a required field entered by the advertiser that sets the ceiling and specified in local micros. |
Campaign - Target Cpa - CPC Bid Floor Micros | campaign.target_cpa.cpc_bid_floor_micros | Minimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies. |
Campaign - Target Cpa - Target Cpa Micros | campaign.target_cpa.target_cpa_micros | Output 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 Micros | campaign.target_impression_share.cpc_bid_ceiling_micros | The highest CPC bid the automated bidding system is permitted to specify. This is a required field entered by the advertiser that sets the ceiling and specified in local micros. |
Campaign - Target Impression Share - Location | campaign.target_impression_share.location | The targeted location on the search results page. |
Campaign - Target Impression Share - Location Fraction Micros | campaign.target_impression_share.location_fraction_micros | The 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 Micros | campaign.target_roas.cpc_bid_ceiling_micros | Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies. |
Campaign - Target Roas - CPC Bid Floor Micros | campaign.target_roas.cpc_bid_floor_micros | Minimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies. |
Campaign - Target Spend - CPC Bid Floor Micros | campaign.target_spend.cpc_bid_floor_micros | #N/A |
Campaign - Target Roas - Target Roas | campaign.target_roas.target_roas | Required. 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 Micros | campaign.target_spend.cpc_bid_ceiling_micros | Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. |
Campaign - Target Spend - Target Spend Micros | campaign.target_spend.target_spend_micros | The spend target under which to maximize clicks. A TargetSpend bidder will attempt to spend the smaller of this value or the natural throttling spend amount. If not specified, the budget is used as the spend target. This field is deprecated and should no longer be used. See https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html for details. |
Campaign - Targeting Setting - Target Restrictions | campaign.targeting_setting.target_restrictions | The per-targeting-dimension setting to restrict the reach of your campaign or ad group. |
Campaign - Tracking Setting - Tracking Url | campaign.tracking_setting.tracking_url | Output only. The url used for dynamic tracking. |
Campaign - Tracking Url Template | campaign.tracking_url_template | The URL template for constructing a tracking URL. |
Campaign - Url Custom Parameters | campaign.url_custom_parameters | The list of mappings used to substitute custom parameter tags in a tracking_url_template, final_urls, or mobile_final_urls. |
Campaign - Url Expansion Opt Out | campaign.url_expansion_opt_out | Represents 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 Mode | campaign.vanity_pharma.vanity_pharma_display_url_mode | The display mode for vanity pharma URLs. |
Campaign - Vanity Pharma - Vanity Pharma Text | campaign.vanity_pharma.vanity_pharma_text | The text that will be displayed in display URL of the text ad when website description is the selected display mode for vanity pharma URLs. |
Campaign - Video Brand Safety Suitability | campaign.video_brand_safety_suitability | Output only. 3-Tier Brand Safety setting for the campaign. |
All Conversions | metrics.all_conversions | The total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric. |
All Conversions Value | metrics.all_conversions_value | The value of all conversions. |
All Conversions From Interactions Rate | metrics.all_conversions_from_interactions_rate | All conversions from interactions (as oppose to view through conversions) divided by the number of ad interactions. |
Average CPC | metrics.average_cpc | The total cost of all clicks divided by the total number of clicks received. |
Clicks | metrics.clicks | The number of clicks. |
Conversions | metrics.conversions | The number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Conversions From Interactions Rate | metrics.conversions_from_interactions_rate | Conversions from interactions divided by the number of ad interactions (such as clicks for text ads or views for video ads). This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Conversions Value | metrics.conversions_value | The value of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Cost Micros (Spend) | metrics.cost_micros | The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. |
Cost Per Conversion | metrics.cost_per_conversion | The cost of ad interactions divided by conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Cost Per All Conversions | metrics.cost_per_all_conversions | The cost of ad interactions divided by all conversions. |
CTR | metrics.ctr | The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). |
Impressions | metrics.impressions | Count of how often your ad has appeared on a search results page or website on the Google Network. |
Search Absolute Top Impressions Share | metrics.search_absolute_top_impression_share | The 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 Share | metrics.search_click_share | The number of clicks you've received on the Search Network divided by the estimated number of clicks you were eligible to receive. Note: Search click share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999. |
Search Impression Share | metrics.search_impression_share | The impressions you've received on the Search Network divided by the estimated number of impressions you were eligible to receive. Note: Search impression share is reported in the range of 0.1 to 1. Any value below 0.1 is reported as 0.0999. |
Value Per All Conversions | metrics.value_per_all_conversions | The value of all conversions divided by the number of all conversions. |
Value Per Conversion | metrics.value_per_conversion | The value of conversions divided by the number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Date | segments.date | Date to which metrics apply. yyyy-MM-dd format, e.g., 2018-04-17. |
Week | segments.week | Week as defined as Monday through Sunday, and represented by the date of Monday. Formatted as yyyy-MM-dd. |
Month | segments.month | Month as represented by the date of the first day of a month. Formatted as yyyy-MM-dd. |
Year | segments.year | Year, formatted as yyyy. |
Device | segments.device | Device to which metrics apply. |
Click Type | segments.click_type | Click type. |
Ad Network Type | segments.ad_network_type | Ad network type. |
Conversion Action Category | segments.conversion_action_category | Conversion action category. |
Conversion Action | segments.conversion_action | Resource name of the conversion action. |
Conversion Action Name | segments.conversion_action_name | Conversion action name. |
Day Of Week | segments.day_of_week | Day of the week, e.g., MONDAY. |
Month Of Year | segments.month_of_year | Month of the year, e.g., January. |
External Conversion Source | segments.external_conversion_source | External conversion source. |
Aggregator ID | segments.product_aggregator_id | Aggregator ID of the product. |
Bidding Category Level 1 | segments.product_bidding_category_level1 | Bidding category (level 1) of the product. |
Bidding Category Level 2 | segments.product_bidding_category_level2 | Bidding category (level 2) of the product. |
Bidding Category Level 3 | segments.product_bidding_category_level3 | Bidding category (level 3) of the product. |
Bidding Category Level 4 | segments.product_bidding_category_level4 | Bidding category (level 4) of the product. |
Bidding Category Level 5 | segments.product_bidding_category_level5 | Bidding category (level 5) of the product. |
Brand | segments.product_brand | Brand of the product. |
Channel | segments.product_channel | Channel of the product. |
Channel Exclusivity | segments.product_channel_exclusivity | Channel exclusivity of the product. |
Condition | segments.product_condition | Condition of the product. |
Country | segments.product_country | Resource name of the geo target constant for the country of sale of the product. |
Custom Attriubte 0 | segments.product_custom_attribute0 | Custom attribute 0 of the product. |
Custom Attriubte 1 | segments.product_custom_attribute1 | Custom attribute 1 of the product. |
Custom Attriubte 2 | segments.product_custom_attribute2 | Custom attribute 2 of the product. |
Custom Attriubte 3 | segments.product_custom_attribute3 | Custom attribute 3 of the product. |
Custom Attriubte 4 | segments.product_custom_attribute4 | Custom attribute 4 of the product. |
Item ID | segments.product_item_id | Item ID of the product. |
Language | segments.product_language | Resource name of the language constant for the language of the product. |
Merchant ID | segments.product_merchant_id | Merchant ID of the product. |
Store ID | segments.product_store_id | Store ID of the product. |
Title | segments.product_title | Title of the product. |
Product Type Level 1 | segments.product_type_l1 | Type (level 1) of the product. |
Product Type Level 2 | segments.product_type_l2 | Type (level 2) of the product. |
Product Type Level 3 | segments.product_type_l3 | Type (level 3) of the product. |
Product Type Level 4 | segments.product_type_l4 | Type (level 4) of the product. |
Product Type Level 5 | segments.product_type_l5 | Type (level 5) of the product. |
Search Term View Report
Dataddo Label | Google Ads Label | Field Description |
---|---|---|
Search Term View - Ad Group | search_term_view.ad_group | Output only. The ad group the search term served in. |
Search Term View - Resource Name | search_term_view.resource_name | Output 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 Term | search_term_view.search_term | Output only. The search term. |
Search Term View - Status | search_term_view.status | Output only. Indicates whether the search term is currently one of your targeted or excluded keywords. |
Customer - ID | customer.id | Output only. The ID of the customer. |
Customer - Currency Code | customer.currency_code | Immutable. The currency in which the account operates. A subset of the currency codes from the ISO 4217 standard is supported. |
Customer - Status | customer.status | Output only. The status of the customer. |
Customer - Descriptive Name | customer.descriptive_name | Optional, non-unique descriptive name of the customer. |
Customer - Time Zone | customer.time_zone | Immutable. The local timezone ID of the customer. |
Campaign - Accessible Bidding Strategy | campaign.accessible_bidding_strategy | Output only. Resource name of AccessibleBiddingStrategy, a read-only view of the unrestricted attributes of the attached portfolio bidding strategy identified by 'bidding_strategy'. Empty, if the campaign does not use a portfolio strategy. Unrestricted strategy attributes are available to all customers with whom the strategy is shared and are read from the AccessibleBiddingStrategy resource. In contrast, restricted attributes are only available to the owner customer of the strategy and their managers. Restricted attributes can only be read from the BiddingStrategy resource. |
Campaign - Ad Serving Optimization Status | campaign.ad_serving_optimization_status | The ad serving optimization status of the campaign. |
Campaign - Advertising Channel Sub Type | campaign.advertising_channel_sub_type | Immutable. Optional refinement to advertising_channel_type. Must be a valid sub-type of the parent channel type. Can be set only when creating campaigns. After campaign is created, the field can not be changed. |
Campaign - Advertising Channel Type | campaign.advertising_channel_type | Immutable. The primary serving target for ads within the campaign. The targeting options can be refined in network_settings. This field is required and should not be empty when creating new campaigns. Can be set only when creating campaigns. After the campaign is created, the field can not be changed. |
Campaign - App Campaign Setting - App ID | campaign.app_campaign_setting.app_id | Immutable. A string that uniquely identifies a mobile application. |
Campaign - App Campaign Setting - App Store | campaign.app_campaign_setting.app_store | Immutable. The application store that distributes this specific app. |
Campaign - App Campaign Setting - Bidding Strategy Goal Type | campaign.app_campaign_setting.bidding_strategy_goal_type | Represents the goal which the bidding strategy of this app campaign should optimize towards. |
Campaign - Audience Settings - Use Audience Grouped Targets | campaign.audience_setting.use_audience_grouped.target | Immutable. If true, this campaign uses an Audience resource for audience targeting. If false, this campaign may use audience segment criteria instead. |
Campaign - Base Campaign | campaign.base_campaign | Output only. The resource name of the base campaign of a draft or experiment campaign. For base campaigns, this is equal to resource_name. This field is read-only. |
Campaign - Bidding Strategy | campaign.bidding_strategy | Portfolio bidding strategy used by campaign. |
Campaign - Bidding Strategy Type | campaign.bidding_strategy_type | Output only. The type of bidding strategy. A bidding strategy can be created by setting either the bidding scheme to create a standard bidding strategy or the bidding_strategy field to create a portfolio bidding strategy. This field is read-only. |
Campaign - Campaign Budget | campaign.campaign_budget | The budget of the campaign. |
Campaign - Commission - Commission Rate Micros | campaign.commission.commission_rate_micros | Commission rate defines the portion of the conversion value that the advertiser will be billed. A commission rate of x should be passed into this field as (x \* 1,000,000). For example, 106,000 represents a commission rate of 0.106 (10.6%). |
Campaign - Dynamic Search Ads Setting - Domain Name | campaign.dynamic_search_ads_setting.domain_name | Required. The Internet domain name that this setting represents, e.g., google.com or www.google.com. |
Campaign - Dynamic Search Ads Setting - Language Code | campaign.dynamic_search_ads_setting.language_code | Required. The language code specifying the language of the domain, e.g., en. |
Campaign - Dynamic Search Ads Setting - Feeds | campaign.dynamic_search_ads_setting.feeds | The list of page feeds associated with the campaign. |
Campaign - Dynamic Search Ads Setting - Use Supplied Urls Only | campaign.dynamic_search_ads_setting.use_supplied_urls_only | Whether the campaign uses advertiser supplied URLs exclusively. |
Campaign - End Date | campaign.end_date | The last day of the campaign in serving customer's timezone in YYYY-MM-DD format. |
Campaign - Excluded Parent Asset Field Types | campaign.excluded_parent_asset_field_types | The asset field types that should be excluded from this campaign. Asset links with these field types will not be inherited by this campaign from the upper level. |
Campaign - Experiment Type | campaign.experiment_type | Output only. The type of campaign: normal, draft, or experiment. |
Campaign - Final Url Suffix | campaign.final_url_suffix | Suffix used to append query parameters to landing pages that are served with parallel tracking. |
Campaign - Frequency Caps | campaign.frequency_caps | A list that limits how often each user will see this campaign's ads. |
Campaign - ID | campaign.id | Output only. The ID of the campaign. |
Campaign - Labels | campaign.labels | Output only. The resource names of labels attached to this campaign. |
Campaign - Local Campaign Setting - Location Source Type | campaign.local_campaign_setting.location_source_type | The location source type for this local campaign. |
Campaign - Manual CPC - Enhanced CPC Enabled | campaign.manual_cpc.enhanced_cpc_enabled | Whether bids are to be enhanced based on conversion optimizer data. |
Campaign - Manual CPM | campaign.manual_cpm | Standard Manual CPM bidding strategy. Manual impression-based bidding where user pays per thousand impressions. |
Campaign - Manual Cpv | campaign.manual_cpv | Output only. A bidding strategy that pays a configurable amount per video view. |
Campaign - Maximize Conversion Value - Target Roas | campaign.maximize_conversion_value.target_roas | Output 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 Cpa | campaign.maximize_conversions.target_cpa | The target cost-per-action (CPA) option. This is the average amount that you would like to spend per conversion action specified in micro units of the bidding strategy's currency. If set, the bid strategy will get as many conversions as possible at or below the target cost-per-action. If the target CPA is not set, the bid strategy will aim to achieve the lowest possible CPA given the budget. |
Campaign - Name | campaign.name | The name of the campaign. This field is required and should not be empty when creating new campaigns. It must not contain any null (code point 0x0), NL line feed (code point 0xA) or carriage return (code point 0xD) characters. |
Campaign - Network Settings - Target Content Network | campaign.network_settings.target_content_network | Whether ads will be served on specified placements in the Google Display Network. Placements are specified using the Placement criterion. |
Campaign - Network Settings - Target Search Network | campaign.network_settings.target_search_network | Whether 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 Network | campaign.network_settings.target_partner_search_network | Whether ads will be served on the Google Partner Network. This is available only to some select Google partner accounts. |
Campaign - Network Settings - Target Google Search | campaign.network_settings.target_google_search | Whether ads will be served with google.com search results. |
Campaign - Optimization Goal Setting - Optimization Goal Types | campaign.optimization_goal_setting.optimization_goal_types | The list of optimization goal types. |
Campaign - Optimization Score | campaign.optimization_score | Output only. Optimization score of the campaign. Optimization score is an estimate of how well a campaign is set to perform. It ranges from 0% (0.0) to 100% (1.0), with 100% indicating that the campaign is performing at full potential. This field is null for unscored campaigns. See About optimization score at https://support.google.com/google-ads/answer/9061546. This field is read-only. |
Campaign - Payment Mode | campaign.payment_mode | Payment mode for the campaign. |
Campaign - Percent CPC - CPC Bid Ceiling Micros | campaign.percent_cpc.cpc_bid_ceiling_micros | Maximum bid limit that can be set by the bid strategy. This is an optional field entered by the advertiser and specified in local micros. Note: A zero value is interpreted in the same way as having bid_ceiling undefined. |
Campaign - Percent CPC - Enhanced CPC Enabled | campaign.percent_cpc.enhanced_cpc_enabled | Adjusts the bid for each auction upward or downward, depending on the likelihood of a conversion. Individual bids may exceed cpc_bid_ceiling_micros, but the average bid amount for a campaign should not. |
Campaign - Real Time Bidding Setting - Opt In | campaign.real_time_bidding_setting.opt_in | Whether the campaign is opted in to real-time bidding. |
Campaign - Resource Name | campaign.resource_name | Immutable. The resource name of the campaign. Campaign resource names have the form: customers/{customer_id}/campaigns/{campaign_id} |
Campaign - Selective Optimization - Conversion Actions | campaign.selective_optimization.conversion_actions | The selected set of conversion actions for optimizing this campaign. |
Campaign - Serving Status | campaign.serving_status | Output only. The ad serving status of the campaign. |
Campaign - Shopping Setting - Campaign Priority | campaign.shopping_setting.campaign_priority | Priority of the campaign. Campaigns with numerically higher priorities take precedence over those with lower priorities. This field is required for Shopping campaigns, with values between 0 and 2, inclusive. This field is optional for Smart Shopping campaigns, but must be equal to 3 if set. |
Campaign - Shopping Setting - Enable Local | campaign.shopping_setting.enable_local | Whether to include local products. |
Campaign - Shopping Setting - Merchant ID | campaign.shopping_setting.merchant_id | Immutable. ID of the Merchant Center account. This field is required for create operations. This field is immutable for Shopping campaigns. |
Campaign - Shopping Setting - Sales Country | campaign.shopping_setting.sales_country | Sales 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 Inventory | campaign.shopping_setting.use_vehicle_inventory | Immutable. Whether to target Vehicle Listing inventory. |
Campaign - Start Date | campaign.start_date | The date when campaign started in serving customer's timezone in YYYY-MM-DD format. |
Campaign - Status | campaign.status | The status of the campaign. When a new campaign is added, the status defaults to ENABLED. |
Campaign - Target Cpa - CPC Bid Ceiling Micros | campaign.target_cpa.cpc_bid_ceiling_micros | Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies. |
Campaign - Target Cpa - Target Cpa Micros | campaign.target_cpa.target_cpa_micros | Output 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 CPM | campaign.target_cpm | A bidding strategy that automatically optimizes cost per thousand impressions. |
Campaign - Target Impression Share - CPC Bid Ceiling Micros | campaign.target_impression_share.cpc_bid_ceiling_micros | The highest CPC bid the automated bidding system is permitted to specify. This is a required field entered by the advertiser that sets the ceiling and specified in local micros. |
Campaign - Target Cpa - CPC Bid Floor Micros | campaign.target_cpa.cpc_bid_floor_micros | Minimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies. |
Camkpaign - Target Cpa - Target Cpa Micros | campaign.target_cpa.target_cpa_micros | Output 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 Micros | campaign.target_impression_share.cpc_bid_ceiling_micros | The highest CPC bid the automated bidding system is permitted to specify. This is a required field entered by the advertiser that sets the ceiling and specified in local micros. |
Campaign - Target Impression Share - Location | campaign.target_impression_share.location | The targeted location on the search results page. |
Campaign - Target Impression Share - Location Fraction Micros | campaign.target_impression_share.location_fraction_micros | The 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 Micros | campaign.target_roas.cpc_bid_ceiling_micros | Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies. |
Campaign - Target Roas - CPC Bid Floor Micros | campaign.target_roas.cpc_bid_floor_micros | Minimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies. |
Campaign - Target Spend - CPC Bid Floor Micros | campaign.target_spend.cpc_bid_floor_micros | #N/A |
Campaign - Target Roas - Target Roas | campaign.target_roas.target_roas | Required. 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 Micros | campaign.target_spend.cpc_bid_ceiling_micros | Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. |
Campaign - Target Spend - Target Spend Micros | campaign.target_spend.target_spend_micros | The spend target under which to maximize clicks. A TargetSpend bidder will attempt to spend the smaller of this value or the natural throttling spend amount. If not specified, the budget is used as the spend target. This field is deprecated and should no longer be used. See https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html for details. |
Campaign - Targeting Setting - Target Restrictions | campaign.targeting_setting.target_restrictions | The per-targeting-dimension setting to restrict the reach of your campaign or ad group. |
Campaign - Tracking Setting - Tracking Url | campaign.tracking_setting.tracking_url | Output only. The url used for dynamic tracking. |
Campaign - Tracking Url Template | campaign.tracking_url_template | The URL template for constructing a tracking URL. |
Campaign - Url Custom Parameters | campaign.url_custom_parameters | The list of mappings used to substitute custom parameter tags in a tracking_url_template, final_urls, or mobile_final_urls. |
Campaign - Url Expansion Opt Out | campaign.url_expansion_opt_out | Represents 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 Mode | campaign.vanity_pharma.vanity_pharma_display_url_mode | The display mode for vanity pharma URLs. |
Campaign - Vanity Pharma - Vanity Pharma Text | campaign.vanity_pharma.vanity_pharma_text | The text that will be displayed in display URL of the text ad when website description is the selected display mode for vanity pharma URLs. |
Campaign - Video Brand Safety Suitability | campaign.video_brand_safety_suitability | Output only. 3-Tier Brand Safety setting for the campaign. |
Absolute Top Impression Percentage | metrics.absolute_top_impression_percentage | The percent of your ad impressions that are shown as the very first ad above the organic search results. |
All Conversions | metrics.all_conversions | The total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric. |
All Conversions From Interactions Rate | metrics.all_conversions_from_interactions_rate | All conversions from interactions (as oppose to view through conversions) divided by the number of ad interactions. |
All Conversions From Interactions Value Per Interaction | metrics.all_conversions_from_interactions_value_per_interaction | The value of all conversions from interactions divided by the total number of interactions. |
All Conversions Value | metrics.all_conversions_value | The value of all conversions. |
All Conversions Value Per Cost | metrics.all_conversions_value_per_cost | The value of all conversions divided by the total cost of ad interactions (such as clicks for text ads or views for video ads). |
Average Cost | metrics.average_cost | The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions. |
Average CPC | metrics.average_cpc | The total cost of all clicks divided by the total number of clicks received. |
Average CPE | metrics.average_cpe | The average amount that you've been charged for an ad engagement. This amount is the total cost of all ad engagements divided by the total number of ad engagements. |
Average CPM | metrics.average_cpm | Average cost-per-thousand impressions (CPM). |
Average Cpv | metrics.average_cpv | The average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views. |
Clicks | metrics.clicks | The number of clicks. |
Conversions | metrics.conversions | The number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Conversions From Interactions Rate | metrics.conversions_from_interactions_rate | Conversions from interactions divided by the number of ad interactions (such as clicks for text ads or views for video ads). This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Conversions From Interactions Value Per Interaction | metrics.conversions_from_interactions_value_per_interaction | The value of conversions from interactions divided by the number of ad interactions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Conversions Value | metrics.conversions_value | The value of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Conversions Value Per Cost | metrics.conversions_value_per_cost | The value of conversions divided by the cost of ad interactions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Cost Micros (Spend) | metrics.cost_micros | The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. |
Cost Per All Conversions | metrics.cost_per_all_conversions | The cost of ad interactions divided by all conversions. |
Cost Per Conversion | metrics.cost_per_conversion | The cost of ad interactions divided by conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Cross Device Conversions | metrics.cross_device_conversions | Conversions from when a customer clicks on a Google Ads ad on one device, then converts on a different device or browser. Cross-device conversions are already included in all_conversions. |
CTR | metrics.ctr | The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). |
Engagement Rate | metrics.engagement_rate | How often people engage with your ad after it's shown to them. This is the number of ad expansions divided by the number of times your ad is shown. |
Engagements | metrics.engagements | The number of engagements. An engagement occurs when a viewer expands your Lightbox ad. Also, in the future, other ad types may support engagement metrics. |
Impressions | metrics.impressions | Count of how often your ad has appeared on a search results page or website on the Google Network. |
Interaction Event Types | metrics.interaction_event_types | The types of payable and free interactions. |
Interaction Rate | metrics.interaction_rate | How often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown. |
Interactions | metrics.interactions | The number of interactions. An interaction is the main user action associated with an ad format-clicks for text and shopping ads, views for video ads, and so on. |
Top Impression Percentage | metrics.top_impression_percentage | The percent of your ad impressions that are shown anywhere above the organic search results. |
Value Per All Conversions | metrics.value_per_all_conversions | The value of all conversions divided by the number of all conversions. |
Value Per Conversion | metrics.value_per_conversion | The value of conversions divided by the number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Video Quartile P100_rate | metrics.video_quartile_p100_rate | Percentage of impressions where the viewer watched all of your video. |
Video Quartile P25_rate | metrics.video_quartile_p25_rate | Percentage of impressions where the viewer watched 25% of your video. |
Video Quartile P50_rate | metrics.video_quartile_p50_rate | Percentage of impressions where the viewer watched 50% of your video. |
Video Quartile P75_rate | metrics.video_quartile_p75_rate | Percentage of impressions where the viewer watched 75% of your video. |
Video View Rate | metrics.video_view_rate | The number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads. |
Video Views | metrics.video_views | The number of times your video ads were viewed. |
View Through Conversions | metrics.view_through_conversions | The total number of view-through conversions. These happen when a customer sees an image or rich media ad, then later completes a conversion on your site without interacting with (e.g., clicking on) another ad. |
Ad Network Type | segments.ad_network_type | Ad network type. |
Conversion Action | segments.conversion_action | Resource name of the conversion action. |
Conversion Action Category | segments.conversion_action_category | Conversion action category. |
Conversion Action Name | segments.conversion_action_name | Conversion action name. |
Date | segments.date | Date to which metrics apply. yyyy-MM-dd format, e.g., 2018-04-17. |
Day Of Week | segments.day_of_week | Day of the week, e.g., MONDAY. |
Device | segments.device | Device to which metrics apply. |
External Conversion Source | segments.external_conversion_source | External conversion source. |
Keyword Criteria | segments.keyword.ad_group_criterion | The AdGroupCriterion resource name. |
Keyword Match Type | segments.keyword.info.match_type | The match type of the keyword. |
Keyword Text | segments.keyword.info.text | The text of the keyword (at most 80 characters and 10 words). |
Month | segments.month | Month as represented by the date of the first day of a month. Formatted as yyyy-MM-dd. |
Month Of Year | segments.month_of_year | Month of the year, e.g., January. |
Quarter | segments.quarter | Quarter 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 Type | segments.search_term_match_type | Match type of the keyword that triggered the ad, including variants. |
Week | segments.week | Week as defined as Monday through Sunday, and represented by the date of Monday. Formatted as yyyy-MM-dd. |
Year | segments.year | Year, formatted as yyyy. |
Gender View Report
Dataddo Label | Google Ads Label | Field Description |
---|---|---|
Gender View - Resource Name | gender_view.resource_name | Output 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 - ID | customer.id | Output only. The ID of the customer. |
Customer - Currency Code | customer.currency_code | Immutable. The currency in which the account operates. A subset of the currency codes from the ISO 4217 standard is supported. |
Customer - Status | customer.status | Output only. The status of the customer. |
Customer - Descriptive Name | customer.descriptive_name | Optional, non-unique descriptive name of the customer. |
Customer - Time Zone | customer.time_zone | Immutable. The local timezone ID of the customer. |
Campaign - Accessible Bidding Strategy | campaign.accessible_bidding_strategy | Output only. Resource name of AccessibleBiddingStrategy, a read-only view of the unrestricted attributes of the attached portfolio bidding strategy identified by 'bidding_strategy'. Empty, if the campaign does not use a portfolio strategy. Unrestricted strategy attributes are available to all customers with whom the strategy is shared and are read from the AccessibleBiddingStrategy resource. In contrast, restricted attributes are only available to the owner customer of the strategy and their managers. Restricted attributes can only be read from the BiddingStrategy resource. |
Campaign - Ad Serving Optimization Status | campaign.ad_serving_optimization_status | The ad serving optimization status of the campaign. |
Campaign - Advertising Channel Sub Type | campaign.advertising_channel_sub_type | Immutable. Optional refinement to advertising_channel_type. Must be a valid sub-type of the parent channel type. Can be set only when creating campaigns. After campaign is created, the field can not be changed. |
Campaign - Advertising Channel Type | campaign.advertising_channel_type | Immutable. The primary serving target for ads within the campaign. The targeting options can be refined in network_settings. This field is required and should not be empty when creating new campaigns. Can be set only when creating campaigns. After the campaign is created, the field can not be changed. |
Campaign - App Campaign Setting - App ID | campaign.app_campaign_setting.app_id | Immutable. A string that uniquely identifies a mobile application. |
Campaign - App Campaign Setting - App Store | campaign.app_campaign_setting.app_store | Immutable. The application store that distributes this specific app. |
Campaign - App Campaign Setting - Bidding Strategy Goal Type | campaign.app_campaign_setting.bidding_strategy_goal_type | Represents the goal which the bidding strategy of this app campaign should optimize towards. |
Campaign - Audience Settings - Use Audience Grouped Targets | campaign.audience_setting.use_audience_grouped.target | Immutable. If true, this campaign uses an Audience resource for audience targeting. If false, this campaign may use audience segment criteria instead. |
Campaign - Base Campaign | campaign.base_campaign | Output only. The resource name of the base campaign of a draft or experiment campaign. For base campaigns, this is equal to resource_name. This field is read-only. |
Campaign - Bidding Strategy | campaign.bidding_strategy | Portfolio bidding strategy used by campaign. |
Campaign - Bidding Strategy Type | campaign.bidding_strategy_type | Output only. The type of bidding strategy. A bidding strategy can be created by setting either the bidding scheme to create a standard bidding strategy or the bidding_strategy field to create a portfolio bidding strategy. This field is read-only. |
Campaign - Campaign Budget | campaign.campaign_budget | The budget of the campaign. |
Campaign - Commission - Commission Rate Micros | campaign.commission.commission_rate_micros | Commission rate defines the portion of the conversion value that the advertiser will be billed. A commission rate of x should be passed into this field as (x \* 1,000,000). For example, 106,000 represents a commission rate of 0.106 (10.6%). |
Campaign - Dynamic Search Ads Setting - Domain Name | campaign.dynamic_search_ads_setting.domain_name | Required. The Internet domain name that this setting represents, e.g., google.com or www.google.com. |
Campaign - Dynamic Search Ads Setting - Language Code | campaign.dynamic_search_ads_setting.language_code | Required. The language code specifying the language of the domain, e.g., en. |
Campaign - Dynamic Search Ads Setting - Feeds | campaign.dynamic_search_ads_setting.feeds | The list of page feeds associated with the campaign. |
Campaign - Dynamic Search Ads Setting - Use Supplied Urls Only | campaign.dynamic_search_ads_setting.use_supplied_urls_only | Whether the campaign uses advertiser supplied URLs exclusively. |
Campaign - End Date | campaign.end_date | The last day of the campaign in serving customer's timezone in YYYY-MM-DD format. |
Campaign - Excluded Parent Asset Field Types | campaign.excluded_parent_asset_field_types | The asset field types that should be excluded from this campaign. Asset links with these field types will not be inherited by this campaign from the upper level. |
Campaign - Experiment Type | campaign.experiment_type | Output only. The type of campaign: normal, draft, or experiment. |
Campaign - Final Url Suffix | campaign.final_url_suffix | Suffix used to append query parameters to landing pages that are served with parallel tracking. |
Campaign - Frequency Caps | campaign.frequency_caps | A list that limits how often each user will see this campaign's ads. |
Campaign - ID | campaign.id | Output only. The ID of the campaign. |
Campaign - Labels | campaign.labels | Output only. The resource names of labels attached to this campaign. |
Campaign - Local Campaign Setting - Location Source Type | campaign.local_campaign_setting.location_source_type | The location source type for this local campaign. |
Campaign - Manual CPC - Enhanced CPC Enabled | campaign.manual_cpc.enhanced_cpc_enabled | Whether bids are to be enhanced based on conversion optimizer data. |
Campaign - Manual CPM | campaign.manual_cpm | Standard Manual CPM bidding strategy. Manual impression-based bidding where user pays per thousand impressions. |
Campaign - Manual Cpv | campaign.manual_cpv | Output only. A bidding strategy that pays a configurable amount per video view. |
Campaign - Maximize Conversion Value - Target Roas | campaign.maximize_conversion_value.target_roas | Output 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 Cpa | campaign.maximize_conversions.target_cpa | The target cost-per-action (CPA) option. This is the average amount that you would like to spend per conversion action specified in micro units of the bidding strategy's currency. If set, the bid strategy will get as many conversions as possible at or below the target cost-per-action. If the target CPA is not set, the bid strategy will aim to achieve the lowest possible CPA given the budget. |
Campaign - Name | campaign.name | The name of the campaign. This field is required and should not be empty when creating new campaigns. It must not contain any null (code point 0x0), NL line feed (code point 0xA) or carriage return (code point 0xD) characters. |
Campaign - Network Settings - Target Content Network | campaign.network_settings.target_content_network | Whether ads will be served on specified placements in the Google Display Network. Placements are specified using the Placement criterion. |
Campaign - Network Settings - Target Search Network | campaign.network_settings.target_search_network | Whether 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 Network | campaign.network_settings.target_partner_search_network | Whether ads will be served on the Google Partner Network. This is available only to some select Google partner accounts. |
Campaign - Network Settings - Target Google Search | campaign.network_settings.target_google_search | Whether ads will be served with google.com search results. |
Campaign - Optimization Goal Setting - Optimization Goal Types | campaign.optimization_goal_setting.optimization_goal_types | The list of optimization goal types. |
Campaign - Optimization Score | campaign.optimization_score | Output only. Optimization score of the campaign. Optimization score is an estimate of how well a campaign is set to perform. It ranges from 0% (0.0) to 100% (1.0), with 100% indicating that the campaign is performing at full potential. This field is null for unscored campaigns. See About optimization score at https://support.google.com/google-ads/answer/9061546. This field is read-only. |
Campaign - Payment Mode | campaign.payment_mode | Payment mode for the campaign. |
Campaign - Percent CPC - CPC Bid Ceiling Micros | campaign.percent_cpc.cpc_bid_ceiling_micros | Maximum bid limit that can be set by the bid strategy. This is an optional field entered by the advertiser and specified in local micros. Note: A zero value is interpreted in the same way as having bid_ceiling undefined. |
Campaign - Percent CPC - Enhanced CPC Enabled | campaign.percent_cpc.enhanced_cpc_enabled | Adjusts the bid for each auction upward or downward, depending on the likelihood of a conversion. Individual bids may exceed cpc_bid_ceiling_micros, but the average bid amount for a campaign should not. |
Campaign - Real Time Bidding Setting - Opt In | campaign.real_time_bidding_setting.opt_in | Whether the campaign is opted in to real-time bidding. |
Campaign - Resource Name | campaign.resource_name | Immutable. The resource name of the campaign. Campaign resource names have the form: customers/{customer_id}/campaigns/{campaign_id} |
Campaign - Selective Optimization - Conversion Actions | campaign.selective_optimization.conversion_actions | The selected set of conversion actions for optimizing this campaign. |
Campaign - Serving Status | campaign.serving_status | Output only. The ad serving status of the campaign. |
Campaign - Shopping Setting - Campaign Priority | campaign.shopping_setting.campaign_priority | Priority of the campaign. Campaigns with numerically higher priorities take precedence over those with lower priorities. This field is required for Shopping campaigns, with values between 0 and 2, inclusive. This field is optional for Smart Shopping campaigns, but must be equal to 3 if set. |
Campaign - Shopping Setting - Enable Local | campaign.shopping_setting.enable_local | Whether to include local products. |
Campaign - Shopping Setting - Merchant ID | campaign.shopping_setting.merchant_id | Immutable. ID of the Merchant Center account. This field is required for create operations. This field is immutable for Shopping campaigns. |
Campaign - Shopping Setting - Sales Country | campaign.shopping_setting.sales_country | Sales 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 Inventory | campaign.shopping_setting.use_vehicle_inventory | Immutable. Whether to target Vehicle Listing inventory. |
Campaign - Start Date | campaign.start_date | The date when campaign started in serving customer's timezone in YYYY-MM-DD format. |
Campaign - Status | campaign.status | The status of the campaign. When a new campaign is added, the status defaults to ENABLED. |
Campaign - Target Cpa - CPC Bid Ceiling Micros | campaign.target_cpa.cpc_bid_ceiling_micros | Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies. |
Campaign - Target Cpa - Target Cpa Micros | campaign.target_cpa.target_cpa_micros | Output 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 CPM | campaign.target_cpm | A bidding strategy that automatically optimizes cost per thousand impressions. |
Campaign - Target Impression Share - CPC Bid Ceiling Micros | campaign.target_impression_share.cpc_bid_ceiling_micros | The highest CPC bid the automated bidding system is permitted to specify. This is a required field entered by the advertiser that sets the ceiling and specified in local micros. |
Campaign - Target Cpa - CPC Bid Floor Micros | campaign.target_cpa.cpc_bid_floor_micros | Minimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies. |
Camkpaign - Target Cpa - Target Cpa Micros | campaign.target_cpa.target_cpa_micros | Output 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 Micros | campaign.target_impression_share.cpc_bid_ceiling_micros | The highest CPC bid the automated bidding system is permitted to specify. This is a required field entered by the advertiser that sets the ceiling and specified in local micros. |
Campaign - Target Impression Share - Location | campaign.target_impression_share.location | The targeted location on the search results page. |
Campaign - Target Impression Share - Location Fraction Micros | campaign.target_impression_share.location_fraction_micros | The 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 Micros | campaign.target_roas.cpc_bid_ceiling_micros | Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies. |
Campaign - Target Roas - CPC Bid Floor Micros | campaign.target_roas.cpc_bid_floor_micros | Minimum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. This should only be set for portfolio bid strategies. |
Campaign - Target Spend - CPC Bid Floor Micros | campaign.target_spend.cpc_bid_floor_micros | #N/A |
Campaign - Target Roas - Target Roas | campaign.target_roas.target_roas | Required. 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 Micros | campaign.target_spend.cpc_bid_ceiling_micros | Maximum bid limit that can be set by the bid strategy. The limit applies to all keywords managed by the strategy. |
Campaign - Target Spend - Target Spend Micros | campaign.target_spend.target_spend_micros | The spend target under which to maximize clicks. A TargetSpend bidder will attempt to spend the smaller of this value or the natural throttling spend amount. If not specified, the budget is used as the spend target. This field is deprecated and should no longer be used. See https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html for details. |
Campaign - Targeting Setting - Target Restrictions | campaign.targeting_setting.target_restrictions | The per-targeting-dimension setting to restrict the reach of your campaign or ad group. |
Campaign - Tracking Setting - Tracking Url | campaign.tracking_setting.tracking_url | Output only. The url used for dynamic tracking. |
Campaign - Tracking Url Template | campaign.tracking_url_template | The URL template for constructing a tracking URL. |
Campaign - Url Custom Parameters | campaign.url_custom_parameters | The list of mappings used to substitute custom parameter tags in a tracking_url_template, final_urls, or mobile_final_urls. |
Campaign - Url Expansion Opt Out | campaign.url_expansion_opt_out | Represents 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 Mode | campaign.vanity_pharma.vanity_pharma_display_url_mode | The display mode for vanity pharma URLs. |
Campaign - Vanity Pharma - Vanity Pharma Text | campaign.vanity_pharma.vanity_pharma_text | The text that will be displayed in display URL of the text ad when website description is the selected display mode for vanity pharma URLs. |
Campaign - Video Brand Safety Suitability | campaign.video_brand_safety_suitability | Output only. 3-Tier Brand Safety setting for the campaign. |
Bidding Strategy - ID | bidding_strategy.id | Output only. The ID of the bidding strategy. |
Bidding Strategy - Name | bidding_strategy.name | The 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 - Type | bidding_strategy.type | Output only. The type of the bidding strategy. Create a bidding strategy by setting the bidding scheme. This field is read-only. |
Bidding Strategy - Status | bidding_strategy.status | Output only. The status of the bidding strategy. This field is read-only. |
Ad Group Criterion - Criterion ID | ad_group_criterion.criterion_id | Output only. The ID of the criterion. This field is ignored for mutates. |
Ad Group Criterion - Age Range - Type | ad_group_criterion.age_range.type | Type of the age range. |
Ad Group Criterion - Approval Status | ad_group_criterion.approval_status | Output only. Approval status of the criterion. |
Ad Group Criterion - Audience - Audience | ad_group_criterion.audience.audience | The Audience resource name. |
Ad Group Criterion - Type | ad_group_criterion.type | Output only. The type of the criterion. |
Ad Group Criterion - Status | ad_group_criterion.status | The 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 - Type | ad_group_criterion.gender.type | Type of the gender. |
Ad Group Criterion - Keyword - Match Type | ad_group_criterion.keyword.match_type | The match type of the keyword. |
Ad Group Criterion - Keyword - Text | ad_group_criterion.keyword.text | The text of the keyword (at most 80 characters and 10 words). |
Ad Group Criterion - Negative | ad_group_criterion.negative | Immutable. 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 Micros | ad_group_criterion.position_estimates.first_page_cpc_micros | Output 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 Micros | ad_group_criterion.position_estimates.first_position_cpc_micros | Output 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 Micros | ad_group_criterion.cpm_bid_micros | The CPM (cost-per-thousand viewable impressions) bid. |
Ad Group Criterion - Effective CPM Bid Micros | ad_group_criterion.effective_cpm_bid_micros | Output only. The effective CPM (cost-per-thousand viewable impressions) bid. |
Ad Group Criterion - Effective CPM Bid Source | ad_group_criterion.effective_cpm_bid_source | Output only. Source of the effective CPM bid. |
Ad Group Criterion - CPC Bid Micros | ad_group_criterion.cpc_bid_micros | The CPC (cost-per-click) bid. |
Ad Group Criterion - Effective CPC Bid Micros | ad_group_criterion.effective_cpc_bid_micros | Output only. The effective CPC (cost-per-click) bid. |
Ad Group Criterion - Effective CPC Bid Source | ad_group_criterion.effective_cpc_bid_source | Output only. Source of the effective CPC bid. |
Ad Group Criterion - Final Mobile Urls | ad_group_criterion.final_mobile_urls | The list of possible final mobile URLs after all cross-domain redirects. |
Ad Group Criterion - Final Urls | ad_group_criterion.final_urls | The list of possible final URLs after all cross-domain redirects for the ad. |
Ad Group Criterion - Tracking Url Template | ad_group_criterion.tracking_url_template | The URL template for constructing a tracking URL. |
Ad Group Criterion - Bid Modifier | ad_group_criterion.bid_modifier | The 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 Parameters | ad_group_criterion.url_custom_parameters | The list of mappings used to substitute custom parameter tags in a tracking_url_template, final_urls, or mobile_final_urls. |
Active View CPM | metrics.active_view_cpm | Average cost of viewable impressions (active_view_impressions). |
Active View CTR | metrics.active_view_ctr | Active view measurable clicks divided by active view viewable impressions. This metric is reported only for display network. |
Active View Impressions | metrics.active_view_impressions | A measurement of how often your ad has become viewable on a Display Network site. |
Active View Measurability | metrics.active_view_measurability | The ratio of impressions that could be measured by Active View over the number of served impressions. |
Active View Measurable Cost Micros | metrics.active_view_measurable_cost_micros | The cost of the impressions you received that were measurable by Active View. |
Active View Measurable Impressions | metrics.active_view_measurable_impressions | The number of times your ads are appearing on placements in positions where they can be seen. |
Active View Viewability | metrics.active_view_viewability | The percentage of time when your ad appeared on an Active View enabled site (measurable impressions) and was viewable (viewable impressions). |
All Conversions | metrics.all_conversions | The total number of conversions. This includes all conversions regardless of the value of include_in_conversions_metric. |
All Conversions Value | metrics.all_conversions_value | The value of all conversions. |
Average Cost | metrics.average_cost | The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions. |
Average CPC | metrics.average_cpc | The total cost of all clicks divided by the total number of clicks received. |
Average CPE | metrics.average_cpe | The average amount that you've been charged for an ad engagement. This amount is the total cost of all ad engagements divided by the total number of ad engagements. |
Average CPM | metrics.average_cpm | Average cost-per-thousand impressions (CPM). |
Average Cpv | metrics.average_cpv | The average amount you pay each time someone views your ad. The average CPV is defined by the total cost of all ad views divided by the number of views. |
Clicks | metrics.clicks | The number of clicks. |
Conversions | metrics.conversions | The number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Conversions From Interactions Rate | metrics.conversions_from_interactions_rate | Conversions from interactions divided by the number of ad interactions (such as clicks for text ads or views for video ads). This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Conversions Value | metrics.conversions_value | The value of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Cost Micros (Spend) | metrics.cost_micros | The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. |
Cost Per Conversion | metrics.cost_per_conversion | The cost of ad interactions divided by conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Cost Per All Conversions | metrics.cost_per_all_conversions | The cost of ad interactions divided by all conversions. |
Cross Device Conversions | metrics.cross_device_conversions | Conversions from when a customer clicks on a Google Ads ad on one device, then converts on a different device or browser. Cross-device conversions are already included in all_conversions. |
CTR | metrics.ctr | The number of clicks your ad receives (Clicks) divided by the number of times your ad is shown (Impressions). |
Engagement Rate | metrics.engagement_rate | How often people engage with your ad after it's shown to them. This is the number of ad expansions divided by the number of times your ad is shown. |
Engagements | metrics.engagements | The number of engagements. An engagement occurs when a viewer expands your Lightbox ad. Also, in the future, other ad types may support engagement metrics. |
Impressions | metrics.impressions | Count of how often your ad has appeared on a search results page or website on the Google Network. |
Gmail Forwards | metrics.gmail_forwards | The number of times the ad was forwarded to someone else as a message. |
Gmail Saves | metrics.gmail_saves | The number of times someone has saved your Gmail ad to their inbox as a message. |
Gmail Secondary Clicks | metrics.gmail_secondary_clicks | The number of clicks to the landing page on the expanded state of Gmail ads. |
Interaction Event Types | metrics.interaction_event_types | The types of payable and free interactions. |
Interaction Rate | metrics.interaction_rate | How often people interact with your ad after it is shown to them. This is the number of interactions divided by the number of times your ad is shown. |
Interactions | metrics.interactions | The number of interactions. An interaction is the main user action associated with an ad format-clicks for text and shopping ads, views for video ads, and so on. |
Value Per All Conversions | metrics.value_per_all_conversions | The value of all conversions divided by the number of all conversions. |
Value Per Conversion | metrics.value_per_conversion | The value of conversions divided by the number of conversions. This only includes conversion actions which include_in_conversions_metric attribute is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
Video Quartile P100_rate | metrics.video_quartile_p100_rate | Percentage of impressions where the viewer watched all of your video. |
Video Quartile P75_rate | metrics.video_quartile_p75_rate | Percentage of impressions where the viewer watched 75% of your video. |
Video Quartile P50_rate | metrics.video_quartile_p50_rate | Percentage of impressions where the viewer watched 50% of your video. |
Video Quartile P25_rate | metrics.video_quartile_p25_rate | Percentage of impressions where the viewer watched 25% of your video. |
Video View Rate | metrics.video_view_rate | The number of views your TrueView video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads. |
Video Views | metrics.video_views | The number of times your video ads were viewed. |
View Through Conversions | metrics.view_through_conversions | The total number of view-through conversions. These happen when a customer sees an image or rich media ad, then later completes a conversion on your site without interacting with (e.g., clicking on) another ad. |
Date | segments.date | Date to which metrics apply. yyyy-MM-dd format, e.g., 2018-04-17. |
Week | segments.week | Week as defined as Monday through Sunday, and represented by the date of Monday. Formatted as yyyy-MM-dd. |
Month | segments.month | Month as represented by the date of the first day of a month. Formatted as yyyy-MM-dd. |
Year | segments.year | Year, formatted as yyyy. |
Device | segments.device | Device to which metrics apply. |
Click Type | segments.click_type | Click type. |
Ad Network Type | segments.ad_network_type | Ad network type. |
Conversion Action Category | segments.conversion_action_category | Conversion action category. |
Conversion Action | segments.conversion_action | Resource name of the conversion action. |
Conversion Action Name | segments.conversion_action_name | Conversion action name. |
Day Of Week | segments.day_of_week | Day of the week, e.g., MONDAY. |
Month Of Year | segments.month_of_year | Month of the year, e.g., January. |
External Conversion Source | segments.external_conversion_source | External conversion source. |
Was this article helpful?