The following image shows a high-level data feed taxonomy for Google Ads. (Click the image to enlarge.)
The following image shows the in-depth data formats for Google Ads VVC, VRC, Masthead, and Demand Gen. (Click the image to enlarge.)
Here's a detailed schema for the Google Ads data feed, with field descriptions and sample values.
| Google Ads Data Feed Column Name | Data Type | Sample Value | Description |
|---|---|---|---|
GroupName |
string | Generic Brand |
The name of the custom grouping for this data feed, used for organizing data. |
ReportDate |
string | 2025-08-05 |
The date the data is reported, in YYYY-MM-DD format. |
TimeGranularity |
string | DAILY |
The time interval for the report (for example, DAILY, WEEKLY). |
Product |
string | AUCTION_VIDEO_REACH_VRC |
The specific Google Ads product associated with the data. |
CountryCriteriaId |
int64 | 2840 |
The unique geographic ID for the country, as defined by Google. |
CountryName |
string | United States |
The name of the country. |
RegionCriteriaId |
int64 | 21137 |
The unique geographic ID for the region (for example, state, province). |
RegionName |
string | California |
The name of the region. |
MetroCriteriaId |
int64 | 200803 |
The unique geographic ID for the metro or Designated Market Area (DMA). |
MetroName |
string | Los Angeles, CA |
The name of the metro or DMA. |
Device |
string | MOBILE |
The type of device where the ad was shown (for example, MOBILE, DESKTOP, TABLET). |
Targeting |
string | OTHER |
The targeting method used for the ad. |
IsGooglePreferred |
bool | FALSE |
Indicates if the ad placement was part of the premium Google Preferred network (TRUE/FALSE). |
CurrencyCode |
string | USD |
The ISO 4217 currency code for cost-related metrics. |
BiddingStrategyType |
string | BIDDING_STRATEGY_TYPE_TARGET_CPM |
The bidding strategy used for the campaign (for example, Target CPM, Maximize Conversions). |
CampaignType |
string | CAMPAIGN_TYPE_VIDEO |
The primary type of the campaign (for example, VIDEO, PMAX, SEARCH). |
CampaignSubType |
string | CAMPAIGN_SUB_TYPE_NON_SKIPPABLE |
The specific subtype of the campaign for more detailed classification. |
AdGroupType |
string | ADGROUP_TYPE_RESPONSIVE |
The type of the ad group within the campaign. |
Impressions |
int64 | 15234 |
The total number of times the ad was shown on a search result page or other site. |
Clicks |
int64 | 89 |
The total number of clicks on the ad. |
CostUsd |
double | 450.75 |
The total cost of all clicks or impressions in US dollars. |
Cost |
double | 450.75 |
The total cost in the local currency specified by CurrencyCode. |
VideoViews |
int64 | 11042 |
The number of times a video ad was viewed, as defined by the platform. |
TopImpressionsPercentage |
double | 0.652 |
The percentage of your ad impressions that are shown anywhere above the organic search results. |
AbsoluteTopImpressionsPercentage |
double | 0.213 |
The percentage of your ad impressions that are shown as the very first ad above the organic search results. |
Interactions |
int64 | 11200 |
The total number of user interactions with an ad (for example, clicks, views, swipes). |
Account_ID |
int64 | 1234567890 |
The unique identifier for the Google Ads account. |
Account_Name |
string | Generic Brand Main Account |
The user-defined name of the Google Ads account. |