Here's a detailed schema for the GQV data feed, with field descriptions and sample values.
| GQV Data Feed Column Name | Data Type | Sample Value | Description |
|---|---|---|---|
QueryLabel |
string | GENERIC |
"BRAND" or "GENERIC" |
ReportDate |
string | 2022-09-25 |
Same as the report date for the standard Google Ads report, such as "2021-10-31" |
TimeGranularity |
string | WEEKLY_SUNDAY |
Same as in Google Ads report. |
GeoCriteriaId |
int64 | 21144 |
Criterion ID of the geo location this breakout is for. |
GeoName |
string | Hawaii |
Name of the geo location this breakout is for. |
GeoType |
string | STATE |
"COUNTRY", "STATE", or "DMA_REGION" |
IndexedQueryVolume |
double | 0.123123123 |
Consistent, baselined and normalized query volume index. |
What is GQV?
Google Query Volume (GQV) is a supplemental, indexed organic search volume dataset designed to support paid search modeling in Marketing Mix Models (MMMs). It serves as a critical control variable to isolate baseline consumer interest, preventing selection bias and ensuring accurate search ROI representation.
Resources & Methodology Guidance
- Documentation: Learn more about organic demand controls at Paid Search Modeling on the Meridian Developer Site.
- Methodology Innovation: Users should integrate GQV in line with Google's published econometric best practices to control for search intent.
GQV Content and Stability Methodology
- Branded and Generic Splits: GQV separates brand and generic queries. Branded queries are mapped using Knowledge Graph (KG) IDs based on the brand names in the request. Generic queries are gathered from categories associated with the brand names; no custom user input for generic queries can be accepted.
- Lookback and Indexing: GQV is delivered as indexed values (not raw search volumes) and is available for up to a 3-year historical lookback. Indexing remains consistent across recurring updates.
GQV Support FAQs
- Why can't I request a standalone GQV report?
- GQV is designed as a supplemental add-on to a broader performance data request, in line with Meridian and search policy guidelines.
- What geo granularity is available for GQV?
- Users can request GQV data at either the DMA or National Level. When requesting data, users have the option to select performance data (clicks, impressions, cost) at either the DMA or national-level. If National-level data is selected, the supplementary GQV data will also be delivered aggregated to the national level.
- How is GQV indexing done?
- Indexing values are consistent for all requests by an advertiser per country. So, if a user requests GQV for an advertiser in the US at the DMA level, and then requests data for that same advertiser for a different time horizon at the National (or DMA) level for the US, the indexing value will be the same. Note: index value may be higher than 100.
- Are GQV reports updated as part of recurring deliveries? Will the brand and generic queries remain consistent with the initial report?
- Yes, GQV reports will be updated as part of recurring deliveries. The brand queries, generic queries, and indexing value will be consistent so that advertisers can use the data to refresh their models.