Google Ads: Most-used fields#
The table below gives information about most-used fields that you can import from Google Ads. Other fields might also be available in Adverity.
The fields that you can fetch in Adverity are updated regularly to reflect updates to data source APIs.
API name |
Adverity UI name |
Description |
Use in Adverity |
|---|---|---|---|
Accent_color__multi_asset_responsive_display_ |
Accent_color__multi_asset_responsive_display_ |
The accent color, in hexadecimal format, used for a multi-asset responsive display ad. |
dimension |
Account |
Account |
The name of the Google Ads account. |
dimension |
Active_view_measurable_impressions |
Active_view_measurable_impressions |
The number of impressions that were measurable by Active View technology. |
metric |
Active_view_viewable_impressions |
Active_view_viewable_impressions |
The number of impressions that were considered viewable by Active View technology, meaning a certain percentage of the ad was on screen for a minimum duration. |
metric |
Ad |
Ad |
Represents an individual advertisement. |
dimension |
Ad Final URL suffix |
ad_group_ad.ad.final_url_suffix |
A suffix used to append query parameters to landing pages that are served with parallel tracking for an ad. |
dimension |
Ad Group Criterion User List |
ad_group_criterion.user_list.user_list |
A criterion at the ad group level that defines a user list for targeting or exclusion of ads. |
dimension |
Ad Group Criterion display name |
ad_group_criterion.display_name |
The display name of an ad group criterion, which represents a specific targeting setting within an ad group (e.g., keyword, audience). |
dimension |
Ad ID |
ad_group_ad.ad.id |
The unique identifier for an ad within an ad group. |
dimension |
Ad group |
ad_group.name |
The name of the ad group. |
dimension |
Ad group ID |
ad_group.id |
The unique numerical identifier for the ad group. |
dimension |
Ad group ad resource name |
ad_group_ad.resource_name |
The resource name of the ad group ad, which uniquely identifies an ad within an ad group. Its format is customers/{customer_id}/adGroupAds/{ad_group_id}~{ad_id}. |
dimension |
Ad group resource name |
ad_group.resource_name |
The unique resource name for an ad group in the Google Ads API. |
dimension |
Ad resource name |
ad_group_ad.ad.resource_name |
The resource name of the ad within the ad group. This typically refers to the ad_group_ad.resource_name, which uniquely identifies the ad. |
dimension |
Ad schedule end time |
Ad schedule end time |
The end time for an ad schedule, specifying when ads should stop serving on a given day. |
dimension |
Ad schedule start time |
Ad schedule start time |
The start time for an ad schedule, specifying when ads should begin serving on a given day. |
dimension |
Ad_Final_URL_suffix |
Ad_Final_URL_suffix |
An optional field for adding parameters to the end of a final URL for tracking purposes, allowing for detailed tracking of lead sources and campaign performance. |
dimension |
Ad_ID |
Ad_ID |
A unique identifier for an ad creative within the Google Ads platform. |
dimension |
Ad_format_preference__multi_asset_responsive_display_ |
Ad_format_preference__multi_asset_responsive_display_ |
The format setting that dictates how a multi-asset responsive display ad is rendered, such as native or non-native. |
dimension |
Ad_format_preference__responsive_ |
Ad_format_preference__responsive_ |
The format setting that dictates how a responsive ad is rendered, such as native or non-native, influencing its appearance across different ad spaces. |
dimension |
Ad_group |
Ad_group |
The name of the ad group in Google Ads, which organizes ads, keywords, and bids. |
dimension |
Ad_group_Campaign_ID |
Ad_group_Campaign_ID |
The unique identifier for the campaign to which the ad group belongs. |
dimension |
Ad_group_ID |
Ad_group_ID |
The unique, globally identifiable ID for the ad group. |
dimension |
Ad_group_ad_labels |
Ad_group_ad_labels |
Labels applied to an individual ad within an ad group, used for organization and filtering of ad performance data. |
dimension |
Ad_group_audience_setting_use_audience_grouped |
Ad_group_audience_setting_use_audience_grouped |
Indicates whether audience targeting is enabled for an ad group using grouped audiences. |
dimension |
Ad_group_excluded_parent_asset_field_types |
Ad_group_excluded_parent_asset_field_types |
A list of asset field types that are excluded from being inherited by this ad group from higher levels in the account hierarchy. |
dimension |
Ad_group_excluded_parent_asset_set_types |
Ad_group_excluded_parent_asset_set_types |
A list of asset set types that are excluded from being inherited by this ad group from higher levels in the account hierarchy. |
dimension |
Ad_group_labels |
Ad_group_labels |
Labels applied to the ad group for organizational and filtering purposes, allowing for custom categorization of ad groups. |
dimension |
Ad_group_state |
Ad_group_state |
The current serving status of the ad group, indicating its operational state (e.g., enabled, paused, or removed). |
dimension |
Ad_group_target_CPA |
Ad_group_target_CPA |
The target cost-per-acquisition (CPA) set at the ad group level, which can override a campaign’s overall Target CPA bidding strategy. |
metric |
Ad_group_target_CPM |
Ad_group_target_CPM |
The target cost-per-thousand impressions (CPM) set for the ad group, used in bidding strategies to optimize for impressions. |
metric |
Ad_group_target_ROAS |
Ad_group_target_ROAS |
The target Return On Ad Spend (ROAS) set at the ad group level, which can override a campaign’s overall Target ROAS bidding strategy. |
metric |
Ad_group_type |
Ad_group_type |
The specific type of the ad group, which is tied to its campaign channel type (e.g., Search, Display, Video, Shopping) and dictates what entities can be added to it. |
dimension |
Ad_headline |
Ad_headline |
The main text lines that appear at the top of an ad, designed to capture user attention and convey the ad’s core message. |
dimension |
Ad_name |
Ad_name |
The name of the ad creative within an ad group. |
dimension |
Ad_product_type |
Ad_product_type |
The specific format or category of an ad, such as Expanded Text Ad, Responsive Search Ad, or Call Ad, which defines its structure and available features. |
dimension |
Ad_resource_name |
Ad_resource_name |
The unique identifier for an ad within the Google Ads API, formatted hierarchically to include the customer and ad ID. |
dimension |
Ad_state |
Ad_state |
The current serving status of the ad, indicating whether it is enabled, paused, or removed. |
dimension |
Ad_strength |
Ad_strength |
A metric that estimates the relevance, quantity, and diversity of an ad’s content and assets, providing a rating (e.g., Poor, Average, Good, Excellent) to help improve ad performance. |
dimension |
Ad_type |
Ad_type |
The specific format or type of an ad, such as Expanded Text Ad, Responsive Search Ad, or Image Ad. |
dimension |
Advertising channel |
campaign.advertising_channel_type |
The primary advertising channel type for a campaign, which dictates the kind of ads, features, and bidding strategies available. Examples include “SEARCH” for Search Network campaigns or “PERFORMANCE_MAX”. |
dimension |
Age range |
Age range |
The demographic age range targeted by an ad or for which data is reported. |
dimension |
Age range view resource name |
age_range_view.resource_name |
The resource name for an age range view, used to identify specific age range criteria for analysis. The format is customers/{customer_id}/ageRangeViews/{ad_group_id}~{criterion_id}. |
dimension |
All conv. |
All conv. |
The total number of all conversions, including those that are estimated or cross-device. |
metric |
All conv. value |
All conv. value |
The total value of all conversions, including cross-device and estimated conversions. |
metric |
All conversions |
metrics.all_conversions |
The total number of conversions, including all conversion actions regardless of their include_in_conversions_metric attribute setting. |
metric |
All conversions value |
metrics.all_conversions_value |
The sum of the values of all conversions. This metric reflects modifications made by conversion value rule sets. |
metric |
All_conversion_value__by_conversion_time_ |
All_conversion_value__by_conversion_time_ |
The total value of all conversions (including all primary and secondary conversion actions) attributed to ads, reported based on the time each conversion occurred. |
metric |
All_conversions |
All_conversions |
The total number of all conversions, including primary and secondary conversion actions, regardless of their ‘include in conversions’ metric setting. |
metric |
All_conversions__by_conversion_time_ |
All_conversions__by_conversion_time_ |
The total number of all conversions (including primary and secondary conversion actions) attributed to ads, reported based on the time each conversion occurred. |
metric |
All_conversions_value |
All_conversions_value |
The combined monetary value of all conversions, including primary and secondary conversion actions, representing the total revenue generated. |
metric |
Allow_flexible_color__multi_asset_responsive_display_ |
Allow_flexible_color__multi_asset_responsive_display_ |
Indicates if the Responsive Display Ad is allowed to serve with different colors than those explicitly specified, enabling more flexibility in ad rendering. |
dimension |
Asset group name |
asset_group.name |
The name of the asset group. |
dimension |
Asset group status |
asset_group.status |
The current status of the asset group (e.g., enabled, paused, removed). |
dimension |
Asset resource name |
asset.resource_name |
This is the resource name for an asset, which uniquely identifies it within the Google Ads API. |
dimension |
Asset_ID |
Asset_ID |
The unique identifier for an asset, such as an image, video, or text snippet. |
dimension |
Asset_name |
Asset_name |
The human-readable name of the asset. |
dimension |
Asset_source |
Asset_source |
The origin or source of the asset, indicating if it was user-provided or automatically generated/sourced (e.g., from an app store listing). |
dimension |
Asset_type |
Asset_type |
The category of content the asset represents, such as text, image, or video. |
dimension |
Audience view resource name |
ad_group_audience_view.resource_name |
The unique identifier (resource name) for the ad group audience view, used for retrieving audience performance data. |
dimension |
Audience_setting_use_audience_grouped |
Audience_setting_use_audience_grouped |
Indicates whether audience targeting is enabled for an ad group using grouped audiences. |
dimension |
Average_CPC |
Average_CPC |
The average cost paid for each click on an ad, calculated by dividing the total cost by the total number of clicks. |
metric |
Base_ad_group_ID |
Base_ad_group_ID |
The unique identifier for the base ad group, often used in experiments or drafts to refer to the original ad group. |
dimension |
Base_campaign_ID |
Base_campaign_ID |
The ID of the original campaign from which a draft or trial campaign was created, serving as the foundation for experiments. |
dimension |
Bid strategy type (campaign) |
campaign.bidding_strategy_type |
The type of bidding strategy used for a campaign. This field is read-only and indicates whether a standard or portfolio bidding strategy is applied. |
dimension |
Bid_strategy_ID |
Bid_strategy_ID |
The unique identifier for a bidding strategy, which can be applied to campaigns or ad groups. |
dimension |
Bid_strategy_name |
Bid_strategy_name |
The human-readable name of the bidding strategy. |
dimension |
Bid_strategy_type |
Bid_strategy_type |
The type of bidding strategy used, such as Maximize Conversions, Target ROAS, or Manual CPC. |
dimension |
Business_name |
Business_name |
The name of the business associated with an ad or lead form. |
dimension |
Business_name__multi_asset_responsive_display_ |
Business_name__multi_asset_responsive_display_ |
The business or brand name displayed within multi-asset Responsive Display Ads. |
dimension |
Buy Type |
Buy Type |
The purchasing model for an ad, such as ‘Auction’ or ‘Reservation’. |
dimension |
CPA_bidding_maximum_CPC__micros_ |
CPA_bidding_maximum_CPC__micros_ |
The maximum cost-per-click (CPC) bid allowed for automated bidding strategies like Target CPA, specified in micros. |
dimension |
CPA_bidding_minimum_CPC__micros_ |
CPA_bidding_minimum_CPC__micros_ |
The minimum cost-per-click (CPC) bid allowed for automated bidding strategies, specified in micros. |
dimension |
CPA_bidding_strategy |
CPA_bidding_strategy |
An automated bidding strategy focused on acquiring conversions at a predefined average cost-per-acquisition (CPA). |
dimension |
Call_to_action_text__multi_asset_responsive_display_ |
Call_to_action_text__multi_asset_responsive_display_ |
The call-to-action text displayed on a multi-asset Responsive Display Ad (e.g., ‘Shop Now’, ‘Learn More’). |
dimension |
Call_to_action_text__responsive_ |
Call_to_action_text__responsive_ |
The text displayed on a responsive ad (e.g., ‘Shop Now’, ‘Learn More’) that prompts users to take a specific action. |
dimension |
Campaign |
campaign.name |
The name of the campaign. |
dimension |
Campaign ID |
campaign.id |
The unique identifier for the campaign. |
dimension |
Campaign resource name |
campaign.resource_name |
The full resource name of the campaign, which uniquely identifies it within the API. |
dimension |
Campaign state |
campaign.status |
This field indicates the current status of a campaign, such as enabled, paused, or removed. |
dimension |
Campaign type |
Campaign type |
The type of campaign (e.g., Search, Display, Shopping, Video, App). |
dimension |
Campaign_ID |
Campaign_ID |
The unique identifier for a Google Ads campaign. |
dimension |
Campaign_labels |
Campaign_labels |
Labels applied to a campaign for organization and filtering. |
dimension |
Campaign_state |
Campaign_state |
The current operational state of the campaign, such as enabled, paused, or removed. |
dimension |
Campaign_tracking_URL |
Campaign_tracking_URL |
An optional template used to specify additional tracking parameters or redirects for the campaign’s destination URLs. |
dimension |
City name |
City name |
The name of the city targeted or where an ad was served. |
dimension |
Clicks |
metrics.clicks |
The number of clicks on your ads that led to visits to your website or landing page. |
metric |
Client Customer Id |
Client Customer Id |
The Google Ads customer ID of the client account. |
metric |
Client Customer Name |
Client Customer Name |
The descriptive name of the client customer account. |
dimension |
Client_name |
Client_name |
The descriptive, human-readable name of the Google Ads customer account. |
dimension |
Content Impr. share |
Content Impr. share |
The impressions you’ve received on the Display Network divided by the estimated number of impressions you were eligible to receive. |
dimension |
Content impression share |
metrics.content_impression_share |
The percentage of impressions your ads received on the Display Network compared to the estimated number of eligible impressions. Values range from 0.1 to 1, with anything below 0.1 reported as 0.0999. |
metric |
Conv. rate |
Conv. rate |
The percentage of ad interactions that result in a conversion. |
metric |
Conversion Tracker ID |
segments.conversion_action |
The resource name of the conversion action that recorded the conversion event, used for segmentation in reports. |
dimension |
Conversion action all conversions total number |
Conversion action all conversions total number |
The total number of all conversion actions recorded, including cross-device conversions. |
metric |
Conversion action all conversions value |
Conversion action all conversions value |
The total value of all conversions for a specific conversion action. |
metric |
Conversion category |
segments.conversion_action_category |
The category of a conversion action (e.g., purchase, lead, page view). |
dimension |
Conversion name |
segments.conversion_action_name |
The name assigned to a specific conversion action. |
dimension |
Conversion_action_ID |
Conversion_action_ID |
The unique identifier for a specific conversion action. |
dimension |
Conversion_action_always_use_default_value |
Conversion_action_always_use_default_value |
Indicates whether the default value should always be used for this conversion action, overriding any dynamically provided values. |
dimension |
Conversion_action_app_ID |
Conversion_action_app_ID |
The identifier of the mobile application associated with an app conversion action. |
dimension |
Conversion_action_attribution_model |
Conversion_action_attribution_model |
The attribution model used for this conversion action, determining how credit for conversions is assigned to different ad interactions. |
dimension |
Conversion_action_category |
Conversion_action_category |
The category that describes the type of conversion action (e.g., Purchase, Lead, Download). |
dimension |
Conversion_action_click_through_lookback_window__days_ |
Conversion_action_click_through_lookback_window__days_ |
The number of days after a click during which a conversion action can be recorded. |
metric |
Conversion_action_counting_type |
Conversion_action_counting_type |
The method used to count conversions for this action, e.g., ‘Every’ (all conversions) or ‘One_per_click’ (unique conversions). |
dimension |
Conversion_action_data_driven_model_status |
Conversion_action_data_driven_model_status |
The status of the data-driven attribution model for this conversion action. |
dimension |
Conversion_action_default_currency_code |
Conversion_action_default_currency_code |
The default currency code associated with a conversion action. |
dimension |
Conversion_action_default_value |
Conversion_action_default_value |
The default monetary value assigned to a conversion action when no specific value is reported. |
metric |
Conversion_action_include_in_conversions_metric |
Conversion_action_include_in_conversions_metric |
Indicates whether this conversion action’s data is included in the ‘Conversions’ metric, which is used for conversion-based bidding strategies. |
metric |
Conversion_action_name |
Conversion_action_name |
The name given to the conversion action, which is a descriptive identifier. |
dimension |
Conversion_action_owner_customer |
Conversion_action_owner_customer |
The resource name of the customer who owns this conversion action. |
dimension |
Conversion_action_phone_call_duration__seconds_ |
Conversion_action_phone_call_duration__seconds_ |
The minimum duration in seconds a phone call must last to be counted as a conversion for a call-based conversion action. |
metric |
Conversion_action_resource_name |
Conversion_action_resource_name |
The unique identifier (resource name) for the conversion action. |
dimension |
Conversion_action_status |
Conversion_action_status |
The current status of the conversion action (e.g., enabled, paused, removed). |
dimension |
Conversion_action_tag_snippets |
Conversion_action_tag_snippets |
The code snippets (tags) required to be implemented on a website to track this conversion action. |
dimension |
Conversion_action_type |
Conversion_action_type |
The specific type of conversion action, such as website, app install, or phone call. |
dimension |
Conversion_action_view_through_lookback_window__days_ |
Conversion_action_view_through_lookback_window__days_ |
The number of days after an impression (view) during which a view-through conversion can be recorded. |
metric |
Conversion_category |
Conversion_category |
The category that describes the type of conversion (e.g., Purchase, Lead, Download). |
dimension |
Conversion_name |
Conversion_name |
The descriptive name assigned to a conversion. |
dimension |
Conversion_rate |
Conversion_rate |
The rate at which ad interactions lead to a desired action, calculated as conversions divided by interactions. This metric is derived and not directly provided by the Google Ads API. |
metric |
Conversion_value__by_conversion_time_ |
Conversion_value__by_conversion_time_ |
The total value of all conversions, reported based on the timestamp when the conversions actually occurred. |
metric |
Conversion_value__current_model_ |
Conversion_value__current_model_ |
The total value of all conversions as calculated by the currently applied attribution model. |
metric |
Conversions |
metrics.conversions |
The total number of conversions, specifically including only conversion actions where the include_in_conversions_metric attribute is set to true. |
metric |
Conversions__by_conversion_time_ |
Conversions__by_conversion_time_ |
The total number of conversions, reported based on the date and time when the conversions actually occurred. |
metric |
Conversions__current_model_ |
Conversions__current_model_ |
The total number of conversions as determined by the currently applied attribution model. |
metric |
Cost |
metrics.cost_micros |
The total cost of ad interactions, measured in micro-units (one millionth of the base currency unit). |
metric |
Cost_per_conversion |
Cost_per_conversion |
The average cost incurred for each conversion, calculated as total cost divided by the total number of conversions. |
metric |
Country/territory name |
Country/territory name |
The name of the country or territory targeted or where an ad was served. |
dimension |
Cross-device conv. |
Cross-device conv. |
The number of conversions that started on one device and finished on another. |
metric |
Currency |
customer.currency_code |
The currency code (ISO 4217 standard) in which the Google Ads account operates. |
dimension |
Custom_parameter |
Custom_parameter |
Optional ValueTrack parameters that allow advertisers to assign custom IDs for tracking purposes. |
dimension |
Customer ID |
customer.id |
The unique ID of the Google Ads customer account. |
dimension |
Customer Name |
Customer Name |
The name of the Google Ads customer account. |
dimension |
Customer resource name |
customer.resource_name |
The resource name for the customer entity, serving as its unique identifier within the Google Ads API. |
dimension |
Customer_ID |
Customer_ID |
The unique identifier for the Google Ads customer account. |
dimension |
Customer_name |
Customer_name |
The descriptive name of the Google Ads customer account. |
dimension |
Day |
segments.date |
The date for which the performance metrics are reported, used for segmenting data by day. |
dimension |
Days_to_conversion |
Days_to_conversion |
The number of days that elapsed between an ad interaction (click or impression) and the resulting conversion. |
dimension |
Demand Gen |
Demand Gen |
Indicates whether the campaign is a Demand Gen campaign, designed to drive demand and interest. |
dimension |
Demand Gen Type |
Demand Gen Type |
The type of Demand Generation campaign, designed to create visually rich and relevant ads to drive customer action. |
dimension |
Description__responsive_ |
Description__responsive_ |
The descriptive text for a responsive ad, which can vary to match potential customers’ search queries. |
dimension |
Description_line_1 |
Description_line_1 |
The first line of descriptive text for an Expanded Text Ad. |
dimension |
Description_line_2 |
Description_line_2 |
The second line of descriptive text for an Expanded Text Ad. |
dimension |
Descriptions__multi_asset_responsive_display_ |
Descriptions__multi_asset_responsive_display_ |
Multiple descriptive text assets provided for a Responsive Display Ad, from which Google Ads selects the best combination to show. |
dimension |
Detail_view_placement_string |
Detail_view_placement_string |
The automatic placement string at a detailed level, such as a website URL, mobile application ID, or YouTube video ID. |
dimension |
Display_URL |
Display_URL |
The URL shown in the ad, which gives users an idea of where they’ll go after clicking, often a simplified version of the final URL. |
dimension |
End date |
campaign.end_date |
The end date of the campaign. |
dimension |
Engagements |
metrics.engagements |
The total number of engagements with an ad. An engagement typically occurs when a viewer expands a Lightbox ad, and this metric may apply to other ad types in the future. |
metric |
Enhanced_CPC_bidding_strategy |
Enhanced_CPC_bidding_strategy |
A Smart Bidding strategy that automatically adjusts manual bids in real-time to increase conversions while trying to keep the average cost-per-click below the maximum CPC. |
dimension |
Enhanced_CPC_enabled |
Enhanced_CPC_enabled |
Indicates whether the Enhanced CPC feature is activated for a manual CPC bidding strategy. |
dimension |
Excluded_parent_asset_field_types |
Excluded_parent_asset_field_types |
A list of asset field types that are excluded from being inherited by a campaign from higher levels in the account hierarchy. |
dimension |
Excluded_parent_asset_set_types |
Excluded_parent_asset_set_types |
A list of asset set types that are excluded from being inherited by a campaign from higher levels in the account hierarchy. |
dimension |
Expanded_landing_page |
Expanded_landing_page |
The URL of the landing page after all redirects and expansions, representing the final destination a user reaches after clicking an ad. |
dimension |
Expanded_text_ad_description_2 |
Expanded_text_ad_description_2 |
The second line of descriptive text for an Expanded Text Ad. |
dimension |
Expanded_text_ad_headline_3 |
Expanded_text_ad_headline_3 |
The third, optional headline for an Expanded Text Ad, providing additional ad text that can appear on wider mobile devices. |
dimension |
Final_URL |
Final_URL |
The actual landing page URL where a user is directed after clicking an ad. |
dimension |
Final_app_URLs |
Final_app_URLs |
A list of final URLs for mobile applications, used when a user has the specific app installed on their device. |
dimension |
Full_image_URL |
Full_image_URL |
The direct URL to the full-size image asset. |
dimension |
Gender |
Gender |
The demographic gender targeted by an ad or for which data is reported. |
dimension |
Gender view resource name |
gender_view.resource_name |
The resource name for a gender view, used to identify specific gender criteria for analysis. The format is customers/{customer_id}/genderViews/{ad_group_id}~{criterion_id}. This view reflects the effective serving state for genders, including those not explicitly targeted. |
dimension |
Geographic view |
Geographic view |
A report view that provides performance data broken down by geographical location. |
dimension |
Has recommended Budget |
Has recommended Budget |
Indicates whether the campaign budget has a recommended amount. |
dimension |
Headline_1 |
Headline_1 |
The first headline for an Expanded Text Ad. |
dimension |
Headline_2 |
Headline_2 |
The second headline for an Expanded Text Ad. |
dimension |
Headlines__multi_asset_responsive_display_ |
Headlines__multi_asset_responsive_display_ |
Multiple headline text assets provided for a Responsive Display Ad, from which Google Ads selects the best combination to show. |
dimension |
Hotel_property_asset_set |
Hotel_property_asset_set |
The asset set containing hotel properties, used specifically for Performance Max campaigns with travel goals. |
dimension |
Image_URL_01__multi_asset_responsive_display_ |
Image_URL_01__multi_asset_responsive_display_ |
The URL of a specific image asset (e.g., the first) used in a multi-asset Responsive Display Ad. |
dimension |
Image_URL_02__multi_asset_responsive_display_ |
Image_URL_02__multi_asset_responsive_display_ |
The URL of a specific image asset (e.g., the second) used in a multi-asset Responsive Display Ad. |
dimension |
Image_URL_03__multi_asset_responsive_display_ |
Image_URL_03__multi_asset_responsive_display_ |
The URL of a specific image asset (e.g., the third) used in a multi-asset Responsive Display Ad. |
dimension |
Image_URL_04__multi_asset_responsive_display_ |
Image_URL_04__multi_asset_responsive_display_ |
The URL of a specific image asset (e.g., the fourth) used in a multi-asset Responsive Display Ad. |
dimension |
Image_URL_05__multi_asset_responsive_display_ |
Image_URL_05__multi_asset_responsive_display_ |
The URL of a specific image asset (e.g., the fifth) used in a multi-asset Responsive Display Ad. |
dimension |
Image_URL_06__multi_asset_responsive_display_ |
Image_URL_06__multi_asset_responsive_display_ |
The URL of a specific image asset (e.g., the sixth) used in a multi-asset Responsive Display Ad. |
dimension |
Image_URL_07__multi_asset_responsive_display_ |
Image_URL_07__multi_asset_responsive_display_ |
The URL of a specific image asset (e.g., the seventh) used in a multi-asset Responsive Display Ad. |
dimension |
Image_URL_08__multi_asset_responsive_display_ |
Image_URL_08__multi_asset_responsive_display_ |
The URL of a specific image asset (e.g., the eighth) used in a multi-asset Responsive Display Ad. |
dimension |
Image_URL_09__multi_asset_responsive_display_ |
Image_URL_09__multi_asset_responsive_display_ |
The URL of a specific image asset (e.g., the ninth) used in a multi-asset Responsive Display Ad. |
dimension |
Image_URL_10__multi_asset_responsive_display_ |
Image_URL_10__multi_asset_responsive_display_ |
The URL of a specific image asset (e.g., the tenth) used in a multi-asset Responsive Display Ad. |
dimension |
Image_URL_12__multi_asset_responsive_display_ |
Image_URL_12__multi_asset_responsive_display_ |
The URL of a specific image asset (e.g., the twelfth) used in a multi-asset Responsive Display Ad. |
dimension |
Image_URL_14__multi_asset_responsive_display_ |
Image_URL_14__multi_asset_responsive_display_ |
The URL of a specific image asset (e.g., the fourteenth) used in a multi-asset Responsive Display Ad. |
dimension |
Image_URL_15__multi_asset_responsive_display_ |
Image_URL_15__multi_asset_responsive_display_ |
The URL of a specific image asset (e.g., the fifteenth) used in a multi-asset Responsive Display Ad. |
dimension |
Image_asset_auto_migration_done |
Image_asset_auto_migration_done |
Indicates if feed-based images have been migrated to asset-based images for the customer. |
dimension |
Image_asset_auto_migration_done_date_time |
Image_asset_auto_migration_done_date_time |
The timestamp when the migration from feed-based images to asset-based images was completed for the customer. |
dimension |
Images__multi_asset_responsive_display_ |
Images__multi_asset_responsive_display_ |
A collection of image assets provided for a Responsive Display Ad, from which Google Ads selects the best combination to show. |
dimension |
Impr. (Top) % |
Impr. (Top) % |
The percentage of your total impressions that were shown anywhere in the top section (above organic search results). |
dimension |
Impressions |
metrics.impressions |
The total number of times your ads were shown. |
metric |
Instream |
Instream |
Refers to instream video ads, which play before, during, or after other video content. |
dimension |
Interaction Rate |
Interaction Rate |
The percentage of impressions that result in an interaction with your ad. |
metric |
Interactions |
metrics.interactions |
The total number of interactions with an ad. An interaction represents the primary user action for a specific ad format, such as clicks for text and shopping ads or views for video ads. |
metric |
Labels |
Labels |
Custom labels applied to campaigns, ad groups, ads, or keywords for organization and filtering. |
dimension |
Landing_page |
Landing_page |
The final URL that a user is directed to after clicking an ad, before any redirects or expansions. |
dimension |
Landscape_logos__multi_asset_responsive_display_ |
Landscape_logos__multi_asset_responsive_display_ |
A collection of landscape-oriented logo assets provided for a Responsive Display Ad. |
dimension |
Last_conversion_date |
Last_conversion_date |
This field represents the date of the last recorded conversion for an entity. |
dimension |
Location_asset_auto_migration_done |
Location_asset_auto_migration_done |
Indicates if feed-based locations have been migrated to asset-based locations for the customer. |
dimension |
Logos__multi_asset_responsive_display_ |
Logos__multi_asset_responsive_display_ |
A collection of logo assets provided for a Responsive Display Ad. |
dimension |
Long_headline |
Long_headline |
A longer headline for a Responsive Display Ad, offering more space to convey the brand or product’s value proposition. |
dimension |
Long_headline__multi_asset_responsive_display_ |
Long_headline__multi_asset_responsive_display_ |
The long headline text asset used in multi-asset Responsive Display Ads. |
dimension |
Maximize_conversions_target_cpa_micros |
Maximize_conversions_target_cpa_micros |
The optional target cost-per-acquisition (CPA) for a Maximize Conversions bidding strategy, specified in micros. |
metric |
Metro area name |
Metro area name |
The human-readable name of the metro area. |
dimension |
Mobile_final_URL |
Mobile_final_URL |
A list of specific landing page URLs optimized for mobile devices. |
dimension |
Month |
segments.month |
A segment that represents the month to which metrics apply. When used for filtering, it must be specified as the first day of the month in ‘YYYY-MM-DD’ format. |
dimension |
Month of Year |
Month of Year |
The month of the year to which metrics apply. |
dimension |
Most specific location Canonical |
Most specific location Canonical |
The canonical name of the most specific geographic location targeted or reported on. |
dimension |
Most specific location Name |
Most specific location Name |
The human-readable name of the most specific geographic location targeted or reported on. |
dimension |
Network |
segments.ad_network_type |
A segment that categorizes data by the ad network type where the ad was served (e.g., Google Search, Display Network, YouTube). |
dimension |
Network (with search partners) |
Network (with search partners) |
The network on which the ad served, including Google Search and Search Partners. |
dimension |
Parental status |
Parental status |
The demographic parental status targeted by an ad or for which data is reported. |
dimension |
Path_1 |
Path_1 |
The first optional path segment appended to the display URL, providing additional context about the landing page content. |
dimension |
Path_2 |
Path_2 |
The second optional path segment appended to the display URL, providing further context about the landing page content. |
dimension |
Platform |
Platform |
The advertising platform or device type where the ad was served (e.g., Mobile, Desktop, Tablet). |
dimension |
Price_prefix__multi_asset_responsive_display_ |
Price_prefix__multi_asset_responsive_display_ |
Optional text (e.g., ‘Starting at’, ‘As low as’) that appears before the price in a multi-asset Responsive Display Ad. |
dimension |
Promotion_text__multi_asset_responsive_display_ |
Promotion_text__multi_asset_responsive_display_ |
Optional promotional text (e.g., ‘Free shipping!’) used in a multi-asset Responsive Display Ad to highlight special offers. |
dimension |
Promotion_text__responsive_ |
Promotion_text__responsive_ |
Optional promotional text used in a responsive ad to highlight special offers, such as ‘Free two-day shipping.’ |
dimension |
ROAS_bidding_maximum_CPC__micros_ |
ROAS_bidding_maximum_CPC__micros_ |
The maximum cost-per-click (CPC) bid allowed for a Target ROAS bidding strategy, specified in micros. |
dimension |
ROAS_bidding_minimum_CPC__micros_ |
ROAS_bidding_minimum_CPC__micros_ |
The minimum cost-per-click (CPC) bid allowed for a Target ROAS bidding strategy, specified in micros. |
dimension |
Recommended Budget amount |
Recommended Budget amount |
The recommended budget amount for a campaign. |
metric |
Region name |
Region name |
The human-readable name of the geographic region. |
dimension |
Responsive_search_ad_descriptions_1 |
Responsive_search_ad_descriptions_1 |
The first descriptive text asset for a Responsive Search Ad, used to create various ad combinations. |
dimension |
Responsive_search_ad_descriptions_2 |
Responsive_search_ad_descriptions_2 |
The second descriptive text asset for a Responsive Search Ad, used to create various ad combinations. |
dimension |
Responsive_search_ad_descriptions_3 |
Responsive_search_ad_descriptions_3 |
The third descriptive text asset for a Responsive Search Ad, used to create various ad combinations. |
dimension |
Responsive_search_ad_descriptions_4 |
Responsive_search_ad_descriptions_4 |
The fourth descriptive text asset for a Responsive Search Ad, used to create various ad combinations. |
dimension |
Responsive_search_ad_headlines_1 |
Responsive_search_ad_headlines_1 |
The first headline text asset for a Responsive Search Ad, used to create various ad combinations. |
dimension |
Responsive_search_ad_headlines_10 |
Responsive_search_ad_headlines_10 |
The tenth headline text asset for a Responsive Search Ad, used to create various ad combinations. |
dimension |
Responsive_search_ad_headlines_11 |
Responsive_search_ad_headlines_11 |
The eleventh headline text asset for a Responsive Search Ad, used to create various ad combinations. |
dimension |
Responsive_search_ad_headlines_12 |
Responsive_search_ad_headlines_12 |
The twelfth headline text asset for a Responsive Search Ad, used to create various ad combinations. |
dimension |
Responsive_search_ad_headlines_13 |
Responsive_search_ad_headlines_13 |
The thirteenth headline text asset for a Responsive Search Ad, used to create various ad combinations. |
dimension |
Responsive_search_ad_headlines_14 |
Responsive_search_ad_headlines_14 |
The fourteenth headline text asset for a Responsive Search Ad, used to create various ad combinations. |
dimension |
Responsive_search_ad_headlines_15 |
Responsive_search_ad_headlines_15 |
The fifteenth headline text asset for a Responsive Search Ad, used to create various ad combinations. |
dimension |
Responsive_search_ad_headlines_2 |
Responsive_search_ad_headlines_2 |
The second headline text asset for a Responsive Search Ad, used to create various ad combinations. |
dimension |
Responsive_search_ad_headlines_3 |
Responsive_search_ad_headlines_3 |
The third headline text asset for a Responsive Search Ad, used to create various ad combinations. |
dimension |
Responsive_search_ad_headlines_4 |
Responsive_search_ad_headlines_4 |
The fourth headline text asset for a Responsive Search Ad, used to create various ad combinations. |
dimension |
Responsive_search_ad_headlines_5 |
Responsive_search_ad_headlines_5 |
The fifth headline text asset for a Responsive Search Ad, used to create various ad combinations. |
dimension |
Responsive_search_ad_headlines_6 |
Responsive_search_ad_headlines_6 |
The sixth headline text asset for a Responsive Search Ad, used to create various ad combinations. |
dimension |
Responsive_search_ad_headlines_7 |
Responsive_search_ad_headlines_7 |
The seventh headline text asset for a Responsive Search Ad, used to create various ad combinations. |
dimension |
Responsive_search_ad_headlines_8 |
Responsive_search_ad_headlines_8 |
The eighth headline text asset for a Responsive Search Ad, used to create various ad combinations. |
dimension |
Responsive_search_ad_headlines_9 |
Responsive_search_ad_headlines_9 |
The ninth headline text asset for a Responsive Search Ad, used to create various ad combinations. |
dimension |
Search Exact match IS |
Search Exact match IS |
The percentage of impressions that your exact match keywords received compared to the estimated number of eligible exact match impressions on the Search Network. |
dimension |
Search Impr. share |
Search Impr. share |
The percentage of impressions that your ads received compared to the estimated number of impressions they were eligible to receive on the Search Network. |
dimension |
Search impression share |
metrics.search_impression_share |
The percentage of impressions your ads received on the Search Network compared to the estimated number of impressions you were eligible to receive. |
metric |
Search top IS |
Search top IS |
The percentage of your ad impressions that were shown anywhere above the organic search results. |
metric |
Short_headline |
Short_headline |
A concise text asset used as a headline for an ad. |
dimension |
Start date |
campaign.start_date |
The start date of the campaign. |
dimension |
Target campaign CPM |
Target campaign CPM |
The target Cost Per Mille (thousand impressions) for a campaign, a bidding strategy aimed at achieving a specific CPM. |
dimension |
Target_ROAS |
Target_ROAS |
This field represents the target Return On Ad Spend (ROAS) for a bidding strategy, aiming to maximize conversion value while achieving a specific ROAS. |
metric |
Target_spend_bidding_maximum_CPC__micros_ |
Target_spend_bidding_maximum_CPC__micros_ |
The maximum cost-per-click (CPC) bid allowed for a campaign or bidding strategy, expressed in micros. This acts as a ceiling for automated bidding strategies. |
metric |
Target_spend_bidding_target_spend__micros_ |
Target_spend_bidding_target_spend__micros_ |
The target budget amount for a campaign using a Target Spend bidding strategy, expressed in micros. This field’s direct use for Maximize Clicks strategies has been deprecated in the API, with daily budgets being the recommended alternative. |
dimension |
Targeting Category |
Targeting Category |
The category used for targeting purposes (e.g., interest-based, demographic). |
dimension |
Text asset |
asset.text_asset.text |
The actual text content of a text asset. Text assets are created directly within an ad and are immutable after creation. |
dimension |
Total conv. value |
Total conv. value |
The total value of all recorded conversions. |
metric |
Total conversion value |
metrics.conversions_value |
The sum of values of all conversions recorded that are included in the ‘conversions’ metric. |
metric |
Total_conversion_value |
Total_conversion_value |
The total value of all conversions, which can be modified by conversion value rules. |
metric |
Tracking_template |
Tracking_template |
A URL template that contains tracking information and parameters to customize the final URL when an ad is clicked. It allows for dynamic insertion of values and can be set at various levels (account, campaign, ad group, ad, keyword). |
dimension |
Universal app ad Youtube videos titles |
Universal app ad Youtube videos titles |
The titles of YouTube videos used as assets in Universal App Ads. |
dimension |
Universal app ad Youtube videos urls |
Universal app ad Youtube videos urls |
The URLs of YouTube videos used as assets in Universal App Ads. |
dimension |
User location |
User location |
Refers to the physical location of the user when an ad impression or click occurred. |
dimension |
Video Plays 100% |
Video Plays 100% |
The number of times the video ad was played to 100% of its length. |
metric |
Video Plays 25% |
Video Plays 25% |
The number of times the video ad was played to 25% of its length. |
metric |
Video Plays 50% |
Video Plays 50% |
The number of times the video ad was played to 50% of its length. |
metric |
Video Plays 75% |
Video Plays 75% |
The number of times the video ad was played to 75% of its length. |
metric |
Video played to 100% |
metrics.video_quartile_p100_rate |
The percentage of impressions where the viewer watched 100% of your video ad. |
metric |
Video played to 25% |
metrics.video_quartile_p25_rate |
The percentage of impressions where the viewer watched 25% of your video ad. |
metric |
Video played to 50% |
metrics.video_quartile_p50_rate |
The percentage of impressions where the viewer watched 50% of your video ad. |
metric |
Video played to 75% |
metrics.video_quartile_p75_rate |
The percentage of impressions where the viewer watched 75% of your video ad. |
metric |
View-through conv. |
View-through conv. |
The number of view-through conversions, where a user sees an impression but doesn’t interact with the ad, then converts later. |
metric |
View_through_conversions |
View_through_conversions |
The number of conversions that occur when a user sees an ad but does not click on it, and then later completes a conversion action within a defined view-through conversion window. |
metric |
Views |
metrics.video_views |
The total number of times your video ads were viewed. |
metric |
Youtube_video_ID |
Youtube_video_ID |
The unique identifier assigned to a YouTube video, used to reference specific video content within Google Ads campaigns, especially for video assets. |
dimension |
Youtube_video_title |
Youtube_video_title |
The title of the YouTube video asset. |
dimension |
Youtube_videos__multi_asset_responsive_display_ |
Youtube_videos__multi_asset_responsive_display_ |
A collection of YouTube video assets provided for a multi-asset Responsive Display Ad. |
dimension |
accessible_bidding_strategy.id |
Accessible bidding strategy ID |
The unique identifier for an accessible bidding strategy. |
dimension |
accessible_bidding_strategy.name |
Accessible bidding strategy name |
The name of the accessible bidding strategy. |
dimension |
accessible_bidding_strategy.owner_customer_id |
Accessible bidding strategy owner customer ID |
The customer ID of the owner of the accessible bidding strategy. |
dimension |
accessible_bidding_strategy.owner_descriptive_name |
Accessible bidding strategy owner descriptive name |
The descriptive name of the customer who owns the accessible bidding strategy. |
dimension |
accessible_bidding_strategy.target_roas.target_roas |
Accessible bidding strategy target ROAS |
The target Return On Ad Spend (ROAS) for the bidding strategy. |
dimension |
accessible_bidding_strategy.type |
Accessible bidding strategy type |
The type of the accessible bidding strategy (e.g., Target ROAS, Maximize Conversions). |
dimension |
account_budget.adjusted_spending_limit_micros |
Account Budget adjusted spending limit |
The adjusted spending limit for the account budget, in micro-units. |
dimension |
account_budget.adjusted_spending_limit_type |
Account Budget adjusted spending limit type |
The type of the adjusted spending limit for the account budget (e.g., fixed or unlimited). |
dimension |
account_budget.amount_served_micros |
Account Budget amount served |
The amount of money that has been served (spent) against the account budget, in micro-units. |
dimension |
account_budget.approved_end_date_time |
Account Budget approved end date time |
The approved end date and time of the account budget. |
dimension |
account_budget.approved_end_time_type |
Account Budget approved end time type |
The type of the approved end time for the account budget (e.g., fixed date or indefinite). |
dimension |
account_budget.approved_spending_limit_micros |
Account Budget approved spending limit |
The approved spending limit for the account budget, in micro-units. |
dimension |
account_budget.approved_spending_limit_type |
Account Budget approved spending limit type |
The type of the approved spending limit for the account budget (e.g., fixed or unlimited). |
dimension |
account_budget.approved_start_date_time |
Account Budget approved start date time |
The approved start date and time of the account budget. |
dimension |
account_budget.billing_setup |
Account Budget billing setup |
The resource name of the billing setup associated with this account budget. |
dimension |
account_budget.id |
Account Budget ID |
The unique identifier for an account budget. |
dimension |
account_budget.name |
Account Budget name |
The name of the account budget. |
dimension |
account_budget.notes |
Account Budget notes |
Optional notes or comments associated with the account budget. |
dimension |
account_budget.proposed_end_date_time |
Account Budget proposed end date time |
The proposed end date and time of the account budget. |
dimension |
account_budget.proposed_end_time_type |
Account Budget proposed end time type |
The type of the proposed end time for the account budget (e.g., fixed date or indefinite). |
dimension |
account_budget.proposed_spending_limit_micros |
Account Budget proposed spending limit |
The proposed spending limit for the account budget, in micro-units. |
dimension |
account_budget.proposed_spending_limit_type |
Account Budget proposed spending limit type |
The type of the proposed spending limit for the account budget (e.g., fixed or unlimited). |
dimension |
account_budget.proposed_start_date_time |
Account Budget proposed start date time |
The proposed start date and time of the account budget. |
dimension |
account_budget.purchase_order_number |
Account Budget PO Number |
The purchase order number associated with the account budget, which will appear on the invoice. |
dimension |
account_budget.resource_name |
Account Budget resource name |
The resource name of the account budget, which uniquely identifies it in the Google Ads API. |
dimension |
account_budget.status |
Account Budget status |
The current status of the account budget (e.g., pending, approved, ended). |
dimension |
account_budget.total_adjustments_micros |
Account Budget total adjustments |
The total amount of adjustments made to the account budget, in micro-units. |
dimension |
account_id |
account_id |
The unique identifier for a Google Ads account (customer ID). |
dimension |
account_link.account_link_id |
Account link ID |
The unique identifier for an account link, connecting Google Ads to another service. |
dimension |
account_link.status |
Account link status |
The current status of the account link (e.g., pending, enabled, removed). |
dimension |
account_link.third_party_app_analytics.app_analytics_provider_id |
App analytics provider ID |
The unique identifier of the third-party app analytics provider linked to the account. |
dimension |
account_link.third_party_app_analytics.app_id |
App analytics app ID |
The unique identifier of the mobile application being tracked by the third-party app analytics provider. |
dimension |
account_link.third_party_app_analytics.app_vendor |
App vendor |
The vendor or developer of the mobile application being tracked by the third-party app analytics provider. |
dimension |
account_link.type |
Account link type |
The type of service linked to the Google Ads account (e.g., Google Analytics, Firebase, third-party app analytics). |
dimension |
account_name |
account_name |
The descriptive name of the Google Ads account. |
dimension |
ad_group.ad_rotation_mode |
Ad rotation mode |
The method used to rotate ads within an ad group (e.g., optimize for clicks, optimize for conversions, rotate indefinitely). |
dimension |
ad_group.audience_setting.use_audience_grouped |
Ad group audience setting use audience grouped |
Indicates whether audience targeting is enabled and grouped for the ad group, allowing for the addition of ad group criteria with audiences. |
dimension |
ad_group.base_ad_group |
Base ad group ID |
The resource name of the base ad group from which this ad group was copied or derived (e.g., for experiments). |
dimension |
ad_group.campaign |
Ad group Campaign ID |
The resource name of the campaign to which this ad group belongs. |
dimension |
ad_group.cpc_bid_micros |
Default max. CPC |
The default maximum cost-per-click (CPC) bid for the ad group, in micro-units. |
dimension |
ad_group.cpm_bid_micros |
Maximum CPM |
The maximum cost-per-thousand-impressions (CPM) bid for the ad group, in micro-units. |
dimension |
ad_group.cpv_bid_micros |
Maximum CPV |
The maximum cost-per-view (CPV) bid for the ad group, in micro-units. |
dimension |
ad_group.display_custom_bid_dimension |
Content network bid dimension |
Specifies the dimension that should be used for absolute bids on the Display Network when multiple bids are set in different dimensions. |
dimension |
ad_group.effective_cpc_bid_micros |
Ad group effective cpc bid micros |
The effective cost-per-click (CPC) bid for the ad group, in micro-units, taking into account all bidding strategies and overrides. |
dimension |
ad_group.effective_target_cpa_micros |
Target CPA (ad group) |
The effective target Cost-Per-Acquisition (CPA) for the ad group, in micro-units. |
dimension |
ad_group.effective_target_cpa_source |
Target CPA source |
The source from which the effective target CPA for the ad group is derived. |
dimension |
ad_group.effective_target_roas |
Target ROAS (ad group) |
The effective target Return On Ad Spend (ROAS) for the ad group. |
dimension |
ad_group.effective_target_roas_source |
Target ROAS source |
The source from which the effective target ROAS for the ad group is derived. |
dimension |
ad_group.excluded_parent_asset_field_types |
Ad group excluded parent asset field types |
A list of asset field types that are excluded from serving for an ad group. |
dimension |
ad_group.excluded_parent_asset_set_types |
Ad group excluded parent asset set types |
A list of asset set types that are excluded from serving for an ad group. |
dimension |
ad_group.final_url_suffix |
Ad group final URL template |
A suffix that is appended to the final URL for tracking purposes. |
dimension |
ad_group.id |
Ad group ID |
The unique identifier for the ad group. |
dimension |
ad_group.labels |
Ad group labels |
The list of resource names of labels applied to the ad group. |
dimension |
ad_group.name |
Ad group |
The name of the ad group. |
dimension |
ad_group.optimized_targeting_enabled |
Ad group optimized targeting |
Indicates whether optimized targeting is enabled for the ad group, allowing the system to find more relevant customers. |
dimension |
ad_group.percent_cpc_bid_micros |
Ad group CPC bid amount (%) |
The percentage-based cost-per-click (CPC) bid for the ad group criterion, measured in micros. |
dimension |
ad_group.primary_status |
Ad group primary status |
The primary serving status of the ad group (e.g., enabled, paused, removed). |
dimension |
ad_group.primary_status_reasons |
Ad group primary status reasons |
The reasons or explanations for the ad group’s primary serving status. |
dimension |
ad_group.resource_name |
Ad group resource name |
The resource name of the ad group, which uniquely identifies it in the Google Ads API. |
dimension |
ad_group.status |
Ad group state |
The status of the ad group, such as ENABLED, PAUSED, or REMOVED. |
dimension |
ad_group.target_cpa_micros |
Ad group target CPA |
The target Cost-Per-Acquisition (CPA) for the ad group, in micro-units. |
dimension |
ad_group.target_cpm_micros |
Ad group target CPM |
The target Cost-Per-Thousand-Impressions (CPM) for the ad group, in micro-units. |
dimension |
ad_group.target_roas |
Ad group target ROAS |
The target Return On Ad Spend (ROAS) for the ad group. |
dimension |
ad_group.targeting_setting.target_restrictions |
Is restricting |
Indicates specific targeting restrictions applied to the ad group. |
dimension |
ad_group.tracking_url_template |
Ad group tracking URL template |
The URL template used for tracking clicks from ads within the ad group. |
dimension |
ad_group.type |
Ad group type |
The type of the ad group, indicating its behavior and targeting (e.g., Standard, DSA, Smart). |
dimension |
The type of the ad group, which defines its category and serving behavior (e.g., standard search, display, or video ad groups). |
dimension |
||
ad_group.url_custom_parameters |
Ad group URL custom parameters |
A list of custom parameters that can be appended to URLs for additional tracking information. |
dimension |
ad_group_ad.action_items |
Recommendations for Ad strength |
Recommendations or action items for improving the strength and performance of an ad. |
dimension |
ad_group_ad.ad.added_by_google_ads |
Auto-applied ad suggestion |
Indicates whether the ad was automatically created or added by Google Ads. |
dimension |
ad_group_ad.ad.app_ad.descriptions |
Universal app ad descriptions |
The descriptive texts used for a Universal App ad. |
dimension |
ad_group_ad.ad.app_ad.headlines |
Universal app ad headlines |
The headlines used for a Universal App ad. |
dimension |
ad_group_ad.ad.app_ad.html5_media_bundles |
Universal app ad HTML5 media bundles |
HTML5 media bundles used as creative assets for a Universal App ad. |
dimension |
ad_group_ad.ad.app_ad.images |
Universal app ad images |
Image assets used for a Universal App ad. |
dimension |
ad_group_ad.ad.app_ad.mandatory_ad_text |
Universal app ad mandatory ad text |
Mandatory text content for a Universal App ad. |
dimension |
ad_group_ad.ad.app_ad.youtube_videos |
Universal app ad Youtube videos |
YouTube video assets used for a Universal App ad. |
dimension |
ad_group_ad.ad.app_engagement_ad.descriptions |
App engagement ad descriptions |
The descriptive texts used for an App engagement ad. |
dimension |
ad_group_ad.ad.app_engagement_ad.headlines |
App engagement ad headlines |
The headlines used for an App engagement ad. |
dimension |
ad_group_ad.ad.app_engagement_ad.images |
App engagement ad images |
Image assets used for an App engagement ad. |
dimension |
ad_group_ad.ad.app_engagement_ad.videos |
App engagement ad videos |
Video assets used for an App engagement ad. |
dimension |
ad_group_ad.ad.app_pre_registration_ad.descriptions |
App pre-registration ad description |
The descriptive texts used for an App pre-registration ad. |
dimension |
ad_group_ad.ad.app_pre_registration_ad.headlines |
App pre-registration ad headlines |
The headlines used for an App pre-registration ad. |
dimension |
ad_group_ad.ad.app_pre_registration_ad.images |
App pre-registration ad images |
Image assets used for an App pre-registration ad. |
dimension |
ad_group_ad.ad.app_pre_registration_ad.youtube_videos |
App pre-registration ad youtube videos |
YouTube video assets used for an App pre-registration ad. |
dimension |
ad_group_ad.ad.call_ad.business_name |
Call only ad business name |
The business name displayed in a call-only ad. |
dimension |
ad_group_ad.ad.call_ad.call_tracked |
Call only ad call tracked |
Indicates whether calls made from this call-only ad are tracked as conversions. |
dimension |
ad_group_ad.ad.call_ad.conversion_action |
Call only ad conversion action |
The resource name of the conversion action that tracks calls from this call-only ad. |
dimension |
ad_group_ad.ad.call_ad.conversion_reporting_state |
Call only ad conversion reporting state |
The reporting state for call conversions from this call-only ad. |
dimension |
ad_group_ad.ad.call_ad.country_code |
Call only ad country code |
The country code associated with the phone number in a Call ad. |
dimension |
ad_group_ad.ad.call_ad.description1 |
Call only ad description 1 |
The first line of descriptive text for a Call Ad, providing additional details about the advertised business or offering. |
dimension |
ad_group_ad.ad.call_ad.description2 |
Call only ad description 2 |
The second line of descriptive text for a Call Ad, offering further information to potential customers. |
dimension |
ad_group_ad.ad.call_ad.disable_call_conversion |
Call only ad disable call conversion |
Indicates whether call conversions are disabled for this specific Call Ad. |
dimension |
ad_group_ad.ad.call_ad.headline1 |
Call only ad headline 1 |
The first headline for a call-only ad. |
dimension |
ad_group_ad.ad.call_ad.headline2 |
Call only ad headline 2 |
The second headline for a Call Ad, used to provide more information or encourage engagement. |
dimension |
ad_group_ad.ad.call_ad.path1 |
Call only ad path 1 |
The first optional display URL path for a call-only ad. |
dimension |
ad_group_ad.ad.call_ad.path2 |
Call only ad path 2 |
The second optional display URL path for a call-only ad. |
dimension |
ad_group_ad.ad.call_ad.phone_number |
Call only ad phone number |
The phone number displayed in the Call Ad, which users can directly dial. |
dimension |
ad_group_ad.ad.call_ad.phone_number_verification_url |
Call only ad phone number verification URL |
The URL used for verifying the phone number in a Call ad, required if final URLs are empty. |
dimension |
ad_group_ad.ad.demand_gen_carousel_ad.business_name |
Demand gen carousel ad business name |
The name of the business or brand associated with the Demand Gen carousel ad. |
dimension |
ad_group_ad.ad.demand_gen_carousel_ad.call_to_action_text |
Demand gen carousel ad call to action text |
The text for the call to action button displayed on the Demand Gen carousel ad, prompting users to take a specific action. |
dimension |
ad_group_ad.ad.demand_gen_carousel_ad.carousel_cards |
Demand gen carousel ad carousel cards |
A list of carousel cards (images or videos) displayed in a Demand Generation carousel ad. |
dimension |
ad_group_ad.ad.demand_gen_carousel_ad.description |
Demand gen carousel ad description |
The main descriptive text for the Demand Gen carousel ad. |
dimension |
ad_group_ad.ad.demand_gen_carousel_ad.headline |
Demand gen carousel ad headline |
The primary headline for the Demand Gen carousel ad. |
dimension |
ad_group_ad.ad.demand_gen_carousel_ad.logo_image |
Demand gen carousel ad logo |
The logo image asset associated with the Demand Gen carousel ad. |
dimension |
ad_group_ad.ad.demand_gen_multi_asset_ad.business_name |
Demand gen multi asset ad business name |
The name of the business or brand associated with the Demand Gen multi-asset ad. |
dimension |
ad_group_ad.ad.demand_gen_multi_asset_ad.call_to_action_text |
Demand gen multi asset ad call to action text |
The text for the call to action button displayed on the Demand Gen multi-asset ad. |
dimension |
ad_group_ad.ad.demand_gen_multi_asset_ad.descriptions |
Demand gen multi asset ad descriptions |
A list of descriptive texts used in the Demand Gen multi-asset ad. |
dimension |
ad_group_ad.ad.demand_gen_multi_asset_ad.headlines |
Demand gen multi asset ad headlines |
A list of headlines used in the Demand Gen multi-asset ad. |
dimension |
ad_group_ad.ad.demand_gen_multi_asset_ad.lead_form_only |
Demand gen multi asset ad lead form only |
Indicates whether the Demand Gen multi-asset ad is configured as a lead form only ad. |
dimension |
ad_group_ad.ad.demand_gen_multi_asset_ad.logo_images |
Demand gen multi asset ad logo |
A list of logo image assets used in the Demand Gen multi-asset ad. |
dimension |
ad_group_ad.ad.demand_gen_multi_asset_ad.marketing_images |
Demand gen multi asset ad marketing images |
A list of marketing image assets used in the Demand Gen multi-asset ad. |
dimension |
ad_group_ad.ad.demand_gen_multi_asset_ad.portrait_marketing_images |
Demand gen multi asset ad portrait marketing images |
A list of portrait-oriented marketing image assets used in the Demand Gen multi-asset ad. |
dimension |
ad_group_ad.ad.demand_gen_multi_asset_ad.square_marketing_images |
Demand gen multi asset ad square marketing images |
A list of square-oriented marketing image assets used in the Demand Gen multi-asset ad. |
dimension |
ad_group_ad.ad.demand_gen_video_responsive_ad.breadcrumb1 |
Responsive demand gen video ad breadcrumb 1 |
The first breadcrumb text for a responsive Demand Generation video ad, used in the display URL path. |
dimension |
ad_group_ad.ad.demand_gen_video_responsive_ad.breadcrumb2 |
Responsive demand gen video ad breadcrumb 2 |
The second breadcrumb text for a responsive Demand Generation video ad, used in the display URL path. |
dimension |
ad_group_ad.ad.demand_gen_video_responsive_ad.business_name |
Responsive demand gen video ad business name |
The name of the business or brand associated with the Demand Gen video responsive ad. |
dimension |
ad_group_ad.ad.demand_gen_video_responsive_ad.call_to_actions |
Responsive demand gen video ad call to actions |
A list of call-to-action assets used in the Demand Gen video responsive ad. |
dimension |
ad_group_ad.ad.demand_gen_video_responsive_ad.descriptions |
Responsive demand gen video ad descriptions |
A list of descriptive texts used in the Demand Gen video responsive ad. |
dimension |
ad_group_ad.ad.demand_gen_video_responsive_ad.headlines |
Responsive demand gen video ad headlines |
A list of headlines used in the Demand Gen video responsive ad. |
dimension |
ad_group_ad.ad.demand_gen_video_responsive_ad.logo_images |
Responsive demand gen video ad logo |
A list of logo image assets used in the Demand Gen video responsive ad. |
dimension |
ad_group_ad.ad.demand_gen_video_responsive_ad.long_headlines |
Responsive demand gen video ad long headlines |
A list of long headlines used in the Demand Gen video responsive ad. |
dimension |
ad_group_ad.ad.demand_gen_video_responsive_ad.videos |
Responsive demand gen video ad videos |
A list of video assets used in the Demand Gen video responsive ad. |
dimension |
ad_group_ad.ad.device_preference |
Device preference |
The device preference setting for an ad, indicating whether it is optimized for mobile devices or all devices. |
dimension |
ad_group_ad.ad.display_upload_ad.display_upload_product_type |
Ad product type |
The product type for a display upload ad, such as HTML5_UPLOAD_AD, which specifies the format of the uploaded creative. |
dimension |
ad_group_ad.ad.display_upload_ad.media_bundle |
Media bundle |
The media bundle asset (e.g., an HTML5 zip file) for a display upload ad. |
dimension |
ad_group_ad.ad.display_url |
Display URL |
The URL that is displayed in the ad to users, often a simplified or user-friendly version of the final URL. |
dimension |
ad_group_ad.ad.expanded_dynamic_search_ad.description |
Expanded dynamic search ad description |
The primary description line for an Expanded Dynamic Search Ad. |
dimension |
ad_group_ad.ad.expanded_dynamic_search_ad.description2 |
Expanded dynamic search ad description 2 |
The second description line for an Expanded Dynamic Search Ad. |
dimension |
ad_group_ad.ad.expanded_text_ad.description |
Description |
The primary description text for an expanded text ad. |
dimension |
ad_group_ad.ad.expanded_text_ad.description2 |
Expanded text ad description 2 |
The second line of description text for an Expanded Text Ad. |
dimension |
ad_group_ad.ad.expanded_text_ad.headline_part1 |
Headline 1 |
The first headline text for an expanded text ad. |
dimension |
ad_group_ad.ad.expanded_text_ad.headline_part2 |
Headline 2 |
The second headline text for an expanded text ad. |
dimension |
ad_group_ad.ad.expanded_text_ad.headline_part3 |
Expanded text ad headline 3 |
The third optional headline part of an Expanded Text Ad, which can appear on wider screens. |
dimension |
ad_group_ad.ad.expanded_text_ad.path1 |
Path 1 |
The first optional path segment appended to the display URL of an Expanded Text Ad. |
dimension |
ad_group_ad.ad.expanded_text_ad.path2 |
Path 2 |
The second optional path segment appended to the display URL of an Expanded Text Ad. |
dimension |
ad_group_ad.ad.final_app_urls |
Final app URLs |
A list of final URLs used for deep linking into a mobile application when a user has the specific app installed. |
dimension |
ad_group_ad.ad.final_mobile_urls |
Mobile final URL |
A list of final URLs specifically optimized for mobile devices, used as landing pages when an ad is clicked on a mobile device. |
dimension |
ad_group_ad.ad.final_url_suffix |
Ad Final URL suffix |
An optional string that is appended to the end of the final URL, used for additional tracking parameters, especially with parallel tracking. |
dimension |
ad_group_ad.ad.final_urls |
Final URL |
A list of actual landing pages for the ad, keyword, or sitelink, representing the URL a user ultimately sees after clicking the ad. |
dimension |
ad_group_ad.ad.final_urls.{NUM} |
ad_group_ad.ad.final_urls.{NUM} |
A list of possible final URLs for the ad after all cross-domain redirects have occurred. |
dimension |
ad_group_ad.ad.hotel_ad |
Hotel ad details |
Container for Hotel Ad details, which are automatically generated based on hotel listings and prices to target travelers with availability, pricing, and booking options. |
dimension |
ad_group_ad.ad.id |
Ad ID |
The unique identifier for the ad. |
dimension |
ad_group_ad.ad.image_ad.image_url |
Image ad URL |
The URL of the image asset used in an image ad. |
dimension |
ad_group_ad.ad.image_ad.mime_type |
Image mime type |
The MIME type of the image asset used in an Image Ad, indicating its format (e.g., image/jpeg, image/png). |
dimension |
ad_group_ad.ad.image_ad.name |
Image ad name |
The name of the image asset used in an image ad. If the image was created from a MediaFile, this is the MediaFile’s name; otherwise, it can be empty. |
dimension |
ad_group_ad.ad.image_ad.pixel_height |
Image height |
The height of the image asset in pixels, used in an Image Ad. |
dimension |
ad_group_ad.ad.image_ad.pixel_width |
Image width |
The width of the image asset in pixels, used in an Image Ad. |
dimension |
ad_group_ad.ad.image_ad.preview_image_url |
Image ad preview image URL |
The URL for a preview version of the image asset used in an Image Ad. |
dimension |
ad_group_ad.ad.image_ad.preview_pixel_height |
Image ad preview image height (px) |
The height of the preview image in pixels for an Image Ad. |
dimension |
ad_group_ad.ad.image_ad.preview_pixel_width |
Image ad preview image width (px) |
The width of the preview image in pixels for an Image Ad. |
dimension |
ad_group_ad.ad.legacy_app_install_ad |
Legacy app install ID |
The legacy app install ad object, which provides details about the app being promoted. |
dimension |
ad_group_ad.ad.legacy_responsive_display_ad.accent_color |
Accent color (responsive) |
The accent color used for a legacy responsive display ad. |
dimension |
ad_group_ad.ad.legacy_responsive_display_ad.allow_flexible_color |
Allow flexible color (responsive) |
Indicates whether the legacy responsive display ad is allowed to serve with different colors than specified if necessary. |
dimension |
ad_group_ad.ad.legacy_responsive_display_ad.business_name |
Business name |
The business name displayed in a legacy responsive display ad. |
dimension |
ad_group_ad.ad.legacy_responsive_display_ad.call_to_action_text |
Call to action text (responsive) |
The call to action text used in a legacy responsive display ad. |
dimension |
ad_group_ad.ad.legacy_responsive_display_ad.description |
Description (responsive) |
The description text for a legacy responsive display ad. |
dimension |
ad_group_ad.ad.legacy_responsive_display_ad.format_setting |
Ad format preference (responsive) |
The format setting that determines how the legacy responsive display ad is rendered (e.g., native or non-native). |
dimension |
ad_group_ad.ad.legacy_responsive_display_ad.logo_image |
Landscape logo ID (responsive) |
The resource ID of the landscape logo image used in a legacy responsive display ad. |
dimension |
ad_group_ad.ad.legacy_responsive_display_ad.long_headline |
Long headline |
The longer headline text for a legacy responsive display ad, offering more descriptive space. |
dimension |
ad_group_ad.ad.legacy_responsive_display_ad.main_color |
Main color (responsive) |
The main color used for a legacy responsive display ad, specified in hexadecimal RGB format. |
dimension |
ad_group_ad.ad.legacy_responsive_display_ad.marketing_image |
Image ID (responsive) |
The resource ID of the marketing image used in a legacy responsive display ad. |
dimension |
ad_group_ad.ad.legacy_responsive_display_ad.price_prefix |
Price prefix (responsive) |
The text that appears before the price in a legacy responsive display ad (e.g., ‘From’, ‘Up to’). |
dimension |
ad_group_ad.ad.legacy_responsive_display_ad.promo_text |
Promotion text (responsive) |
The promotional text used in a legacy responsive display ad. |
dimension |
ad_group_ad.ad.legacy_responsive_display_ad.short_headline |
Short headline |
The short headline text for a legacy responsive display ad. |
dimension |
ad_group_ad.ad.legacy_responsive_display_ad.square_logo_image |
Logo ID (responsive) |
The resource ID of the square logo image used in a legacy responsive display ad. |
dimension |
ad_group_ad.ad.legacy_responsive_display_ad.square_marketing_image |
Square image ID (responsive) |
The resource ID of the square marketing image used in a legacy responsive display ad. |
dimension |
ad_group_ad.ad.local_ad.call_to_actions |
Local ad call to actions |
A list of call to action assets used in a local ad. |
dimension |
ad_group_ad.ad.local_ad.descriptions |
Local ad descriptions |
A list of description assets used in a local ad. |
dimension |
ad_group_ad.ad.local_ad.headlines |
Local ad headlines |
A list of headline assets used in a local ad. |
dimension |
ad_group_ad.ad.local_ad.logo_images |
Local ad logo |
A list of logo image assets used in a local ad. |
dimension |
ad_group_ad.ad.local_ad.marketing_images |
Local ad marketing images |
A list of marketing image assets used in a local ad. |
dimension |
ad_group_ad.ad.local_ad.path1 |
Local ad path 1 |
The first optional display URL path for a local ad. |
dimension |
ad_group_ad.ad.local_ad.path2 |
Local ad path 2 |
The second optional display URL path for a local ad. |
dimension |
ad_group_ad.ad.local_ad.videos |
Local ad videos |
A list of video assets used in a local ad. |
dimension |
ad_group_ad.ad.name |
Ad name |
The name given to the ad. |
dimension |
ad_group_ad.ad.resource_name |
Ad resource name |
The resource name of the ad, which uniquely identifies this ad. |
dimension |
ad_group_ad.ad.responsive_display_ad.accent_color |
Accent color (multi asset responsive display) |
The accent color used for a multi-asset responsive display ad. |
dimension |
ad_group_ad.ad.responsive_display_ad.allow_flexible_color |
Allow flexible color (multi asset responsive display) |
Indicates whether the responsive display ad is allowed to serve with different colors than specified if necessary. |
dimension |
ad_group_ad.ad.responsive_display_ad.business_name |
Business name (multi asset responsive display) |
The business name displayed in a responsive display ad. |
dimension |
ad_group_ad.ad.responsive_display_ad.call_to_action_text |
Call to action text (multi asset responsive display) |
The call to action text used in a responsive display ad. |
dimension |
ad_group_ad.ad.responsive_display_ad.control_spec.enable_asset_enhancements |
Enable asset enhancements responsive |
Indicates whether asset enhancements are enabled for the responsive display ad. |
dimension |
ad_group_ad.ad.responsive_display_ad.control_spec.enable_autogen_video |
Enable autogen video responsive |
Indicates whether automatically generated videos are enabled for the responsive display ad. |
dimension |
ad_group_ad.ad.responsive_display_ad.descriptions |
Descriptions (multi asset responsive display) |
A list of description assets used in a responsive display ad. |
dimension |
ad_group_ad.ad.responsive_display_ad.format_setting |
Ad format preference (multi asset responsive display) |
The format setting that determines how the responsive display ad is rendered (e.g., native or non-native). |
dimension |
ad_group_ad.ad.responsive_display_ad.headlines |
Headlines (multi asset responsive display) |
A list of headline assets used in a responsive display ad. |
dimension |
ad_group_ad.ad.responsive_display_ad.logo_images |
Landscape logos (multi asset responsive display) |
A list of landscape logo image assets used in a responsive display ad. |
dimension |
ad_group_ad.ad.responsive_display_ad.long_headline |
Long headline (multi asset responsive display) |
The longer headline text for a responsive display ad, offering more descriptive space. |
dimension |
ad_group_ad.ad.responsive_display_ad.main_color |
Main color (multi asset responsive display) |
The main color used for a responsive display ad, specified in hexadecimal RGB format. |
dimension |
ad_group_ad.ad.responsive_display_ad.marketing_images |
Images (multi asset responsive display) |
A list of marketing image assets used in a responsive display ad. |
dimension |
ad_group_ad.ad.responsive_display_ad.marketing_images.asset_01.image_asset.full_size.url |
Image URL 01 (multi asset responsive display) |
The full-size URL of the first marketing image asset in a responsive display ad. |
dimension |
ad_group_ad.ad.responsive_display_ad.marketing_images.asset_02.image_asset.full_size.url |
Image URL 02 (multi asset responsive display) |
The full-size URL of the second marketing image asset in a responsive display ad. |
dimension |
ad_group_ad.ad.responsive_display_ad.marketing_images.asset_03.image_asset.full_size.url |
Image URL 03 (multi asset responsive display) |
The full-size URL of the third marketing image asset in a responsive display ad. |
dimension |
ad_group_ad.ad.responsive_display_ad.marketing_images.asset_04.image_asset.full_size.url |
Image URL 04 (multi asset responsive display) |
The full-size URL of the fourth marketing image asset in a responsive display ad. |
dimension |
ad_group_ad.ad.responsive_display_ad.marketing_images.asset_05.image_asset.full_size.url |
Image URL 05 (multi asset responsive display) |
The full-size URL of the fifth marketing image asset in a responsive display ad. |
dimension |
ad_group_ad.ad.responsive_display_ad.marketing_images.asset_06.image_asset.full_size.url |
Image URL 06 (multi asset responsive display) |
The full-size URL of the sixth marketing image asset in a responsive display ad. |
dimension |
ad_group_ad.ad.responsive_display_ad.marketing_images.asset_07.image_asset.full_size.url |
Image URL 07 (multi asset responsive display) |
The full-size URL of the seventh marketing image asset in a responsive display ad. |
dimension |
ad_group_ad.ad.responsive_display_ad.marketing_images.asset_08.image_asset.full_size.url |
Image URL 08 (multi asset responsive display) |
The full-size URL of the eighth marketing image asset in a responsive display ad. |
dimension |
ad_group_ad.ad.responsive_display_ad.marketing_images.asset_09.image_asset.full_size.url |
Image URL 09 (multi asset responsive display) |
The full-size URL of the ninth marketing image asset in a responsive display ad. |
dimension |
ad_group_ad.ad.responsive_display_ad.marketing_images.asset_10.image_asset.full_size.url |
Image URL 10 (multi asset responsive display) |
The full-size URL of the tenth marketing image asset in a responsive display ad. |
dimension |
ad_group_ad.ad.responsive_display_ad.marketing_images.asset_11.image_asset.full_size.url |
Image URL 11 (multi asset responsive display) |
The full-size URL of the eleventh marketing image asset in a responsive display ad. |
dimension |
ad_group_ad.ad.responsive_display_ad.marketing_images.asset_12.image_asset.full_size.url |
Image URL 12 (multi asset responsive display) |
The full-size URL of the twelfth marketing image asset in a responsive display ad. |
dimension |
ad_group_ad.ad.responsive_display_ad.marketing_images.asset_13.image_asset.full_size.url |
Image URL 13 (multi asset responsive display) |
The full-size URL of the thirteenth marketing image asset in a responsive display ad. |
dimension |
ad_group_ad.ad.responsive_display_ad.marketing_images.asset_14.image_asset.full_size.url |
Image URL 14 (multi asset responsive display) |
The full-size URL of the fourteenth marketing image asset in a responsive display ad. |
dimension |
ad_group_ad.ad.responsive_display_ad.marketing_images.asset_15.image_asset.full_size.url |
Image URL 15 (multi asset responsive display) |
The full-size URL of the fifteenth marketing image asset in a responsive display ad. |
dimension |
ad_group_ad.ad.responsive_display_ad.price_prefix |
Price prefix (multi asset responsive display) |
The text that appears before the price in a multi-asset responsive display ad. |
dimension |
ad_group_ad.ad.responsive_display_ad.promo_text |
Promotion text (multi asset responsive display) |
The promotional text used in a multi-asset responsive display ad. |
dimension |
ad_group_ad.ad.responsive_display_ad.square_logo_images |
Logos (multi asset responsive display) |
Logos used in a responsive display ad. Responsive display ads automatically adjust their size, appearance, and format to fit available ad spaces. |
dimension |
ad_group_ad.ad.responsive_display_ad.square_marketing_images |
Square images (multi asset responsive display) |
Square marketing images used in a responsive display ad, which adapts its creative to various ad placements. |
dimension |
ad_group_ad.ad.responsive_display_ad.square_marketing_images.asset_01.image_asset.full_size.url |
Square image URL 01 (multi asset responsive display) |
The URL of the first square marketing image asset for a responsive display ad. |
dimension |
ad_group_ad.ad.responsive_display_ad.square_marketing_images.asset_02.image_asset.full_size.url |
Square image URL 02 (multi asset responsive display) |
The URL of the second square marketing image asset for a responsive display ad. |
dimension |
ad_group_ad.ad.responsive_display_ad.square_marketing_images.asset_03.image_asset.full_size.url |
Square image URL 03 (multi asset responsive display) |
The URL of the third square marketing image asset for a responsive display ad. |
dimension |
ad_group_ad.ad.responsive_display_ad.square_marketing_images.asset_04.image_asset.full_size.url |
Square image URL 04 (multi asset responsive display) |
The URL of the fourth square marketing image asset for a responsive display ad. |
dimension |
ad_group_ad.ad.responsive_display_ad.square_marketing_images.asset_05.image_asset.full_size.url |
Square image URL 05 (multi asset responsive display) |
The URL of the fifth square marketing image asset for a responsive display ad. |
dimension |
ad_group_ad.ad.responsive_display_ad.square_marketing_images.asset_06.image_asset.full_size.url |
Square image URL 06 (multi asset responsive display) |
The URL of the sixth square marketing image asset for a responsive display ad. |
dimension |
ad_group_ad.ad.responsive_display_ad.square_marketing_images.asset_07.image_asset.full_size.url |
Square image URL 07 (multi asset responsive display) |
The URL of the seventh square marketing image asset used in a responsive display ad. |
dimension |
ad_group_ad.ad.responsive_display_ad.square_marketing_images.asset_08.image_asset.full_size.url |
Square image URL 08 (multi asset responsive display) |
The URL of the eighth square marketing image asset used in a responsive display ad. |
dimension |
ad_group_ad.ad.responsive_display_ad.square_marketing_images.asset_09.image_asset.full_size.url |
Square image URL 09 (multi asset responsive display) |
The URL of the ninth square marketing image asset for a responsive display ad. |
dimension |
ad_group_ad.ad.responsive_display_ad.square_marketing_images.asset_10.image_asset.full_size.url |
Square image URL 10 (multi asset responsive display) |
The URL of the tenth square marketing image asset used in a responsive display ad. |
dimension |
ad_group_ad.ad.responsive_display_ad.square_marketing_images.asset_11.image_asset.full_size.url |
Square image URL 11 (multi asset responsive display) |
The URL of the eleventh square marketing image asset used in a responsive display ad. |
dimension |
ad_group_ad.ad.responsive_display_ad.square_marketing_images.asset_12.image_asset.full_size.url |
Square image URL 12 (multi asset responsive display) |
The URL of the twelfth square marketing image asset used in a responsive display ad. |
dimension |
ad_group_ad.ad.responsive_display_ad.square_marketing_images.asset_13.image_asset.full_size.url |
Square image URL 13 (multi asset responsive display) |
The URL of the thirteenth square marketing image asset used in a responsive display ad. |
dimension |
ad_group_ad.ad.responsive_display_ad.square_marketing_images.asset_14.image_asset.full_size.url |
Square image URL 14 (multi asset responsive display) |
The URL of the fourteenth square marketing image asset used in a responsive display ad. |
dimension |
ad_group_ad.ad.responsive_display_ad.square_marketing_images.asset_15.image_asset.full_size.url |
Square image URL 15 (multi asset responsive display) |
The URL of the fifteenth square marketing image asset used in a responsive display ad. |
dimension |
ad_group_ad.ad.responsive_display_ad.youtube_videos |
Youtube videos (multi asset responsive display) |
A collection of YouTube video assets used in a responsive display ad. |
dimension |
ad_group_ad.ad.responsive_search_ad.descriptions |
Responsive search ad descriptions |
The descriptions for a responsive search ad, which can be dynamically combined by Google Ads. |
dimension |
ad_group_ad.ad.responsive_search_ad.headlines |
Responsive search ad headlines |
The headlines for a responsive search ad, which can be dynamically combined by Google Ads. |
dimension |
ad_group_ad.ad.responsive_search_ad.path1 |
Responsive search ad path 1 |
The first optional display path for a responsive search ad URL. |
dimension |
ad_group_ad.ad.responsive_search_ad.path2 |
Responsive search ad path 2 |
The second optional display path for a responsive search ad URL. |
dimension |
ad_group_ad.ad.shopping_comparison_listing_ad.headline |
Comparison listing ad headline |
The headline for a Shopping Comparison Listing Ad, used to promote products from multiple merchants. |
dimension |
ad_group_ad.ad.shopping_product_ad |
Product ad details |
Details pertaining to a Shopping Product Ad. |
dimension |
ad_group_ad.ad.shopping_smart_ad |
Smart shopping ad details |
Details pertaining to a Smart Shopping Ad. |
dimension |
ad_group_ad.ad.smart_campaign_ad.descriptions |
Smart campaign ad descriptions |
The descriptions for a Smart Campaign Ad. |
dimension |
ad_group_ad.ad.smart_campaign_ad.headlines |
Smart campaign ad headlines |
The headlines for a Smart Campaign Ad. |
dimension |
ad_group_ad.ad.system_managed_resource_source |
System managed entity source |
The source indicating whether an ad resource is managed automatically by the Google Ads system or provided by the advertiser. |
dimension |
ad_group_ad.ad.text_ad.description1 |
Description line 1 |
The first description line for a standard text ad. |
dimension |
ad_group_ad.ad.text_ad.description2 |
Description line 2 |
The second description line for a standard text ad. |
dimension |
ad_group_ad.ad.text_ad.headline |
Ad headline |
The headline for a standard text ad. |
dimension |
ad_group_ad.ad.tracking_url_template |
Ad tracking URL template |
The URL template used for tracking clicks on the ad. |
dimension |
ad_group_ad.ad.travel_ad |
Travel ad |
Details pertaining to a Travel Ad, used for promoting travel-related products or services. |
dimension |
ad_group_ad.ad.type |
Ad type |
The type of the ad, such as Text Ad, Responsive Search Ad, or Video Ad. |
dimension |
ad_group_ad.ad.url_collections |
Ad URL collections |
A collection of URLs for the ad, including final URLs, mobile URLs, and tracking URLs. |
dimension |
ad_group_ad.ad.url_custom_parameters |
Ad URL customer parameters |
Custom parameters that can be appended to the ad’s URL for tracking or dynamic content. |
dimension |
ad_group_ad.ad.video_ad.bumper.action_button_label |
Bumper ad CTA label |
The call-to-action button label for a bumper video ad. |
dimension |
ad_group_ad.ad.video_ad.bumper.action_headline |
Bumper ad CTA headline |
The call-to-action headline for a bumper video ad. |
dimension |
ad_group_ad.ad.video_ad.in_feed.description1 |
In-feed ad description 1 |
The first description line for an in-feed video ad. |
dimension |
ad_group_ad.ad.video_ad.in_feed.description2 |
In-feed ad description 2 |
The second description line for an in-feed video ad. |
dimension |
ad_group_ad.ad.video_ad.in_feed.headline |
In-feed ad headline |
The headline for an in-feed video ad. |
dimension |
ad_group_ad.ad.video_ad.in_feed.thumbnail |
In-feed ad thumbnail |
The thumbnail image for an in-feed video ad. |
dimension |
ad_group_ad.ad.video_ad.in_stream.action_button_label |
In-stream ad CTA label |
The call-to-action button label for an in-stream video ad. |
dimension |
ad_group_ad.ad.video_ad.in_stream.action_headline |
In-stream ad CTA headline |
The call-to-action headline for an in-stream video ad. |
dimension |
ad_group_ad.ad.video_ad.non_skippable.action_button_label |
Non-skippable ad CTA label |
The call-to-action button label for a non-skippable in-stream video ad. |
dimension |
ad_group_ad.ad.video_ad.non_skippable.action_headline |
Non-skippable ad CTA headline |
The call-to-action headline for a non-skippable in-stream video ad. |
dimension |
ad_group_ad.ad.video_ad.out_stream.description |
Outstream video description |
The description for an outstream video ad. |
dimension |
ad_group_ad.ad.video_ad.out_stream.headline |
Outstream video headline |
The headline for an outstream video ad. |
dimension |
ad_group_ad.ad.video_responsive_ad.breadcrumb1 |
Responsive video ad breadcrumb 1 |
The first breadcrumb for the responsive video ad’s display URL. |
dimension |
ad_group_ad.ad.video_responsive_ad.breadcrumb2 |
Responsive video ad breadcrumb 2 |
The second breadcrumb for the responsive video ad’s display URL. |
dimension |
ad_group_ad.ad.video_responsive_ad.call_to_actions |
Responsive video ad call to action |
A collection of call-to-action elements for a responsive video ad. |
dimension |
ad_group_ad.ad.video_responsive_ad.companion_banners |
Responsive video ad companion banners |
A collection of companion banners for a responsive video ad. |
dimension |
ad_group_ad.ad.video_responsive_ad.descriptions |
Responsive video ad descriptions |
The descriptions for a responsive video ad. |
dimension |
ad_group_ad.ad.video_responsive_ad.headlines |
Responsive video ad headlines |
The short headlines for a responsive video ad. |
dimension |
ad_group_ad.ad.video_responsive_ad.long_headlines |
Responsive video ad long headlines |
The long headlines for a responsive video ad. |
dimension |
ad_group_ad.ad.video_responsive_ad.videos |
Responsive video ad videos |
A collection of video assets for a responsive video ad. |
dimension |
ad_group_ad.ad_group |
ad_group_ad.ad_group |
The ad group to which the ad group ad belongs. This field provides a reference to the parent ad group object. |
dimension |
ad_group_ad.ad_strength |
Ad strength |
An indicator of the relevance, quality, and diversity of the ad’s creative assets. |
dimension |
ad_group_ad.labels |
Ad group ad labels |
A list of labels applied to the ad group ad for organizational purposes. |
dimension |
ad_group_ad.policy_summary.approval_status |
Ad policy approval status |
The approval status of the ad based on Google Ads policies. |
dimension |
ad_group_ad.policy_summary.policy_topic_entries |
Ad policy topic entries |
A list of policy topics and their corresponding details that caused the ad to be disapproved or limited. |
dimension |
ad_group_ad.policy_summary.review_status |
Policy information review status |
The current review status of the ad’s policy information. |
dimension |
ad_group_ad.primary_status |
Ad primary status |
The primary overall status of the ad, indicating if it’s eligible to serve. |
dimension |
ad_group_ad.primary_status_reasons |
Ad primary status reasons |
A list of reasons contributing to the ad’s primary status, especially if it’s not serving. |
dimension |
ad_group_ad.resource_name |
Ad group ad resource name |
The resource name of the ad group ad in the Google Ads API, uniquely identifying it. |
dimension |
ad_group_ad.status |
Ad state |
The current serving status of the ad, such as enabled, paused, or removed. |
dimension |
ad_group_ad_asset_view.ad_group_ad |
Ad asset view ad group |
The resource name of the ad group ad associated with this asset view. |
dimension |
ad_group_ad_asset_view.asset |
Ad asset view ad asset |
The resource name of the asset associated with this ad group ad asset view. |
dimension |
ad_group_ad_asset_view.field_type |
Ad asset field type |
The type of asset field, indicating where the asset is used within the ad (e.g., HEADLINE, DESCRIPTION). |
dimension |
ad_group_ad_asset_view.performance_label |
Ad asset view performance label |
The performance label for the asset when used in the ad, such as ‘Best’, ‘Good’, or ‘Low’. |
dimension |
ad_group_ad_asset_view.policy_summary |
Ad asset view policy summary |
Summary of policy information for the asset within the context of the ad group ad. |
dimension |
ad_group_ad_asset_view.resource_name |
Ad asset view resource name |
The resource name of the ad group ad asset view, uniquely identifying the link between an ad, an asset, and its field type. |
dimension |
ad_group_ad_label.label |
Ad group ad label |
The resource name of the label associated with the ad group ad. |
dimension |
ad_group_ad_label.resource_name |
Ad group ad label resource name |
The resource name of the ad group ad label, uniquely identifying the label assigned to an ad group ad. |
dimension |
ad_group_asset.ad_group |
Ad Group Asset ad group |
The resource name of the ad group associated with this ad group asset. |
dimension |
ad_group_asset.asset |
Ad Group Asset asset |
The resource name of the asset associated with this ad group asset. |
dimension |
ad_group_asset.field_type |
Ad Group Asset field type |
The type of asset field, indicating where the asset is used within the ad group (e.g., SITELINK, CALLOUT). |
dimension |
ad_group_asset.primary_status |
Ad Group Asset primary status |
The primary overall status of the asset within the ad group, indicating if it’s eligible to serve. |
dimension |
ad_group_asset.primary_status_details |
Ad Group Asset primary status details |
Additional details about the primary status of the asset within the ad group. |
dimension |
ad_group_asset.primary_status_reasons |
Ad Group Asset primary status reasons |
A list of reasons contributing to the asset’s primary status within the ad group, especially if it’s not serving. |
dimension |
ad_group_asset.resource_name |
Ad Group Asset resource name |
The resource name of the ad group asset, uniquely identifying the link between an ad group and an asset. |
dimension |
ad_group_asset.source |
Ad Group Asset source |
The source of the ad group asset, such as advertiser-provided or automatically generated. |
dimension |
ad_group_asset.status |
Ad Group Asset status |
The current status of the asset within the ad group, such as enabled, paused, or removed. |
dimension |
ad_group_audience_view.resource_name |
Audience view resource name |
The resource name for the ad group audience view, which provides performance data for audience targeting at the ad group level. |
dimension |
ad_group_bid_modifier.resource_name |
Ad group bid modifier resource name |
The resource name of the bid modifier for an ad group, used to adjust bids based on criteria like device or location. |
dimension |
ad_group_criterion.age_range.type |
Ad Group Criterion Age range type |
The type of age range criterion applied to the ad group, such as ‘Undetermined’ or specific age segments. |
dimension |
ad_group_criterion.approval_status |
Ad Group Criterion Approval Status |
The approval status of the ad group criterion based on Google Ads policies. |
dimension |
ad_group_criterion.bid_modifier |
Ad Group Criterion Bid Modifier |
The bid modifier value for the ad group criterion, which adjusts the base bid. |
dimension |
ad_group_criterion.cpc_bid_micros |
Ad Group CPC (cost-per-click) bid |
The maximum cost-per-click (CPC) bid amount, in micros, for the ad group criterion. |
dimension |
ad_group_criterion.criterion_id |
Ad Group Criterion ID |
The unique identifier of the ad group criterion. |
dimension |
ad_group_criterion.custom_affinity.custom_affinity |
ad_group_criterion.custom_affinity.custom_affinity |
The custom affinity audience targeted by an ad group criterion, which groups users based on their lifestyle and interests. |
dimension |
ad_group_criterion.custom_audience.custom_audience |
ad_group_criterion.custom_audience.custom_audience |
The custom audience targeted by an ad group criterion, allowing advertisers to reach specific user groups defined by interests, URLs, or apps. |
dimension |
ad_group_criterion.custom_intent.custom_intent |
ad_group_criterion.custom_intent.custom_intent |
The custom intent audience targeted by an ad group criterion, which groups users based on their active research and purchase intentions. |
dimension |
ad_group_criterion.disapproval_reasons |
Disapproval reasons |
A list of reasons why the ad group criterion was disapproved. |
dimension |
ad_group_criterion.display_name |
Ad Group Criterion display name |
The human-readable name of the ad group criterion. |
dimension |
ad_group_criterion.effective_cpc_bid_micros |
Ad Group Criterion The effective CPC (cost-per-click) bid |
The effective maximum cost-per-click (CPC) bid amount, in micros, after applying all bid adjustments, for the ad group criterion. |
dimension |
ad_group_criterion.effective_cpc_bid_source |
Ad Group Criterion effective CPC bid source |
The source of the effective CPC bid for the ad group criterion. |
dimension |
ad_group_criterion.effective_cpm_bid_micros |
Ad Group Criterion The effective CPM |
The effective maximum cost-per-thousand impressions (CPM) bid amount, in micros, after applying all bid adjustments, for the ad group criterion. |
dimension |
ad_group_criterion.effective_cpm_bid_source |
Ad Group Criterion effective CPM |
The source of the effective CPM bid for the ad group criterion. |
dimension |
ad_group_criterion.effective_cpv_bid_micros |
Ad Group Criterion The effective CPV (cost-per-view) bid |
The effective maximum cost-per-view (CPV) bid amount, in micros, after applying all bid adjustments, for the ad group criterion. |
dimension |
ad_group_criterion.effective_cpv_bid_source |
Ad Group Criterion Source of the effective CPV bid |
The source of the effective CPV bid for the ad group criterion. |
dimension |
ad_group_criterion.final_mobile_urls |
Ad Group Criterion final mobile URLs |
A list of final mobile URLs for the ad group criterion. |
dimension |
ad_group_criterion.final_url_suffix |
Ad Group Criterion URL template |
A suffix that will be appended to the final URL for the ad group criterion. |
dimension |
ad_group_criterion.final_urls |
Ad Group Criterion final URLs |
A list of final URLs for the ad group criterion. |
dimension |
ad_group_criterion.gender.type |
Ad Group Criterion Gender type |
The type of gender criterion applied to the ad group, such as ‘Male’, ‘Female’, or ‘Undetermined’. |
dimension |
ad_group_criterion.keyword.match_type |
Ad Group Criterion Keyword match type |
The match type of the keyword criterion, such as ‘Exact’, ‘Phrase’, or ‘Broad’. |
dimension |
ad_group_criterion.keyword.text |
Ad Group Criterion Keyword text |
The text of the keyword criterion. |
dimension |
ad_group_criterion.labels |
Ad Group Criterion labels |
A list of labels applied to the ad group criterion for organizational purposes. |
dimension |
ad_group_criterion.listing_group.case_value.product_brand.value |
Product group name |
The brand of a product within a listing group, used for product group targeting in Shopping campaigns. |
dimension |
ad_group_criterion.listing_group.parent_ad_group_criterion |
Ad Group Criterion Parent |
The resource name of the parent ad group criterion in a listing group hierarchy. |
dimension |
ad_group_criterion.listing_group.type |
Ad Group Criterion listing group type |
The type of listing group criterion, such as ‘Unit’ or ‘Subdivision’. |
dimension |
ad_group_criterion.negative |
Ad Group Criterion Is negative |
Indicates if the ad group criterion is negative, meaning it excludes certain traffic. |
dimension |
ad_group_criterion.parental_status.type |
Ad Group Criterion Parental status type |
The type of parental status criterion applied to the ad group, such as ‘Parent’ or ‘Not a Parent’. |
dimension |
ad_group_criterion.placement.url |
Ad Group Criterion Placement URL |
The URL of the placement criterion, targeting specific websites or apps. |
dimension |
ad_group_criterion.position_estimates.estimated_add_clicks_at_first_position_cpc |
Ad Group Criterion Estimated add clicks first position CPC |
Estimated additional clicks if the ad group criterion achieved a first position ranking for a given cost-per-click (CPC). |
dimension |
ad_group_criterion.position_estimates.estimated_add_cost_at_first_position_cpc |
Ad Group Criterion Estimated add cost first position CPC |
Estimated additional cost if the ad group criterion achieved a first position ranking for a given cost-per-click (CPC). |
dimension |
ad_group_criterion.position_estimates.first_page_cpc_micros |
Ad Group Criterion Estimate first page CPC bid |
An estimate of the CPC bid needed for the ad to show on the first page of search results, in micros. |
dimension |
ad_group_criterion.position_estimates.first_position_cpc_micros |
Ad Group Criterion Estimate first position CPC bid |
An estimate of the CPC bid needed for the ad to show in the first position of search results, in micros. |
dimension |
ad_group_criterion.position_estimates.top_of_page_cpc_micros |
Ad Group Criterion Estimate top of page CPC bid |
An estimate of the CPC bid needed for the ad to show at the top of the page of search results, in micros. |
dimension |
ad_group_criterion.quality_info.creative_quality_score |
Ad Group Criterion Creative quality score |
A score representing the quality and relevance of the creative assets for the ad group criterion. |
dimension |
ad_group_criterion.quality_info.post_click_quality_score |
Ad Group Criterion Landing page quality score |
A score representing the quality and relevance of the landing page experience for the ad group criterion. |
dimension |
ad_group_criterion.quality_info.quality_score |
Ad Group Criterion Quality score |
An aggregated score representing the overall quality of the ad group criterion (e.g., keyword relevance, landing page experience, expected CTR). |
dimension |
ad_group_criterion.quality_info.search_predicted_ctr |
Ad Group Criterion Predicted CTR |
The predicted click-through rate (CTR) for the ad group criterion on the Google Search Network. |
dimension |
ad_group_criterion.resource_name |
ad_group_criterion.resource_name |
This is the resource name for an ad group criterion, which represents a specific targeting setting (like a keyword or audience) applied to an ad group. |
dimension |
ad_group_criterion.status |
Ad Group Criterion Status |
The current status of the ad group criterion, such as enabled, paused, or removed. |
dimension |
ad_group_criterion.system_serving_status |
Ad Group Criterion Serving status |
The system-determined serving status of the ad group criterion. |
dimension |
ad_group_criterion.topic.path |
Ad Group Criterion Category |
The category path of the topic criterion, representing a hierarchical topic for targeting. |
dimension |
ad_group_criterion.topic.topic_constant |
Ad Group Criterion Topic Constant |
The resource name of the topic constant used for targeting in the ad group criterion. |
dimension |
ad_group_criterion.tracking_url_template |
Ad Group Criterion tracking URL template |
The URL template used for tracking clicks on the ad group criterion. |
dimension |
ad_group_criterion.type |
Ad Group Criterion Type |
The type of the ad group criterion, such as Keyword, Placement, or Audience. |
dimension |
This field specifies the type of the ad group criterion, such as a keyword, age range, gender, or placement. |
dimension |
||
ad_group_criterion.url_custom_parameters |
Ad Group Criterion URL custom parameters |
Custom parameters that can be appended to the criterion’s URL for tracking or dynamic content. |
dimension |
ad_group_criterion.user_interest.user_interest_category |
ad_group_criterion.user_interest.user_interest_category |
The user interest category targeted by an ad group criterion, allowing ads to reach users with specific interests. |
dimension |
ad_group_criterion.user_list.user_list |
Ad Group Criterion User List |
The resource name of the user list used for audience targeting in the ad group criterion. |
dimension |
ad_schedule_view.resource_name |
Ad schedule view resource name |
The resource name for the ad schedule view, which provides performance data broken down by ad schedule. |
dimension |
advertiser |
advertiser |
Refers to the Google Ads customer account associated with the campaigns and ads. |
dimension |
age_range_view.resource_name |
Age range view resource name |
The resource name for the age range view, which provides performance data broken down by age range targeting. |
dimension |
asset.book_on_google_asset |
Book on Google |
An asset specifically designed for booking services directly through Google platforms. |
dimension |
asset.call_asset.ad_schedule_targets |
Asset call asset ad schedule targets |
A list of ad schedule targets defining when the call asset is eligible to show. |
dimension |
asset.call_asset.call_conversion_action |
Asset call asset call conversion action |
The resource name of the conversion action to be counted when a call from this asset is considered a conversion. |
dimension |
asset.call_asset.call_conversion_reporting_state |
Asset call asset call conversion reporting state |
The reporting state of call conversions for this asset, indicating how calls are tracked as conversions. |
dimension |
asset.call_asset.country_code |
Asset call asset country code |
The country code of the phone number for the call asset. |
dimension |
asset.call_asset.phone_number |
Asset call asset phone number |
The phone number displayed in the call asset. |
dimension |
asset.call_to_action_asset.call_to_action |
Asset call to action asset call to action |
The call-to-action text for the call-to-action asset (e.g., ‘Shop Now’, ‘Learn More’). |
dimension |
asset.callout_asset.ad_schedule_targets |
Asset callout asset ad schedule targets |
A list of ad schedule targets defining when the callout asset is eligible to show. |
dimension |
asset.callout_asset.callout_text |
Asset callout asset callout text |
The text content of the callout asset. |
dimension |
asset.callout_asset.end_date |
Asset callout asset end date |
The last date on which the callout asset is eligible to serve. |
dimension |
asset.callout_asset.start_date |
Asset callout asset start date |
The first date on which the callout asset is eligible to serve. |
dimension |
asset.demand_gen_carousel_card_asset.call_to_action_text |
Asset demand gen carousel card asset call to action text |
The call-to-action text for a card within a Demand Gen carousel asset. |
dimension |
asset.demand_gen_carousel_card_asset.headline |
Asset demand gen carousel card asset headline |
The headline for a card within a Demand Gen carousel asset. |
dimension |
asset.demand_gen_carousel_card_asset.marketing_image_asset |
Asset demand gen carousel card asset marketing image asset |
The resource name of the marketing image asset used for a card within a Demand Gen carousel asset. |
dimension |
asset.demand_gen_carousel_card_asset.portrait_marketing_image_asset |
Asset demand gen carousel card asset portrait marketing image asset |
The resource name of the portrait marketing image asset used for a card within a Demand Gen carousel asset. |
dimension |
asset.demand_gen_carousel_card_asset.square_marketing_image_asset |
Asset demand gen carousel card asset square marketing image asset |
The resource name of the square marketing image asset used for a card within a Demand Gen carousel asset. |
dimension |
asset.dynamic_custom_asset.android_app_link |
Asset dynamic custom asset android app link |
An Android application link used within a dynamic custom asset, which can be populated from advertiser data feeds. |
dimension |
asset.dynamic_custom_asset.contextual_keywords |
Asset dynamic custom asset contextual keywords |
Keywords used for matching a dynamic custom asset to relevant content or searches. |
dimension |
asset.dynamic_custom_asset.formatted_price |
Asset dynamic custom asset formatted price |
The price of a custom dynamic asset, formatted for display in ads. |
dimension |
asset.dynamic_custom_asset.formatted_sale_price |
Asset dynamic custom asset formatted sale price |
The sale price of a custom dynamic asset, formatted for display in ads. |
dimension |
asset.dynamic_custom_asset.id |
Asset dynamic custom asset id |
The unique identifier for a custom dynamic asset. |
dimension |
asset.dynamic_custom_asset.id2 |
Asset dynamic custom asset id2 |
A secondary identifier for a dynamic custom asset. |
dimension |
asset.dynamic_custom_asset.image_url |
Asset dynamic custom asset image url |
The URL of the main image associated with the custom dynamic asset. |
dimension |
asset.dynamic_custom_asset.ios_app_link |
Asset dynamic custom asset ios app link |
The deep link URL for an iOS application related to the custom dynamic asset. |
dimension |
asset.dynamic_custom_asset.ios_app_store_id |
Asset dynamic custom asset ios app store id |
The App Store ID for an iOS application associated with the custom dynamic asset. |
dimension |
asset.dynamic_custom_asset.item_address |
Asset dynamic custom asset item address |
The physical address associated with the custom dynamic asset, if applicable. |
dimension |
asset.dynamic_custom_asset.item_category |
Asset dynamic custom asset item category |
The category of an item associated with a dynamic custom asset, often used for product or service feeds. |
dimension |
asset.dynamic_custom_asset.item_description |
Asset dynamic custom asset item description |
A descriptive text for the item represented by the custom dynamic asset. |
dimension |
asset.dynamic_custom_asset.item_subtitle |
Asset dynamic custom asset item subtitle |
The subtitle for an item associated with a dynamic custom asset. |
dimension |
asset.dynamic_custom_asset.item_title |
Asset dynamic custom asset item title |
The primary title for the item represented by the custom dynamic asset. |
dimension |
asset.dynamic_custom_asset.price |
Asset dynamic custom asset price |
The raw price of the item represented by the custom dynamic asset. |
dimension |
asset.dynamic_custom_asset.sale_price |
Asset dynamic custom asset sale price |
The raw sale price of the item represented by the custom dynamic asset, if the item is on sale. |
dimension |
asset.dynamic_custom_asset.similar_ids |
Asset dynamic custom asset similar ids |
A list of identifiers for similar items or assets related to a dynamic custom asset. |
dimension |
asset.dynamic_education_asset.address |
Asset dynamic education asset address |
The physical address of the educational institution or program. |
dimension |
asset.dynamic_education_asset.android_app_link |
Asset dynamic education asset android app link |
The deep link URL for an Android application related to the dynamic education asset. |
dimension |
asset.dynamic_education_asset.contextual_keywords |
Asset dynamic education asset contextual keywords |
Contextual keywords for a dynamic asset related to educational offerings, used for targeting. |
dimension |
asset.dynamic_education_asset.image_url |
Asset dynamic education asset image url |
The URL of the main image associated with the dynamic education asset. |
dimension |
asset.dynamic_education_asset.ios_app_link |
Asset dynamic education asset ios app link |
The deep link URL for an iOS application related to the dynamic education asset. |
dimension |
asset.dynamic_education_asset.ios_app_store_id |
Asset dynamic education asset ios app store id |
The App Store ID for an iOS application associated with the dynamic education asset. |
dimension |
asset.dynamic_education_asset.location_id |
Asset dynamic education asset location id |
The unique identifier for the location of the educational program. |
dimension |
asset.dynamic_education_asset.program_description |
Asset dynamic education asset program description |
A detailed description of the educational program. |
dimension |
asset.dynamic_education_asset.program_id |
Asset dynamic education asset program id |
The unique identifier for the educational program. |
dimension |
asset.dynamic_education_asset.program_name |
Asset dynamic education asset program name |
The name of the educational program. |
dimension |
asset.dynamic_education_asset.school_name |
Asset dynamic education asset school name |
The name of the school or institution offering the program. |
dimension |
asset.dynamic_education_asset.similar_program_ids |
Asset dynamic education asset similar program ids |
A list of IDs for similar educational programs, used for recommendations. |
dimension |
asset.dynamic_education_asset.subject |
Asset dynamic education asset subject |
The subject area of the educational program. |
dimension |
asset.dynamic_education_asset.thumbnail_image_url |
Asset dynamic education asset thumbnail image url |
The URL of a thumbnail image for a dynamic asset related to educational content. |
dimension |
asset.dynamic_flights_asset.android_app_link |
Asset dynamic flights asset android app link |
The deep link URL for an Android application related to the dynamic flights asset. |
dimension |
asset.dynamic_flights_asset.destination_id |
Asset dynamic flights asset destination id |
The unique identifier for the flight’s destination. |
dimension |
asset.dynamic_flights_asset.destination_name |
Asset dynamic flights asset destination name |
The name of the flight’s destination. |
dimension |
asset.dynamic_flights_asset.flight_description |
Asset dynamic flights asset flight description |
A description of the flight or flight deal. |
dimension |
asset.dynamic_flights_asset.flight_price |
Asset dynamic flights asset flight price |
The raw price of the flight. |
dimension |
asset.dynamic_flights_asset.flight_sale_price |
Asset dynamic flights asset flight sale price |
The raw sale price of the flight, if applicable. |
dimension |
asset.dynamic_flights_asset.formatted_price |
Asset dynamic flights asset formatted price |
The price of the flight, formatted for display in ads. |
dimension |
asset.dynamic_flights_asset.formatted_sale_price |
Asset dynamic flights asset formatted sale price |
The sale price of the flight, formatted for display in ads. |
dimension |
asset.dynamic_flights_asset.image_url |
Asset dynamic flights asset image url |
The URL of the main image associated with the dynamic flights asset. |
dimension |
asset.dynamic_flights_asset.ios_app_link |
Asset dynamic flights asset ios app link |
The deep link URL for an iOS application related to the dynamic flights asset. |
dimension |
asset.dynamic_flights_asset.ios_app_store_id |
Asset dynamic flights asset ios app store id |
The App Store ID for an iOS application associated with the dynamic flights asset. |
dimension |
asset.dynamic_flights_asset.origin_id |
Asset dynamic flights asset origin id |
The unique identifier for the flight’s origin. |
dimension |
asset.dynamic_flights_asset.origin_name |
Asset dynamic flights asset origin name |
The name of the flight’s origin. |
dimension |
asset.dynamic_flights_asset.similar_destination_ids |
Asset dynamic flights asset similar destination ids |
Identifiers for similar flight destinations related to a dynamic flights asset. |
dimension |
asset.dynamic_hotels_and_rentals_asset.address |
Asset dynamic hotels and rentals asset address |
The physical address of the hotel or rental property. |
dimension |
asset.dynamic_hotels_and_rentals_asset.android_app_link |
Asset dynamic hotels and rentals asset android app link |
The deep link URL for an Android application related to the dynamic hotels and rentals asset. |
dimension |
asset.dynamic_hotels_and_rentals_asset.category |
Asset dynamic hotels and rentals asset category |
The category of the hotel or rental property (e.g., “hotel”, “apartment”, “villa”). |
dimension |
asset.dynamic_hotels_and_rentals_asset.contextual_keywords |
Asset dynamic hotels and rentals asset contextual keywords |
Contextual keywords for a dynamic asset related to hotels and rentals, used for targeting. |
dimension |
asset.dynamic_hotels_and_rentals_asset.description |
Asset dynamic hotels and rentals asset description |
A detailed description of the hotel or rental property. |
dimension |
asset.dynamic_hotels_and_rentals_asset.destination_name |
Asset dynamic hotels and rentals asset destination name |
The name of the destination where the hotel or rental property is located. |
dimension |
asset.dynamic_hotels_and_rentals_asset.formatted_price |
Asset dynamic hotels and rentals asset formatted price |
The price of the hotel or rental, formatted for display in ads. |
dimension |
asset.dynamic_hotels_and_rentals_asset.formatted_sale_price |
Asset dynamic hotels and rentals asset formatted sale price |
The sale price of the hotel or rental, formatted for display in ads. |
dimension |
asset.dynamic_hotels_and_rentals_asset.image_url |
Asset dynamic hotels and rentals asset image url |
The URL of the main image associated with the dynamic hotels and rentals asset. |
dimension |
asset.dynamic_hotels_and_rentals_asset.ios_app_link |
Asset dynamic hotels and rentals asset ios app link |
The deep link URL for an iOS application related to the dynamic hotels and rentals asset. |
dimension |
asset.dynamic_hotels_and_rentals_asset.ios_app_store_id |
Asset dynamic hotels and rentals asset ios app store id |
The App Store ID for an iOS application associated with the dynamic hotels and rentals asset. |
dimension |
asset.dynamic_hotels_and_rentals_asset.price |
Asset dynamic hotels and rentals asset price |
The raw price of the hotel or rental property. |
dimension |
asset.dynamic_hotels_and_rentals_asset.property_id |
Asset dynamic hotels and rentals asset property id |
The unique identifier for the hotel or rental property. |
dimension |
asset.dynamic_hotels_and_rentals_asset.property_name |
Asset dynamic hotels and rentals asset property name |
The name of the hotel or rental property. |
dimension |
asset.dynamic_hotels_and_rentals_asset.sale_price |
Asset dynamic hotels and rentals asset sale price |
The raw sale price of the hotel or rental property, if it is on sale. |
dimension |
asset.dynamic_hotels_and_rentals_asset.similar_property_ids |
Asset dynamic hotels and rentals asset similar property ids |
Identifiers for similar properties related to a dynamic hotels and rentals asset. |
dimension |
asset.dynamic_hotels_and_rentals_asset.star_rating |
Asset dynamic hotels and rentals asset star rating |
The star rating of the hotel property. |
dimension |
asset.dynamic_jobs_asset.address |
Asset dynamic jobs asset address |
The physical address of the job location. |
dimension |
asset.dynamic_jobs_asset.android_app_link |
Asset dynamic jobs asset android app link |
The deep link URL for an Android application related to the dynamic jobs asset. |
dimension |
asset.dynamic_jobs_asset.contextual_keywords |
Asset dynamic jobs asset contextual keywords |
Contextual keywords for a dynamic asset related to job listings, used for targeting. |
dimension |
asset.dynamic_jobs_asset.description |
Asset dynamic jobs asset description |
A detailed description of the job posting. |
dimension |
asset.dynamic_jobs_asset.image_url |
Asset dynamic jobs asset image url |
The URL of the main image associated with the dynamic jobs asset. |
dimension |
asset.dynamic_jobs_asset.ios_app_link |
Asset dynamic jobs asset ios app link |
The deep link URL for an iOS application related to the dynamic jobs asset. |
dimension |
asset.dynamic_jobs_asset.ios_app_store_id |
Asset dynamic jobs asset ios app store id |
The App Store ID for an iOS application associated with the dynamic jobs asset. |
dimension |
asset.dynamic_jobs_asset.job_category |
Asset dynamic jobs asset job category |
The category of the job (e.g., “Software Engineering”, “Marketing”). |
dimension |
asset.dynamic_jobs_asset.job_id |
Asset dynamic jobs asset job id |
The unique identifier for the job posting. |
dimension |
asset.dynamic_jobs_asset.job_subtitle |
Asset dynamic jobs asset job subtitle |
The subtitle for a job listing associated with a dynamic jobs asset. |
dimension |
asset.dynamic_jobs_asset.job_title |
Asset dynamic jobs asset job title |
The primary title of the job posting. |
dimension |
asset.dynamic_jobs_asset.location_id |
Asset dynamic jobs asset location id |
The unique identifier for the job’s location. |
dimension |
asset.dynamic_jobs_asset.salary |
Asset dynamic jobs asset salary |
The salary or salary range offered for the job. |
dimension |
asset.dynamic_jobs_asset.similar_job_ids |
Asset dynamic jobs asset similar job ids |
Identifiers for similar job listings related to a dynamic jobs asset. |
dimension |
asset.dynamic_local_asset.address |
Asset dynamic local asset address |
The physical address of the local deal or business. |
dimension |
asset.dynamic_local_asset.android_app_link |
Asset dynamic local asset android app link |
The deep link URL for an Android application related to the dynamic local asset. |
dimension |
asset.dynamic_local_asset.category |
Asset dynamic local asset category |
The category of the local deal or business. |
dimension |
asset.dynamic_local_asset.contextual_keywords |
Asset dynamic local asset contextual keywords |
Contextual keywords for a dynamic asset related to local businesses or deals, used for targeting. |
dimension |
asset.dynamic_local_asset.deal_id |
Asset dynamic local asset deal id |
The unique identifier for the local deal. |
dimension |
asset.dynamic_local_asset.deal_name |
Asset dynamic local asset deal name |
The name or title of the local deal. |
dimension |
asset.dynamic_local_asset.description |
Asset dynamic local asset description |
A detailed description of the local deal or business. |
dimension |
asset.dynamic_local_asset.formatted_price |
Asset dynamic local asset formatted price |
The price of the local deal, formatted for display in ads. |
dimension |
asset.dynamic_local_asset.formatted_sale_price |
Asset dynamic local asset formatted sale price |
The sale price of the local deal, formatted for display in ads. |
dimension |
asset.dynamic_local_asset.image_url |
Asset dynamic local asset image url |
The URL of the main image associated with the dynamic local asset. |
dimension |
asset.dynamic_local_asset.ios_app_link |
Asset dynamic local asset ios app link |
The deep link URL for an iOS application related to the dynamic local asset. |
dimension |
asset.dynamic_local_asset.ios_app_store_id |
Asset dynamic local asset ios app store id |
The App Store ID for an iOS application associated with the dynamic local asset. |
dimension |
asset.dynamic_local_asset.price |
Asset dynamic local asset price |
The raw price of the local deal. |
dimension |
asset.dynamic_local_asset.sale_price |
Asset dynamic local asset sale price |
The raw sale price of the local deal, if it is on sale. |
dimension |
asset.dynamic_local_asset.similar_deal_ids |
Asset dynamic local asset similar deal ids |
Identifiers for similar local deals related to a dynamic local asset. |
dimension |
asset.dynamic_local_asset.subtitle |
Asset dynamic local asset subtitle |
The subtitle for a local listing or deal associated with a dynamic local asset. |
dimension |
asset.dynamic_real_estate_asset.address |
Asset dynamic real estate asset address |
The physical address of the real estate listing. |
dimension |
asset.dynamic_real_estate_asset.android_app_link |
Asset dynamic real estate asset android app link |
The deep link URL for an Android application related to the dynamic real estate asset. |
dimension |
asset.dynamic_real_estate_asset.city_name |
Asset dynamic real estate asset city name |
The name of the city where the real estate property is located. |
dimension |
asset.dynamic_real_estate_asset.contextual_keywords |
Asset dynamic real estate asset contextual keywords |
Contextual keywords for a dynamic asset related to real estate listings, used for targeting. |
dimension |
asset.dynamic_real_estate_asset.description |
Asset dynamic real estate asset description |
A detailed description of the real estate listing. |
dimension |
asset.dynamic_real_estate_asset.formatted_price |
Asset dynamic real estate asset formatted price |
The price of the real estate listing, formatted for display in ads. |
dimension |
asset.dynamic_real_estate_asset.image_url |
Asset dynamic real estate asset image url |
The URL of the main image associated with the dynamic real estate asset. |
dimension |
asset.dynamic_real_estate_asset.ios_app_link |
Asset dynamic real estate asset ios app link |
The deep link URL for an iOS application related to the dynamic real estate asset. |
dimension |
asset.dynamic_real_estate_asset.ios_app_store_id |
Asset dynamic real estate asset ios app store id |
The App Store ID for an iOS application associated with the dynamic real estate asset. |
dimension |
asset.dynamic_real_estate_asset.listing_id |
Asset dynamic real estate asset listing id |
The unique identifier for the real estate listing. |
dimension |
asset.dynamic_real_estate_asset.listing_name |
Asset dynamic real estate asset listing name |
The name or title of the real estate listing. |
dimension |
asset.dynamic_real_estate_asset.listing_type |
Asset dynamic real estate asset listing type |
The type of real estate listing (e.g., “for sale”, “for rent”). |
dimension |
asset.dynamic_real_estate_asset.price |
Asset dynamic real estate asset price |
The raw price of the real estate listing. |
dimension |
asset.dynamic_real_estate_asset.property_type |
Asset dynamic real estate asset property type |
The type of property in the real estate listing (e.g., “house”, “apartment”, “land”). |
dimension |
asset.dynamic_real_estate_asset.similar_listing_ids |
Asset dynamic real estate asset similar listing ids |
Identifiers for similar real estate listings related to a dynamic real estate asset. |
dimension |
asset.dynamic_travel_asset.android_app_link |
Asset dynamic travel asset android app link |
The deep link URL for an Android application related to the dynamic travel asset. |
dimension |
asset.dynamic_travel_asset.category |
Asset dynamic travel asset category |
The category of the travel offering (e.g., “tour”, “activity”, “vacation package”). |
dimension |
asset.dynamic_travel_asset.contextual_keywords |
Asset dynamic travel asset contextual keywords |
Contextual keywords for a dynamic asset related to travel destinations or packages, used for targeting. |
dimension |
asset.dynamic_travel_asset.destination_address |
Asset dynamic travel asset destination address |
The physical address of the travel destination. |
dimension |
asset.dynamic_travel_asset.destination_id |
Asset dynamic travelasset destination id |
The unique identifier for the travel destination. |
dimension |
asset.dynamic_travel_asset.destination_name |
Asset dynamic travel asset destination name |
The name of the travel destination. |
dimension |
asset.dynamic_travel_asset.formatted_price |
Asset dynamic travel asset formatted price |
The price of the travel offering, formatted for display in ads. |
dimension |
asset.dynamic_travel_asset.formatted_sale_price |
Asset dynamic travel asset formatted sale price |
The sale price of the travel offering, formatted for display in ads. |
dimension |
asset.dynamic_travel_asset.image_url |
Asset dynamic travel asset image url |
The URL of the main image associated with the dynamic travel asset. |
dimension |
asset.dynamic_travel_asset.ios_app_link |
Asset dynamic travel asset ios app link |
The deep link URL for an iOS application related to the dynamic travel asset. |
dimension |
asset.dynamic_travel_asset.ios_app_store_id |
Asset dynamic travel asset ios app store id |
The App Store ID for an iOS application associated with the dynamic travel asset. |
dimension |
asset.dynamic_travel_asset.origin_id |
Asset dynamic travel asset origin id |
The unique identifier for the travel origin. |
dimension |
asset.dynamic_travel_asset.origin_name |
Asset dynamic travel asset origin name |
The name of the travel origin. |
dimension |
asset.dynamic_travel_asset.price |
Asset dynamic travel asset price |
The raw price of the travel offering. |
dimension |
asset.dynamic_travel_asset.sale_price |
Asset dynamic travel asset sale price |
The raw sale price of the travel offering, if it is on sale. |
dimension |
asset.dynamic_travel_asset.similar_destination_ids |
Asset dynamic travel asset similar destination ids |
Identifiers for similar travel destinations related to a dynamic travel asset. |
dimension |
asset.dynamic_travel_asset.title |
Asset dynamic travel asset title |
The primary title for the dynamic travel asset. |
dimension |
asset.field_type_policy_summaries |
Field type policy summaries |
Summaries of policy information related to the field types used within an asset, indicating compliance status. |
dimension |
asset.final_mobile_urls |
Asset final mobile urls |
The list of URLs that users are directed to when they click on the asset on a mobile device. |
dimension |
asset.final_url_suffix |
Asset final url suffix |
A suffix that is appended to the final URL, used for tracking parameters. |
dimension |
asset.final_urls |
Asset final urls |
The list of URLs that users are directed to when they click on the asset. |
dimension |
asset.hotel_callout_asset.language_code |
Asset hotel callout asset language code |
The language code of the text content within the hotel callout asset. |
dimension |
asset.hotel_callout_asset.text |
Asset hotel callout asset text |
The text content of the hotel callout asset, used to highlight specific features or offers. |
dimension |
asset.hotel_property_asset.hotel_address |
Hotel property asset hotel address |
The physical address of the hotel property. |
dimension |
asset.hotel_property_asset.hotel_name |
Hotel property asset hotel name |
The name of the hotel property associated with the asset. |
dimension |
asset.hotel_property_asset.place_id |
Hotel property asset place id |
The unique Google Place ID for the hotel property asset. |
dimension |
asset.id |
Asset ID |
The unique identifier for the asset. |
dimension |
asset.image_asset.file_size |
Full image file size |
The size of the image file in bytes. |
dimension |
asset.image_asset.full_size.height_pixels |
Full image height (px) |
The height of the image asset in pixels at its full size. |
dimension |
asset.image_asset.full_size.url |
Full image URL |
The URL where the full-size image asset can be accessed. |
dimension |
asset.image_asset.full_size.width_pixels |
Full image width (px) |
The width of the image asset in pixels at its full size. |
dimension |
asset.image_asset.mime_type |
Image media type |
The MIME type of the image asset (e.g., ‘image/jpeg’, ‘image/png’). |
dimension |
asset.lead_form_asset.background_image_asset |
Asset lead form asset background image asset |
The background image asset used for the lead form. |
dimension |
asset.lead_form_asset.business_name |
Asset lead form asset business name |
The business name displayed in the lead form asset. |
dimension |
asset.lead_form_asset.call_to_action_description |
Asset lead form asset call to action description |
A descriptive text for the call to action on the lead form. |
dimension |
asset.lead_form_asset.call_to_action_type |
Asset lead form asset call to action type |
The type of call to action presented on the lead form. |
dimension |
asset.lead_form_asset.custom_disclosure |
Asset lead form asset custom disclosure |
Custom legal or privacy disclosure text for the lead form. |
dimension |
asset.lead_form_asset.custom_question_fields |
Asset lead form asset custom question fields |
Custom questions included in a lead form asset, allowing advertisers to collect specific information from users. |
dimension |
asset.lead_form_asset.delivery_methods |
Asset lead form asset delivery methods |
The methods used to deliver submitted lead form data (e.g., webhooks). |
dimension |
asset.lead_form_asset.description |
Asset lead form asset description |
The description text displayed in the lead form asset. |
dimension |
asset.lead_form_asset.desired_intent |
Asset lead form asset desired intent |
The advertiser’s desired intent or goal for submissions received through a lead form asset. |
dimension |
asset.lead_form_asset.fields |
Asset lead form asset fields |
The collection of input fields presented to the user on the lead form (e.g., name, email, phone). |
dimension |
asset.lead_form_asset.headline |
Asset lead form asset headline |
The headline text displayed in the lead form asset. |
dimension |
asset.lead_form_asset.post_submit_call_to_action_type |
Asset lead form asset post submit call to action type |
The type of call to action displayed to the user after they submit the lead form. |
dimension |
asset.lead_form_asset.post_submit_description |
Asset lead form asset post submit description |
The description text displayed to the user after they submit the lead form. |
dimension |
asset.lead_form_asset.post_submit_headline |
Asset lead form asset post submit headline |
The headline text displayed to the user after they submit the lead form. |
dimension |
asset.lead_form_asset.privacy_policy_url |
Asset lead form asset privacy policy url |
The URL to the privacy policy associated with the lead form. |
dimension |
asset.location_asset.business_profile_locations |
Location asset business profile locations |
Business profile locations associated with the location asset. |
dimension |
asset.location_asset.location_ownership_type |
Location asset location ownership type |
The ownership type of the location associated with a location asset (e.g., owned by the business, partner managed). |
dimension |
asset.location_asset.place_id |
Location asset place id |
The unique Google Place ID for the location asset. |
dimension |
asset.mobile_app_asset.app_id |
Asset mobile app asset app id |
The unique identifier for the mobile application linked as an asset. |
dimension |
asset.mobile_app_asset.app_store |
Asset mobile app asset app store |
The app store where the mobile application is available (e.g., Google Play, Apple App Store). |
dimension |
asset.mobile_app_asset.end_date |
Asset mobile app asset end date |
The date when the mobile app asset is scheduled to stop serving. |
dimension |
asset.mobile_app_asset.link_text |
Asset mobile app asset link text |
The text displayed as the link for the mobile app asset. |
dimension |
asset.mobile_app_asset.start_date |
Asset mobile app asset start date |
The date when the mobile app asset is scheduled to start serving. |
dimension |
asset.name |
Asset name |
The name given to the asset. |
dimension |
asset.page_feed_asset.labels |
Asset page feed asset labels |
Labels applied to a page feed asset for categorization and targeted advertising. |
dimension |
asset.page_feed_asset.page_url |
Asset page feed asset page url |
The URL of the page included in the page feed asset. |
dimension |
asset.policy_summary.approval_status |
Asset policy summary approval status |
The overall approval status of the asset based on policy review. |
dimension |
asset.policy_summary.policy_topic_entries |
Asset policy summary policy topic entries |
Details about specific policy topics or violations found during the asset review. |
dimension |
asset.policy_summary.review_status |
Asset policy summary review status |
The current review status of the asset by Google Ads policy teams. |
dimension |
asset.price_asset.language_code |
Asset price asset language code |
The language code of the price asset content. |
dimension |
asset.price_asset.price_offerings |
Asset price asset price offerings |
A list of price offerings or services included in the price asset. |
dimension |
asset.price_asset.price_qualifier |
Asset price asset price qualifier |
Text that qualifies the prices shown (e.g., ‘from’, ‘up to’). |
dimension |
asset.price_asset.type |
Asset price asset type |
The type of price asset, indicating what kind of offerings it displays. |
dimension |
asset.promotion_asset.ad_schedule_targets |
Asset promotion asset ad schedule targets |
Defines the days and times when the promotion asset is eligible to show. |
dimension |
asset.promotion_asset.discount_modifier |
Asset promotion asset discount modifier |
The modifier applied to the discount, such as ‘up to’ or ‘percent off’. |
dimension |
asset.promotion_asset.end_date |
Asset promotion asset end date |
The date when the promotion asset is scheduled to stop serving. |
dimension |
asset.promotion_asset.language_code |
Asset promotion asset language code |
The language code of the promotion asset content. |
dimension |
asset.promotion_asset.money_amount_off.amount_micros |
Asset promotion asset money amount off amount micros |
The monetary amount of the discount, in micros (one millionth of the currency unit). |
dimension |
asset.promotion_asset.money_amount_off.currency_code |
Asset promotion asset money amount off currency code |
The currency code for the monetary discount (e.g., ‘USD’, ‘EUR’). |
dimension |
asset.promotion_asset.occasion |
Asset promotion asset occasion |
The occasion for which the promotion is offered (e.g., ‘SEASONAL’, ‘HOLIDAY’). |
dimension |
asset.promotion_asset.orders_over_amount.amount_micros |
Asset promotion asset orders over amount amount micros |
The minimum order amount required for the promotion to apply, in micros. |
dimension |
asset.promotion_asset.orders_over_amount.currency_code |
Asset promotion asset orders over amount currency code |
The currency code for the minimum order amount. |
dimension |
asset.promotion_asset.percent_off |
Asset promotion asset percent off |
The percentage discount offered by the promotion. |
dimension |
asset.promotion_asset.promotion_code |
Asset promotion asset promotion code |
A unique code that customers can use to redeem the promotion. |
dimension |
asset.promotion_asset.promotion_target |
Asset promotion asset promotion target |
The specific product, service, or category to which the promotion applies. |
dimension |
asset.promotion_asset.redemption_end_date |
Asset promotion asset redemption end date |
The last date when the promotion can be redeemed. |
dimension |
asset.promotion_asset.redemption_start_date |
Asset promotion asset redemption start date |
The first date when the promotion can be redeemed. |
dimension |
asset.promotion_asset.start_date |
Asset promotion asset start date |
The date when the promotion asset is scheduled to start serving. |
dimension |
asset.resource_name |
Asset resource name |
The resource name of the asset, which uniquely identifies it within the API. |
dimension |
asset.sitelink_asset.ad_schedule_targets |
Asset sitelink asset ad schedule targets |
Defines the days and times when the sitelink asset is eligible to show. |
dimension |
asset.sitelink_asset.description1 |
Asset sitelink asset description1 |
The first descriptive line for the sitelink asset. |
dimension |
asset.sitelink_asset.description2 |
Asset sitelink asset description2 |
The second descriptive line for the sitelink asset. |
dimension |
asset.sitelink_asset.end_date |
Asset sitelink asset end date |
The date when the sitelink asset is scheduled to stop serving. |
dimension |
asset.sitelink_asset.link_text |
Asset sitelink asset link text |
The clickable text displayed for the sitelink asset. |
dimension |
asset.sitelink_asset.start_date |
Asset sitelink asset start date |
The date when the sitelink asset is scheduled to start serving. |
dimension |
asset.source |
Asset source |
The origin of the asset, indicating whether it was provided by the advertiser or automatically generated by the system. |
dimension |
asset.structured_snippet_asset.header |
Asset structured snippet asset header |
The header for the structured snippet asset (e.g., ‘Amenities’, ‘Destinations’). |
dimension |
asset.structured_snippet_asset.values |
Asset structured snippet asset values |
A list of values associated with the structured snippet header. |
dimension |
asset.text_asset.text |
Text asset |
The actual text content of the text asset. |
dimension |
asset.tracking_url_template |
Asset tracking url template |
A template for constructing tracking URLs for the asset. |
dimension |
asset.type |
Asset type |
The type of asset (e.g., IMAGE, TEXT, YOUTUBE_VIDEO). |
dimension |
asset.url_custom_parameters |
Asset url custom parameters |
A list of custom URL parameters for the asset, used for tracking. |
dimension |
asset.youtube_video_asset.youtube_video_id |
Youtube video ID |
The YouTube video ID for the YouTube video asset. |
dimension |
asset.youtube_video_asset.youtube_video_title |
Youtube video title |
The title of the YouTube video associated with the asset. |
dimension |
asset_field_type_view.field_type |
Asset field type |
The specific way an asset is used within an ad (e.g., HEADLINE, DESCRIPTION). |
dimension |
asset_field_type_view.resource_name |
Asset field type view resource name |
The resource name for the asset field type view. |
dimension |
asset_group.ad_strength |
Asset group ad strength |
An indicator of the quality and expected performance of the ads within the asset group. |
dimension |
asset_group.final_mobile_urls |
Asset group final mobile urls |
A list of final mobile URLs for the asset group, leading to the landing pages. |
dimension |
asset_group.final_urls |
Asset group final urls |
A list of final URLs for the asset group, leading to the landing pages. |
dimension |
asset_group.id |
Asset group ID |
The unique identifier for the asset group. |
dimension |
asset_group.name |
Asset group name |
The name of the asset group. |
dimension |
asset_group.path1 |
Asset group path1 |
The first path component for an asset group’s final URL, used to construct the display URL. |
dimension |
asset_group.path2 |
Asset group path2 |
The second path component for an asset group’s final URL, used to construct the display URL. |
dimension |
asset_group.primary_status |
Asset group primary status |
The primary status of the asset group (e.g., ENABLED, PAUSED). |
dimension |
asset_group.primary_status_reasons |
Asset group primary status reasons |
A list of reasons explaining the primary status of the asset group. |
dimension |
asset_group.resource_name |
asset_group.resource_name |
The resource name of the asset group, which uniquely identifies it. Its format is customers/{customer_id}/assetGroups/{asset_group_id}. |
dimension |
asset_group.status |
Asset group status |
The overall status of the asset group (e.g., ENABLED, PAUSED, REMOVED). |
dimension |
asset_group_asset.field_type |
asset_group_asset.field_type |
Describes the role or placement of an asset within an asset group, such as a HEADLINE or YOUTUBE_VIDEO. |
dimension |
asset_group_asset.resource_name |
asset_group_asset.resource_name |
The resource name of the asset group asset, which uniquely identifies the link between an asset and an asset group. Its format is customers/{customer_id}/assetGroupAssets/{asset_group_id}~{asset_id}~{field_type}. |
dimension |
asset_group_listing_group_filter.case_value.product_brand.value |
Asset group listing group filter product brand value |
The brand value used in the listing group filter for product ads within an asset group. |
dimension |
asset_group_listing_group_filter.case_value.product_category.category_id |
Asset group listing group filter product category category id |
The category ID for filtering product ads within an asset group based on product category. |
dimension |
asset_group_listing_group_filter.case_value.product_category.level |
Asset group listing group filter product category level |
The level of the product category used in the listing group filter (e.g., top-level, sub-category). |
dimension |
asset_group_listing_group_filter.case_value.product_channel.channel |
Asset group listing group filter product channel |
The sales channel (e.g., online, local) used in the listing group filter for product ads. |
dimension |
asset_group_listing_group_filter.case_value.product_condition.condition |
Asset group listing group filter product condition |
The condition of the product (e.g., new, used) used in the listing group filter. |
dimension |
asset_group_listing_group_filter.case_value.product_custom_attribute.index |
Asset group listing group filter product custom attribute index |
The index of the custom product attribute used in the listing group filter. |
dimension |
asset_group_listing_group_filter.case_value.product_custom_attribute.value |
Asset group listing group filter product custom attribute value |
The value of the custom product attribute used in the listing group filter. |
dimension |
asset_group_listing_group_filter.case_value.product_item_id.value |
Asset group listing group filter product item ID value |
The specific product item ID used in the listing group filter. |
dimension |
asset_group_listing_group_filter.case_value.product_type.level |
Asset group listing group filter product type level |
The level of the product type used in the listing group filter. |
dimension |
asset_group_listing_group_filter.case_value.product_type.value |
Asset group listing group filter product type value |
The value of the product type used in the listing group filter. |
dimension |
asset_group_listing_group_filter.id |
Asset group listing group filter id |
The unique identifier for the asset group listing group filter. |
dimension |
asset_group_listing_group_filter.listing_source |
Asset group listing group filter listing source |
The source of product or service listings used for filtering within an asset group, often referencing a Merchant Center feed. |
dimension |
asset_group_listing_group_filter.parent_listing_group_filter |
Asset group listing group filter parent listing group filter |
The resource name of the parent listing group filter in a hierarchical structure. |
dimension |
asset_group_listing_group_filter.path |
Asset group listing group filter path |
The path of the listing group filter in a hierarchical structure. |
dimension |
asset_group_listing_group_filter.type |
Asset group listing group filter type |
The type of the asset group listing group filter. |
dimension |
average_cost |
average_cost |
The average cost per interaction. |
metric |
average_cpe |
average_cpe |
The average cost-per-engagement (CPE) for your ads. |
metric |
average_cpm |
average_cpm |
The average cost-per-thousand impressions (CPM) for your ads. |
metric |
average_cpv |
average_cpv |
The average cost-per-view (CPV) for your video ads. |
metric |
bidding_strategy.campaign_count |
Bidding strategy campaign count |
The number of campaigns currently using this bidding strategy. |
dimension |
bidding_strategy.currency_code |
Bidding strategy currency |
The currency code used for the bidding strategy (e.g., ‘USD’, ‘EUR’). |
dimension |
bidding_strategy.enhanced_cpc |
Enhanced CPC bidding strategy |
Indicates if the Enhanced CPC (cost-per-click) bidding strategy is enabled. |
dimension |
bidding_strategy.id |
Bid strategy ID |
The unique identifier for the bidding strategy. |
dimension |
bidding_strategy.name |
Bid strategy name |
The name of the bidding strategy. |
dimension |
bidding_strategy.non_removed_campaign_count |
Non-removed campaigns |
The number of active, non-removed campaigns associated with this bidding strategy. |
dimension |
bidding_strategy.resource_name |
Bidding strategy resource name |
The resource name of the bidding strategy. |
dimension |
bidding_strategy.status |
Bid strategy state |
The status of the bidding strategy (e.g., ENABLED, REMOVED). |
dimension |
bidding_strategy.target_cpa.cpc_bid_ceiling_micros |
Upper bid limit (target CPA) |
The maximum CPC bid an advertiser is willing to pay, in micros, for the Target CPA bidding strategy. |
dimension |
bidding_strategy.target_cpa.cpc_bid_floor_micros |
Lower bid limit (target CPA) |
The minimum CPC bid an advertiser is willing to pay, in micros, for the Target CPA bidding strategy. |
dimension |
bidding_strategy.target_cpa.target_cpa_micros |
Target CPA |
The target cost-per-acquisition (CPA) for the bidding strategy, in micros. |
dimension |
bidding_strategy.target_impression_share.cpc_bid_ceiling_micros |
Bidding strategy target impression share maximum CPC bid (micros) |
The maximum CPC bid an advertiser is willing to pay, in micros, for the Target Impression Share bidding strategy. |
dimension |
bidding_strategy.target_impression_share.location |
Bidding strategy target location |
The location target for the Target Impression Share bidding strategy. |
dimension |
bidding_strategy.target_impression_share.location_fraction_micros |
Bidding strategy target impression share location fraction (micros) |
The target impression share percentage for the chosen location, in micros (e.g., 1,000,000 for 100%). |
dimension |
bidding_strategy.target_roas.cpc_bid_ceiling_micros |
Upper bid limit (target ROAS) |
The maximum CPC bid an advertiser is willing to pay, in micros, for the Target ROAS bidding strategy. |
dimension |
bidding_strategy.target_roas.cpc_bid_floor_micros |
Lower bid limit (target ROAS) |
The minimum CPC bid an advertiser is willing to pay, in micros, for the Target ROAS bidding strategy. |
dimension |
bidding_strategy.target_roas.target_roas |
Target ROAS |
The target return on ad spend (ROAS) for the bidding strategy. |
dimension |
bidding_strategy.target_spend.cpc_bid_ceiling_micros |
Bid limit (maximize clicks) |
The maximum CPC bid an advertiser is willing to pay, in micros, for the Target Spend (Maximize Clicks) bidding strategy. |
dimension |
bidding_strategy.target_spend.target_spend_micros |
Target spend (maximize clicks) |
The target spend amount for the bidding strategy, in micros. |
dimension |
bidding_strategy.type |
Bid strategy type |
The type of bidding strategy (e.g., MAXIMIZE_CONVERSIONS, TARGET_CPA). |
dimension |
billing_setup.end_date_time |
Billing Setup end date time |
The date and time when the billing setup is scheduled to end. |
dimension |
billing_setup.id |
Billing Setup ID |
The unique identifier for the billing setup. |
dimension |
billing_setup.payments_account |
Billing Setup payments account |
The resource name of the payments account linked to the billing setup. |
dimension |
billing_setup.payments_account_info.payments_account_id |
Billing Setup payments account ID |
The ID of the payments account associated with the billing setup. |
dimension |
billing_setup.payments_account_info.payments_account_name |
Billing Setup payments account name |
The name of the payments account associated with the billing setup. |
dimension |
billing_setup.payments_account_info.payments_profile_id |
Billing Setup payments profile ID |
The ID of the payments profile associated with the billing setup. |
dimension |
billing_setup.payments_account_info.payments_profile_name |
Billing Setup payments profile name |
The name of the payments profile associated with the billing setup. |
dimension |
billing_setup.payments_account_info.secondary_payments_profile_id |
Billing Setup secondary payments profile id |
The ID of the secondary payments profile, if any, associated with the billing setup. |
dimension |
billing_setup.resource_name |
Billing Setup resource name |
The resource name of the billing setup. |
dimension |
billing_setup.start_date_time |
Billing Setup start date time |
The date and time when the billing setup became effective. |
dimension |
billing_setup.status |
Billing Setup status |
The status of the billing setup (e.g., APPROVED, PENDING, CANCELLED). |
dimension |
bounce_rate |
bounce_rate |
The percentage of visits in which a user left your site from the entrance page without interacting with the page. |
metric |
brand |
brand |
The brand of a product in Shopping campaigns. |
dimension |
call_view.call_duration_seconds |
Call duration seconds |
The duration of the call in seconds. |
dimension |
call_view.call_status |
Call status |
The status of the call (e.g., MISSED, RECEIVED). |
dimension |
call_view.call_tracking_display_location |
Call tracking display location |
The location where the call tracking phone number was displayed in the ad. |
dimension |
call_view.caller_area_code |
Caller area code |
The area code of the caller’s phone number. |
dimension |
call_view.caller_country_code |
Caller country code |
The country code of the caller’s phone number. |
dimension |
call_view.end_call_date_time |
End call date time |
The date and time when the call ended. |
dimension |
call_view.resource_name |
Call view resource name |
The resource name of the call view. |
dimension |
call_view.start_call_date_time |
Start call date time |
The date and time when the call started. |
dimension |
call_view.type |
Call view type |
The type of call recorded in the call view. |
dimension |
campaign.accessible_bidding_strategy |
Accessible bidding strategy |
The resource name of the bidding strategy accessible by this campaign. |
dimension |
campaign.ad_serving_optimization_status |
Ad serving optimization status |
The status of ad serving optimization for the campaign, indicating how ads are rotated. |
dimension |
campaign.advertising_channel_sub_type |
Advertising sub channel |
The sub-type of the advertising channel for the campaign (e.g., SEARCH_MOBILE_APP, DISPLAY_EXPRESS). |
dimension |
campaign.advertising_channel_type |
Advertising channel |
The main type of advertising channel for the campaign (e.g., SEARCH, DISPLAY, PERFORMANCE_MAX). |
dimension |
campaign.app_campaign_setting.app_id |
App campaign app ID |
The unique identifier of the app associated with the app campaign. |
dimension |
campaign.app_campaign_setting.app_store |
App campaign app store |
The app store where the app for the campaign is available (e.g., GOOGLE_PLAY, APPLE_APP_STORE). |
dimension |
campaign.app_campaign_setting.bidding_strategy_goal_type |
App campaign goal type bidding strategy |
The bidding strategy goal type for the app campaign (e.g., OPTIMIZE_FOR_INSTALLS, OPTIMIZE_FOR_IN_APP_ACTIONS). |
dimension |
campaign.audience_setting.use_audience_grouped |
Audience setting use audience grouped |
Indicates whether audience targeting settings for the campaign are grouped. |
dimension |
campaign.base_campaign |
Base campaign ID |
The resource name of the base campaign from which this campaign was created (e.g., for draft or experiment campaigns). |
dimension |
campaign.bidding_strategy |
Campaign Bid strategy ID |
The resource name of the bidding strategy applied to the campaign. |
dimension |
campaign.bidding_strategy_system_status |
Bidding strategy system status |
The system-determined status of the campaign’s bidding strategy (e.g., active, learning, limited). |
dimension |
campaign.bidding_strategy_type |
Bid strategy type (campaign) |
The type of bidding strategy applied to the campaign (e.g., Maximize Conversions, Target ROAS, Manual CPC). |
dimension |
campaign.campaign_budget |
Budget ID |
The unique identifier (resource name) of the budget associated with this campaign. |
dimension |
campaign.campaign_group |
Group ID |
The unique identifier (resource name) of the campaign group to which this campaign belongs. |
dimension |
campaign.commission.commission_rate_micros |
Commission rate (micros) |
The commission rate in micros (one millionth of a unit) for campaigns using a commission-based bidding strategy. |
dimension |
campaign.dynamic_search_ads_setting.domain_name |
Campaign domain name |
The domain name specified in the Dynamic Search Ads (DSA) settings for the campaign, which Google Ads uses to generate ads. |
dimension |
campaign.dynamic_search_ads_setting.feeds |
Campaign page feeds |
Provides the list of page feeds used to specify URLs for Dynamic Search Ads (DSA) in a campaign. |
dimension |
campaign.dynamic_search_ads_setting.language_code |
Campaign domain language code |
The language code for the domain used in Dynamic Search Ads settings, indicating the language of the webpages to be crawled. |
dimension |
campaign.dynamic_search_ads_setting.use_supplied_urls_only |
Campaign use supplied URLs only |
Indicates whether the Dynamic Search Ads campaign should only use URLs explicitly provided by the advertiser, rather than crawling the entire domain. |
dimension |
campaign.end_date |
End date |
The end date of the campaign in YYYY-MM-DD format, after which ads will stop running. |
dimension |
campaign.excluded_parent_asset_field_types |
Excluded parent asset field types |
A list of field types for parent assets that are excluded from being used in this campaign. |
dimension |
campaign.excluded_parent_asset_set_types |
Excluded parent asset set types |
A list of asset set types for parent assets that are excluded from being used in this campaign. |
dimension |
campaign.experiment_type |
Campaign trial type |
The type of experiment or trial a campaign is participating in (e.g., base campaign, experiment campaign). |
dimension |
campaign.final_url_suffix |
Final URL suffix |
A suffix appended to the final URLs of ads in the campaign, often used for tracking additional parameters. |
dimension |
campaign.frequency_caps |
Campaign frequency caps |
Settings that limit the number of times an ad in this campaign can be shown to the same user over a specified period. |
dimension |
campaign.geo_target_type_setting.negative_geo_target_type |
Negative geo_targeting type |
The type of negative geographic targeting applied to the campaign, defining how excluded locations are handled. |
dimension |
campaign.geo_target_type_setting.positive_geo_target_type |
Positive geo targeting type |
The type of positive geographic targeting applied to the campaign, defining how included locations are handled. |
dimension |
campaign.hotel_property_asset_set |
Hotel property asset set |
The resource name of the asset set containing hotel properties relevant to this campaign. |
dimension |
campaign.hotel_setting.hotel_center_id |
Hotel center account ID |
The identifier of the Hotel Center account linked to this hotel campaign. |
dimension |
campaign.id |
Campaign ID |
The unique identifier for the campaign. |
dimension |
campaign.labels |
Campaign labels |
Labels applied to the campaign for organizational purposes and filtering. |
dimension |
campaign.listing_type |
Listing type |
The type of listing (e.g., products, services, properties) that the campaign is designed to promote. |
dimension |
campaign.local_campaign_setting.location_source_type |
Location source |
The source of location information used for a local campaign (e.g., Google My Business listings). |
dimension |
campaign.local_services_campaign_settings.category_bids |
Categorical level bids for Manual CPA |
Bidding settings at the category level for a Local Services campaign using a Manual CPA (Cost Per Acquisition) strategy. |
dimension |
campaign.manual_cpa |
CPA bidding strategy |
A bidding strategy where the advertiser manually sets bids based on desired cost per acquisition. |
dimension |
campaign.manual_cpc.enhanced_cpc_enabled |
Enhanced CPC enabled |
Indicates whether Enhanced CPC (eCPC) is enabled for a Manual CPC bidding strategy, which automatically adjusts bids for potential conversions. |
dimension |
campaign.manual_cpm |
CPM bidding strategy |
A bidding strategy where the advertiser manually sets bids based on desired cost per thousand impressions. |
dimension |
campaign.manual_cpv |
CPV bidding strategy |
Indicates if the campaign uses a Manual Cost-Per-View (CPV) bidding strategy, where advertisers set the maximum amount they’re willing to pay per view for their video ads. |
dimension |
campaign.maximize_conversion_value.target_roas |
Target ROAS (maximize conversion value) |
The target Return On Ad Spend (ROAS) percentage for a Maximize Conversion Value bidding strategy. |
dimension |
campaign.maximize_conversions.target_cpa_micros |
Maximize conversions target cpa micros |
The target Cost Per Acquisition (CPA) in micros for a Maximize Conversions bidding strategy. |
dimension |
campaign.name |
Campaign |
The name of the campaign. |
dimension |
campaign.network_settings.target_content_network |
Target content network |
Indicates whether the campaign targets the Google Display Network (content network). |
dimension |
campaign.network_settings.target_google_search |
Target google search |
Indicates whether the campaign targets Google Search results. |
dimension |
campaign.network_settings.target_partner_search_network |
Target partner search network |
Indicates whether the campaign targets Google search partners. |
dimension |
campaign.network_settings.target_search_network |
Target search network |
Indicates whether the campaign targets the Google Search Network (including Google Search and search partners). |
dimension |
campaign.optimization_goal_setting.optimization_goal_types |
Optimization goal types |
The types of optimization goals configured for the campaign (e.g., conversions, conversion value). |
dimension |
campaign.optimization_score |
Campaign optimization score |
A score indicating how optimized the campaign is, with recommendations for potential improvements. |
dimension |
campaign.payment_mode |
Campaign payment mode |
The mode of payment for the campaign (e.g., based on clicks, conversions). |
dimension |
campaign.percent_cpc.cpc_bid_ceiling_micros |
Percentage CPC maximum bid (micros) |
The maximum cost-per-click (CPC) bid in micros for a Percent CPC bidding strategy. |
dimension |
campaign.percent_cpc.enhanced_cpc_enabled |
Campaign Percent CPC enhanced enabled |
Indicates whether Enhanced CPC (eCPC) is enabled for a Percent CPC bidding strategy. |
dimension |
campaign.performance_max_upgrade.performance_max_campaign |
Performance max target campaign |
The resource name of the Performance Max campaign that a legacy campaign was upgraded to. |
dimension |
campaign.performance_max_upgrade.pre_upgrade_campaign |
Performance max legacy campaign |
The resource name of the legacy campaign that was upgraded to a Performance Max campaign. |
dimension |
campaign.performance_max_upgrade.status |
Performance max upgrade status |
The status of the Performance Max upgrade process for the campaign. |
dimension |
campaign.primary_status |
Primary status |
The primary status of the campaign, indicating its overall state (e.g., enabled, paused, ended). |
dimension |
campaign.primary_status_reasons |
Primary status reasons |
A list of reasons providing more detail about the campaign’s primary status, especially if there are issues preventing it from serving. |
dimension |
campaign.real_time_bidding_setting.opt_in |
Real time bidding opt-in |
Indicates whether real-time bidding is enabled for the campaign. |
dimension |
campaign.resource_name |
Campaign resource name |
The unique resource name of the campaign, used to identify it in the API. |
dimension |
campaign.selective_optimization.conversion_actions |
Campaign conversion optimization actions |
A list of specific conversion actions that this campaign is optimized for when selective optimization is enabled. |
dimension |
campaign.serving_status |
Campaign serving status |
The serving status of the campaign, indicating whether it is currently delivering ads (e.g., serving, paused, ended). |
dimension |
campaign.shopping_setting.campaign_priority |
Shopping campaign priority |
The priority level for a Shopping campaign, used when multiple Shopping campaigns target the same products. |
dimension |
campaign.shopping_setting.enable_local |
Shopping campaign enable local products |
Indicates whether a Shopping campaign is enabled to serve ads for local products. |
dimension |
campaign.shopping_setting.feed_label |
Shopping campaign feed label |
The feed label used by a Shopping campaign to target specific products from a Merchant Center product feed. |
dimension |
campaign.shopping_setting.merchant_id |
Shopping campaign merchant ID |
The Merchant Center ID associated with a Shopping campaign. |
dimension |
campaign.shopping_setting.use_vehicle_inventory |
Shopping setting use vehicle inventory |
Indicates whether a Shopping campaign is configured to use vehicle inventory for vehicle ads. |
dimension |
campaign.start_date |
Start date |
The start date of the campaign in YYYY-MM-DD format, when ads begin running. |
dimension |
campaign.status |
Campaign state |
The overall status of the campaign (e.g., ENABLED, PAUSED, REMOVED). |
dimension |
campaign.target_cpa.cpc_bid_ceiling_micros |
CPA bidding maximum CPC (micros) |
The maximum cost-per-click (CPC) bid in micros allowed for a Target CPA bidding strategy. |
dimension |
campaign.target_cpa.cpc_bid_floor_micros |
CPA bidding minimum CPC (micros) |
The minimum cost-per-click (CPC) bid in micros for a Target CPA bidding strategy. |
dimension |
campaign.target_cpa.target_cpa_micros |
CPA bidding target CPA (micros) |
The target cost-per-acquisition (CPA) in micros for a Target CPA bidding strategy. |
dimension |
campaign.target_cpm.target_frequency_goal.target_count |
Target cpm target frequency goal target count |
The target number of impressions for a Target CPM (cost per thousand impressions) frequency goal. |
dimension |
campaign.target_cpm.target_frequency_goal.time_unit |
Target cpm target frequency goal time unit |
The time unit for a Target CPM (cost per thousand impressions) frequency goal (e.g., DAY, WEEK). |
dimension |
campaign.target_impression_share.cpc_bid_ceiling_micros |
Impression share bidding CPC maximum bid (micros) |
The maximum cost-per-click (CPC) bid in micros for a Target Impression Share bidding strategy. |
dimension |
campaign.target_impression_share.location |
Impression share bidding location |
The target location on the search results page (e.g., ‘top of page’, ‘anywhere’) for a Target Impression Share bidding strategy. |
dimension |
campaign.target_impression_share.location_fraction_micros |
Impression share bidding location fraction (micros) |
The target impression share percentage in micros for the specified location in a Target Impression Share bidding strategy. |
dimension |
campaign.target_roas.cpc_bid_ceiling_micros |
ROAS bidding maximum CPC (micros) |
The maximum cost-per-click (CPC) bid in micros for a Target ROAS (Return On Ad Spend) bidding strategy. |
dimension |
campaign.target_roas.cpc_bid_floor_micros |
ROAS bidding minimum CPC (micros) |
The minimum cost-per-click (CPC) bid in micros for a Target ROAS (Return On Ad Spend) bidding strategy. |
dimension |
campaign.target_roas.target_roas |
ROAS bidding target ROAS |
The target Return On Ad Spend (ROAS) percentage for a Target ROAS bidding strategy. |
dimension |
campaign.target_spend.cpc_bid_ceiling_micros |
Target spend bidding maximum CPC (micros) |
The maximum cost-per-click (CPC) bid in micros for a Target Spend bidding strategy. |
dimension |
campaign.target_spend.target_spend_micros |
Target spend bidding target spend (micros) |
The target spending amount in micros for a Target Spend bidding strategy. |
dimension |
campaign.targeting_setting.target_restrictions |
Campaign target restrictions |
Restrictions applied to the campaign’s targeting settings, such as exclusions or specific targeting parameters. |
dimension |
campaign.tracking_setting.tracking_url |
Campaign tracking URL |
The tracking URL for the campaign, used to measure clicks and other interactions with ads. |
dimension |
campaign.tracking_url_template |
Tracking template |
The URL template used for tracking clicks from ads in the campaign. |
dimension |
campaign.travel_campaign_settings.travel_account_id |
Travel campaign settings travel account id |
The identifier of the travel account associated with a travel campaign. |
dimension |
campaign.url_custom_parameters |
Custom parameter |
Custom parameters that can be appended to URLs for detailed tracking purposes. |
dimension |
campaign.url_expansion_opt_out |
Url expansion opt out |
Indicates whether URL expansion is opted out for the campaign, affecting how landing pages are generated. |
dimension |
campaign.vanity_pharma.vanity_pharma_display_url_mode |
Vanity pharma URL display mode |
The display mode for vanity URLs in pharmaceutical ads within the campaign. |
dimension |
campaign.vanity_pharma.vanity_pharma_text |
Vanity pharma URL text |
The text displayed for vanity URLs in pharmaceutical ads within the campaign. |
dimension |
campaign.video_brand_safety_suitability |
Campaign brand safety setting |
Brand safety settings for video ads in the campaign, controlling the types of content where ads can appear. |
dimension |
campaign_asset.asset |
Campaign Asset asset |
The resource name of the asset linked to this campaign. |
dimension |
campaign_asset.campaign |
Campaign Asset campaign |
The resource name of the campaign to which this asset is linked. |
dimension |
campaign_asset.field_type |
Campaign Asset field type |
The specific field type that the asset fulfills within the context of the campaign (e.g., HEADLINE, DESCRIPTION). |
dimension |
campaign_asset.primary_status |
Campaign Asset primary status |
The primary status of the campaign asset, indicating its overall state (e.g., enabled, paused, removed). |
dimension |
campaign_asset.primary_status_details |
Campaign Asset primary status details |
Details providing more information about the primary status of the campaign asset. |
dimension |
campaign_asset.primary_status_reasons |
Campaign Asset primary status reasons |
A list of reasons for the primary status of the campaign asset. |
dimension |
campaign_asset.resource_name |
Campaign Asset resource name |
The unique resource name of the campaign asset. |
dimension |
campaign_asset.source |
Campaign Asset source |
The source of the campaign asset, indicating whether it was provided by the advertiser or automatically generated by the system. |
dimension |
campaign_asset.status |
Campaign Asset status |
The status of the campaign asset (e.g., ENABLED, PAUSED, REMOVED). |
dimension |
campaign_audience_view.resource_name |
Campaign audience view resource name |
The resource name for the campaign audience view, used for reporting on campaign audience performance. |
dimension |
campaign_bid_modifier.bid_modifier |
Bid modifier |
The bid adjustment value applied at the campaign level for a specific criterion (e.g., device, location). |
dimension |
campaign_bid_modifier.campaign |
Bid modifier campaign |
The resource name of the campaign to which the bid modifier applies. |
dimension |
campaign_bid_modifier.criterion_id |
Bid modifier criterion ID |
The unique identifier of the criterion for which the bid modifier is set (e.g., device, location). |
dimension |
campaign_bid_modifier.interaction_type.type |
Bid modifier interaction ID |
The type of interaction criterion (e.g., call, website visit) for which the bid modifier is set. |
dimension |
campaign_bid_modifier.resource_name |
Bid modifier resource name |
The unique resource name of the campaign bid modifier. |
dimension |
campaign_budget.amount_micros |
Budget |
The daily budget amount in micros (one millionth of a currency unit) for the campaign budget. |
dimension |
campaign_budget.delivery_method |
Delivery method |
The delivery method for the campaign budget, controlling how quickly the budget is spent (e.g., STANDARD, ACCELERATED). |
dimension |
campaign_budget.explicitly_shared |
Explicitly shared |
Indicates whether the campaign budget is explicitly shared across multiple campaigns. |
dimension |
campaign_budget.has_recommended_budget |
Has recommended budget |
Indicates whether Google Ads has a recommended budget available for the campaign. |
dimension |
campaign_budget.id |
Campaign budget ID |
The unique identifier for the campaign budget. |
dimension |
campaign_budget.name |
Budget name |
The name of the campaign budget. |
dimension |
campaign_budget.period |
Budget period |
The period over which the budget is allocated (e.g., DAILY). |
dimension |
campaign_budget.recommended_budget_amount_micros |
Recommended budget amount |
The recommended budget amount in micros suggested by Google Ads. |
dimension |
campaign_budget.recommended_budget_estimated_change_weekly_clicks |
Estimated change in weekly clicks at recommended budget |
The estimated change in weekly clicks if the campaign budget were adjusted to the recommended amount. |
dimension |
campaign_budget.recommended_budget_estimated_change_weekly_cost_micros |
Estimated change in weekly cost at recommended budget |
The estimated change in weekly cost, in micro-units, if the campaign budget were adjusted to the recommended amount. |
dimension |
campaign_budget.recommended_budget_estimated_change_weekly_interactions |
Estimated change in weekly interactions at recommended budget |
The estimated change in weekly interactions if the campaign budget were adjusted to the recommended amount. Interactions can include clicks, calls, or other engagements depending on the ad format. |
dimension |
campaign_budget.recommended_budget_estimated_change_weekly_views |
Estimated change in weekly views at recommended budget |
The estimated change in weekly views if the campaign budget were adjusted to the recommended amount. |
dimension |
campaign_budget.reference_count |
Campaign budget reference count |
The number of campaigns that share this budget. A value of 1 indicates an unshared campaign budget. |
dimension |
campaign_budget.resource_name |
Campaign budget resource name |
The resource name of the campaign budget, which uniquely identifies it within the Google Ads API. |
dimension |
campaign_budget.status |
Budget state |
The current status of the campaign budget (e.g., enabled, removed). |
dimension |
campaign_budget.total_amount_micros |
Total budget amount |
The total budget amount, in micro-units, allocated for the campaign budget. |
dimension |
campaign_budget.type |
Campaign budget type |
The type of campaign budget, indicating whether it’s a shared budget or a campaign-specific budget. |
dimension |
campaign_criterion.ad_schedule.day_of_week |
Ad schedule day of the week |
The day of the week (e.g., MONDAY, TUESDAY) on which an ad schedule is active. |
dimension |
campaign_criterion.bid_modifier |
Campaign Criterion bid modifier |
A multiplier applied to bids for a specific campaign criterion, such as device, location, or audience. |
dimension |
campaign_criterion.criterion_id |
Campaign Criterion ID |
The unique identifier for a campaign criterion. |
dimension |
campaign_criterion.display_name |
Campaign Criterion display name |
The user-friendly name of a campaign criterion (e.g., a location name or audience segment name). |
dimension |
campaign_criterion.keyword.match_type |
Campaign Criterion keyword match type |
The match type of a keyword criterion (e.g., exact, phrase, broad). |
dimension |
campaign_criterion.keyword.text |
Campaign Criterion keyword text |
The text of the keyword used as a campaign criterion. |
dimension |
campaign_criterion.location.geo_target_constant |
Campaign Criterion location geo target constant |
The resource name of the geographic target constant used as a location criterion for the campaign. |
dimension |
campaign_criterion.negative |
Campaign Criterion is negative |
Indicates whether the campaign criterion is an exclusion (negative) or an inclusion. |
dimension |
campaign_criterion.placement.url |
Campaign Criterion placement URL |
The URL of a website placement targeted or excluded at the campaign level. |
dimension |
campaign_criterion.proximity.address.city_name |
Campaign Criterion City Name |
The city name used in a proximity targeting criterion. |
dimension |
campaign_criterion.proximity.address.country_code |
Campaign Criterion Country Code |
The country code used in a proximity targeting criterion. |
dimension |
campaign_criterion.proximity.address.postal_code |
Campaign Criterion Postal Code |
The postal code used in a proximity targeting criterion. |
dimension |
campaign_criterion.proximity.address.province_code |
Campaign Criterion Province Code |
The province code used in a proximity targeting criterion. |
dimension |
campaign_criterion.proximity.address.province_name |
Campaign Criterion Province Name |
The province name used in a proximity targeting criterion. |
dimension |
campaign_criterion.proximity.address.street_address |
Campaign Criterion Street Address |
The street address used in a proximity targeting criterion. |
dimension |
campaign_criterion.proximity.geo_point.latitude_in_micro_degrees |
Campaign Criterion Geo Point Latitude Micro Degrees |
The latitude, in micro-degrees, of the geographical point for proximity targeting. |
dimension |
campaign_criterion.proximity.geo_point.longitude_in_micro_degrees |
Campaign Criterion Geo Point Longitude Micro Degrees |
The longitude, in micro-degrees, of the geographical point for proximity targeting. |
dimension |
campaign_criterion.proximity.radius |
Campaign Criterion Radius |
The radius around a geographical point or address for proximity targeting. |
dimension |
campaign_criterion.proximity.radius_units |
Campaign Criterion Radius Units |
The unit of measurement for the radius in proximity targeting (e.g., KILOMETERS, MILES). |
dimension |
campaign_criterion.resource_name |
Campaign Criterion resource name |
The resource name of the campaign criterion, which uniquely identifies it within the Google Ads API. |
dimension |
campaign_criterion.status |
Campaign Criterion status |
The current status of the campaign criterion (e.g., enabled, paused, removed). |
dimension |
campaign_criterion.type |
Campaign Criterion type |
The type of the campaign criterion (e.g., KEYWORD, LOCATION, AGE_RANGE). |
dimension |
campaign_criterion.user_list.user_list |
Campaign Criterion User List |
The resource name of the user list used as an audience criterion for the campaign. |
dimension |
campaign_group.id |
Campaign group id |
The unique identifier for the campaign group. |
dimension |
campaign_group.name |
Campaign group name |
The name of the campaign group. |
dimension |
campaign_group.resource_name |
Campaign group resource name |
The resource name of the campaign group, which uniquely identifies it within the Google Ads API. |
dimension |
campaign_group.status |
Campaign group status |
The current status of the campaign group (e.g., enabled, removed). |
dimension |
campaign_name |
campaign_name |
The name of the advertising campaign. |
dimension |
campaign_objective |
campaign_objective |
The marketing objective set for the campaign (e.g., Sales, Leads, Website traffic). |
dimension |
campaign_search_term_insight.campaign_id |
Campaign search term insight campaign ID |
The ID of the campaign associated with the search term insight. |
dimension |
campaign_search_term_insight.category_label |
Campaign search term insight category label |
A label categorizing the search term insight (e.g., related to a specific product or service). |
dimension |
campaign_search_term_insight.id |
Campaign search term insight ID |
The unique identifier for the campaign search term insight. |
dimension |
change_event.change_date_time |
Change Event Changed Date Time |
The date and time when the change event occurred. |
dimension |
change_event.change_resource_name |
Change Event Changed Resource Name |
The resource name of the entity that was changed (e.g., campaign, ad group). |
dimension |
change_event.change_resource_type |
Change Event Changed Resource Type |
The type of resource that was changed (e.g., CAMPAIGN, AD_GROUP). |
dimension |
change_event.changed_fields |
Change Event Changed Fields |
A list of the specific fields within the resource that were modified during the change event. |
dimension |
change_event.client_type |
Change Event Client Type |
The type of client that initiated the change (e.g., GOOGLE_ADS_WEB_INTERFACE, GOOGLE_ADS_API). |
dimension |
change_event.new_resource |
Change Event New Resource |
The state of the resource after the change occurred. |
dimension |
change_event.old_resource |
Change Event Old Resource |
The state of the resource before the change occurred. |
dimension |
change_event.resource_change_operation |
Change Event Resource Change Operation |
The type of operation performed on the resource (e.g., CREATE, UPDATE, REMOVE). |
dimension |
change_event.user_email |
Change Event User Email |
The email address of the user who made the change. |
dimension |
click_view.ad_group_ad |
Click View Ad |
The resource name of the ad group ad that was clicked. |
dimension |
click_view.area_of_interest.city |
City (location of interest) |
The city identified as the user’s area of interest when the click occurred. |
dimension |
click_view.area_of_interest.country |
Country/territory (location of interest) |
The country or territory identified as the user’s area of interest when the click occurred. |
dimension |
click_view.area_of_interest.metro |
Metro area (location of interest) |
The metro area identified as the user’s area of interest when the click occurred. |
dimension |
click_view.area_of_interest.most_specific |
Most specific location target (location of interest) |
The most specific location target identified as the user’s area of interest when the click occurred. |
dimension |
click_view.area_of_interest.region |
Region (location of interest) |
The region identified as the user’s area of interest when the click occurred. |
dimension |
click_view.campaign_location_target |
Click view campaign location target |
The resource name of the campaign location target that was relevant to the click. |
dimension |
click_view.gclid |
Google click ID |
The Google Click Identifier (GCLID) associated with a click, used for tracking conversions and linking ad interactions to website activity. |
dimension |
click_view.keyword |
Click view keyword |
The resource name of the keyword that triggered the ad click. |
dimension |
click_view.keyword_info.match_type |
Click view keyword match type |
The match type of the keyword that triggered the ad click. |
dimension |
click_view.keyword_info.text |
Click view keyword info text |
The text of the keyword that triggered the ad click. |
dimension |
click_view.location_of_presence.city |
City (physical location) |
The city of the user’s physical location when the ad was clicked. |
dimension |
click_view.location_of_presence.country |
Country/territory (physical location) |
The country/territory of the user’s physical location when the ad was clicked. |
dimension |
click_view.location_of_presence.metro |
Metro area (physical location) |
The metro area of the user’s physical location when the ad was clicked. |
dimension |
click_view.location_of_presence.most_specific |
Most specific location target (physical location) |
The most specific geographical location where the user was physically present when the click occurred. |
dimension |
click_view.location_of_presence.region |
Region (physical location) |
The region (e.g., state, province) of the user’s physical location when the ad was clicked. |
dimension |
click_view.page_number |
Page |
The page number on the search results where the ad impression and subsequent click occurred. |
dimension |
click_view.resource_name |
Click view resource name |
The resource name of the click view, which uniquely identifies the click event. |
dimension |
click_view.user_list |
Click view user list |
The user list associated with the click, often used for remarketing or audience targeting. |
dimension |
clicks_googleAds |
clicks_googleAds |
The number of clicks on your Google Ads that led to visits to your website or landing page. |
metric |
conversion_action.app_id |
Conversion action app ID |
The application ID associated with this conversion action, if it’s an app conversion. |
dimension |
conversion_action.attribution_model_settings.attribution_model |
Conversion action attribution model |
The attribution model used for this conversion action (e.g., Last Click, Data-driven, Linear). |
dimension |
conversion_action.attribution_model_settings.data_driven_model_status |
Conversion action data driven model status |
The status of the data-driven attribution model for this conversion action. |
dimension |
conversion_action.category |
Conversion action category |
The category of the conversion action (e.g., PURCHASE, LEAD, PAGE_VIEW). |
dimension |
conversion_action.click_through_lookback_window_days |
Conversion action click through lookback window (days) |
The duration in days after a click during which a conversion can be recorded for this action. |
dimension |
conversion_action.counting_type |
Conversion action counting type |
Specifies how conversions for this action are counted (e.g., ONE_PER_INTERACTION, EVERY_ACTION). |
dimension |
conversion_action.id |
Conversion action ID |
The unique identifier for the conversion action. |
dimension |
conversion_action.include_in_conversions_metric |
Conversion action include in conversions metric |
Indicates whether conversions from this action are included in the ‘Conversions’ column in Google Ads reports. |
dimension |
conversion_action.name |
Conversion action name |
The name of the conversion action. |
dimension |
conversion_action.origin |
Conversion action origin |
The origin of the conversion action, such as WEBSITE, APP, GOOGLE_HOSTED, or STORE. |
dimension |
conversion_action.owner_customer |
Conversion action owner customer |
The customer account that owns this conversion action. |
dimension |
conversion_action.phone_call_duration_seconds |
Conversion action phone call duration (seconds) |
The minimum duration in seconds for a phone call to be counted as a conversion for this action. |
dimension |
conversion_action.primary_for_goal |
Conversion action primary for goal |
Indicates if this conversion action is designated as a primary action for a conversion goal. |
dimension |
conversion_action.resource_name |
Conversion action resource name |
The resource name of the conversion action, which uniquely identifies it in the API. |
dimension |
conversion_action.status |
Conversion action status |
The status of the conversion action (e.g., ENABLED, REMOVED). |
dimension |
conversion_action.tag_snippets |
Conversion action tag snippets |
The code snippets used to implement tracking for this conversion action on a website or app. |
dimension |
conversion_action.type |
Conversion action type |
The type of conversion action (e.g., WEBSITE, APP_DOWNLOAD, PHONE_CALL). |
dimension |
conversion_action.value_settings.always_use_default_value |
Conversion action always use default value |
Indicates if the conversion action should always use the default value, ignoring any dynamically provided values. |
dimension |
conversion_action.value_settings.default_currency_code |
Conversion action default currency code |
The default currency code used for the conversion value if no specific currency is provided. |
dimension |
conversion_action.value_settings.default_value |
Conversion action default value |
The default monetary value assigned to each conversion for this action. |
dimension |
conversion_action.view_through_lookback_window_days |
Conversion action view through lookback window (days) |
The duration in days after an impression (without a click) during which a conversion can be recorded for this action. |
dimension |
conversions_value |
conversions_value |
The sum of conversion values for all conversions. |
metric |
cost_googleAds |
cost_googleAds |
The total cost of all ad interactions, in micros (one millionth of the currency unit). |
metric |
country |
country |
The country selected for geographical targeting within an advertising campaign. |
dimension |
ctr |
ctr |
Click-through rate, which is the ratio of clicks to impressions. |
metric |
custom_conversion_goal.status |
Custom Conversion Goal Status |
The status of a custom conversion goal (e.g., ‘ENABLED’, ‘PAUSED’). |
dimension |
customer.auto_tagging_enabled |
Auto tagging enabled |
Indicates if auto-tagging is enabled for the customer’s account, which adds a GCLID to ad destination URLs. |
dimension |
customer.call_reporting_setting.call_conversion_action |
Customer call conversion action |
The conversion action configured to track phone call conversions for this customer. |
dimension |
customer.call_reporting_setting.call_conversion_reporting_enabled |
Customer call conversion reporting enabled |
Indicates if conversion reporting for phone calls is enabled for this customer. |
dimension |
customer.call_reporting_setting.call_reporting_enabled |
Customer call reporting enabled |
Indicates if phone call reporting is enabled for this customer’s account. |
dimension |
customer.conversion_tracking_setting.accepted_customer_data_terms |
Accepted customer data terms |
Indicates whether the customer has accepted the customer data terms for conversion tracking. |
dimension |
customer.conversion_tracking_setting.conversion_tracking_id |
Customer conversion tracking ID |
The ID used for conversion tracking within this customer account. |
dimension |
customer.conversion_tracking_setting.conversion_tracking_status |
Conversion tracking status |
The status of conversion tracking for this customer account. |
dimension |
customer.conversion_tracking_setting.cross_account_conversion_tracking_id |
Customer cross account conversion tracking ID |
The conversion tracking ID used for cross-account conversion tracking by the customer. |
dimension |
customer.conversion_tracking_setting.enhanced_conversions_for_leads_enabled |
Enhanced conversions for leads enabled |
Indicates if enhanced conversions for leads are enabled to improve the accuracy of lead conversion measurement. |
dimension |
customer.conversion_tracking_setting.google_ads_conversion_customer |
Google ads conversion customer |
The customer account that manages conversions for this customer, especially in a cross-account conversion tracking setup. |
dimension |
customer.currency_code |
Currency |
The currency code (e.g., ‘USD’, ‘EUR’) used for billing and reporting in this customer account. |
dimension |
customer.customer_agreement_setting.accepted_lead_form_terms |
Accepted lead form terms |
Indicates whether the customer has accepted the terms and conditions for using lead forms. |
dimension |
customer.descriptive_name |
Client name |
A user-provided descriptive name for the customer account. |
dimension |
customer.final_url_suffix |
Customer final URL suffix |
A suffix that is appended to all final URLs in the customer account for tracking purposes. |
dimension |
customer.has_partners_badge |
Customer partner program badge |
Indicates if the customer account is associated with a Google Partners badge. |
dimension |
customer.id |
Customer ID |
The unique ID of the customer account. |
dimension |
customer.image_asset_auto_migration_done |
Image asset auto migration done |
Indicates if the automated migration process for image assets has been completed for this customer. |
dimension |
customer.image_asset_auto_migration_done_date_time |
Image asset auto migration done date time |
The date and time when the automated migration of image assets was completed. |
dimension |
customer.local_services_settings.granular_insurance_statuses |
Local services granular insurance statuses |
The granular insurance verification statuses for Local Services Ads managed by this customer. |
dimension |
customer.local_services_settings.granular_license_statuses |
Local services granular license statuses |
The granular license verification statuses for Local Services Ads managed by this customer. |
dimension |
customer.location_asset_auto_migration_done |
Location asset auto migration done |
Indicates if the automated migration process for location assets has been completed for this customer. |
dimension |
customer.location_asset_auto_migration_done_date_time |
Location asset auto migration done date time |
The date and time when the automated migration of location assets was completed. |
dimension |
customer.manager |
Can manage clients |
Indicates if this customer account is a manager account, allowing it to manage other client accounts. |
dimension |
customer.name |
Customer name |
The official name of the customer account. |
dimension |
customer.optimization_score |
Customer optimization score |
The optimization score for the customer account, indicating its potential for improvement. |
dimension |
customer.optimization_score_weight |
Customer optimization score weight |
The weight or relative importance of the optimization score for the customer account. |
dimension |
customer.pay_per_conversion_eligibility_failure_reasons |
Customer pay per conversion eligibility reasons |
A list of reasons why the customer account is not eligible for pay-per-conversion billing. |
dimension |
customer.remarketing_setting.google_global_site_tag |
Google global site tag |
The Google Global Site Tag (gtag.js) script used for remarketing tracking for this customer. |
dimension |
customer.resource_name |
Customer resource name |
The resource name of the customer account, which uniquely identifies it in the API. |
dimension |
customer.status |
Status |
The status of the customer account (e.g., ENABLED, CANCELED). |
dimension |
customer.test_account |
Test account |
Indicates if this customer account is a test account, used for development and testing purposes. |
dimension |
customer.time_zone |
Time zone |
The time zone setting for the customer account. |
dimension |
customer.tracking_url_template |
Customer tracking URL template |
The URL template applied to all tracking URLs at the customer account level. |
dimension |
customer_asset.asset |
Customer Asset asset |
The asset resource associated with the customer asset. |
dimension |
customer_asset.field_type |
Customer Asset field type |
The type of creative field where the asset is used (e.g., HEADLINE, DESCRIPTION, IMAGE). |
dimension |
customer_asset.primary_status |
Customer Asset primary status |
The primary status of the customer asset, indicating its overall health (e.g., PENDING, APPROVED, DISAPPROVED). |
dimension |
customer_asset.primary_status_details |
Customer Asset primary status details |
Additional details regarding the primary status of the customer asset. |
dimension |
customer_asset.primary_status_reasons |
Customer Asset primary status reasons |
The specific reasons for the primary status of the customer asset (e.g., policies violated). |
dimension |
customer_asset.resource_name |
Customer Asset resource name |
The resource name of the customer asset, uniquely identifying the association between a customer and an asset. |
dimension |
customer_asset.source |
Customer Asset source |
The source from which the customer asset was created or uploaded. |
dimension |
customer_asset.status |
Customer Asset status |
The status of the customer asset, indicating if it is enabled or paused. |
dimension |
customer_user_access.access_creation_date_time |
Access creation date time |
The date and time when the user’s access to the customer account was created. |
dimension |
customer_user_access.access_role |
Access role |
The access role assigned to the user for the customer account (e.g., ADMIN, STANDARD). |
dimension |
customer_user_access.email_address |
Email address |
The email address of the user who has access to the customer account. |
dimension |
customer_user_access.user_id |
User ID |
The unique identifier for the user with access to the customer account. |
dimension |
date |
date |
The specific date for which the performance data is reported. |
dimension |
detail_placement_view.display_name |
Criteria display name |
A user-friendly name for the detailed ad placement. |
dimension |
detail_placement_view.group_placement_target_url |
Domain (detail placement) |
The domain of the website where the ad was placed. |
dimension |
detail_placement_view.placement |
Detail view placement string |
A detailed string identifying the specific location where the ad was placed. |
dimension |
detail_placement_view.placement_type |
Detail view placement type |
The type of placement (e.g., WEBSITE, MOBILE_APP) for the detailed view. |
dimension |
detail_placement_view.resource_name |
Detail view resource name |
The resource name of the detailed placement view, uniquely identifying the specific placement occurrence. |
dimension |
detail_placement_view.target_url |
URL (detail placement) |
The specific URL of the page where the ad was displayed. |
dimension |
display_keyword_view.resource_name |
Display keyword view resource name |
The resource name of the display keyword view, representing a keyword in the Google Display Network. |
dimension |
distance_view.distance_bucket |
Distance from location extensions |
The distance bucket (e.g., ‘0-1 miles’, ‘1-5 miles’) from the location extension that triggered an interaction. |
dimension |
distance_view.resource_name |
Distance view resource name |
The resource name of the distance view, which provides aggregated data based on distance from location extensions. |
dimension |
dynamic_search_ads_search_term_view.has_matching_keyword |
Dynamic search ads campaign has matching keyword |
For Dynamic Search Ads, indicates whether the user’s search query also matched an existing keyword in the account. |
dimension |
dynamic_search_ads_search_term_view.has_negative_keyword |
Dynamic search ads campaign has negative keyword |
For Dynamic Search Ads, indicates whether the user’s search query was excluded by a negative keyword. |
dimension |
dynamic_search_ads_search_term_view.has_negative_url |
Dynamic search ads campaign has negative URL |
For Dynamic Search Ads, indicates whether the landing page URL associated with the ad was excluded by a negative URL criterion. |
dimension |
dynamic_search_ads_search_term_view.headline |
Dynamically generated Headline |
The dynamically generated headline for the ad in a Dynamic Search Ads campaign. |
dimension |
dynamic_search_ads_search_term_view.landing_page |
URL |
The landing page URL that the user was directed to from a Dynamic Search Ad. |
dimension |
dynamic_search_ads_search_term_view.page_url |
Dynamic search ad page_url |
The URL of the advertiser’s webpage that was matched by a search term in a Dynamic Search Ads campaign. |
dimension |
dynamic_search_ads_search_term_view.resource_name |
Dynamic search ad resource name |
The resource name of the dynamic search ads search term view, which provides insights into search terms and ad performance for DSA. |
dimension |
dynamic_search_ads_search_term_view.search_term |
Search term (dynamic search ads) |
The search query entered by the user that triggered a Dynamic Search Ad. |
dimension |
end_date |
end_date |
The end date for a campaign or other entity, in YYYY-MM-DD format. |
dimension |
expanded_landing_page_view.expanded_final_url |
Expanded landing page |
The expanded final URL of the landing page after all URL templates and custom parameters have been applied. |
dimension |
expanded_landing_page_view.resource_name |
Expanded landing page view resource name |
The resource name of the expanded landing page view, providing data for the fully resolved landing page URLs. |
dimension |
experiment.description |
experiment.description |
An optional descriptive text for the experiment, used for reference and documentation purposes, without affecting its execution. |
dimension |
experiment.end_date |
experiment.end_date |
The date when the experiment is scheduled to conclude, in YYYY-MM-DD format. |
dimension |
experiment.experiment_id |
experiment.experiment_id |
The unique identifier for the experiment. |
dimension |
experiment.name |
experiment.name |
The unique name assigned to the experiment. |
dimension |
experiment.resource_name |
experiment.resource_name |
The unique identifier (resource name) for the experiment. |
dimension |
experiment.start_date |
experiment.start_date |
The date when the experiment is scheduled to begin, in YYYY-MM-DD format. |
dimension |
The type of the experiment, such as a custom experiment for Search or Display campaigns. |
dimension |
||
experiment_arm.campaigns.{NUM} |
experiment_arm.campaigns.{NUM} |
A list of campaigns included in a specific experiment arm, which can be either a control or a treatment arm. |
dimension |
experiment_arm.control |
experiment_arm.control |
Indicates if this experiment arm serves as the control group, against which other treatment arms are compared. |
dimension |
experiment_arm.experiment |
experiment_arm.experiment |
The resource name of the experiment to which this experiment arm belongs. |
dimension |
experiment_arm.name |
experiment_arm.name |
The unique name assigned to the experiment arm within its associated experiment. |
dimension |
experiment_arm.resource_name |
experiment_arm.resource_name |
The unique identifier (resource name) for the experiment arm. |
dimension |
experiment_arm.traffic_split |
experiment_arm.traffic_split |
The percentage of campaign traffic directed to this specific experiment arm. |
metric |
format_type |
format_type |
The format of the ad (e.g., text, image, video). |
dimension |
gender_view.resource_name |
Gender view resource name |
The resource name of the gender view, which provides performance data segmented by user gender. |
dimension |
geo |
geo |
Geographic targeting information, specifying the regions where ads are shown. |
dimension |
geo_target_constant.canonical_name |
Geo Target Constant canonical name |
The canonical, human-readable name of the geographical target (e.g., ‘New York, United States’). |
dimension |
geo_target_constant.country_code |
Geo Target Constant country code |
The country code (ISO-3166-1 alpha-2) of the geographical target. |
dimension |
geo_target_constant.id |
Geo Target Constant id |
The unique identifier for the geographical target constant. |
dimension |
geo_target_constant.name |
Geo Target Constant name |
The name of the geographical target constant. |
dimension |
geo_target_constant.parent_geo_target |
Geo Target Constant parent geo target |
The resource name of the parent geographical target, representing a broader geographical area. |
dimension |
geo_target_constant.resource_name |
Geo Target Constant resource name |
The resource name of the geographical target constant, uniquely identifying the geographical location. |
dimension |
geo_target_constant.status |
Geo Target Constant status |
The status of the geographical target constant. |
dimension |
geo_target_constant.target_type |
Geo Target Constant target type |
The type of geographical target (e.g., COUNTRY, PROVINCE, CITY). |
dimension |
geographic_view.country_criterion_id |
Geographic view country criterion ID |
The criterion ID of the country associated with the geographic view. |
dimension |
geographic_view.location_type |
Location type |
The type of location (e.g., LOCATION_OF_PRESENCE, LOCATION_OF_INTEREST) used in the geographic view. |
dimension |
geographic_view.resource_name |
Geographic view resource name |
The resource name of the geographic view, providing performance data segmented by geographical location. |
dimension |
group_placement_view.display_name |
Group placement view display name |
A user-friendly name for the grouped ad placement. |
dimension |
group_placement_view.placement |
Group placement view placement |
A string identifying the grouped location where the ad was placed. |
dimension |
group_placement_view.placement_type |
Group placement view placement type |
The type of placement (e.g., WEBSITE, MOBILE_APP) for the grouped view. |
dimension |
group_placement_view.resource_name |
Group placement view resource name |
The resource name of the group placement view, which provides aggregated data for groups of placements. |
dimension |
group_placement_view.target_url |
Domain |
The domain of the website for the grouped ad placement. |
dimension |
hotel_group_view.resource_name |
Hotel group view resource name |
The resource name of the hotel group view, providing data segmented by hotel groups in Hotel campaigns. |
dimension |
hotel_performance_view.resource_name |
Hotel performance view resource name |
The resource name of the hotel performance view, providing overall performance metrics for Hotel campaigns. |
dimension |
impressions_googleAds |
impressions_googleAds |
The total number of times your Google Ads were shown. |
metric |
keyword_plan_ad_group.name |
Keyword plan ad group name |
The name of the ad group within a keyword plan. |
dimension |
keyword_plan_ad_group_keyword.cpc_bid_micros |
CPC bid micros |
The CPC bid for the keyword within a keyword plan ad group, expressed in micros. |
dimension |
keyword_plan_ad_group_keyword.id |
Keyword plan keyword id |
The unique identifier for the keyword plan keyword. |
dimension |
keyword_plan_ad_group_keyword.match_type |
Keyword match type |
The match type of the keyword within the keyword plan (e.g., EXACT, PHRASE, BROAD). |
dimension |
keyword_plan_ad_group_keyword.negative |
Negative |
Indicates if the keyword in the keyword plan is a negative keyword, preventing ads from showing for those terms. |
dimension |
keyword_plan_ad_group_keyword.text |
Keyword text |
The text of the keyword within a keyword plan ad group. |
dimension |
keyword_plan_campaign.name |
Keyword plan campaign name |
The name of the campaign within a keyword plan. |
dimension |
keyword_view.resource_name |
Keyword view resource name |
The resource name of the keyword view, providing performance data segmented by individual keywords. |
dimension |
label.id |
Label ID |
The unique identifier for the label. |
dimension |
label.name |
Label Name |
The name of the label. |
dimension |
landing_page_view.resource_name |
Landing page view resource name |
The resource name of the landing page view, providing performance data for landing pages. |
dimension |
landing_page_view.unexpanded_final_url |
Landing page |
The unexpanded final URL of the landing page, before any tracking templates or custom parameters are applied. |
dimension |
language |
language |
This field represents the language targeting setting for a campaign or ad group, identified by a language ID or code. |
dimension |
lead_form_submission_data.gclid |
Gclid |
The Google Click Identifier (GCLID) associated with the lead form submission. |
dimension |
lead_form_submission_data.id |
ID |
The unique identifier for the lead form submission. |
dimension |
lead_form_submission_data.lead_form_submission_fields |
Lead form submission fields |
The fields and their values submitted by the user through the lead form. |
dimension |
lead_form_submission_data.submission_date_time |
Submission date time |
The date and time when the lead form was submitted. |
dimension |
local_services_lead.category_id |
Lead category ID |
The category ID for the Local Services lead, identifying the service type. |
dimension |
local_services_lead.contact_details |
Lead contact details |
The contact details provided by the lead from Local Services Ads. |
dimension |
local_services_lead.creation_date_time |
Lead creation date |
The date and time when the Local Services lead was created. |
dimension |
local_services_lead.credit_details.credit_state |
Lead credit state |
The current credit state of the Local Services lead (e.g., CHARGED, CREDITED, PENDING). |
dimension |
local_services_lead.credit_details.credit_state_last_update_date_time |
Lead credit state last updated date |
The date and time when the credit state of the Local Services lead was last updated. |
dimension |
local_services_lead.id |
Lead ID |
The unique identifier for the Local Services lead. |
dimension |
local_services_lead.lead_charged |
Lead charged |
Indicates if the Local Services lead resulted in a charge to the advertiser. |
dimension |
local_services_lead.lead_status |
Lead status |
The current status of the Local Services lead (e.g., NEW, BOOKED, ARCHIVED). |
dimension |
local_services_lead.lead_type |
Lead type |
The type of Local Services lead (e.g., PHONE_CALL, MESSAGE). |
dimension |
local_services_lead.locale |
Lead locale |
The locale (language and region) of the Local Services lead. |
dimension |
local_services_lead.service_id |
Lead service ID |
The service ID related to the Local Services lead. |
dimension |
location_view.resource_name |
Location view resource name |
The resource name of the location view, providing performance data segmented by geographic location. |
dimension |
managed_placement_view.resource_name |
Managed placement view resource name |
The resource name of the managed placement view, providing performance data for placements explicitly targeted by the advertiser. |
dimension |
mcc.id |
MCC ID |
The unique identifier for the Manager Account (MCC). |
dimension |
mcc.name |
MCC name |
The name of the Manager Account (MCC). |
dimension |
metrics.absolute_top_impression_percentage |
Absolute Top Impression (%) |
The percentage of impressions that were shown as the very first ad above the organic search results. |
metric |
metrics.active_view_cpm |
Active view average CPM |
The average cost-per-thousand viewable impressions (CPM) for ads served on the Google Display Network or YouTube. |
metric |
metrics.active_view_ctr |
Active view viewable CTR |
The Click-Through Rate (CTR) specifically for viewable impressions. |
metric |
metrics.active_view_impressions |
Active view viewable impressions |
The number of viewable impressions served. An impression is counted as viewable if at least 50% of its pixels are on screen for at least one second for display ads, or two consecutive seconds for video ads. |
metric |
metrics.active_view_measurability |
Active view measurability |
The percentage of impressions that were measurable by Active View. |
metric |
metrics.active_view_measurable_cost_micros |
Active view measurable cost |
The cost in micros for impressions that were measurable by Active View. |
metric |
metrics.active_view_measurable_impressions |
Active view measurable impressions |
The number of impressions that were measurable by Active View. |
metric |
metrics.active_view_viewability |
Active view viewability |
The percentage of Active View measurable impressions that were actually viewable. |
metric |
metrics.all_conversions |
All conversions |
The total number of all conversions, including those that are not reported in the ‘Conversions’ column. |
metric |
metrics.all_conversions_by_conversion_date |
All conversions (by conversion time) |
The total number of all conversions, reported based on the date the conversion actually occurred. |
metric |
metrics.all_conversions_from_click_to_call |
All conversions from click to call |
The total number of all conversions resulting from click-to-call interactions. |
metric |
metrics.all_conversions_from_directions |
All conversions from directions |
The total number of all conversions resulting from requests for directions to a business location. |
metric |
metrics.all_conversions_from_interactions_rate |
All conversion rate |
The rate at which interactions led to all conversions. |
metric |
metrics.all_conversions_from_interactions_value_per_interaction |
All conversions from interactions per interaction value |
The total value of all conversions divided by the total number of interactions. |
metric |
metrics.all_conversions_from_location_asset_click_to_call |
All conversions from location asset click to call |
The total number of all conversions resulting from click-to-call interactions via a location asset. |
metric |
metrics.all_conversions_from_location_asset_directions |
All conversions from location asset directions |
The total number of all conversions resulting from directions requests via a location asset. |
metric |
metrics.all_conversions_from_location_asset_menu |
All conversions from location asset menu |
Number of menu link clicks on any location surface after a chargeable ad event (click or impression). |
metric |
metrics.all_conversions_from_location_asset_order |
All conversions from location asset order |
Number of order clicks on any location surface after a chargeable ad event (click or impression). |
metric |
metrics.all_conversions_from_location_asset_other_engagement |
All conversions from location asset other engagement |
Number of other types of local action clicks on any location surface after a chargeable ad event (click or impression). |
metric |
metrics.all_conversions_from_location_asset_store_visits |
All conversions from location asset store visits |
Estimated number of visits to the store after a chargeable ad event (click or impression). |
metric |
metrics.all_conversions_from_location_asset_website |
All conversions from location asset website |
Number of website URL clicks on any location surface after a chargeable ad event (click or impression). |
metric |
metrics.all_conversions_from_menu |
All conversions from menu |
The number of times people clicked a link to view a store’s menu after clicking an ad. This metric applies to feed items only. |
metric |
metrics.all_conversions_from_order |
All conversions from order |
The number of times people placed an order at a store after clicking an ad. This metric applies to feed items only. |
metric |
metrics.all_conversions_from_other_engagement |
All conversions from other engagement |
The number of other conversions (for example, posting a review or saving a location for a store) that occurred after people clicked an ad. This metric applies to feed items only. |
metric |
metrics.all_conversions_from_store_visit |
All conversions from store visit |
Estimated number of times people visited a store after clicking an ad. This metric applies to feed items only. |
metric |
metrics.all_conversions_from_store_website |
All conversions from store website |
The number of times that people were taken to a store’s URL after clicking an ad. This metric applies to feed items only. |
metric |
metrics.all_conversions_value |
All conversions value |
The value of all conversions. |
metric |
metrics.all_conversions_value_by_conversion_date |
All conversion value (by conversion time) |
The value of all conversions. When this column is selected with date, the values in date column means the conversion date. |
metric |
metrics.all_conversions_value_per_cost |
All conversions per cost |
The value of all conversions divided by the total cost of ad interactions (such as clicks for text ads or views for video ads). |
metric |
metrics.average_cart_size |
Average cart size |
Average cart size is the average number of products in each order attributed to your ads. Calculated by total number of products sold divided by total number of orders received. |
metric |
metrics.average_cost |
Average cost |
The average amount you pay per interaction. This amount is the total cost of your ads divided by the total number of interactions. |
metric |
metrics.average_cpc |
Average CPC |
The average amount an advertiser pays each time a user clicks on one of their ads. It is calculated by dividing the total cost of all clicks by the total number of clicks. This metric is returned in micros and needs to be divided by 1,000,000 to get the actual value. |
metric |
metrics.average_cpe |
Average CPE |
The average amount that you’ve been charged for an ad engagement. This amount is the total cost of all ad engagements divided by the total number of ad engagements. |
metric |
metrics.average_cpm |
Average CPM |
Average cost-per-thousand impressions (CPM), based on your total cost and impressions. |
metric |
metrics.average_cpv |
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. This metric is returned in micros. |
metric |
metrics.average_impression_frequency_per_user |
Average impression frequency per user |
The average number of times a unique user saw your ad during the requested time period. This metric cannot be aggregated, and can only be requested for date ranges of 92 days or less. This metric is available for Display, Video, Discovery, and App campaign types. |
metric |
metrics.average_order_value_micros |
Average order value micros |
Average order value is the average revenue you made per order attributed to your ads. This metric is returned in micros. |
metric |
metrics.average_page_views |
Average page views |
Average number of pages viewed per session. |
metric |
metrics.average_target_cpa_micros |
Average target cpa micros |
The average Target CPA. This metric allows you to measure the Cost-Per-Acquisition that your bid strategy targeted for specific time periods. This metric is returned in micros. |
metric |
metrics.average_target_roas |
Average target roas |
The average Target ROAS (Return On Ad Spend). This metric allows you to measure the ROAS that your bid strategy targeted for specific time periods. |
metric |
metrics.average_time_on_site |
Average session duration (seconds) |
Total duration of all sessions (in seconds) divided by the number of sessions. Imported from Google Analytics. |
metric |
metrics.benchmark_average_max_cpc |
Benchmark average maximum CPC |
The benchmark average maximum CPC for a product partition, used to compare your performance against competitors. |
metric |
metrics.benchmark_ctr |
Benchmark CTR |
The benchmark CTR for a product partition, used to compare your performance against competitors. |
metric |
metrics.biddable_app_install_conversions |
Biddable app install conversions |
The number of app install conversions from biddable actions. This metric is not available on all resource levels. |
metric |
metrics.biddable_app_post_install_conversions |
Biddable app post install conversions |
The number of app post-install conversions from biddable actions. This metric is not available on all resource levels. |
metric |
metrics.bounce_rate |
Bounce rate |
The percentage of sessions in which a visitor only saw one page and did not navigate to other pages on your site. Imported from Google Analytics. |
metric |
metrics.clicks |
Clicks |
The number of clicks your ad has received. In some reports, this includes all clicks (charged and free), while in others it refers only to charged clicks. |
metric |
metrics.combined_clicks |
Combined clicks |
Total number of clicks from both ads and organic search results. |
metric |
metrics.combined_clicks_per_query |
Combined clicks per query |
The number of clicks from ads or organic search results divided by the total number of searches that returned pages from your site or triggered one of your ads. |
metric |
metrics.combined_queries |
Combined queries |
Total number of searches that returned pages from your site in the organic search results or triggered one of your ads. |
metric |
metrics.content_budget_lost_impression_share |
Content lost impression share (budget) |
The estimated percentage of times that your ad was eligible to show on the Display Network but didn’t because your budget was too low. |
metric |
metrics.content_impression_share |
Content impression share |
The impressions you’ve received on the Display Network divided by the estimated number of impressions you were eligible to receive. Reported in the range of 0.1 to 1, with values below 0.1 reported as 0.0999. |
metric |
metrics.content_rank_lost_impression_share |
Content lost impression share (rank) |
The estimated percentage of impressions on the Display Network that your ads didn’t receive due to poor Ad Rank. Reported in the range of 0 to 0.9, with values above 0.9 reported as 0.9001. |
metric |
metrics.conversion_last_conversion_date |
Last conversion date |
The date of the most recent conversion recorded. |
metric |
metrics.conversion_last_received_request_date_time |
Last received conversion request |
The date and time when the last conversion tracking request was received. |
metric |
metrics.conversions |
Conversions |
The number of conversions. This only includes conversion actions for which ‘include_in_conversions_metric’ is set to true. If you use conversion-based bidding, your bid strategies will optimize for these conversions. |
metric |
metrics.conversions_by_conversion_date |
Conversions (by conversion time) |
The sum of conversions by conversion date for biddable conversion types. Can be fractional due to attribution modeling. When this column is selected with date, the values in the date column represent the conversion date. |
metric |
metrics.conversions_from_interactions_rate |
Conversion rate |
Conversions from interactions divided by the number of ad interactions (such as clicks for text ads or views for video ads). This rate shows how often an ad interaction leads to a conversion. |
metric |
metrics.conversions_from_interactions_value_per_interaction |
Interaction conversions per interaction |
The value of conversions from interactions divided by the number of ad interactions. This only includes conversion actions where ‘include_in_conversions_metric’ is true. |
metric |
metrics.conversions_value |
Total conversion value |
The sum of conversion values for the conversions included in the ‘conversions’ field. This metric is useful only if you have assigned values to your conversion actions. |
metric |
metrics.conversions_value_by_conversion_date |
Conversion value (by conversion time) |
The sum of biddable conversions value by conversion date. When this column is selected with date, the values in the date column represent the conversion date. |
metric |
metrics.conversions_value_per_cost |
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. |
metric |
metrics.cost_micros |
Cost |
The sum of your cost-per-click (CPC) and cost-per-thousand impressions (CPM) costs during this period. This value is in micros (1,000,000 times the account currency) and needs to be divided by 1,000,000 to get the actual cost value. |
metric |
metrics.cost_of_goods_sold_micros |
Cost of goods sold micros |
Cost of goods sold (COGS) is the total cost of the products you sold in orders attributed to your ads. This metric is returned in micros. |
metric |
metrics.cost_per_all_conversions |
Cost per all conversion |
The cost of ad interactions divided by all conversions. This represents the average cost per all conversions. |
metric |
metrics.cost_per_conversion |
Cost per conversion |
The cost of ad interactions divided by conversions. This represents the average cost per conversion for actions where ‘include_in_conversions_metric’ is true. |
metric |
metrics.cost_per_current_model_attributed_conversion |
Cost per conversion (current model) |
The cost of ad interactions divided by current model attributed conversions. This represents the average cost per conversion based on your currently selected attribution model. |
metric |
metrics.cross_device_conversions |
Cross-device conversions |
Conversions from when a customer clicks on a Google Ads ad on one device, then converts on a different device or browser. Cross-device conversions are already included in ‘all_conversions’. |
metric |
metrics.cross_sell_cost_of_goods_sold_micros |
Cross sell cost of goods sold micros |
Cost of goods sold (COGS) from products sold as a result of advertising a different product (cross-sell). This metric is returned in micros. |
metric |
metrics.cross_sell_gross_profit_micros |
Cross sell gross profit micros |
Gross profit from products sold as a result of advertising a different product (cross-sell). This metric is returned in micros. |
metric |
metrics.cross_sell_revenue_micros |
Cross sell revenue micros |
Revenue from products sold as a result of advertising a different product (cross-sell). This metric is returned in micros. |
metric |
metrics.cross_sell_units_sold |
Cross sell units sold |
The total number of products sold as a result of advertising a different product (cross-sell). This metric is only available if you report conversions with cart data. |
metric |
metrics.ctr |
CTR |
Click-through rate (CTR) is the number of clicks your ad received divided by the number of times your ad was shown (impressions). It indicates how relevant and engaging your ad is to users. |
metric |
metrics.current_model_attributed_conversions |
Conversions (current model) |
Shows how your historic conversions data would look under the attribution model you’ve currently selected. This only includes conversion actions where ‘include_in_conversions_metric’ is true. |
metric |
metrics.current_model_attributed_conversions_from_interactions_rate |
Model conversions from interactions |
Current model attributed conversions from interactions divided by the number of ad interactions. This rate shows how often an ad interaction leads to a conversion based on your current attribution model. |
metric |
metrics.current_model_attributed_conversions_from_interactions_value_per_interaction |
Conversions from interactions per interaction value |
The value of current model attributed conversions from interactions divided by the number of ad interactions. This only includes conversion actions where ‘include_in_conversions_metric’ is true. |
metric |
metrics.current_model_attributed_conversions_value |
Conversion value (current model) |
The value of current model attributed conversions. This only includes conversion actions where ‘include_in_conversions_metric’ is true. |
metric |
metrics.current_model_attributed_conversions_value_per_cost |
Model conversions per cost of ad |
The value of current model attributed conversions divided by the cost of ad interactions. This only includes conversion actions where ‘include_in_conversions_metric’ is true. |
metric |
metrics.eligible_impressions_from_location_asset_store_reach |
Eligible impressions from location asset store reach |
Number of impressions in which the store location was shown or the location was used for targeting. |
metric |
metrics.engagement_rate |
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 (impressions). |
metric |
metrics.engagements |
Engagements |
The number of engagements with your ad. An engagement occurs when a viewer expands your Lightbox ad, watches a video ad for a certain duration, or clicks on a video ad. |
metric |
metrics.gmail_forwards |
Gmail forwards |
The number of times a Gmail ad was forwarded to someone else as a message. |
metric |
metrics.gmail_saves |
Gmail saves |
The number of times someone has saved your Gmail ad to their inbox as a message. |
metric |
metrics.gmail_secondary_clicks |
Gmail clicks to website |
The number of clicks to the landing page on the expanded state of Gmail ads. |
metric |
metrics.gross_profit_margin |
Gross profit margin |
The gross profit margin from products sold, calculated as (revenue - cost of goods sold) / revenue. This metric is available if you provide cost of goods sold (COGS) data. |
metric |
metrics.gross_profit_micros |
Gross profit micros |
The total amount of gross profit from products sold. This metric is returned in micros and is available if you provide cost of goods sold (COGS) data. |
metric |
metrics.historical_creative_quality_score |
Ad relevance (historical) |
Historical quality score for ad relevance, measuring the performance of the ad compared to other advertisers. Available at the keyword level. |
metric |
metrics.historical_landing_page_quality_score |
Landing page experience (historical) |
Historical quality score for landing page experience, measuring the quality of the landing page. Available at the keyword level. |
metric |
metrics.historical_quality_score |
Quality score (historical) |
Overall historical Quality Score for keywords, on a scale from 1-10. This score influences ad position and cost-per-click. |
metric |
metrics.historical_search_predicted_ctr |
Expected clickthrough rate (historical) |
Historical expected click-through rate (CTR) for keywords, representing the likelihood of your ad being clicked when shown, compared to other advertisers. |
metric |
metrics.hotel_average_lead_value_micros |
Hotel average lead value (micros) |
Average lead value for hotel ads. This metric is returned in micros. |
metric |
metrics.hotel_eligible_impressions |
Hotel eligible impressions |
The total number of opportunities your hotel ad was eligible to show (entered the auction) based on the targeting criteria over the specified time period. |
metric |
metrics.hotel_price_difference_percentage |
Hotel price difference (%) |
For hotel campaigns, the percentage difference in price compared to a benchmark, indicating competitiveness. |
metric |
metrics.impressions |
Impressions |
The number of times your ad has appeared on a search results page or website on the Google Network. |
metric |
metrics.impressions_from_store_reach |
Location-based store ad impressions |
Location-based store ad impressions, indicating how often a store location was shown or used for targeting in an ad. |
metric |
metrics.interaction_event_types |
Interaction types |
The types of payable and free interactions with an ad, such as clicks, views, or engagements. |
metric |
metrics.interaction_rate |
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 (impressions). |
metric |
metrics.interactions |
Interactions |
The number of interactions with your ad. An interaction is the main user action associated with an ad format (e.g., clicks for text/shopping ads, views for video ads). |
metric |
metrics.invalid_click_rate |
Invalid click rate |
The percentage of all clicks on an ad that are considered invalid by Google (e.g., accidental clicks, fraudulent traffic). Google automatically filters these from reports. |
metric |
metrics.invalid_clicks |
Invalid clicks |
The number of clicks that Google Ads identified as invalid and filtered out. |
metric |
metrics.lead_cost_of_goods_sold_micros |
Lead cost of goods sold micros |
Cost of goods sold (COGS) from products sold as a result of advertising the same product (lead). This metric is returned in micros. |
metric |
metrics.lead_gross_profit_micros |
Lead gross profit micros |
Gross profit from products sold as a result of advertising the same product (lead). This metric is returned in micros. |
metric |
metrics.lead_revenue_micros |
Lead revenue micros |
Revenue from products sold as a result of advertising the same product (lead). This metric is returned in micros. |
metric |
metrics.lead_units_sold |
Lead units sold |
The total number of products sold as a result of advertising the same product (lead). This metric is only available if you report conversions with cart data. |
metric |
metrics.message_chat_rate |
Message chat rate |
The rate at which message ads resulted in chats. |
metric |
metrics.message_chats |
Message chats |
The number of message chats initiated from message ads. |
metric |
metrics.message_impressions |
Message impressions |
The number of impressions for message ads. |
metric |
metrics.mobile_friendly_clicks_percentage |
Mobile-friendly click rate |
The percentage of clicks on your ads that lead to a mobile-friendly landing page. |
metric |
metrics.optimization_score_uplift |
Optimization score uplift |
The estimated increase in optimization score if all related recommendations are applied. This is an estimate based on all available recommendations as a whole. |
metric |
metrics.optimization_score_url |
Optimization score url |
A deep link into the Google Ads UI to view information on related recommendations. |
metric |
metrics.orders |
Orders |
The total number of purchase conversions you received attributed to your ads. This metric is only available if you report conversions with cart data. |
metric |
metrics.organic_clicks |
Organic clicks |
The number of times someone clicked your site’s listing in the unpaid search results for a particular query. |
metric |
metrics.organic_clicks_per_query |
Organic clicks per query |
The number of clicks you’ve received on your organic search listings divided by the total number of searches that returned pages from your site. |
metric |
metrics.organic_impressions |
Organic listings |
The number of times a page from your site was listed in the organic search results. |
metric |
metrics.organic_impressions_per_query |
Organic listings per query |
Average number of times a page from your site was listed per query in organic search results. |
metric |
metrics.organic_queries |
Organic queries |
Total number of searches that returned organic search results for your site over the given period. |
metric |
metrics.percent_new_visitors |
New sessions (%) |
Percentage of first-time sessions (from people who had never visited your site before). Imported from Google Analytics. |
metric |
metrics.phone_calls |
Phone calls |
The number of offline phone calls received. |
metric |
metrics.phone_impressions |
Phone impressions |
The number of times your phone number is shown in ads, leading to a phone call. |
metric |
metrics.phone_through_rate |
PTR |
Number of phone calls received (metrics.phone_calls) divided by the number of times your phone number is shown (metrics.phone_impressions). |
metric |
metrics.publisher_organic_clicks |
Publisher organic clicks |
The count of ad clicks collected from unpaid and owned traffic to the publisher site where the ad is published. |
metric |
metrics.publisher_purchased_clicks |
Publisher purchased clicks |
The count of ad clicks from paid third-party traffic to the site where the ad is published. |
metric |
metrics.publisher_unknown_clicks |
Publisher unknown clicks |
The count of clicks not definitively identified as organic or purchased traffic to the publisher site. |
metric |
metrics.relative_ctr |
Relative CTR |
Your click-through rate (CTR) divided by the average click-through rate of all advertisers on the websites that show your ads. Measures how your ads perform on Display Network sites compared to other ads on the same sites. |
metric |
metrics.revenue_micros |
Revenue micros |
The total amount of revenue generated from orders attributed to your ads. This metric is returned in micros. |
metric |
metrics.search_absolute_top_impression_share |
Search absolute top impression share |
The percentage of your Search ad impressions that are shown in the most prominent Search position (the very first ad above organic search results). |
metric |
metrics.search_budget_lost_absolute_top_impression_share |
Search lost absolute top impression share (budget) |
The estimated percentage of times that your ad was eligible to show as the very first ad above the organic search results but didn’t because your budget was too low. |
metric |
metrics.search_budget_lost_impression_share |
Search lost impression share (budget) |
The estimated percentage of times that your ad was eligible to show on the Search Network but didn’t because your budget was too low. This data is available at the campaign level only. |
metric |
metrics.search_budget_lost_top_impression_share |
Search lost top impression share (budget) |
The estimated percentage of times that your ad was eligible to show anywhere above the organic search results but didn’t because your budget was too low. |
metric |
metrics.search_click_share |
Click share |
The estimated percentage of all available clicks on the Search Network that your ads received. |
metric |
metrics.search_exact_match_impression_share |
Search exact match impression share |
The impressions you’ve received for search terms that precisely matched your keywords, divided by the estimated total number of exact match impressions you were eligible to receive. |
metric |
metrics.search_impression_share |
Search impression share |
The impressions you’ve received on the Search Network divided by the estimated number of impressions you were eligible to receive. |
metric |
metrics.search_rank_lost_absolute_top_impression_share |
Search lost absolute top impression share (rank) |
The estimated percentage of times your ad was not the very first ad above the organic search results due to a low Ad Rank. |
metric |
metrics.search_rank_lost_impression_share |
Search lost impression share (rank) |
The estimated percentage of times that your ads weren’t shown on the Search Network due to poor Ad Rank in the auction. |
metric |
metrics.search_rank_lost_top_impression_share |
Search lost top impression share (rank) |
The estimated percentage of times your ad did not show anywhere above the organic search results because of a low Ad Rank. |
metric |
metrics.search_top_impression_share |
Search top impression share |
The percentage of your Search ad impressions that are shown anywhere above the organic search results. |
metric |
metrics.search_volume |
Search volume |
Average monthly searches for keywords over the past 12 months. This is a historical metric used in keyword planning. |
metric |
metrics.sk_ad_network_installs |
Sk ad network installs |
The number of app installs attributed via SKAdNetwork. |
metric |
metrics.sk_ad_network_total_conversions |
Sk ad network total conversions |
The total number of conversions attributed via SKAdNetwork. |
metric |
metrics.speed_score |
Mobile speed score |
Mobile speed score for landing pages, indicating how quickly a page loads and becomes interactive. |
metric |
metrics.top_impression_percentage |
Top Impression (%) |
The percentage of your ad impressions that are shown anywhere above the organic search results. |
metric |
metrics.unique_users |
Unique users |
The number of unique users who saw your ad during the requested time period. This metric cannot be aggregated, and can only be requested for date ranges of 92 days or less. Available for Display, Video, Discovery, and App campaign types. |
metric |
metrics.units_sold |
Units sold |
The total count of products sold as a result of your advertising. This metric is only available if you report conversions with cart data. |
metric |
metrics.valid_accelerated_mobile_pages_clicks_percentage |
Valid AMP click rate |
The percentage of clicks that land on a valid Accelerated Mobile Pages (AMP) landing page. |
metric |
metrics.value_per_all_conversions |
Value per all conversion |
The value of all conversions divided by the number of all conversions. This represents the average value per all conversions. |
metric |
metrics.value_per_all_conversions_by_conversion_date |
Value / all conversion (by conversion time) |
The value of all conversions divided by the number of all conversions. When this column is selected with date, the values in the date column represent the conversion date. |
metric |
metrics.value_per_conversion |
Value per conversion |
The value of conversions divided by the number of conversions. This represents the average value per conversion for actions where ‘include_in_conversions_metric’ is true. |
metric |
metrics.value_per_conversions_by_conversion_date |
Value / conversion (by conversion time) |
The value of biddable conversions divided by the number of biddable conversions, segmented by conversion date. |
metric |
metrics.value_per_current_model_attributed_conversion |
Value per conversion (current model) |
The value of current model attributed conversions divided by the number of current model attributed conversions. This represents the average value per conversion based on your current attribution model. |
metric |
metrics.video_quartile_p100_rate |
Video played to 100% |
Percentage of impressions where the viewer watched 100% of your video ad. |
metric |
metrics.video_quartile_p25_rate |
Video played to 25% |
Percentage of impressions where the viewer watched 25% of your video ad. |
metric |
metrics.video_quartile_p50_rate |
Video played to 50% |
Percentage of impressions where the viewer watched 50% of your video ad. |
metric |
metrics.video_quartile_p75_rate |
Video played to 75% |
Percentage of impressions where the viewer watched 75% of your video ad. |
metric |
metrics.video_view_rate |
View rate |
The number of views your video ad receives divided by its number of impressions, including thumbnail impressions for TrueView in-display ads. |
metric |
metrics.video_views |
Views |
The number of times your video ads were viewed. |
metric |
metrics.view_through_conversions |
View-through conversions |
Conversions that 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. |
metric |
metrics.view_through_conversions_from_location_asset_click_to_call |
View through conversions from location asset click to call |
Number of call button clicks on any location surface after an impression, leading to a view-through conversion. |
metric |
metrics.view_through_conversions_from_location_asset_directions |
View through conversions from location asset directions |
Number of directions clicks on any location surface after an impression, leading to a view-through conversion. |
metric |
metrics.view_through_conversions_from_location_asset_menu |
View through conversions from location asset menu |
Number of menu link clicks on any location surface after an impression, leading to a view-through conversion. |
metric |
metrics.view_through_conversions_from_location_asset_order |
View through conversions from location asset order |
Number of order clicks on any location surface after an impression, leading to a view-through conversion. |
metric |
metrics.view_through_conversions_from_location_asset_other_engagement |
View through conversions from location asset other engagement |
Number of other types of local action clicks on any location surface after an impression, leading to a view-through conversion. |
metric |
metrics.view_through_conversions_from_location_asset_store_visits |
View through conversions from location asset store visits |
Estimated number of visits to the store after an impression, leading to a view-through conversion. |
metric |
metrics.view_through_conversions_from_location_asset_website |
View through conversions from location asset website |
Number of website URL clicks on any location surface after an impression, leading to a view-through conversion. |
metric |
paid_organic_search_term_view.resource_name |
Paid organic search term view resource name |
Resource name for the paid and organic search term view, which combines data from paid ads and organic search results for a given search query. |
dimension |
paid_organic_search_term_view.search_term |
Query |
The actual search term entered by a user that triggered an ad or organic listing. |
dimension |
parental_status_view.resource_name |
Parental status view resource name |
The resource name for the parental status targeting view. |
dimension |
per_store_view.place_id |
Per store view place ID |
The unique identifier of a specific store location for which data is reported. |
dimension |
performance_max_placement_view.display_name |
Performance Max Placement View Display Name |
A user-friendly name for the placement of ads in a Performance Max campaign. |
dimension |
performance_max_placement_view.placement |
Performance Max Placement View Placement |
The specific location where ads from a Performance Max campaign were displayed. |
dimension |
performance_max_placement_view.placement_type |
Performance Max Placement View Placement Type |
The type of placement (e.g., WEBSITE, YOUTUBE) for ads in a Performance Max campaign. |
dimension |
performance_max_placement_view.resource_name |
Performance Max Placement View Resource Name |
The resource name for the Performance Max placement view, uniquely identifying it within the Google Ads API. |
dimension |
performance_max_placement_view.target_url |
Performance Max Placement View Target URL |
The URL where an ad from a Performance Max campaign was displayed. |
dimension |
product |
product |
Refers to a specific product advertised in Shopping or Performance Max campaigns, providing performance data related to that product. |
dimension |
product_group_view.resource_name |
Product group view resource name |
Resource name for the product group view, which provides aggregated reporting statistics for product groups within Shopping campaigns. |
dimension |
recommendation_description |
recommendation_description |
A detailed description of the optimization recommendation provided by Google Ads, fetched via RecommendationService. |
dimension |
recommendation_details |
recommendation_details |
Additional detailed information or context about the optimization recommendation, fetched via RecommendationService. |
dimension |
recommendation_id |
recommendation_id |
The unique identifier for an optimization recommendation, fetched via RecommendationService. |
dimension |
recommendation_type |
recommendation_type |
The category or type of the optimization recommendation (e.g., ‘Add keywords,’ ‘Improve responsive search ads’), fetched via RecommendationService. |
dimension |
responsive.search.ad.descriptions_1 |
Responsive search ad descriptions 1 |
The text content for the first description asset in a Responsive Search Ad. |
dimension |
responsive.search.ad.descriptions_2 |
Responsive search ad descriptions 2 |
The text content for the second description asset in a Responsive Search Ad. |
dimension |
responsive.search.ad.descriptions_3 |
Responsive search ad descriptions 3 |
The text content for the third description asset in a Responsive Search Ad. |
dimension |
responsive.search.ad.descriptions_4 |
Responsive search ad descriptions 4 |
The text content for the fourth description asset in a Responsive Search Ad. |
dimension |
responsive.search.ad.headlines_1 |
Responsive search ad headlines 1 |
The text for a specific headline of a Responsive Search Ad. Responsive Search Ads allow for up to 15 headlines that dynamically rotate to create different ad combinations. |
dimension |
responsive.search.ad.headlines_10 |
Responsive search ad headlines 10 |
The text for a specific headline of a Responsive Search Ad. Responsive Search Ads allow for up to 15 headlines that dynamically rotate to create different ad combinations. |
dimension |
responsive.search.ad.headlines_11 |
Responsive search ad headlines 11 |
The text for a specific headline of a Responsive Search Ad. Responsive Search Ads allow for up to 15 headlines that dynamically rotate to create different ad combinations. |
dimension |
responsive.search.ad.headlines_12 |
Responsive search ad headlines 12 |
The text for a specific headline of a Responsive Search Ad. Responsive Search Ads allow for up to 15 headlines that dynamically rotate to create different ad combinations. |
dimension |
responsive.search.ad.headlines_13 |
Responsive search ad headlines 13 |
The text for a specific headline of a Responsive Search Ad. Responsive Search Ads allow for up to 15 headlines that dynamically rotate to create different ad combinations. |
dimension |
responsive.search.ad.headlines_14 |
Responsive search ad headlines 14 |
The text for a specific headline of a Responsive Search Ad. Responsive Search Ads allow for up to 15 headlines that dynamically rotate to create different ad combinations. |
dimension |
responsive.search.ad.headlines_15 |
Responsive search ad headlines 15 |
The text for a specific headline of a Responsive Search Ad. Responsive Search Ads allow for up to 15 headlines that dynamically rotate to create different ad combinations. |
dimension |
responsive.search.ad.headlines_2 |
Responsive search ad headlines 2 |
The text for a specific headline of a Responsive Search Ad. Responsive Search Ads allow for up to 15 headlines that dynamically rotate to create different ad combinations. |
dimension |
responsive.search.ad.headlines_3 |
Responsive search ad headlines 3 |
The text for a specific headline of a Responsive Search Ad. Responsive Search Ads allow for up to 15 headlines that dynamically rotate to create different ad combinations. |
dimension |
responsive.search.ad.headlines_4 |
Responsive search ad headlines 4 |
The text for a specific headline of a Responsive Search Ad. Responsive Search Ads allow for up to 15 headlines that dynamically rotate to create different ad combinations. |
dimension |
responsive.search.ad.headlines_5 |
Responsive search ad headlines 5 |
The text for a specific headline of a Responsive Search Ad. Responsive Search Ads allow for up to 15 headlines that dynamically rotate to create different ad combinations. |
dimension |
responsive.search.ad.headlines_6 |
Responsive search ad headlines 6 |
The text for a specific headline of a Responsive Search Ad. Responsive Search Ads allow for up to 15 headlines that dynamically rotate to create different ad combinations. |
dimension |
responsive.search.ad.headlines_7 |
Responsive search ad headlines 7 |
The text for a specific headline of a Responsive Search Ad. Responsive Search Ads allow for up to 15 headlines that dynamically rotate to create different ad combinations. |
dimension |
responsive.search.ad.headlines_8 |
Responsive search ad headlines 8 |
The text for a specific headline of a Responsive Search Ad. Responsive Search Ads allow for up to 15 headlines that dynamically rotate to create different ad combinations. |
dimension |
responsive.search.ad.headlines_9 |
Responsive search ad headlines 9 |
The text for a specific headline of a Responsive Search Ad. Responsive Search Ads allow for up to 15 headlines that dynamically rotate to create different ad combinations. |
dimension |
revenue |
revenue |
The monetary value generated from conversions. This often corresponds to conversion value metrics. |
metric |
search_term_view.ad_group |
Search term view ad group |
The resource name of the ad group associated with a search term in the search_term_view report. |
dimension |
search_term_view.resource_name |
Search term view resource name |
The resource name for the search_term_view entity, serving as its unique identifier within the Google Ads API. |
dimension |
search_term_view.search_term |
Search term |
The actual search query entered by a user that triggered an ad. This is available in the search_term_view report. |
dimension |
search_term_view.status |
Added/excluded |
The status of the search term, indicating whether it has been added as a keyword or excluded as a negative keyword. |
dimension |
segments.ad_destination_type |
Destination type |
The type of destination a user is taken to after clicking an ad (e.g., Website, App Deep Link). |
dimension |
segments.ad_format_type |
Ad format type |
The format type of the ad, such as text ad, image ad, or video ad. |
dimension |
segments.ad_network_type |
Network |
The type of ad network where the impression occurred (e.g., Google Search, Search Partners, Display Network, YouTube). |
dimension |
segments.auction_insight_domain |
Auction insight domain |
A segment representing the domain of a competitor in the auction insights report. |
dimension |
segments.click_type |
Click type |
The type of click that occurred on the ad, such as headline, sitelink, or phone call. |
dimension |
segments.conversion_action |
Conversion Tracker ID |
The resource name of the conversion action that recorded the conversion. |
dimension |
segments.conversion_action_category |
Conversion category |
The category of the conversion action (e.g., PURCHASE, LEAD, DOWNLOAD). |
dimension |
segments.conversion_action_name |
Conversion name |
The name of the conversion action. |
dimension |
segments.conversion_adjustment |
Conversion adjustment |
Indicates whether a conversion was adjusted (e.g., due to a return or cancellation). |
dimension |
segments.conversion_attribution_event_type |
Ad event type |
A segment categorizing conversions by the type of ad event that led to them. |
dimension |
segments.conversion_lag_bucket |
Days to conversion |
A segment that groups conversions by the number of days between the ad interaction and the conversion. |
dimension |
segments.date |
Day |
The specific date to which the metrics in the report apply, formatted as YYYY-MM-DD. |
dimension |
segments.day_of_week |
Day of week |
The day of the week (e.g., MONDAY, TUESDAY) to which the metrics apply. |
dimension |
segments.device |
Device |
The device type on which the ad was shown (e.g., mobile, desktop, tablet). |
dimension |
segments.external_conversion_source |
Conversion source |
The external source from which the conversion was imported (e.g., SALESFORCE, GOOGLE_ANALYTICS). |
dimension |
segments.geo_target_city |
City |
The geographical city used for targeting or for which performance data is reported. |
dimension |
segments.geo_target_county |
Target county |
The geographical county used for targeting or for which performance data is reported. |
dimension |
segments.geo_target_metro |
Metro area |
The geographical metro area (e.g., designated market area) used for targeting or for which performance data is reported. |
dimension |
segments.geo_target_most_specific_location |
Most specific location |
The most specific geographical location targeted or for which performance data is reported. |
dimension |
segments.geo_target_postal_code |
Target postal code |
Geographical targeting by postal code, used to segment performance data. |
dimension |
segments.geo_target_region |
Region |
The geographical region (e.g., state, province) used for targeting or for which performance data is reported. |
dimension |
segments.geo_target_state |
Target state |
The geographical state used for targeting or for which performance data is reported. |
dimension |
segments.hour |
Hour of day |
The hour of the day (0-23) to which the metrics apply. |
metric |
segments.keyword.ad_group_criterion |
Keyword ID |
The resource name of the ad group criterion (e.g., keyword) that triggered the ad. |
dimension |
segments.keyword.info.text |
Keyword |
The text of the keyword that was matched for the ad impression. |
dimension |
segments.month |
Month |
The month to which the metrics in the report apply, represented by the date of the first day of the month (YYYY-MM-DD). |
dimension |
segments.month_of_year |
Month of year |
The month of the year, allowing segmentation of performance data by month. |
dimension |
segments.product_brand |
Brand |
The brand of the product from the Google Merchant Center feed. |
dimension |
segments.product_category_level1 |
Product category level1 |
The first level of the Google Product Category hierarchy, used for shopping campaigns. |
dimension |
segments.product_category_level2 |
Product category level2 |
The second level of the Google Product Category hierarchy, used for shopping campaigns. |
dimension |
segments.product_category_level3 |
Product category level3 |
The third level of the Google Product Category hierarchy, used for shopping campaigns. |
dimension |
segments.product_category_level4 |
Product category level4 |
The fourth level of the Google Product Category hierarchy, used for shopping campaigns. |
dimension |
segments.product_category_level5 |
Product category level5 |
The fifth level of the Google Product Category hierarchy, used for shopping campaigns. |
dimension |
segments.product_channel |
Channel |
The channel through which the product is sold (e.g., ONLINE, LOCAL). |
dimension |
segments.product_condition |
Condition |
The condition of the product (e.g., NEW, USED, REFURBISHED). |
dimension |
segments.product_country |
Country/territory |
The country associated with a product in shopping campaigns, used for segmentation. |
dimension |
segments.product_custom_attribute0 |
Custom label 0 |
A custom label (0) defined for the product in Google Merchant Center, used for custom reporting or bidding. |
dimension |
segments.product_custom_attribute1 |
Custom label 1 |
A custom label (1) defined for the product in Google Merchant Center, used for custom reporting or bidding. |
dimension |
segments.product_custom_attribute2 |
Custom label 2 |
A custom label (2) defined for the product in Google Merchant Center, used for custom reporting or bidding. |
dimension |
segments.product_custom_attribute3 |
Custom label 3 |
A custom label (3) defined for the product in Google Merchant Center, used for custom reporting or bidding. |
dimension |
segments.product_custom_attribute4 |
Custom label 4 |
A custom label (4) defined for the product in Google Merchant Center, used for custom reporting or bidding. |
dimension |
segments.product_item_id |
Item ID |
The unique identifier for a product item within a shopping campaign. |
metric |
segments.product_language |
Language |
The language associated with a product in shopping campaigns, used for segmentation. |
dimension |
segments.product_merchant_id |
MC ID |
The ID of the Google Merchant Center account that owns the product. |
metric |
segments.product_store_id |
Store ID |
The store ID associated with a product, used for segmentation in local inventory ads. |
dimension |
segments.product_title |
Product title |
The title of the product from the Google Merchant Center feed. |
dimension |
segments.product_type_l1 |
Product type (1st level) |
The first level of the product type hierarchy as defined in Google Merchant Center, used for shopping campaigns. |
dimension |
segments.product_type_l2 |
Product type (2nd level) |
The second level of the product type hierarchy as defined in Google Merchant Center, used for shopping campaigns. |
dimension |
segments.product_type_l3 |
Product type (3rd level) |
The third level of the product type hierarchy as defined in Google Merchant Center, used for shopping campaigns. |
dimension |
segments.product_type_l4 |
Product type (4th level) |
The fourth level of the product type hierarchy as defined in Google Merchant Center, used for shopping campaigns. |
dimension |
segments.product_type_l5 |
Product type (5th level) |
The fifth level of the product type hierarchy as defined in Google Merchant Center, used for shopping campaigns. |
dimension |
segments.quarter |
Quarter |
The quarter to which the metrics in the report apply, represented by the date of the first day of the quarter (YYYY-MM-DD). |
dimension |
segments.search_engine_results_page_type |
Search result type |
Breaks down performance data by the type of search results page where the ad was shown (e.g., organic, paid). |
dimension |
segments.search_term_match_type |
Match type |
The match type of the search term that triggered an ad, such as exact, phrase, or broad match. This also includes PERFORMANCE_MAX for Performance Max campaigns. |
dimension |
segments.slot |
Top vs. other |
The position on the search results page where the ad was shown (e.g., ‘Top’ for top of page, ‘Other’ for other positions). |
dimension |
segments.week |
Week |
The week to which the metrics in the report apply, represented by the date of Monday of that week (YYYY-MM-DD). |
dimension |
segments.year |
Year |
The year to which the metrics in the report apply. |
metric |
shared_criterion.criterion_id |
Shared Criterion ID |
The ID of the criterion within a shared set. |
dimension |
shared_criterion.keyword.match_type |
Shared Criterion Keyword match type |
The match type of the keyword within a shared criterion (e.g., EXACT, PHRASE, BROAD). |
dimension |
shared_criterion.keyword.text |
Shared Criterion Keyword text |
The actual text of the keyword within a shared criterion. |
dimension |
shared_criterion.mobile_application.app_id |
Shared Criterion Mobile application ID |
The application ID of a mobile application used as a shared criterion for targeting or exclusion. |
dimension |
shared_criterion.mobile_application.name |
Shared Criterion Mobile application name |
The name of the mobile application used as a shared criterion. |
dimension |
shared_criterion.placement.url |
Shared Criterion Placement URL |
The URL of a website or app placement used as a shared criterion for targeting or exclusion. |
dimension |
shared_criterion.type |
Shared Criterion Type |
The type of criterion in the shared set (e.g., KEYWORD, PLACEMENT, MOBILE_APP_CATEGORY). |
dimension |
shared_criterion.youtube_channel.channel_id |
Shared Criterion Youtube channel ID |
The ID of the YouTube channel used as a shared criterion for targeting or exclusion. |
dimension |
shared_criterion.youtube_video.video_id |
Shared Criterion Youtube video ID |
The ID of the YouTube video used as a shared criterion for targeting or exclusion. |
dimension |
shared_set.id |
Shared Set ID |
The ID of the shared set. |
dimension |
shared_set.member_count |
Shared Set Member count |
The number of items (members) in a shared set, such as a negative keyword list or a user list. |
dimension |
shared_set.name |
Shared Set Name |
The name of the shared set. |
dimension |
shared_set.reference_count |
Shared Set Reference count |
The number of campaigns or other entities that reference this shared set. |
dimension |
shared_set.status |
Shared Set Status |
The status of the shared set (e.g., ENABLED, REMOVED). |
dimension |
shared_set.type |
Shared Set Type |
The type of criteria contained in the shared set (e.g., NEGATIVE_KEYWORDS, PLACEMENTS). |
dimension |
shopping_performance_view.resource_name |
Shopping performance view resource name |
The resource name for the shopping_performance_view entity, serving as its unique identifier within the Google Ads API. |
dimension |
start_date |
start_date |
The start date for a campaign or other entity, in YYYY-MM-DD format. |
dimension |
targeting |
targeting |
Describes the targeting criteria applied to an ad or ad group. |
dimension |
targeting_type |
targeting_type |
This field specifies the type of targeting used for an ad group or campaign, indicating whether criteria are used to restrict traffic (‘Targeting’ mode) or to allow bidding adjustments without restricting traffic (‘Observation’ mode). |
dimension |
topic_view.resource_name |
Topic view resource name |
The resource name for the topic_view entity, providing performance data aggregated by topic for Display Network campaigns. |
dimension |
universal.app.ad.descriptions_1 |
Universal app ad descriptions 1 |
One of up to five descriptions provided for a Universal App Ad. These descriptions are used to generate various ad formats. |
dimension |
universal.app.ad.descriptions_2 |
Universal app ad descriptions 2 |
One of up to five descriptions provided for a Universal App Ad. These descriptions are used to generate various ad formats. |
dimension |
universal.app.ad.descriptions_3 |
Universal app ad descriptions 3 |
One of up to five descriptions provided for a Universal App Ad. These descriptions are used to generate various ad formats. |
dimension |
universal.app.ad.descriptions_4 |
Universal app ad descriptions 4 |
One of up to five descriptions provided for a Universal App Ad. These descriptions are used to generate various ad formats. |
dimension |
universal.app.ad.descriptions_5 |
Universal app ad descriptions 5 |
One of up to five descriptions provided for a Universal App Ad. These descriptions are used to generate various ad formats. |
dimension |
universal.app.ad.headlines_1 |
Universal app ad headlines 1 |
The text for a specific headline of a Universal App Ad (now called App campaign ad). These headlines are used to dynamically create different ad combinations for app promotion. |
dimension |
universal.app.ad.headlines_2 |
Universal app ad headlines 2 |
The text for a specific headline of a Universal App Ad (now called App campaign ad). These headlines are used to dynamically create different ad combinations for app promotion. |
dimension |
universal.app.ad.headlines_3 |
Universal app ad headlines 3 |
The text for a specific headline of a Universal App Ad (now called App campaign ad). These headlines are used to dynamically create different ad combinations for app promotion. |
dimension |
universal.app.ad.headlines_4 |
Universal app ad headlines 4 |
The text for a specific headline of a Universal App Ad (now called App campaign ad). These headlines are used to dynamically create different ad combinations for app promotion. |
dimension |
universal.app.ad.headlines_5 |
Universal app ad headlines 5 |
The text for a specific headline of a Universal App Ad (now called App campaign ad). These headlines are used to dynamically create different ad combinations for app promotion. |
dimension |
user_interest.launched_to_all |
user_interest.launched_to_all |
Indicates whether a specific user interest is available for targeting to all advertisers. |
dimension |
user_interest.name |
user_interest.name |
The name of the user interest category, used for audience targeting. |
dimension |
user_interest.resource_name |
user_interest.resource_name |
The resource name that uniquely identifies the user interest in the Google Ads API. |
dimension |
user_interest.taxonomy_type |
user_interest.taxonomy_type |
The type of taxonomy used to classify the user interest, such as Affinity or In-Market categories. |
dimension |
user_interest.user_interest_id |
user_interest.user_interest_id |
The unique identifier for the user interest. |
dimension |
user_interest.user_interest_parent |
user_interest.user_interest_parent |
The resource name of the parent user interest category, indicating its position in a hierarchical structure. |
dimension |
user_list.access_reason |
User list access reason |
The reason for the user list’s access status, such as whether it’s owned by the account or shared. |
dimension |
user_list.account_user_list_status |
Account user list status |
The status of the user list in the account (e.g., active, closed). |
dimension |
user_list.basic_user_list.actions |
User list actions |
The actions associated with a basic user list, defining how users are added to it. |
dimension |
user_list.closing_reason |
Closing reason |
The reason why a user list was closed, if applicable. |
dimension |
user_list.crm_based_user_list.app_id |
CRM based App ID |
The application ID associated with a CRM-based user list, used for customer match audiences. |
dimension |
user_list.crm_based_user_list.data_source_type |
CRM based data source type |
The data source type for a CRM-based user list (e.g., FIRST_PARTY, THIRD_PARTY). |
dimension |
user_list.crm_based_user_list.upload_key_type |
CRM based upload key type |
The type of key used for uploading data to a CRM-based user list (e.g., CONTACT_INFO, MOBILE_ADVERTISING_ID). |
dimension |
user_list.description |
User list description |
A descriptive text for the user list. |
dimension |
user_list.eligible_for_display |
User list eligible for Google Display Network |
Indicates whether the user list is eligible to be used for targeting on the Google Display Network. |
dimension |
user_list.eligible_for_search |
User list eligible for Google Search Network |
Indicates whether the user list is eligible to be used for targeting on the Google Search Network. |
dimension |
user_list.id |
User list ID |
The ID of the user list. |
dimension |
user_list.integration_code |
User list integration code |
A short code that can be used to identify a user list for integration with other systems. |
dimension |
user_list.logical_user_list.rules |
User list logical user list rules |
The rules that define a logical user list, combining multiple user lists with AND/OR logic. |
dimension |
user_list.lookalike_user_list.country_codes |
Lookalike user list country codes |
A list of country codes defining the geographical scope for creating a lookalike user list. |
dimension |
user_list.lookalike_user_list.expansion_level |
Lookalike user list expansion level |
The degree to which a lookalike user list is expanded from its seed list, influencing audience size and similarity. |
dimension |
user_list.lookalike_user_list.seed_user_list_ids |
Lookalike user list seed user list IDs |
A list of user list IDs that serve as the basis for creating a lookalike audience. |
dimension |
user_list.match_rate_percentage |
User list match rate percentage |
The percentage of users from an uploaded customer list that were successfully matched to Google users. |
dimension |
user_list.membership_life_span |
User list membership life span |
The number of days a user remains in the user list. |
dimension |
user_list.membership_status |
User list membership status |
The membership status of the user list, indicating whether it is open (collecting users) or active. |
dimension |
user_list.name |
User list name |
The name of the user list. |
dimension |
user_list.read_only |
User list read only |
Indicates whether the user list is read-only. |
dimension |
user_list.resource_name |
User list resource name |
The resource name for the user_list entity, serving as its unique identifier within the Google Ads API. |
dimension |
user_list.rule_based_user_list.flexible_rule_user_list.exclusive_operands |
User list exclusive operands |
The exclusive operands used in the flexible rule for a rule-based user list, defining conditions for user exclusion. |
dimension |
user_list.rule_based_user_list.flexible_rule_user_list.inclusive_operands |
User list inclusive operands |
The inclusive operands used in the flexible rule for a rule-based user list, defining conditions for user inclusion. |
dimension |
user_list.rule_based_user_list.flexible_rule_user_list.inclusive_rule_operator |
User list inclusive rule operator |
The operator (e.g., AND, OR) used to combine inclusive rules in a flexible rule-based user list. |
dimension |
user_list.rule_based_user_list.prepopulation_status |
Pre-population status |
The pre-population status of a rule-based user list, indicating if it’s currently pre-populating with past users. |
dimension |
user_list.similar_user_list.seed_user_list |
Seed user list |
The resource name of the original user list used as a seed to generate a similar user list. |
dimension |
user_list.size_for_display |
User list size for Google Display Network |
The estimated size of the user list for the Google Display Network. |
dimension |
user_list.size_for_search |
User list size for Google Search Network |
The estimated size of the user list for the Google Search Network. |
dimension |
user_list.size_range_for_display |
User list size range for Google Display Network |
The estimated size range of the user list for the Google Display Network, providing a broader category of audience size. |
dimension |
user_list.size_range_for_search |
User list size range for Google Search Network |
The estimated size range of the user list for the Google Search Network, providing a broader category of audience size. |
dimension |
user_list.type |
User list type |
The type of user list (e.g., REMARKETING, CRM_BASED, LOGICAL, RULE_BASED, SIMILAR). |
dimension |
user_location_view.country_criterion_id |
User location view country criterion ID |
The criterion ID of the country associated with the user’s physical location. |
dimension |
user_location_view.resource_name |
User location view resource name |
The resource name for the user_location_view entity, serving as its unique identifier within the Google Ads API. |
dimension |
user_location_view.targeting_location |
Is targetable |
Indicates whether the user’s location is a targeted location for the campaign. |
dimension |
video.channel_id |
Video channel ID |
The ID of the YouTube channel where the video is hosted. |
dimension |
video.duration_millis |
Video duration |
The duration of the video in milliseconds. |
dimension |
video.id |
Video ID |
The YouTube video ID. |
dimension |
video.resource_name |
Video resource name |
The resource name for the video entity, serving as its unique identifier within the Google Ads API. |
dimension |
video.title |
Video title |
The title of the video. |
dimension |
video_played_to_100 |
video_played_to_100 |
The percentage of video ad impressions where the viewer watched 100% of the video. |
metric |
video_played_to_25 |
video_played_to_25 |
The percentage of video ad impressions where the viewer watched at least 25% of the video. |
metric |
video_played_to_50 |
video_played_to_50 |
The percentage of video ad impressions where the viewer watched at least 50% of the video. |
metric |
video_played_to_75 |
video_played_to_75 |
The percentage of video ad impressions where the viewer watched at least 75% of the video. |
metric |
video_plays_100% |
video_plays_100% |
This is an alias for metrics.video_quartile_p100_rate, representing the percentage of impressions where the viewer watched 100% of your video ad. |
metric |
video_plays_25% |
video_plays_25% |
This is an alias for metrics.video_quartile_p25_rate, representing the percentage of impressions where the viewer watched 25% of your video ad. |
metric |
video_plays_50% |
video_plays_50% |
This is an alias for metrics.video_quartile_p50_rate, representing the percentage of impressions where the viewer watched 50% of your video ad. |
metric |
video_plays_75% |
video_plays_75% |
This is an alias for metrics.video_quartile_p75_rate, representing the percentage of impressions where the viewer watched 75% of your video ad. |
metric |