Data reference

Introduction

Quantcast is a programmatic advertising platform that combines audience measurement with display, video, and audio ad delivery. The connector exposes campaign performance — impressions, clicks, viewability, completion rates, reach, frequency, and spend — through Quantcast’s GraphQL Developer API. Reporting follows a four-level campaign hierarchy: ad account, campaign, ad set, and ad or creative. Reflecting Quantcast’s roots as a measurement platform, audience and measurement signals such as device and household reach, completion rates, and viewability are first-class metrics alongside spend and clicks. As a marketing connector, metrics, breakdowns, and currencies are standardized so widgets can aggregate across other ad-platform and analytics sources without additional configuration. To connect this data source, see How to connect Quantcast to Adriel.

Data refresh strategy

Architecture data

Architecture covers ad account, campaign, ad set, and ad metadata. It refreshes twice daily, at 4:00 PM UTC and 5:00 AM UTC. Ad-to-campaign IDs are back-filled during the fetch, and VAST video creatives are resolved during the same pass.

Reports data

Reports include daily performance for ad account, campaign, ad set, and ad. Real-time. Report data is queried live from the GraphQL API when a dashboard loads, so visits reflect current data. Scheduled jobs also keep recent ranges warm:

5:00 PM UTC — syncs the last 9 days across ad account, campaign, ad set, and ad.
11:40 PM UTC and 6:40 AM UTC — sync the last 3 days across the same levels.
7:30 AM UTC on the 1st and 15th of each month — syncs the last 30 days across the same levels.

The metric catalogue is fetched per ad account and cached for one hour, so metrics newly published on the Quantcast side become available without a redeploy once the cache expires.

Architecture levels

Ad account → Campaign → Ad set → Ad / Creative

Date range limits

Breakdown	Max range
Daily	93 days
Weekly	1 year
Monthly	2 years

Metrics

How to read the columnsData type uses Adriel’s vocabulary — Number, Currency, Percentage, Ratio, Duration, Date, Text, URL, Array, Boolean. API Key in code style like Impressions is the literal Quantcast API field; italic marks a value Adriel computes or derives on its side rather than a single API field. Currency values are reported in each ad account’s configured Quantcast currency.

Campaign Attributes

Metric	Description	Data type	API Key
Active Status	Whether the campaign, ad set, or creative is currently active.	Text	Adriel-side
Ad Account Name	Name of the Quantcast ad account.	Text	`name`
Ad Name	Name of the Quantcast creative.	Text	`creative.name`
Ad Set Name	Name of the Quantcast ad set.	Text	`name`
Ad Spend	Total amount delivered against the campaign budget.	Currency	`Budget Delivered`
Bid Cap	Maximum bid amount configured for the Quantcast ad set.	Currency	Adriel-side
Bid Strategy	Bid strategy configured for the Quantcast campaign or ad set.	Text	Adriel-side
Budget	Budget details returned for the ad set, including the stored amount and budget mode.	Text	`budget`
Campaign Name	Name of the Quantcast campaign.	Text	`name`
Creative Type	Image creative format surfaced when a Quantcast display asset is available.	Text	`creative.display.image.assetId`
Creative URL	Display creative asset details used to build the preview image URL when available.	Text	`creative.display.image.assetId`
Daily Budget	Daily budget amount for ad sets that use a daily budget in Quantcast.	Currency	`budget`, `budgetType`
Ends	End date scheduled for the ad set in Quantcast.	Date	`endTime`
Landing URL	Landing page URLs attached to the creative.	Text	`creative.display.image.landingUrl`, `creative.video.quantcastHosted.landingUrl`
Lifetime Budget	Lifetime budget amount for ad sets that use a total budget in Quantcast.	Currency	`budget`, `budgetType`
Objective	Campaign objective represented for the Quantcast entity.	Text	Adriel-side
Starts	Start date scheduled for the ad set in Quantcast.	Date	`startTime`
Status (Text)	A human-readable label for the current delivery status.	Text	Adriel-side
Status (Toggle)	Current delivery status of the campaign, ad set, or creative in Quantcast.	Text	`state`
UTM Campaign	UTM campaign values found in the creative destination URLs when present.	Text	Adriel-side
UTM Content	UTM content values found in the creative destination URLs when present.	Text	Adriel-side
UTM Medium	UTM medium values found in the creative destination URLs when present.	Text	Adriel-side
UTM Source	UTM source values found in the creative destination URLs when present.	Text	Adriel-side
UTM Term	UTM term values found in the creative destination URLs when present.	Text	Adriel-side

Campaign Structure

Metric	Description	Data type	API Key
Ad Account ID	Unique Quantcast identifier for the ad account.	Text	`id`
Ad ID	Adriel ad identifier built from the Quantcast ad set ID and creative ID.	Text	`adSetId`, `creative.id`
Ad Set ID	Unique Quantcast identifier for the ad set.	Text	`id`, `adSetId`
Campaign ID	Unique Quantcast identifier for the campaign.	Text	`id`, `campaignId`
Channel	Channel labels assigned by the connector for the selected Quantcast entity.	Text	Adriel-side

