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 |
|---|---|---|---|
ACTIVE_VIEW_MEASURABLE_COST_MICROS |
ACTIVE_VIEW_MEASURABLE_COST_MICROS |
The cost associated with Active View measurable impressions in micro-units. |
dimension |
Abs Top Impressions |
Abs Top Impressions |
The percentage of your ad impressions that were shown as the very first ad above the organic search results. |
metric |
Absolute Top Impression (%) |
metrics.absolute_top_impression_percentage |
The percentage of your ad impressions that were shown as the very first ad above the organic search results. |
metric |
Access creation date time |
customer_user_access.access_creation_date_time |
The date and time when the user access to the customer account was created. |
dimension |
Access role |
customer_user_access.access_role |
The access role assigned to a user for the customer account (e.g., Admin, Standard, Read-only). |
dimension |
Account |
Account |
The name of the Google Ads account. |
dimension |
Account Budget ID |
account_budget.id |
The unique identifier for an account budget. |
metric |
Account Budget amount served |
account_budget.amount_served_micros |
The amount of ads served under the account budget, including any overdelivery costs, measured in micros. |
metric |
Account Budget approved spending limit |
account_budget.approved_spending_limit_micros |
The approved spending limit for the account budget, measured in micros. |
metric |
Account Budget billing setup |
account_budget.billing_setup |
The billing setup associated with this account budget, indicating which Payments account will be billed. |
dimension |
Account Budget name |
account_budget.name |
The name of the account budget. |
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 |
account_budget.total_adjustments_micros |
Total adjustments applied to the account budget, such as credits for overdelivery, measured in micros. |
metric |
Account name |
Account name |
The descriptive name of the Google Ads customer account. |
dimension |
Account user list status |
user_list.account_user_list_status |
The status of the user list at the account level. |
dimension |
AccountId |
AccountId |
The unique identifier for the Google Ads customer account. |
metric |
AccountName |
AccountName |
The descriptive name of the Google Ads customer account. |
dimension |
Active View avg. CPM |
Active View avg. CPM |
The average cost-per-thousand viewable impressions for ads on the Display Network. |
metric |
Active View measurable cost |
Active View measurable cost |
The total cost for impressions that were measurable by Active View. |
metric |
Active View measurable impr. |
Active View measurable impr. |
The number of ad impressions that were measurable by Active View. |
metric |
Active View viewable CTR |
Active View viewable CTR |
The percentage of viewable impressions that resulted in a click on an ad. |
metric |
Active View viewable impressions |
Active View viewable impressions |
The number of ad impressions that were considered viewable according to Active View criteria. |
metric |
Ad |
Ad |
Represents an individual advertisement. |
dimension |
Ad Group Criterion ID |
ad_group_criterion.criterion_id |
The unique identifier for the criterion within the ad group. |
dimension |
Ad Group Criterion Keyword match type |
ad_group_criterion.keyword.match_type |
The match type of the keyword (e.g., exact, phrase, broad) for this ad group criterion. |
dimension |
Ad Group Criterion Keyword text |
ad_group_criterion.keyword.text |
This field contains the actual text of the keyword associated with an ad group criterion, used for targeting ads. |
dimension |
Ad Group Criterion Status |
ad_group_criterion.status |
This field indicates the current user-set status of an ad group criterion, such as enabled, paused, or removed. |
dimension |
Ad Size |
Ad Size |
The dimensions (width x height) of a display ad. |
dimension |
Ad asset field type |
ad_group_ad_asset_view.field_type |
This field indicates the role or type of an asset within an ad, such as a headline, description, or image. |
dimension |
Ad asset view resource name |
ad_group_ad_asset_view.resource_name |
This is the resource name for an ad group ad asset view, which provides data about a specific asset used within an ad in an ad group. |
dimension |
Ad group |
ad_group.name |
The name of the ad group, which is a collection of ads, keywords, and bids. |
dimension |
Ad group Campaign ID |
ad_group.campaign |
The resource name or ID of the campaign to which the ad group belongs. |
dimension |
Ad group ad resource name |
ad_group_ad.resource_name |
The unique resource name for an ad group ad. |
dimension |
Ad group labels |
ad_group.labels |
Labels applied to an ad group for organization and filtering purposes. |
dimension |
Ad group resource name |
ad_group.resource_name |
The unique resource name for an ad group in the Google Ads API. |
dimension |
Ad group state |
ad_group.status |
This field indicates the current status of an ad group, such as enabled, paused, or removed. |
dimension |
Ad group type |
ad_group.type |
The type of the ad group, such as ‘Search Ad Group’ or ‘Display Ad Group.’ |
dimension |
Ad name |
ad_group_ad.ad.name |
The name of the ad creative within an ad group. |
dimension |
Ad relevance |
Ad relevance |
This field measures how closely your ad matches the intent behind a user’s search query, a key component of Quality Score. |
dimension |
Ad resource name |
ad_group_ad.ad.resource_name |
The unique resource name for an individual ad within an ad group. |
dimension |
AdType |
AdType |
The specific type of an ad (e.g., Expanded Text Ad, Responsive Search Ad, Call Ad). |
dimension |
Added/Excluded |
Added/Excluded |
Indicates whether a specific criterion (e.g., keyword, location) is actively targeted (added) or prevented from targeting (excluded). |
dimension |
Advertiser |
Advertiser |
The descriptive name of the Google Ads customer account (advertiser). |
dimension |
Advertising Channel |
Advertising Channel |
The top-level advertising channel for a campaign (e.g., Search, Display, Video). |
dimension |
Advertising Sub Channel |
Advertising Sub Channel |
A more specific advertising channel within a main channel (e.g., Search Partners, Gmail). |
dimension |
Adwords Campaign Type |
Adwords Campaign Type |
The type of the campaign in Google Ads (e.g., Search, Display, Video, Performance Max). |
dimension |
Age range |
Age range |
The demographic age range targeted by an ad or for which data is reported. |
dimension |
All conv. |
All conv. |
The total number of all conversions, including those that are estimated or cross-device. |
metric |
All conv. rate |
All conv. rate |
The percentage of interactions that resulted in an all conversion. |
metric |
All conv. value |
All conv. value |
The total value of all conversions, including cross-device and estimated conversions. |
metric |
All conversions from location asset click to call |
metrics.all_conversions_from_location_asset_click_to_call |
The total number of conversions that originated from a click-to-call action on a location asset. |
metric |
All conversions from location asset directions |
metrics.all_conversions_from_location_asset_directions |
The total number of conversions that originated from a click for directions on a location asset. |
metric |
All conversions from location asset store visits |
metrics.all_conversions_from_location_asset_store_visits |
The total number of conversions attributed to store visits originating from a location asset. |
metric |
All conversions from location asset website |
metrics.all_conversions_from_location_asset_website |
The total number of conversions that originated from a website click on a location asset. |
metric |
App final URL |
App final URL |
The final URL for an ad that directs users to a mobile application. |
dimension |
Approval Status |
Approval Status |
The editorial approval status of an ad or creative (e.g., Approved, Disapproved). |
dimension |
Asset ID |
asset.id |
This field provides the unique identifier for an asset, such as an image, video, or text snippet. |
metric |
Asset group ID |
asset_group.id |
This field provides the unique identifier for an asset group, a collection of creative assets used in Performance Max campaigns. |
metric |
Asset group ad strength |
asset_group.ad_strength |
This field indicates the strength or effectiveness of the ads generated from an asset group, rated on a scale (e.g., Excellent, Good, Average, Poor). |
dimension |
Asset group name |
asset_group.name |
This field contains the human-readable name of the asset group. |
dimension |
Asset group status |
asset_group.status |
This field indicates the current operational status of an asset group. |
dimension |
Asset name |
asset.name |
This field contains the human-readable name of the asset. |
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 |
Audience |
Audience |
A reusable collection of focused segments, demographic targeting, and exclusions used for campaign targeting. |
dimension |
Audience Type |
Audience Type |
The type of audience targeted (e.g., ‘Affinity’, ‘In-market’, ‘Remarketing’). |
dimension |
Average CPC |
metrics.average_cpc |
The average cost paid for each click on an ad. |
metric |
Average CPM |
metrics.average_cpm |
The average cost-per-thousand impressions. |
metric |
Avg. CPC |
Avg. CPC |
The average cost-per-click, calculated by dividing the total cost by the total number of clicks. |
metric |
Avg. CPM |
Avg. CPM |
The average cost-per-thousand impressions, calculated by dividing the total cost by the number of impressions (in thousands). |
metric |
Avg. CPV |
Avg. CPV |
The average cost-per-view for video campaigns, calculated by dividing the total cost by the total number of video views. |
metric |
Avg. Cost |
Avg. Cost |
The average amount paid per interaction with an ad. |
metric |
Avg. impr. freq. per cookie |
Avg. impr. freq. per cookie |
The average number of times an ad impression was served to a single cookie over a period. |
metric |
Avg. position |
Avg. position |
The average position of your ad on the search results page. |
dimension |
Base Ad group ID |
Base Ad group ID |
For experiment campaigns, the ID of the original ad group from which the experiment ad group was derived. |
dimension |
Base Campaign ID |
Base Campaign ID |
For experiment campaigns, the ID of the original campaign from which the experiment campaign was derived. |
dimension |
Bid Strategy ID |
Bid Strategy ID |
The unique identifier for the bidding strategy used by a campaign or ad group. |
dimension |
Bid Strategy Name |
Bid Strategy Name |
The name of the bidding strategy. |
dimension |
Bid Strategy Type |
Bid Strategy Type |
The type of bidding strategy (e.g., MAXIMIZE_CONVERSIONS, MANUAL_CPC). |
dimension |
Bid Strategy Type (Campaign) |
Bid Strategy Type (Campaign) |
The type of bidding strategy applied to a campaign, such as Maximize Conversions or Target ROAS. |
dimension |
Bidding Strategy Source |
Bidding Strategy Source |
Indicates where the bidding strategy is defined, such as at the campaign level or as a portfolio strategy. |
dimension |
Billing Setup ID |
billing_setup.id |
The unique identifier for a billing setup. |
metric |
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 payments account |
billing_setup.payments_account |
The resource name of the payments account linked to this billing setup. |
dimension |
Billing Setup payments account ID |
billing_setup.payments_account_info.payments_account_id |
The unique identifier of the payments account associated with the billing setup. |
dimension |
Billing Setup payments account name |
billing_setup.payments_account_info.payments_account_name |
The name of the payments account associated with the billing setup. |
dimension |
Billing Setup payments profile ID |
billing_setup.payments_account_info.payments_profile_id |
The unique identifier of the payments profile linked to the payments account in the billing setup. |
dimension |
Billing Setup payments profile name |
billing_setup.payments_account_info.payments_profile_name |
The name of the payments profile linked to the payments account in the billing setup. |
dimension |
Billing Setup resource name |
billing_setup.resource_name |
The resource name of the billing setup, which uniquely identifies it in the Google Ads API. |
dimension |
Billing Setup secondary payments profile id |
billing_setup.payments_account_info.secondary_payments_profile_id |
The secondary payments profile ID associated with the billing setup, which is linked to the Payments account responsible for charges. |
dimension |
Billing Setup start date time |
billing_setup.start_date_time |
The date and time when the billing setup is scheduled to start. |
dimension |
Billing Setup status |
billing_setup.status |
The current status of the billing setup (e.g., pending, active, ended). |
dimension |
Budget |
campaign_budget.amount_micros |
The daily or total budget amount for a campaign, expressed in micro-units of the account’s currency. |
metric |
Bumper ad companion banner |
Bumper ad companion banner |
Indicates whether a bumper ad has a companion banner associated with it. Bumper ads are short, non-skippable video ads. |
dimension |
Buy Type |
Buy Type |
The purchasing model for an ad, such as ‘Auction’ or ‘Reservation’. |
dimension |
CID |
CID |
The unique identifier for the Google Ads customer account. |
dimension |
CPC |
CPC |
The average cost-per-click (CPC) for an ad interaction. |
dimension |
CPM |
CPM |
Cost-per-thousand impressions, a metric indicating the cost for one thousand ad impressions. |
metric |
CPV |
CPV |
This metric represents the average cost paid for each view of a video ad. |
metric |
CPV bidding strategy |
campaign.manual_cpv |
A bidding strategy where the advertiser pays a configurable amount for each video view. |
dimension |
Call detail ID |
Call detail ID |
The unique identifier for a specific call detail record. |
metric |
Call duration |
Call duration |
The duration of a phone call, typically in seconds. |
metric |
Call end date time |
Call end date time |
The date and time when a phone call ended. |
dimension |
Call from Ads |
Call from Ads |
The number of phone calls generated directly from ad interactions. |
metric |
Call resource name |
Call resource name |
The resource name for a call in the Google Ads API, which uniquely identifies the call. |
dimension |
Call start date time |
Call start date time |
The date and time when a phone call started. |
dimension |
Call type |
Call type |
The type of phone call (e.g., ‘Forwarded call’). |
dimension |
Call-only ad phone number |
Call-only ad phone number |
The phone number displayed in a call-only ad. |
dimension |
Calls |
Calls |
The total number of phone calls related to advertising. |
metric |
Calls from Ads |
Calls from Ads |
The number of phone calls generated directly from ad interactions. |
metric |
Campaign |
campaign.name |
The name of the campaign. |
dimension |
Campaign Criterion ID |
campaign_criterion.criterion_id |
The unique identifier for a campaign criterion. |
dimension |
Campaign Criterion display name |
campaign_criterion.display_name |
The user-friendly name of the campaign criterion. |
dimension |
Campaign Criterion resource name |
campaign_criterion.resource_name |
The unique resource name for a campaign criterion. |
dimension |
Campaign Group |
Campaign Group |
A logical grouping of campaigns for organizational or reporting purposes. |
dimension |
Campaign Group ID |
Campaign Group ID |
The unique identifier for a campaign group. |
metric |
Campaign Group Name |
Campaign Group Name |
The name of the campaign group. |
dimension |
Campaign Group Status |
Campaign Group Status |
The current status of the campaign group. |
dimension |
Campaign ID |
campaign.id |
The unique identifier for the campaign. |
metric |
Campaign Objective |
Campaign Objective |
The high-level goal or objective of a campaign (e.g., sales, leads, website traffic). |
dimension |
Campaign Objective Code |
Campaign Objective Code |
A coded value representing the primary marketing objective of a Google Ads campaign (e.g., Sales, Leads, Website traffic). |
dimension |
Campaign Type Code |
Campaign Type Code |
A code representing the type of the campaign (e.g., Search, Display, Video). |
dimension |
Campaign audience view resource name |
campaign_audience_view.resource_name |
The resource name for a campaign audience view, providing insights into audience performance at the campaign level. |
dimension |
Campaign budget resource name |
campaign_budget.resource_name |
The resource name of the campaign budget, which uniquely identifies it in the Google Ads API. |
dimension |
Campaign label |
Campaign label |
Labels applied to a campaign for organization and filtering. |
dimension |
Campaign labels |
campaign.labels |
User-defined labels attached to a campaign for organization and filtering. |
dimension |
Campaign name |
Campaign name |
This field contains the human-readable name of the advertising 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-Type |
Campaign-Type |
The type of advertising channel used for a campaign (e.g., Search, Display, Shopping, Video, App). |
dimension |
CampaignName |
CampaignName |
This field contains the human-readable name of the advertising campaign. |
dimension |
Campaign_labels |
Campaign_labels |
Labels applied to a campaign for organization and filtering. |
dimension |
Channel Code |
Channel Code |
A coded value representing the advertising channel (e.g., Search, Display, Video). |
dimension |
City Name |
City Name |
The name of the city where ad impressions or clicks occurred, or where targeting is applied. This corresponds to a geographic dimension in reports. |
dimension |
Clicks |
metrics.clicks |
The number of clicks on an ad. |
metric |
Clicks to Call |
Clicks to Call |
The number of clicks on a call button in an ad, leading to a phone call. |
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 |
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 Lost IS (budget) |
Content Lost IS (budget) |
The estimated percentage of impressions on the Display Network that your ads didn’t receive due to insufficient budget. |
dimension |
Continent |
Continent |
The continent associated with the ad data or targeting. |
dimension |
Conv. rate |
Conv. rate |
The percentage of ad interactions that result in a conversion. |
metric |
Conversion Tracker Id |
Conversion Tracker Id |
The unique identifier for a conversion action or conversion tracker. |
dimension |
Conversion Type |
Conversion Type |
The specific type of conversion action (e.g., ‘Website purchase’, ‘Lead form submission’). |
dimension |
Conversion Value |
Conversion Value |
This metric represents the total value of all conversions. Conversion value rules can be applied to modify this value based on various conditions. |
metric |
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 adjustment |
Conversion adjustment |
An operation to modify an already recorded conversion, such as restating its value or retracting it. |
dimension |
Conversion category |
Conversion category |
The category of a conversion action (e.g., purchase, lead, page view). |
dimension |
Conversion name |
Conversion name |
The name assigned to a specific conversion action. |
dimension |
Conversion tracking status |
customer.conversion_tracking_setting.conversion_tracking_status |
This field indicates whether conversion tracking is enabled for the customer’s Google Ads account and if cross-account conversion tracking is in use. |
dimension |
ConversionCount |
ConversionCount |
This metric represents the total number of conversions recorded for an ad or campaign, corresponding to metrics.all_conversions in the Google Ads API. |
metric |
ConversionValue |
ConversionValue |
This metric represents the total value of all conversions. Conversion value rules can be applied to modify this value based on various conditions. |
metric |
Cost / all conv. |
Cost / all conv. |
The cost of ad interactions divided by all conversions. |
metric |
Cost / conv. |
Cost / conv. |
The cost of ad interactions divided by conversions (only those included in the ‘conversions’ metric). |
metric |
Cost_USD |
Cost_USD |
The total advertising cost, expressed in US Dollars. This is often derived from ‘cost_micros’ with currency conversion. |
metric |
Country Code |
Country Code |
This field represents the ISO 3166-1 alpha-2 country code (e.g., US, FR) associated with a geographic target. |
dimension |
Country Name |
Country Name |
This field provides the human-readable name of the country targeted by an ad campaign, derived from a geographic target constant. |
dimension |
Country/Territory |
Country/Territory |
The geographic country or territory targeted by the campaign, often represented by a criterion ID in the API. |
metric |
Country/Territory Name |
Country/Territory Name |
The human-readable name of the country or territory. |
dimension |
Creative |
Creative |
The ad creative itself, encompassing text, images, and videos used in an ad. |
dimension |
Creative Size |
Creative Size |
The dimensions or type of an ad creative, such as pixel dimensions or aspect ratio. |
dimension |
Creative_id |
Creative_id |
The unique identifier for an ad creative. |
dimension |
Criteria Type |
Criteria Type |
The type of criterion used for targeting (e.g., keyword, age range, location). |
dimension |
Criterion serving status |
Criterion serving status |
The current serving status of a targeting criterion (e.g., ENABLED, PAUSED). |
dimension |
Cross-device conv. |
Cross-device conv. |
The number of conversions that started on one device and finished on another. |
metric |
Custom Conversion Goal Id |
custom_conversion_goal.id |
The unique identifier for a custom conversion goal. |
metric |
Custom Conversion Goal Name |
custom_conversion_goal.name |
The name of a custom conversion goal. |
dimension |
Custom Conversion Goal Resource name |
custom_conversion_goal.resource_name |
The unique resource name for a custom conversion goal. |
dimension |
Custom Conversion Goal Status |
custom_conversion_goal.status |
The status of a custom conversion goal (e.g., enabled, paused). |
metric |
Customer ID |
customer.id |
The unique ID of the Google Ads customer account. |
metric |
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 |
CustomerName |
CustomerName |
The descriptive name of the Google Ads customer account. |
dimension |
DD |
DD |
This field represents the day component of a date, often used for segmenting reporting data. |
metric |
Date Hour |
Date Hour |
The date and hour for which the data is reported, allowing hourly segmentation. |
dimension |
Day |
segments.date |
The specific date for which metrics are reported, in YYYY-MM-DD format. |
dimension |
Day of week |
Day of week |
The day of the week when an event occurred, used for segmentation (e.g., MONDAY). |
dimension |
DayofWeek |
DayofWeek |
The day of the week when an event occurred, used for segmentation (e.g., MONDAY). |
dimension |
Days to conversion |
Days to conversion |
The number of days between an ad interaction (impression or click) and a conversion, grouped into buckets. |
dimension |
Default max. CPC |
ad_group.cpc_bid_micros |
The default maximum cost-per-click (CPC) bid for the ad group, measured in micros. |
metric |
Delivery method |
campaign_budget.delivery_method |
The method by which the campaign budget is spent over time (e.g., standard or accelerated delivery). |
dimension |
Desktop bid adj. |
Desktop bid adj. |
The bid adjustment applied to desktop devices. |
metric |
Destination URL |
Destination URL |
The URL where users are directed after clicking an ad (legacy field, largely replaced by Final URL). |
dimension |
Directions Conversions |
Directions Conversions |
The number of conversions where users requested directions to a business location after interacting with an ad. |
metric |
EVENT_DATE |
EVENT_DATE |
The date on which a specific event or conversion occurred. |
dimension |
Ecommerce Channel |
Ecommerce Channel |
The e-commerce channel associated with a purchase or conversion. |
dimension |
Effective Date |
Effective Date |
The date from which a particular setting or status becomes active. |
dimension |
Eligible Impressions |
Eligible Impressions |
The total number of impressions that were eligible to be served. |
metric |
End date |
campaign.end_date |
The end date of the campaign. |
dimension |
Engagement |
Engagement |
User interactions with an ad beyond a standard click, such as expanding a Lightbox ad. |
metric |
Enhanced CPC enabled |
campaign.manual_cpc.enhanced_cpc_enabled |
Indicates whether Enhanced CPC (cost-per-click) bidding is enabled for the campaign, allowing bids to be automatically adjusted for conversions. |
dimension |
Est. add. clicks/wk (first position bid) |
Est. add. clicks/wk (first position bid) |
The estimated number of additional clicks per week if the ad were to consistently appear in the first position. |
dimension |
Est. add. cost/wk (first position bid) |
Est. add. cost/wk (first position bid) |
The estimated additional cost per week if the ad were to consistently appear in the first position. |
metric |
Expanded Dynamic Search Ad Description 2 |
Expanded Dynamic Search Ad Description 2 |
The second description line for an Expanded Dynamic Search Ad. |
dimension |
Expanded Text Ad Description 2 |
Expanded Text Ad Description 2 |
The second description line for an Expanded Text Ad. |
dimension |
Expanded Text Ad Headline 3 |
Expanded Text Ad Headline 3 |
The third headline for an Expanded Text Ad. |
dimension |
Expected clickthrough rate |
Expected clickthrough rate |
A component of Quality Score, indicating the expected click-through rate of an ad for a given search query. |
dimension |
Feed Item name |
Feed Item name |
The name of a feed item within a Google Ads feed. |
dimension |
First page CPC |
First page CPC |
The estimated Cost-Per-Click (CPC) required for an ad to appear on the first page of Google search results. |
metric |
First position CPC |
First position CPC |
The estimated Cost-Per-Click (CPC) required for an ad to appear in the top position of Google search results. |
dimension |
Flight End Date |
Flight End Date |
The end date for an ad campaign or a specific ad flight. |
dimension |
Flight Start Date |
Flight Start Date |
The start date for an ad campaign or a specific ad flight. |
dimension |
Gender |
Gender |
The demographic gender targeted by an ad or for which data is reported. |
dimension |
Gender state |
Gender state |
The gender of the audience targeted or observed. |
dimension |
Geographic view |
Geographic view |
A report view that provides performance data broken down by geographical location. |
dimension |
Geography |
Geography |
The geographical area associated with the ad data, which could be a country, region, city, or other defined area. |
dimension |
Geolocation |
Geolocation |
Geographical location information related to ad targeting or where an ad was served. |
dimension |
Gmail ad header image media id |
Gmail ad header image media id |
The media ID for the header image used in a Gmail ad. |
dimension |
Gmail ad logo image media id |
Gmail ad logo image media id |
The media ID for the logo image used in a Gmail ad. |
dimension |
Gmail ad marketing image media id |
Gmail ad marketing image media id |
The media ID for the marketing image used in a Gmail ad. |
dimension |
Google Category 1 |
Google Category 1 |
The primary Google business category associated with an ad or advertiser. |
dimension |
Google Category 2 |
Google Category 2 |
A secondary Google business category associated with an ad or advertiser. |
dimension |
Google Category 3 |
Google Category 3 |
A tertiary Google business category associated with an ad or advertiser. |
dimension |
Google Category 4 |
Google Category 4 |
A fourth-level Google business category associated with an ad or advertiser. |
dimension |
Google Category 5 |
Google Category 5 |
A fifth-level Google business category associated with an ad or advertiser. |
dimension |
Has Quality Score |
Has Quality Score |
This field indicates whether a keyword has a Quality Score, which is a diagnostic tool on a scale of 1-10 reflecting ad quality relative to other advertisers. |
dimension |
Has recommended Budget |
Has recommended Budget |
Indicates whether the campaign budget has a recommended amount. |
dimension |
Hour of day |
segments.hour |
The hour of the day when an event occurred, used for segmentation. |
metric |
INTERACTION_EVENT_TYPES |
INTERACTION_EVENT_TYPES |
The type of interaction event, such as a click, engagement, or video view. |
dimension |
Image Ad URL |
Image Ad URL |
The URL of the image asset used in an image ad. |
dimension |
Image Height |
Image Height |
The height of an image asset, in pixels. |
dimension |
Image Mime Type |
Image Mime Type |
The MIME type of the image asset (e.g., image/jpeg, image/png). |
dimension |
Image Width |
Image Width |
The width of an image asset, in pixels. |
dimension |
Impr. (Abs. Top) % |
Impr. (Abs. Top) % |
The percentage of your total impressions that were shown in the absolute top position (first ad) above the organic search results. |
metric |
Impr. (Top) % |
Impr. (Top) % |
The percentage of your total impressions that were shown anywhere in the top section (above organic search results). |
metric |
Impressions |
metrics.impressions |
The number of times an ad was shown. |
metric |
Impressions on the absolute top |
Impressions on the absolute top |
The percentage of your ad impressions that were shown as the very first ad above the organic search results. |
metric |
Impressions on top |
Impressions on top |
The percentage of your ad impressions that were shown anywhere above the organic search results. |
metric |
Interaction Rate |
Interaction Rate |
The percentage of impressions that result in an interaction with your ad. |
metric |
Interaction Types |
Interaction Types |
The type of interaction that occurred with an ad, such as clicks, calls, or video views. |
dimension |
Inventory Source |
Inventory Source |
The source of the inventory where an ad was served. |
dimension |
Is negative |
Is negative |
Indicates whether a specific entity (e.g., keyword, placement) is set as an exclusion (negative). |
dimension |
Keyword |
Keyword |
The text of the keyword used for targeting. |
dimension |
Keyword ID |
Keyword ID |
The unique identifier for a keyword. |
metric |
Keyword Type |
Keyword Type |
The match type of a keyword (e.g., broad match, phrase match, exact match). |
dimension |
Keyword state |
Keyword state |
This field represents the current operational status of a keyword, such as enabled, paused, or removed. |
dimension |
Keyword view resource name |
keyword_view.resource_name |
This is the resource name for a keyword view, which provides performance data and attributes related to specific keywords. |
dimension |
Label IDs |
Label IDs |
A list of unique identifiers for labels applied to an entity (e.g., campaign, ad group). |
dimension |
Labels |
Labels |
Custom labels applied to campaigns, ad groups, ads, or keywords for organization and filtering. |
dimension |
Landing page experience |
Landing page experience |
This field measures the relevance and usefulness of your landing page to people who click your ad, a key component of Quality Score. |
dimension |
Location |
Location |
A geographical location dimension for reporting or targeting. |
dimension |
Lost impressions (budget) |
Lost impressions (budget) |
The estimated percentage of impressions your ads didn’t receive due to insufficient budget. |
metric |
Lost impressions (rank) |
Lost impressions (rank) |
The estimated percentage of impressions your ads didn’t receive due to low Ad Rank. |
metric |
MCC Name |
MCC Name |
The name of the My Client Center (MCC) account that manages this customer account. |
dimension |
MM |
MM |
This field represents the month component of a date, often used for segmenting reporting data. |
metric |
Make |
Make |
Typically used in automotive advertising, this refers to the ‘make’ or brand of a vehicle being advertised. |
dimension |
Market |
Market |
The geographical market targeted by the advertising campaign. |
dimension |
Marketing Channel |
Marketing Channel |
The marketing channel through which the ad is delivered (e.g., Search, Display, Video). |
dimension |
Match Type |
Match Type |
The keyword match type (e.g., ‘Exact’, ‘Phrase’, ‘Broad’) for search campaigns. |
dimension |
Max CPC source |
Max CPC source |
Indicates the level (e.g., ad group or criterion) from which the maximum CPC bid is derived. |
dimension |
Max. CPC |
Max. CPC |
The maximum Cost Per Click (CPC) bid set for a keyword or ad group. |
metric |
Max. CPM |
Max. CPM |
The maximum Cost Per Mille (thousand impressions) bid set for an ad group or campaign. |
metric |
Metro area |
Metro area |
The metropolitan area targeted or observed in reports. |
dimension |
Metro area name |
Metro area name |
The human-readable name of the metro area. |
dimension |
Mobile bid adj. |
Mobile bid adj. |
The bid adjustment applied to mobile devices. |
dimension |
Month |
Month |
The month in which an event occurred, used for segmentation. |
dimension |
Month of Year |
Month of Year |
The month of the year to which metrics apply. |
dimension |
Most specific location |
Most specific location |
The most granular geographical location targeted or observed in reports (e.g., city, postal code). |
metric |
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 |
Network |
The network on which an ad was shown (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 |
Organic clicks |
metrics.organic_clicks |
The number of clicks on organic (unpaid) search results. |
metric |
Organic clicks per query |
metrics.organic_clicks_per_query |
The average number of clicks on organic search results per search query. |
metric |
Organic listings |
metrics.organic_impressions |
The number of times organic (unpaid) search results were shown to users. |
metric |
Organic listings per query |
metrics.organic_impressions_per_query |
The average number of organic (unpaid) search results shown per search query. |
metric |
Organic queries |
metrics.organic_queries |
The total number of unique search queries that resulted in organic listings. |
metric |
PPC Impressions |
PPC Impressions |
This metric represents the number of times a pay-per-click (PPC) ad was displayed to users. |
metric |
Paid Impressions |
Paid Impressions |
The number of times a paid advertisement was shown to users. |
metric |
Paid organic search term view resource name |
paid_organic_search_term_view.resource_name |
The resource name of the paid organic search term view, which uniquely identifies it in the Google Ads API. |
dimension |
Parental status |
Parental status |
The demographic parental status targeted by an ad or for which data is reported. |
dimension |
Phone Call |
Phone Call |
The number of phone call conversions or interactions. |
metric |
Phone Calls Conversions |
Phone Calls Conversions |
The number of conversions where users made a phone call to the business after interacting with an ad. |
metric |
Phone Calls from Ads |
Phone Calls from Ads |
The number of phone calls generated directly from ad interactions. |
metric |
Placement |
Placement |
The specific location on a website, app, or video where an ad appeared. |
dimension |
Placement_id |
Placement_id |
The unique identifier for an ad placement. |
dimension |
Platform |
Platform |
The advertising platform or network where the ad was shown. |
dimension |
Policy |
Policy |
Information related to ad policy compliance, indicating whether an ad adheres to Google’s advertising policies. |
dimension |
Policy information approval status |
Policy information approval status |
The approval status of an ad based on Google Ads policies. |
dimension |
Policy information policy topic entries |
Policy information policy topic entries |
Details about specific policy violations or topics related to an ad’s disapproval. |
dimension |
Product |
Product |
The product associated with the ad, relevant for Shopping campaigns. |
dimension |
Product Type |
Product Type |
The category or type of a product in Shopping campaigns. |
dimension |
Publisher |
Publisher |
The publisher or website where the ad was displayed. |
dimension |
Purchase Conversions |
Purchase Conversions |
The number of conversions where users completed a purchase after interacting with an ad. |
metric |
Quality score |
Quality score |
A diagnostic score (1-10) that estimates the quality of your ads, keywords, and landing pages. |
metric |
Quarter |
Quarter |
The quarter of the year in which an event occurred, used for segmentation. |
dimension |
Query |
paid_organic_search_term_view.search_term |
The actual search term entered by a user that triggered an ad or organic listing. |
dimension |
ROAS (180) |
ROAS (180) |
Return On Ad Spend (ROAS) calculated over a 180-day attribution window. |
metric |
ROAS (30) |
ROAS (30) |
Return On Ad Spend (ROAS) calculated over a 30-day attribution window. |
metric |
ROAS (90) |
ROAS (90) |
Return On Ad Spend (ROAS) calculated over a 90-day attribution window. |
metric |
ROAS bidding target ROAS |
campaign.target_roas.target_roas |
The target Return On Ad Spend (ROAS) percentage set for a campaign’s automated bidding strategy. |
metric |
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 |
Remarketing |
Remarketing |
Data related to remarketing lists used for audience targeting. |
dimension |
Responsive Search Ad headlines |
Responsive Search Ad headlines |
This field contains the text of the headlines used in a Responsive Search Ad, which Google Ads can combine in various ways. |
dimension |
Responsive Search Ad path 1 |
Responsive Search Ad path 1 |
The first optional path shown in the display URL of a Responsive Search Ad. |
dimension |
Responsive Search Ad path 2 |
Responsive Search Ad path 2 |
The second optional path shown in the display URL of a Responsive Search Ad. |
dimension |
Revenue |
Revenue |
The revenue generated from conversions attributed to ad activity. |
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. |
metric |
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. |
metric |
Search Lost IS (budget) |
Search Lost IS (budget) |
The percentage of time your ads on the Search Network were not shown due to insufficient budget. |
metric |
Search Lost IS (rank) |
Search Lost IS (rank) |
The percentage of impressions that your ads didn’t receive on the Search Network due to low Ad Rank. |
metric |
Search Type |
Search Type |
The type of search that triggered an ad (e.g., Google Search, Search Partners). |
dimension |
Search abs. top IS |
Search abs. top IS |
The percentage of impression share that your ads received in the absolute top position of the search results page. |
metric |
Search eligible impressions |
Search eligible impressions |
The estimated number of impressions a campaign, ad group, or keyword was eligible to receive on the Search Network. |
metric |
Search impression share |
metrics.search_impression_share |
This metric represents the percentage of impressions your ads received on the Search Network compared to the estimated total number of eligible impressions. |
metric |
Search lost abs. top IS (budget) |
Search lost abs. top IS (budget) |
The percentage of time your ads on the Search Network were not shown in the absolute top position due to insufficient budget. |
metric |
Search lost abs. top IS (rank) |
Search lost abs. top IS (rank) |
The percentage of time your ads on the Search Network were not shown in the absolute top position due to low Ad Rank. |
metric |
Search lost impression share (rank) |
metrics.search_rank_lost_impression_share |
This metric indicates the percentage of time your ads were not shown on the Search Network due to a low Ad Rank. |
metric |
Search lost top IS (budget) |
Search lost top IS (budget) |
The percentage of time your ads on the Search Network were not shown in the top positions due to insufficient budget. |
metric |
Search lost top IS (rank) |
Search lost top IS (rank) |
The percentage of time your ads on the Search Network were not shown in the top positions due to low Ad Rank. |
metric |
Search result type |
segments.search_engine_results_page_type |
The type of search engine results page where the ad or organic listing appeared (e.g., Google Search, Google Images). |
dimension |
Search term |
search_term_view.search_term |
The actual search query entered by a user that triggered an ad impression. |
dimension |
Search term view resource name |
search_term_view.resource_name |
The resource name of the search term view, which uniquely identifies this particular search term entry. |
dimension |
Search top IS |
Search top IS |
The percentage of your ad impressions that were shown anywhere above the organic search results. |
metric |
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 Set Name |
shared_set.name |
The name of the shared set. |
dimension |
Shared Set Status |
shared_set.status |
The current status of the shared set (e.g., enabled, removed). |
dimension |
Source |
Source |
The origin or platform from which the data or event was recorded. |
dimension |
Source Name |
Source Name |
The name of the advertising source, e.g., ‘Google Search’, ‘YouTube’. |
dimension |
Spend |
Spend |
The total cost incurred for the advertising campaign or ad group. |
dimension |
Start date |
campaign.start_date |
The start date of the campaign. |
dimension |
Store Visit |
Store Visit |
A conversion representing an estimated visit to a physical store location. |
dimension |
Store Visits |
Store Visits |
The number of estimated store visits generated after users interacted with an ad. |
metric |
Store sales |
Store sales |
This metric represents the number or value of conversions that originated from physical store sales attributed to advertising efforts. |
dimension |
Target ROAS (Maximize Conversion Value) |
Target ROAS (Maximize Conversion Value) |
The desired average return on ad spend (ROAS) that the Maximize Conversion Value bidding strategy aims to achieve. |
metric |
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. |
dimension |
Targeting Category |
Targeting Category |
The category used for targeting purposes (e.g., interest-based, demographic). |
dimension |
Time |
Time |
A time dimension for reporting, typically representing hours, days, or specific timestamps. |
dimension |
Time zone |
customer.time_zone |
This field specifies the time zone setting for the customer’s account, influencing how metrics and reports are recorded. |
dimension |
Top Impression (%) |
metrics.top_impression_percentage |
The percentage of your ad impressions that were shown anywhere above the organic search results. |
metric |
Top Impressions |
Top Impressions |
The percentage of your ad impressions that were shown anywhere above the organic search results. |
metric |
Top of page CPC |
Top of page CPC |
The estimated cost-per-click needed for an ad to appear anywhere in the top section of the search results page. |
metric |
Total Budget amount |
Total Budget amount |
The total monetary amount set for a campaign’s budget. |
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_Events |
Total_Events |
The total count of all recorded events or conversions. |
metric |
TrackingTemplate |
TrackingTemplate |
This field contains a URL template used for tracking clicks and other interactions, allowing for dynamic tracking parameters. |
dimension |
Universal App Ad html5 media bundles |
Universal App Ad html5 media bundles |
HTML5 media bundles, which are interactive assets used in Universal App Campaigns. |
dimension |
Universal App Ad images |
Universal App Ad images |
Image assets used in Universal App Campaigns. |
dimension |
Universal App Ad mandatory ad text |
Universal App Ad mandatory ad text |
Mandatory text assets provided for Universal App Campaigns, such as headlines and descriptions. |
dimension |
Universal App Ad youTube videos |
Universal App Ad youTube videos |
YouTube video assets used in Universal App Campaigns. |
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 |
Universal app ad images urls |
Universal app ad images urls |
The URLs of images used as assets in Universal App Ads. |
dimension |
User list ID |
user_list.id |
The unique identifier for a user list. |
metric |
User list access reason |
user_list.access_reason |
The reason for the access to a user list. |
dimension |
User list description |
user_list.description |
A description of the user list’s purpose or content. |
dimension |
User list membership life span |
user_list.membership_life_span |
The number of days a user remains in a user list. |
metric |
User list membership status |
user_list.membership_status |
The status of a user’s membership in the user list. |
dimension |
User list name |
user_list.name |
The name of the user list. |
dimension |
User list resource name |
user_list.resource_name |
The unique resource name for a user list. |
dimension |
User list rule operator |
User list rule operator |
The operator used in defining the rules for a user list, such as ‘AND’ or ‘OR’. |
dimension |
User list size for Google Display Network |
user_list.size_for_display |
The size of the user list for targeting on the Google Display Network. |
metric |
User list size for Google Search Network |
user_list.size_for_search |
The size of the user list for targeting on the Google Search Network. |
metric |
User list size range for Google Display Network |
user_list.size_range_for_display |
The size range of the user list for targeting on the Google Display Network. |
dimension |
User list size range for Google Search Network |
user_list.size_range_for_search |
The size range of the user list for targeting on the Google Search Network. |
dimension |
User location |
User location |
Refers to the physical location of the user when an ad impression or click occurred. |
dimension |
Vertical ID |
Vertical ID |
A numerical identifier for the industry vertical or business category. |
dimension |
Video Id |
Video Id |
The unique identifier for a YouTube video asset. |
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 Title |
Video Title |
The title of a video asset used in a video ad. |
dimension |
Video Views |
Video Views |
The number of times a TrueView video ad was viewed. |
metric |
Video played to 100% (value) |
Video played to 100% (value) |
The value generated when a video ad was played to 100% of its duration. |
metric |
Video played to 25% (value) |
Video played to 25% (value) |
The value generated when a video ad was played to 25% of its duration. |
metric |
Video played to 50% (value) |
Video played to 50% (value) |
The value generated when a video ad was played to 50% of its duration. |
metric |
Video played to 75% (value) |
Video played to 75% (value) |
The value generated when a video ad was played to 75% of its duration. |
metric |
VideoQuartileViews100 |
VideoQuartileViews100 |
The number of times the video ad was viewed to 100% completion. |
metric |
VideoQuartileViews25 |
VideoQuartileViews25 |
The number of times the video ad was viewed to 25% completion. |
metric |
VideoQuartileViews50 |
VideoQuartileViews50 |
The number of times the video ad was viewed to 50% completion. |
metric |
VideoQuartileViews75 |
VideoQuartileViews75 |
The number of times the video ad was viewed to 75% completion. |
metric |
Video_views_100% |
Video_views_100% |
The number of times a video ad was played to 100% of its duration. |
metric |
Video_views_25% |
Video_views_25% |
The number of times a video ad was played to 25% of its duration. |
metric |
Video_views_50% |
Video_views_50% |
The number of times a video ad was played to 50% of its duration. |
metric |
Video_views_75% |
Video_views_75% |
The number of times a video ad was played to 75% of its duration. |
metric |
View through conversions from location asset click to call |
metrics.view_through_conversions_from_location_asset_click_to_call |
The number of view-through conversions that resulted from a click-to-call action on a location asset. |
metric |
View through conversions from location asset directions |
metrics.view_through_conversions_from_location_asset_directions |
The number of view-through conversions that resulted from a click for directions on a location asset. |
metric |
View through conversions from location asset other engagement |
metrics.view_through_conversions_from_location_asset_other_engagement |
The number of view-through conversions that resulted from other types of engagement with a location asset. |
metric |
View through conversions from location asset website |
metrics.view_through_conversions_from_location_asset_website |
The number of view-through conversions that resulted from a website click on a location asset. |
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 |
Viewable Impr. |
Viewable Impr. |
The number of viewable impressions, meaning the ad was considered seen by a user. |
dimension |
Week |
Week |
The week in which an event occurred, defined as Monday through Sunday, used for segmentation. |
dimension |
YY |
YY |
This field represents the year component of a date, often used for segmenting reporting data. |
metric |
Year |
Year |
The year in which an event occurred, used for segmentation. |
metric |
YouTube channel subscriptions |
YouTube channel subscriptions |
The number of new subscriptions to a YouTube channel attributed to an ad. |
metric |
YouTube follow-on views |
YouTube follow-on views |
The number of additional views of videos on a YouTube channel by users who previously watched a video ad. |
metric |
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 |
account_number |
account_number |
The unique identifier for the Google Ads customer account. |
metric |
account_type |
account_type |
The type of Google Ads account. |
dimension |
actions |
actions |
A general metric representing user actions taken in response to an ad, which could be various types of conversions. |
dimension |
actions.comment |
actions.comment |
A user action indicating a comment made on an ad or post. |
dimension |
actions.link_click |
actions.link_click |
A user action indicating a click on a link within an ad. |
dimension |
actions.onsite_conversion.post_save |
actions.onsite_conversion.post_save |
A user action indicating a conversion event where a user saved a post on the ad platform. |
dimension |
actions.page_engagement |
actions.page_engagement |
A user action indicating engagement with a page associated with an ad. |
dimension |
actions.post |
actions.post |
A user action related to an ad post. |
dimension |
actions.post_engagement |
actions.post_engagement |
A user action indicating engagement with an ad post (e.g., likes, shares, comments). |
dimension |
actions.post_reaction |
actions.post_reaction |
A user action indicating a reaction (e.g., like, love, wow) to an ad post. |
dimension |
active view measurable impressions |
active view measurable impressions |
The number of impressions that were measurable by Active View, Google’s technology for measuring ad viewability. |
metric |
actual_device |
actual_device |
The type of device (e.g., mobile, tablet, desktop) on which an ad impression or click was recorded. |
dimension |
ad group id |
ad group id |
The unique identifier for an ad group. |
metric |
ad_creative_body |
ad_creative_body |
The main text content of an ad creative. |
dimension |
ad_creative_image_url |
ad_creative_image_url |
The URL of an image used in an ad creative. |
dimension |
ad_creative_link_url |
ad_creative_link_url |
The landing page URL associated with an ad creative. |
dimension |
ad_creative_name |
ad_creative_name |
The name assigned to a specific ad creative asset. |
dimension |
ad_creative_title |
ad_creative_title |
The headline or title text of an ad creative. |
dimension |
ad_format |
ad_format |
The format of the ad (e.g., text, image, video). |
dimension |
ad_format_type |
ad_format_type |
This field indicates the specific type of ad format being used, such as text, image, video, or in-feed. |
dimension |
ad_group |
Ad Group |
The advertising group containing ads, keywords, and bids that target a specific set of customers. |
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, indicating its behavior and targeting (e.g., Standard, DSA, Smart). |
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.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_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.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.primary_status |
ad_group_criterion.primary_status |
This field provides the primary serving status of an ad group criterion, indicating whether it is currently serving or not. |
dimension |
ad_group_criterion.primary_status_reasons.{NUM} |
ad_group_criterion.primary_status_reasons.{NUM} |
A list of reasons explaining the primary status of an ad group criterion. |
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_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_group_id |
ad_group_id |
The unique identifier for an ad group. |
dimension |
ad_group_name |
ad_group_name |
The name assigned to the ad group. |
dimension |
ad_id |
ad_id |
The unique identifier for an individual ad. |
dimension |
ad_language |
ad_language |
The language in which the ad is served. |
dimension |
ad_name |
ad_name |
The name of an ad. |
dimension |
ad_network_type |
ad_network_type |
The type of ad network where the ad was served (e.g., Google Search, Display Network, YouTube). |
dimension |
ad_platform |
ad_platform |
The advertising platform where the ads are run (e.g., Google Ads, YouTube). |
dimension |
ad_preview_default_url |
ad_preview_default_url |
The default URL for previewing an ad. |
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 |
ad_type |
ad_type |
This field specifies the detailed type of the ad, such as Expanded Text Ad, Responsive Search Ad, or Image Ad. |
dimension |
ad_type_youtube |
ad_type_youtube |
The type of YouTube ad format (e.g., TrueView In-stream, Bumper, Skippable In-stream). This is likely a dimension from the ‘video’ resource level. |
dimension |
adformat |
adformat |
The format or type of the advertisement, such as text ad, image ad, or video ad. |
dimension |
adgroupid |
adgroupid |
The unique identifier for the ad group. |
metric |
adgroupstatus |
adgroupstatus |
The current status of the ad group (e.g., enabled, paused, removed). |
dimension |
adset_name |
adset_name |
The name of the ad set, a grouping of ads with shared settings like budget, scheduling, and targeting. |
dimension |
adset_targeting |
adset_targeting |
Details about the targeting criteria applied at the ad set level. |
dimension |
adtype_network |
adtype_network |
The type of ad network where the ad was served (e.g., Google Search, Display Network). |
dimension |
advertiserName |
advertiserName |
The descriptive name of the Google Ads customer account (advertiser). |
dimension |
advertiser_id |
advertiser_id |
The unique identifier for the Google Ads customer account (advertiser). |
dimension |
advertiser_name |
advertiser_name |
The descriptive name of the Google Ads customer account (advertiser). |
dimension |
advertising_channel |
advertising_channel |
The primary advertising channel for the campaign (e.g., SEARCH, DISPLAY, VIDEO, SHOPPING). |
dimension |
adwords_clicks |
adwords_clicks |
The number of clicks on Google Ads (formerly Google AdWords) ads. |
metric |
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 |
all conversions |
all conversions |
The total number of conversions, including those not set as “primary for goal”. |
metric |
all conversions value |
all conversions value |
The sum of all conversion values, regardless of their “include in conversions” setting. |
metric |
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.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 |
This is the resource name for an asset group, which uniquely identifies it within the Google Ads API. |
dimension |
asset_group.status |
Asset group status |
The overall status of the asset group (e.g., ENABLED, PAUSED, REMOVED). |
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 |
asset_length |
asset_length |
The duration of a video asset in microseconds. |
metric |
audience_data_source |
audience_data_source |
The source of the data used to create an audience (e.g., first-party data, Google data). |
dimension |
audience_data_source_type |
audience_data_source_type |
The type of data source used to create an audience. |
dimension |
average_cost |
average_cost |
The average cost per interaction. |
metric |
average_cpc |
average_cpc |
The average cost-per-click (CPC) for your ads. |
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 |
averageposition |
averageposition |
The average position of an ad on the search results page or website. |
metric |
avg_watch_time |
avg_watch_time |
This metric represents the average duration, in milliseconds, that users watched a video ad per impression. |
metric |
bid_strategy_type_campaign |
bid_strategy_type_campaign |
The type of bidding strategy used for the campaign (e.g., MAXIMIZE_CONVERSIONS, TARGET_CPA). |
dimension |
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.end_time_type |
billing_setup.end_time_type |
The type of end time for the billing setup, indicating if it’s a specific date, indefinite, or other options. |
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 |
brand_name |
brand_name |
The name of the brand associated with the advertising campaign or products. This can be relevant to brand lists in v21. |
dimension |
buying_platform |
buying_platform |
The platform through which ad inventory was purchased. |
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 country |
campaign country |
The country targeted by a campaign. |
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.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 |
The type of campaign criterion (e.g., location, age range, audience). |
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_daily_budget |
campaign_daily_budget |
The daily budget amount allocated to a campaign. |
dimension |
campaign_day |
campaign_day |
This segment field represents the specific day within a campaign’s reporting period. |
metric |
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_id |
campaign_id |
The unique ID of the campaign. |
dimension |
campaign_month |
campaign_month |
This segment field represents the specific month within a campaign’s reporting period. |
metric |
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 |
campaign_start_time |
campaign_start_time |
The date and time when the campaign started. |
dimension |
campaign_stop_time |
campaign_stop_time |
The date and time when the campaign ended or is scheduled to end. |
dimension |
campaign_type |
campaign_type |
The type of advertising channel used for a campaign (e.g., Search, Display, Shopping, Video, App). |
dimension |
campaign_year |
campaign_year |
This segment field represents the specific year within a campaign’s reporting period. |
metric |
campaignid |
campaignid |
The unique identifier for the advertising campaign. |
metric |
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 |
channel |
channel |
The advertising channel for a campaign, such as Search or Display. |
dimension |
channel_category |
channel_category |
This field categorizes the broader type of advertising channel, such as ‘SEARCH’ or ‘DISPLAY’. |
dimension |
channel_detail |
channel_detail |
Provides granular details about the channel where an ad was served, used for segmentation. |
dimension |
channel_group |
channel_group |
The grouping of advertising channels where an ad was served, used for segmentation. |
dimension |
channel_name |
channel_name |
The name of the channel where an ad was served (e.g., YouTube channel name). |
dimension |
channel_type |
channel_type |
The type of advertising channel for a campaign (e.g., SEARCH, DISPLAY, VIDEO, SHOPPING). |
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_google |
clicks_google |
The number of clicks on ads served on Google properties. |
metric |
clicks_googleAds |
clicks_googleAds |
This metric represents the number of clicks received on ads within the Google Ads platform. |
metric |
client |
client |
Refers to the Google Ads customer account. |
dimension |
client_name |
client_name |
The descriptive name of the Google Ads customer account (client). |
dimension |
conversion |
conversion |
The number of conversions recorded that are included in the ‘conversions’ metric. |
dimension |
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.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 |
conversion_value_total |
conversion_value_total |
This metric represents the total aggregated value of all conversions. |
metric |
conversions |
conversions |
The number of conversions recorded for your ads. |
metric |
conversions_value |
conversions_value |
The sum of conversion values for all conversions. |
metric |
cost |
cost |
The total cost of ad interactions, presented in micros (divide by 1,000,000 for actual currency). |
metric |
cost_googleAds |
cost_googleAds |
This metric represents the cost incurred for advertising on the Google Ads platform. |
metric |
cost_micros |
cost_micros |
The total cost of clicks and interactions in micro-units (one millionth of the currency unit). |
metric |
cost_per_conversion |
cost_per_conversion |
The average cost incurred for each conversion, calculated by dividing the total cost of ad interactions by the number of conversions. |
metric |
costs |
costs |
This metric represents the total cost incurred for advertising activities. |
metric |
costs google |
costs google |
The cost of ad interactions on Google properties, in micros. |
metric |
country |
country |
The country associated with ad impressions, clicks, or targeting. |
dimension |
country_code |
country_code |
The country code, often in ISO format. |
dimension |
country_code_iso_3166-1_alpha-2 |
country_code_iso_3166-1_alpha-2 |
The two-letter ISO 3166-1 alpha-2 country code. |
dimension |
country_id |
country_id |
This field represents the numerical criterion ID for a targeted country. |
dimension |
country_iso3 |
country_iso3 |
The three-letter ISO code for a country. |
dimension |
country_name |
country_name |
The human-readable name of the country. |
dimension |
countrycriteriaid |
countrycriteriaid |
The geographic targeting ID for a country. |
metric |
cpa |
cpa |
This metric represents the average cost per acquisition or cost per action, indicating the cost efficiency of gaining a conversion. |
metric |
creative_name |
creative_name |
The name of the ad creative. |
dimension |
creative_version |
creative_version |
The version identifier for a specific ad creative. |
dimension |
ctr |
ctr |
Click-through rate, which is the ratio of clicks to impressions. |
metric |
currency |
currency |
The currency code used for financial metrics. |
dimension |
custom_conversion_goal.id |
Custom Conversion Goal Id |
The unique identifier for a custom conversion goal. |
dimension |
custom_conversion_goal.name |
Custom Conversion Goal Name |
The name of a custom conversion goal defined in Google Ads. |
dimension |
custom_conversion_goal.resource_name |
Custom Conversion Goal Resource name |
This is the resource name of a custom conversion goal, used to define specific conversion actions for campaign bidding and optimization. |
dimension |
custom_conversion_goal.status |
Custom Conversion Goal Status |
This field indicates the current status of a custom conversion goal, such as enabled or paused. |
dimension |
customer |
Customer |
The resource name of the Google Ads customer account. |
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_id |
customer_id |
The unique identifier for the Google Ads customer account. |
dimension |
customer_name |
customer_name |
The name of the Google Ads customer account. |
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.resource_name |
customer_user_access.resource_name |
The resource name for the customer_user_access entity, serving as its unique identifier within the Google Ads API. |
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 |
date_start |
date_start |
The start date for reporting or the start date of a campaign. |
dimension |
date_stop |
date_stop |
The end date of the reporting period. |
dimension |
date_updated |
date_updated |
The date when the ad entity or its associated data was last updated. |
dimension |
destination_type |
destination_type |
The type of destination a user is taken to after clicking an ad (e.g., Website, App Deep Link). |
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 |
device |
device |
The type of device on which an ad was shown, used for segmentation (e.g., mobile, tablet, desktop). |
dimension |
device_category |
device_category |
This segment field categorizes the type of device used by a user when interacting with an ad, such as mobile, tablet, or desktop. |
dimension |
device_type |
device_type |
The type of device used to view an ad (e.g., mobile, desktop, tablet). |
dimension |
display |
City Name |
The name of the city, representing a geographical location. |
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 |
domain |
domain |
The domain name associated with a website, often used for Dynamic Search Ads. |
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 |
engagements |
engagements |
The number of engagements with your ad (e.g., video plays, clicks on certain ad formats). |
metric |
exchange_rate |
exchange_rate |
The exchange rate used for currency conversion in reporting. |
metric |
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 |
flight_end |
flight_end |
The end date of an advertising campaign flight. |
dimension |
flight_start |
flight_start |
The start date of an advertising campaign flight. |
dimension |
format_type |
format_type |
The format of the ad (e.g., text, image, video). |
dimension |
frequency |
frequency |
The average number of times a unique user saw an ad impression. |
dimension |
gads_campaign |
gads_campaign |
This field represents a Google Ads campaign, which is a set of ad groups sharing budget, targeting, and other settings. |
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_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 |
google_ads_customer_id |
google_ads_customer_id |
The unique identifier for the Google Ads customer account. |
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 |
image url |
image url |
The URL of an image asset used in an ad. |
dimension |
impressions_account |
impressions_account |
The total number of times ads from the account were shown. |
metric |
impressions_ad |
impressions_ad |
This metric represents the number of times an individual ad was shown to users. |
metric |
impressions_adgroup |
impressions_adgroup |
This metric represents the total number of times ads within a specific ad group were shown to users. |
metric |
impressions_campaign |
impressions_campaign |
This metric represents the total number of times ads within a specific campaign were shown to users. |
metric |
impressions_google |
impressions_google |
The number of times an ad was shown on Google properties. |
metric |
impressions_googleAds |
impressions_googleAds |
This metric represents the number of times ads were shown across the Google Ads platform. |
metric |
impressions_volume |
impressions_volume |
The total number of times an ad was shown or the estimated volume of eligible impressions. |
dimension |
insertion_order_id |
insertion_order_id |
The identifier for a billing insertion order. |
dimension |
installs |
installs |
The number of app installs recorded as a conversion. |
dimension |
interactions |
interactions |
The number of interactions with your ad (e.g., clicks on text ads, views on video ads). |
metric |
invalid_impressions_ad |
invalid_impressions_ad |
The number of invalid impressions for a specific ad, which are filtered out as non-human traffic or other invalid activity. |
metric |
invalid_impressions_adgroup |
invalid_impressions_adgroup |
The number of invalid impressions for an ad group, filtered out due to invalid activity. |
metric |
invalid_impressions_campaign |
invalid_impressions_campaign |
The number of invalid impressions for a campaign, filtered out due to invalid activity. |
metric |
invoice.account_budget_summaries.{NUM}.account_budget |
Account budget |
The resource name of the account budget. |
dimension |
invoice.account_budget_summaries.{NUM}.account_budget_name |
Account budget name |
The name of the account budget. |
dimension |
invoice.account_budget_summaries.{NUM}.billable_activity_date_range.end_date |
Billable activity end date |
The end date of the billable activity period for the account budget. |
dimension |
invoice.account_budget_summaries.{NUM}.billable_activity_date_range.start_date |
Billable activity start date |
The start date of the billable activity period for the account budget. |
dimension |
invoice.account_budget_summaries.{NUM}.billed_amount_micros |
invoice.account_budget_summaries.{NUM}.billed_amount_micros |
The amount billed for the account budget in micro-units. |
metric |
invoice.account_budget_summaries.{NUM}.customer |
invoice.account_budget_summaries.{NUM}.customer |
The customer resource name associated with this account budget summary. |
dimension |
invoice.account_budget_summaries.{NUM}.customer_descriptive_name |
invoice.account_budget_summaries.{NUM}.customer_descriptive_name |
The descriptive name of the customer associated with this account budget summary. |
dimension |
invoice.account_budget_summaries.{NUM}.invalid_activity_amount_micros |
invoice.account_budget_summaries.{NUM}.invalid_activity_amount_micros |
The amount of invalid activity detected for the account budget, in micro-units. |
metric |
invoice.account_budget_summaries.{NUM}.invalid_activity_summaries.{NUM}.amount_micros |
invoice.account_budget_summaries.{NUM}.invalid_activity_summaries.{NUM}.amount_micros |
The amount of a specific invalid activity entry for the account budget, in micro-units. |
metric |
invoice.account_budget_summaries.{NUM}.invalid_activity_summaries.{NUM}.original_account_budget_name |
invoice.account_budget_summaries.{NUM}.invalid_activity_summaries.{NUM}.original_account_budget_name |
The name of the original account budget associated with the invalid activity summary. |
dimension |
invoice.account_budget_summaries.{NUM}.invalid_activity_summaries.{NUM}.original_invoice_id |
invoice.account_budget_summaries.{NUM}.invalid_activity_summaries.{NUM}.original_invoice_id |
The ID of the original invoice related to the invalid activity summary. |
dimension |
invoice.account_budget_summaries.{NUM}.invalid_activity_summaries.{NUM}.original_month_of_service |
invoice.account_budget_summaries.{NUM}.invalid_activity_summaries.{NUM}.original_month_of_service |
The month of service for the original activity related to the invalid activity summary. |
dimension |
invoice.account_budget_summaries.{NUM}.invalid_activity_summaries.{NUM}.original_purchase_order_number |
invoice.account_budget_summaries.{NUM}.invalid_activity_summaries.{NUM}.original_purchase_order_number |
The purchase order number from the original account budget related to the invalid activity summary. |
dimension |
invoice.account_budget_summaries.{NUM}.invalid_activity_summaries.{NUM}.original_year_of_service |
invoice.account_budget_summaries.{NUM}.invalid_activity_summaries.{NUM}.original_year_of_service |
The year of service for the original activity related to the invalid activity summary. |
metric |
invoice.account_budget_summaries.{NUM}.overdelivery_amount_micros |
invoice.account_budget_summaries.{NUM}.overdelivery_amount_micros |
The amount of overdelivery for the account budget, in micro-units. |
metric |
invoice.account_budget_summaries.{NUM}.purchase_order_number |
invoice.account_budget_summaries.{NUM}.purchase_order_number |
The purchase order number associated with the account budget. |
dimension |
invoice.account_budget_summaries.{NUM}.served_amount_micros |
invoice.account_budget_summaries.{NUM}.served_amount_micros |
The amount served for the account budget, in micro-units. |
metric |
invoice.account_budget_summaries.{NUM}.subtotal_amount_micros |
Account budget subtotal amount |
The subtotal amount for the account budget summary in micro-units, excluding tax and adjustments. |
metric |
invoice.account_budget_summaries.{NUM}.tax_amount_micros |
Account budget tax amount |
The tax amount for the account budget summary in micro-units. |
metric |
invoice.account_budget_summaries.{NUM}.total_amount_micros |
Account budget total amount |
The total amount for the account budget summary in micro-units, including tax and adjustments. |
metric |
invoice.account_summaries.{NUM}.billing_correction_subtotal_amount_micros |
invoice.account_summaries.{NUM}.billing_correction_subtotal_amount_micros |
The subtotal amount of billing corrections for the account summary, in micro-units. |
metric |
invoice.account_summaries.{NUM}.billing_correction_tax_amount_micros |
invoice.account_summaries.{NUM}.billing_correction_tax_amount_micros |
The tax amount of billing corrections for the account summary, in micro-units. |
metric |
invoice.account_summaries.{NUM}.billing_correction_total_amount_micros |
invoice.account_summaries.{NUM}.billing_correction_total_amount_micros |
The total amount of billing corrections for the account summary, in micro-units. |
metric |
invoice.account_summaries.{NUM}.coupon_adjustment_subtotal_amount_micros |
invoice.account_summaries.{NUM}.coupon_adjustment_subtotal_amount_micros |
The subtotal amount of coupon adjustments for the account summary, in micro-units. |
metric |
invoice.account_summaries.{NUM}.coupon_adjustment_tax_amount_micros |
invoice.account_summaries.{NUM}.coupon_adjustment_tax_amount_micros |
The tax amount of coupon adjustments for the account summary, in micro-units. |
metric |
invoice.account_summaries.{NUM}.coupon_adjustment_total_amount_micros |
invoice.account_summaries.{NUM}.coupon_adjustment_total_amount_micros |
The total amount of coupon adjustments for the account summary, in micro-units. |
metric |
invoice.account_summaries.{NUM}.customer |
invoice.account_summaries.{NUM}.customer |
The customer resource name associated with this account summary. |
metric |
invoice.account_summaries.{NUM}.excess_credit_adjustment_subtotal_amount_micros |
invoice.account_summaries.{NUM}.excess_credit_adjustment_subtotal_amount_micros |
The subtotal amount of excess credit adjustments for the account summary, in micro-units. |
metric |
invoice.account_summaries.{NUM}.excess_credit_adjustment_tax_amount_micros |
invoice.account_summaries.{NUM}.excess_credit_adjustment_tax_amount_micros |
The tax amount of excess credit adjustments for the account summary, in micro-units. |
metric |
invoice.account_summaries.{NUM}.excess_credit_adjustment_total_amount_micros |
invoice.account_summaries.{NUM}.excess_credit_adjustment_total_amount_micros |
The total amount of excess credit adjustments for the account summary, in micro-units. |
metric |
invoice.account_summaries.{NUM}.export_charge_subtotal_amount_micros |
invoice.account_summaries.{NUM}.export_charge_subtotal_amount_micros |
The subtotal amount of export charges for the account summary, in micro-units. |
metric |
invoice.account_summaries.{NUM}.export_charge_tax_amount_micros |
invoice.account_summaries.{NUM}.export_charge_tax_amount_micros |
The tax amount of export charges for the account summary, in micro-units. |
metric |
invoice.account_summaries.{NUM}.export_charge_total_amount_micros |
invoice.account_summaries.{NUM}.export_charge_total_amount_micros |
The total amount of export charges for the account summary, in micro-units. |
metric |
invoice.account_summaries.{NUM}.regulatory_costs_subtotal_amount_micros |
invoice.account_summaries.{NUM}.regulatory_costs_subtotal_amount_micros |
The subtotal amount of regulatory costs for the account summary, in micro-units. |
metric |
invoice.account_summaries.{NUM}.regulatory_costs_tax_amount_micros |
invoice.account_summaries.{NUM}.regulatory_costs_tax_amount_micros |
The tax amount of regulatory costs for the account summary, in micro-units. |
metric |
invoice.account_summaries.{NUM}.regulatory_costs_total_amount_micros |
invoice.account_summaries.{NUM}.regulatory_costs_total_amount_micros |
The total amount of regulatory costs for the account summary, in micro-units. |
metric |
invoice.account_summaries.{NUM}.subtotal_amount_micros |
invoice.account_summaries.{NUM}.subtotal_amount_micros |
The subtotal amount for the account summary in micro-units, excluding tax and adjustments. |
metric |
invoice.account_summaries.{NUM}.tax_amount_micros |
invoice.account_summaries.{NUM}.tax_amount_micros |
The tax amount for the account summary in micro-units. |
metric |
invoice.account_summaries.{NUM}.total_amount_micros |
invoice.account_summaries.{NUM}.total_amount_micros |
The total amount for the account summary in micro-units, including tax and adjustments. |
metric |
invoice.adjustments_subtotal_amount_micros |
Adjustments subtotal amount |
The subtotal amount of adjustments applied to the invoice, in micro-units. |
metric |
invoice.adjustments_tax_amount_micros |
Adjustments tax amount |
The tax amount of adjustments applied to the invoice, in micro-units. |
metric |
invoice.adjustments_total_amount_micros |
Adjustments total amount |
The total amount of adjustments applied to the invoice, in micro-units. |
metric |
invoice.billing_setup |
Billing setup |
The resource name of the billing setup associated with the invoice. |
dimension |
invoice.corrected_invoice |
invoice.corrected_invoice |
Reference to a corrected invoice, if the current invoice is a correction of a previous one. |
metric |
invoice.currency_code |
Currency code |
The currency code in which the invoice amounts are expressed (e.g., ‘USD’). |
dimension |
invoice.due_date |
Due date |
The date by which the invoice payment is due. |
dimension |
invoice.export_charge_subtotal_amount_micros |
invoice.export_charge_subtotal_amount_micros |
The subtotal amount of export charges on the invoice, in micro-units. |
metric |
invoice.export_charge_tax_amount_micros |
invoice.export_charge_tax_amount_micros |
The tax amount of export charges on the invoice, in micro-units. |
metric |
invoice.export_charge_total_amount_micros |
invoice.export_charge_total_amount_micros |
The total amount of export charges on the invoice, in micro-units. |
metric |
invoice.id |
Invoice ID |
The unique identifier for the invoice. |
metric |
invoice.issue_date |
Issue date |
The date when the invoice was issued. |
dimension |
invoice.payments_account_id |
Payments account ID |
The unique identifier for the payments account associated with the invoice. |
dimension |
invoice.payments_account_name |
Payments account name |
The name of the payments account associated with the invoice. |
dimension |
invoice.payments_profile_id |
Payments profile ID |
The unique identifier for the payments profile associated with the invoice. |
dimension |
invoice.payments_profile_name |
Payments profile name |
The name of the payments profile associated with the invoice. |
dimension |
invoice.pdf_url |
PDF URL |
The URL where the PDF version of the invoice can be accessed. |
dimension |
invoice.regulatory_costs_subtotal_amount_micros |
Regulatory costs subtotal amount |
The subtotal amount of regulatory costs on the invoice, in micro-units. |
metric |
invoice.regulatory_costs_tax_amount_micros |
Regulatory costs tax amount |
The tax amount of regulatory costs on the invoice, in micro-units. |
metric |
invoice.regulatory_costs_total_amount_micros |
Regulatory costs total amount |
The total amount of regulatory costs on the invoice, in micro-units. |
metric |
invoice.replaced_invoices.{NUM} |
invoice.replaced_invoices.{NUM} |
A list of resource names for invoices that were replaced by the current invoice. |
metric |
invoice.resource_name |
Invoice resource name |
The full resource name of the invoice, which uniquely identifies it within the API. |
dimension |
invoice.service_date_range.end_date |
Service end date |
The end date of the service period covered by the invoice. |
dimension |
invoice.service_date_range.start_date |
Service start date |
The start date of the service period covered by the invoice. |
dimension |
invoice.subtotal_amount_micros |
Subtotal amount |
The subtotal amount of the invoice in micro-units, excluding tax and total adjustments. |
metric |
invoice.tax_amount_micros |
Tax amount |
The total tax amount on the invoice in micro-units. |
metric |
invoice.total_amount_micros |
Total amount |
The total amount of the invoice in micro-units, including all charges, taxes, and adjustments. |
metric |
Invoice type |
The type of the invoice (e.g., ‘MONTHLY_INVOICE’). |
dimension |
|
is_targeting_location |
is_targeting_location |
Indicates whether the geographic location is explicitly targeted. |
dimension |
iso_year |
iso_year |
The year according to the ISO week date system, used for segmentation. |
metric |
item_id |
item_id |
The unique identifier for a product item in Shopping campaigns. |
dimension |
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 |
latitude |
latitude |
The latitude coordinate of a geographical target. |
metric |
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 |
leads |
leads |
The number of lead conversions recorded. |
metric |
length |
length |
The duration or length of a video ad. |
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_source |
location_source |
The source of the location data for a user, used for segmentation. |
dimension |
location_type |
location_type |
The type of geographic location, such as ‘Physical location’ or ‘Area of interest’. |
dimension |
location_view.resource_name |
Location view resource name |
The resource name of the location view, providing performance data segmented by geographic location. |
dimension |
locationtype |
locationtype |
The type of location (e.g., ‘City’, ‘Region’, ‘Country’) for targeting or reporting. |
dimension |
longitude |
longitude |
The longitude coordinate of a geographical target. |
metric |
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 |
match_type |
match_type |
The match type of the keyword or search term that triggered an ad. |
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 |
mcc_name |
mcc_name |
The descriptive name of the Google Ads Manager Account (MCC). |
dimension |
measured_impressions |
measured_impressions |
The number of times an ad appeared in locations measurable by Active View technology. |
dimension |
media_campaign_id |
media_campaign_id |
The identifier for a media campaign. |
dimension |
media_campaign_name |
media_campaign_name |
The name of the media campaign. |
dimension |
media_channel |
media_channel |
The media channel used for advertising (e.g., Social, Search, Programmatic Display). |
dimension |
media_cost |
media_cost |
The cost associated with media impressions or clicks, in micros. |
metric |
medium |
medium |
The advertising medium that delivered the ad (e.g., cpc, organic, referral). |
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 |
metrocriteriaid |
metrocriteriaid |
The geographic targeting ID for a metropolitan area. |
metric |
monthly_date |
monthly_date |
The date represented at a monthly granularity for reporting. |
dimension |
name |
name |
A generic name field for various entities (e.g., campaign name, ad group name). |
dimension |
objective |
objective |
The overarching goal or objective of the campaign, such as sales or leads. |
dimension |
organic_paid |
organic_paid |
Indicates whether a search result or listing is organic (unpaid) or paid. |
dimension |
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 |
partner_placement |
partner_placement |
Indicates if the ad was shown on a Google partner website or app. |
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 |
per_store_view.resource_name |
per_store_view.resource_name |
The resource name for a per-store view, uniquely identifying the store’s performance data. |
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 |
placement_detail |
placement_detail |
Provides granular details about the ad placement, used for segmentation. |
dimension |
platform_name |
platform_name |
The name of the advertising platform where the ad was served. |
dimension |
potential_impressions |
potential_impressions |
An estimate of the total number of impressions an ad could receive based on targeting and budget. |
metric |
pricing_model |
pricing_model |
The pricing model used for the ad (e.g., CPC, CPM, CPV). |
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 |
product_id |
product_id |
The unique identifier for a product, typically used in Shopping campaigns. |
dimension |
product_name |
product_name |
The name or title of a product in Shopping campaigns. |
dimension |
publisher_name |
publisher_name |
The name of the publisher (e.g., website, app) where the ad was displayed. |
dimension |
publisher_platform |
publisher_platform |
The platform of the publisher whose inventory an ad was served on (e.g., AdMob, Google Display Network). |
dimension |
purchase |
purchase |
A conversion metric indicating a purchase event. |
metric |
quality_score_name |
quality_score_name |
The name or category of the Quality Score (an estimate of the quality of your ads, keywords, and landing pages). |
dimension |
reach |
reach |
The estimated number of unique users who saw an ad. |
dimension |
reattribution_reinstalls |
reattribution_reinstalls |
The number of app reinstalls that are reattributed to an ad campaign. |
dimension |
reattributions |
reattributions |
The number of conversions or app installs that are reattributed to an ad campaign. |
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 |
region |
region |
A geographical region within a country used for targeting or reporting. |
dimension |
region_iso |
region_iso |
The ISO code for a geographical region. |
dimension |
regioncriteriaid |
regioncriteriaid |
The geographic targeting ID for a region or state. |
dimension |
reinstalls |
reinstalls |
The total number of app reinstalls. |
dimension |
report_type |
report_type |
The type of report being generated (e.g., for campaigns, ad groups, or search terms). |
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 |
responsive_search_ad_descriptions |
responsive_search_ad_descriptions |
A list of text assets that serve as descriptions for Responsive Search Ads, from which Google Ads selects to display. |
dimension |
responsive_search_ad_headlines |
responsive_search_ad_headlines |
A list of text assets that serve as headlines for Responsive Search Ads, from which Google Ads selects to display. |
dimension |
roas |
roas |
This metric represents the Return On Ad Spend, calculated by dividing conversion value by cost. |
metric |
sales |
sales |
The number of sales conversions recorded, or the value generated from sales. |
metric |
search_engine |
search_engine |
The search engine where the ad impression occurred. |
dimension |
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 |
search_type |
search_type |
The type of search that triggered an ad (e.g., Google Search, Search Partners). |
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.asset_interaction_target.interaction_on_this_asset |
Asset Interaction ThisVsOther |
A segment indicating whether the user interaction that led to a conversion was directly on the specific asset. |
dimension |
segments.auction_insight_domain |
Auction insight domain |
A segment representing the domain of a competitor in the auction insights report. |
dimension |
segments.budget_campaign_association_status.status |
Budget campaign association status |
The status of the association between a budget and a campaign (e.g., ‘ACTIVE’, ‘REMOVED’). |
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.conversion_or_adjustment_lag_bucket |
Days to conversion or adjustment |
This field categorizes conversions or conversion adjustments based on the time delay (lag) between the ad interaction and the conversion event. |
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_airport |
Target airport |
A segment field that provides data broken down by targeted airports. |
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_district |
Target district |
The geographical district 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_province |
Target province |
The geographical province used for targeting or for which performance data is reported. |
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.interaction_on_this_extension |
This extension vs. other |
Indicates whether the interaction was on the specified ad extension or another part of the ad. |
dimension |
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_aggregator_id |
MCA ID |
The ID of the product aggregator (Multi-Client Account, MCA) in Google Merchant Center. |
metric |
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_channel_exclusivity |
Channel exclusivity |
The channel exclusivity of the product (e.g., SINGLE_CHANNEL, MULTI_CHANNEL). |
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. |
dimension |
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.resource_name |
shared_criterion.resource_name |
The resource name of the shared criterion, which uniquely identifies it in the Google Ads API. |
dimension |
shared_criterion.type |
Shared Criterion Type |
The type of criterion in the shared set (e.g., KEYWORD, PLACEMENT, MOBILE_APP_CATEGORY). |
dimension |
The type of the shared criterion (e.g., KEYWORD, MOBILE_APPLICATION, PLACEMENT). |
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.resource_name |
shared_set.resource_name |
The resource name of the shared set, which uniquely identifies it in the Google Ads API. |
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 |
The type of the shared set (e.g., NEGATIVE_KEYWORDS, PLACEMENT). |
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 |
siteName |
siteName |
The name of the website or publisher where an ad was shown. |
dimension |
size |
size |
The size of an ad creative or asset. |
dimension |
source_medium |
source_medium |
The source and medium of traffic (e.g., ‘google / organic’, ‘google / cpc’). |
dimension |
source_platform |
source_platform |
The platform where an ad was served (e.g., Google Search, YouTube, Display Network). |
dimension |
start_date |
start_date |
The start date for a campaign or other entity, in YYYY-MM-DD format. |
dimension |
stat_time_day |
stat_time_day |
The day for which statistics are reported, used for segmentation. |
dimension |
tactic |
tactic |
The advertising tactic or strategy employed within a campaign or ad group. |
dimension |
target_url |
target_url |
The final URL to which users are directed after clicking an ad. |
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 |
thumbnail_url |
thumbnail_url |
The URL of a thumbnail image for a video or other creative asset. |
dimension |
timestamp |
timestamp |
A timestamp indicating the date and time of an event or data capture. |
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 |
totalRevenue |
totalRevenue |
The total revenue generated from conversions, equivalent to the sum of conversion values. |
dimension |
total_conversion_value |
total_conversion_value |
The total value of all conversions attributed to ads, usually summed over a reporting period. |
metric |
total_costs |
total_costs |
The total cost incurred for the advertising activities. |
metric |
tracking_template |
tracking_template |
An optional URL template used to specify additional tracking parameters or redirects for an ad’s destination URL. |
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_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 |
The type of user list (e.g., remarketing list, customer match list). |
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 |
valid_impressions_account |
valid_impressions_account |
The total number of valid impressions across the entire account. |
metric |
valid_impressions_ad |
valid_impressions_ad |
The number of valid impressions for a specific ad after invalid activity filtering. |
metric |
valid_impressions_adgroup |
valid_impressions_adgroup |
The number of valid impressions for an ad group after invalid activity filtering. |
metric |
valid_impressions_campaign |
valid_impressions_campaign |
The number of valid impressions for a campaign after invalid activity filtering. |
metric |
video played to 25% |
video played to 25% |
The number of times a video ad was played to 25% of its total duration. |
metric |
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_completions |
video_completions |
The number of times a video ad was played to 100% of its duration. |
metric |
video_p100_watched_actions |
video_p100_watched_actions |
The number of times a video ad was watched to 100% completion. |
metric |
video_p100_watched_actions.video_view |
video_p100_watched_actions.video_view |
The number of video views that completed 100% of the video. |
metric |
video_p25_watched_actions |
video_p25_watched_actions |
The number of times a video ad was watched to 25% completion. |
metric |
video_p25_watched_actions.video_view |
video_p25_watched_actions.video_view |
The number of video views that completed at least 25% of the video. |
metric |
video_p50_watched_actions |
video_p50_watched_actions |
The number of times a video ad was watched to 50% completion. |
metric |
video_p50_watched_actions.video_view |
video_p50_watched_actions.video_view |
The number of video views that completed at least 50% of the video. |
metric |
video_quartile_100_rate |
video_quartile_100_rate |
The percentage of video plays that reached 100% completion. |
metric |
video_quartile_25_views |
video_quartile_25_views |
The number of times a video ad was played to 25% of its duration. |
metric |
video_quartile_50_views |
video_quartile_50_views |
The number of times a video ad was played to 50% of its duration. |
metric |
video_quartile_75_views |
video_quartile_75_views |
The number of times a video ad was played to 75% of its duration. |
metric |
video_view_rate |
video_view_rate |
The percentage of impressions that resulted in a video view. |
metric |
video_views |
video_views |
The total number of times the video ad was played. |
metric |
video_views_p100 |
video_views_p100 |
The number of times a video ad was played to 100% of its duration. |
metric |
video_views_p25 |
video_views_p25 |
The number of times a video ad was played to 25% of its duration. |
metric |
video_views_p50 |
video_views_p50 |
The number of times a video ad was played to 50% of its duration. |
metric |
video_views_p75 |
video_views_p75 |
The number of times a video ad was played to 75% of its duration. |
metric |
videoviewrate |
videoviewrate |
The rate at which users view a video ad, calculated as the number of views divided by the number of impressions. |
metric |
viewable_impr |
viewable_impr |
The number of viewable impressions, meaning the ad was considered seen by a user. |
metric |
viewable_impressions |
viewable_impressions |
The number of times an ad’s impressions were considered viewable according to industry standards. |
dimension |
views |
views |
The number of times your video ad was viewed. |
metric |
weekly_date |
weekly_date |
The date represented at a weekly granularity for reporting. |
dimension |