Click Performance

Metric	Description	Data type	API Key
Clicks (All)	Clicks counted after general invalid-traffic filtering.	Number	`Clicks (General IVT)`
CPC	Cost per click — spend divided by clicks.	Currency	Adriel-computed
CPM	Cost per thousand impressions.	Currency	Adriel-computed
CTR	Click-through rate — clicks divided by impressions.	Percentage	Adriel-computed
Impressions	Total number of ad impressions delivered.	Number	`Impressions`
Link Clicks	Clicks counted after advanced invalid-traffic filtering.	Number	`Clicks (Advanced IVT)`

Computed Metrics

These are calculated by Adriel from other metrics; they have no single underlying Quantcast field.

Metric	Description	Data type	API Key
ROAS	Return on ad spend — attributed revenue divided by spend.	Ratio	Adriel-computed

Conversion Performance

Metric	Description	Data type	API Key
Result Indicator	The metric used to represent the result for the campaign’s objective.	Text	Adriel-derived
Results	Result summary reported for the campaign’s configured objective.	Text	Adriel-derived
Revenue	Revenue attributed in Quantcast reporting.	Currency	`Revenue`

Creative Attributes

Metric	Description	Data type	API Key
Creative Image	A reference to the ad’s creative image.	Text	Adriel-side

Quantcast-specific

These metrics exist only for Quantcast and aren’t part of any cross-connector category. Every group above is a standard category shared with other connectors.

Metric	Description	Data type	API Key
100% Completion Rate	Share of video impressions that reached full completion.	Percentage	`100% Completion Rate`
100% Completion Rate (Audible & Visible)	Share of video impressions that completed while audible and visible.	Percentage	`100% Completion Rate (Audible & Visible)`
100% Listen Through Rate	Share of audio impressions that reached full completion.	Percentage	`100% Listen Through Rate`
25% Completion Rate	Share of video impressions that reached 25% completion.	Percentage	`25% Completion Rate`
25% Listen Through Rate	Share of audio impressions that reached 25% completion.	Percentage	`25% Listen Through Rate`
50% Completion Rate	Share of video impressions that reached 50% completion.	Percentage	`50% Completion Rate`
50% Listen Through Rate	Share of audio impressions that reached 50% completion.	Percentage	`50% Listen Through Rate`
75% Completion Rate	Share of video impressions that reached 75% completion.	Percentage	`75% Completion Rate`
75% Listen Through Rate	Share of audio impressions that reached 75% completion.	Percentage	`75% Listen Through Rate`
Ad Agency Fees	Agency fees applied to ad delivery spend.	Currency	`Ad Agency Fees`
Ad External Fees	External fees applied to ad delivery spend.	Currency	`Ad External Fees`
Ad Spend	Total spend in the account’s configured currency during the reporting period.	Currency	Adriel-side
Budget Delivered	Total amount delivered against the campaign budget.	Currency	`Budget Delivered`
Click Results	Attributed results credited to ad clicks.	Number	`Click Results`
Clicks (Advanced IVT)	Clicks counted after advanced invalid-traffic filtering.	Number	`Clicks (Advanced IVT)`
Clicks (General IVT)	Clicks counted after general invalid-traffic filtering.	Number	`Clicks (General IVT)`
Completed Listens	Number of audio impressions that played to completion.	Number	`Completed Listens`
Completed Views	Number of video impressions that played to completion.	Number	`Completed Views`
Completed Views (Audible & Visible)	Number of completed video views that were both audible and visible.	Number	`Completed Views (Audible & Visible)`
Cost Per Household Reach	Average cost to reach one household.	Currency	`Cost Per Household Reach`
Cost Per Reach	Average cost to reach one device.	Currency	`Cost Per Reach`
Cost Per Result	Average advertising cost for each attributed result.	Currency	`Cost Per Result`
CPCL	Average cost for each completed listen.	Currency	`CPCL`
CPCV	Average cost for each completed video view.	Currency	`CPCV`
CPCV (Audible & Visible)	Average cost for each completed video view that was audible and visible.	Currency	`CPCV (Audible & Visible)`
CPM	Average cost per one thousand impressions.	Currency	`CPM`
CTR	Click-through rate based on delivered impressions and clicks.	Percentage	`CTR`
Device Frequency	Average number of impressions served per reached device.	Ratio	`Device Frequency`
Device Reach	Number of distinct devices reached by the campaign.	Number	`Device Reach`
Household Frequency	Average number of impressions served per reached household.	Ratio	`Household Frequency`
Household Reach	Number of distinct households reached by the campaign.	Number	`Household Reach`
Impressions	Total number of ad impressions delivered.	Number	`Impressions`
Measured Impressions	Number of impressions that could be measured for viewability.	Number	`Measured Impressions`
Results	Total number of attributed results reported by Quantcast.	Number	`Results`
Revenue	Revenue attributed in Quantcast reporting.	Currency	`Revenue`
ROAS	Return on ad spend based on attributed revenue and spend.	Ratio	`ROAS`
Survey Agency Fees	Agency fees applied to survey delivery spend.	Currency	`Survey Agency Fees`
Survey External Fees	External fees applied to Brand Lift Live survey activity.	Currency	`Survey External Fees`
Survey Spend	Spend attributed to Brand Lift Live survey delivery.	Currency	`Survey Spend`
View Results	Attributed results credited to ad views.	Number	`View Results`
Viewability	Share of measured impressions that were viewable.	Percentage	`Viewability`
Viewable Impressions	Number of impressions that met Quantcast viewability criteria.	Number	`Viewable Impressions`

Breakdowns

Campaign Structure

Channel and Platform groupings are provided by Adriel for cross-connector consistency rather than returned by Quantcast.

Breakdown	Description	API Key
Ad	Groups results by Quantcast creative name.	`creative.name`
Ad Account	Groups results by Quantcast ad account name.	`name`
Ad Name	Groups results by ad name.	Adriel-side
Ad Set	Groups results by Quantcast ad set name.	`name`
Ad Set Name	Groups results by ad set name.	Adriel-side
Campaign	Groups results by Quantcast campaign name.	`name`
Campaign Name	Groups results by campaign name.	Adriel-side
Channel	Groups results by channel label when that view is available.	Adriel-side
Platform	Groups results by advertising platform.	Adriel-side
Status (Toggle)	Groups results by delivery status.	`state`

Creatives

Adriel post-processes ad creatives to generate these breakdowns.

Breakdown	Description	API Key
Ad Copy	Word extracted from the creative text.	Adriel-side
Color Clustering	Dominant color cluster detected in the creative.	Adriel-side
Emoji Analysis	Emoji detected in the creative text or image analysis.	Adriel-side

Date

Quantcast returns daily records; Adriel groups them into these views for reporting. Each grouping has its own maximum date range (see Date range limits).

Breakdown	Description	API Key
Auto Time Breakdown	Automatic time grouping chosen by Adriel for the selected date range.	Adriel-side
Daily Breakdown	Groups results by calendar day.	`day`
Monthly Breakdown	Groups results by calendar month.	`month`
Quarterly Breakdown	Groups results by calendar quarter.	Adriel-side
Week Date Breakdown	Groups results by the date representing each reporting week.	Adriel-side
Week Number Breakdown (W#)	Groups results by week number in the year.	Adriel-side
Weekly Breakdown (Start: Mon)	Groups results by calendar week.	`week`
Weekly Breakdown (Start: Sun)	Groups results into weeks running from Sunday through Saturday.	Adriel-side
Yearly Breakdown	Groups results by calendar year.	Adriel-side

Others

Breakdown	Description	API Key
No Grouping	Combines all rows into a single group.	Adriel-side

Limitations

Format-dependent metrics — video, audio, brand-lift survey, and conversion-pixel metrics populate only when the campaign runs the matching ad format. Campaigns without that format leave those columns empty.
Reach is not additive — device and household reach are deduplicated only within the query’s date range, so longer windows produce higher reach numbers. Reach cannot be summed across separate ranges.
Two revenue keys merge — Quantcast returns both revenue and pixelRevenue; both map to the standardized Revenue field, so reports that mix conversion sources sum into the same column.
Serial, rate-limited fetching — report jobs run one at a time per data source (concurrency 1) to respect Quantcast’s rate limits. Rate-limit errors surface with a retry-friendly message rather than failing the dashboard.
Per-account metric availability — the metric catalogue is discovered per ad account and cached for one hour, so a newly published Quantcast metric can take up to an hour to appear.

Introduction

Data refresh strategy

Architecture data

Reports data

Architecture levels

Date range limits

Metrics

Campaign Attributes

Campaign Structure

Click Performance

Computed Metrics

Conversion Performance

Creative Attributes

Quantcast-specific

Breakdowns

Campaign Structure

Creatives

Date

Others

Limitations

API references

See also

​Introduction

​Data refresh strategy

​Architecture data

​Reports data

​Architecture levels

​Date range limits

​Metrics

​Campaign Attributes

​Campaign Structure

​Click Performance

​Computed Metrics

​Conversion Performance

​Creative Attributes

​Quantcast-specific

​Breakdowns

​Campaign Structure

​Creatives

​Date

​Others

​Limitations

​API references

​See also

Introduction

Data refresh strategy

Architecture data

Reports data

Architecture levels

Date range limits

Metrics

Campaign Attributes

Campaign Structure

Click Performance

Computed Metrics

Conversion Performance

Creative Attributes

Quantcast-specific

Breakdowns

Campaign Structure

Creatives

Date

Others

Limitations

API references

See also