Data reference

Introduction

Criteo is a global commerce-media platform best known for retargeting and performance display advertising across the open web. The connector pulls campaign- and ad-set-level performance from Criteo’s Stats API, with architecture data (ad accounts, campaigns, ad sets, ads) merged from Criteo’s live architecture endpoints and report-derived fallback data so deleted entities still appear in historical reporting. As a marketing connector, metrics, breakdowns, and currencies are standardized so widgets can aggregate across sources without additional configuration. To connect this data source, see How to connect Criteo to Adriel.

Data refresh strategy

Architecture data

Architecture covers ad accounts, campaigns, ad sets, and ads. It refreshes twice daily at 4:00 PM UTC and 5:00 AM UTC. Architecture data is pulled live from Criteo’s API, then supplemented with report-derived entities so deleted or otherwise missing campaigns and ad sets still appear alongside their historical metrics.

Reports data

Reports include daily performance metrics for ad accounts, campaigns, ad sets, and ads. Real-time. Report data is fetched from Criteo’s Stats API on demand when a dashboard loads, so the latest values are always visible. On top of that, scheduled background syncs keep historical data consistent across multiple time windows. Refresh schedule. Reports refresh on three overlapping schedules:

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

Architecture levels

Ad account → Campaign → Ad set → Ad

Date range limits

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

A single report query is capped at 365 days; wider ranges are split automatically. Criteo also rejects any query whose start date is more than 2 years in the past.

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 Displays is the literal Criteo Stats API field; where the same raw field name is shared across objects (Criteo returns attributes.name for the ad, ad set, and campaign), it’s shown qualified as object.field (for example ad.name) so each row stays unique; italic marks a value Adriel computes or derives. Some raw fields back several rows — notably each ad’s landing-page URL, from which Adriel parses every UTM value — so the same key can appear on multiple rows; that’s the shared source field, not a duplicated entry.

Spend and revenue are reported in the currency configured on the Criteo advertiser account. When an ad account’s currency differs from the workspace currency, values are converted using the current day’s exchange rate.

Basic

Metric	Description	Data type	API Key
Creative Type	Creative format used by the selected ad.	Text	`attributes.mediaType`, `creative.attributes.format`
Lifetime Budget	Lifetime spend limit configured for the selected campaign.	Number	`attributes.spendLimit.spendLimitAmount.value`
Result Indicator	The metric used to represent the result for the campaign’s configured objective.	Text	Adriel-derived
Results	The number of results for the campaign’s configured objective.	Text	Adriel-derived

Campaign Attributes

Metric	Description	Data type	API Key
Ad Account Name	Advertiser name in Criteo.	Text	`attributes.advertiserName`
Ad Name	Ad name in Criteo.	Text	`ad.name`
Ad Set Name	Ad set name in Criteo.	Text	`adset.name`
Ad Spend	Total money spent on Criteo advertising.	Currency	`AdvertiserCost`
Bid Cap	Maximum bid amount configured for the selected ad set.	Currency	`attributes.bidding.bidAmount.value`
Bid Strategy	Bidding strategies used by the selected ad set.	Array	`attributes.bidding.costController`
Budget	Budget settings configured for the selected campaign or ad set.	Text	`attributes.spendLimit.spendLimitAmount.value`, `attributes.budget.budgetAmount.value`
Campaign Name	Campaign name in Criteo.	Text	`campaign.name`
Creative URL	Creative asset URLs used by the selected ad.	Text	`creative.attributes.imageAttributes.urls`, `attributes.imageAttributes.urls`
Daily Budget	Daily budget amount configured for the selected ad set.	Number	`attributes.budget.budgetAmount.value`
Ends	End date configured for the selected campaign or ad set.	Date	`attributes.schedule.endDate.value`
Is Active	Whether the selected campaign or ad set is currently active.	Boolean	Adriel-derived
Landing URL	Landing page URLs used by the selected creative.	Array	`creative.attributes.imageAttributes.landingPageUrl`, `attributes.imageAttributes.landingPageUrl`
Objective	Marketing objective configured for the selected campaign or ad set.	Array	`attributes.goal`, `attributes.objective`
Starts	Start date configured for the selected campaign or ad set.	Date	`attributes.schedule.startDate.value`
Status	Status of the selected Criteo entity.	Text	`attributes.schedule.deliveryStatus`, `attributes.schedule.activationStatus`, `attributes.status`
Status Text	A human-readable label for the status of the selected Criteo entity.	Text	Adriel-derived
UTM Campaign	UTM campaign values extracted from the landing page URL.	Array	`creative.attributes.imageAttributes.landingPageUrl`, `attributes.imageAttributes.landingPageUrl`
UTM Content	UTM content values extracted from the landing page URL.	Array	`creative.attributes.imageAttributes.landingPageUrl`, `attributes.imageAttributes.landingPageUrl`
UTM Medium	UTM medium values extracted from the landing page URL.	Array	`creative.attributes.imageAttributes.landingPageUrl`, `attributes.imageAttributes.landingPageUrl`
UTM Source	UTM source values extracted from the landing page URL.	Array	`creative.attributes.imageAttributes.landingPageUrl`, `attributes.imageAttributes.landingPageUrl`
UTM Term	UTM term values extracted from the landing page URL.	Array	`creative.attributes.imageAttributes.landingPageUrl`, `attributes.imageAttributes.landingPageUrl`

UTM values are parsed by Adriel, not returned by Criteo. Adriel reads the UTM query parameters from each ad’s landing URL and exposes them as metrics for rollup. Landing URL and all five UTM metrics share the same underlying landing-page-URL field.

Campaign Structure

Metric	Description	Data type	API Key
Ad Account ID	Criteo advertiser ID.	Text	`id`, `attributes.advertiserId`
Ad ID	Criteo ad ID.	Text	`id`
Ad Set ID	Criteo ad set ID.	Text	`id`, `attributes.adSetId`
Campaign ID	Criteo campaign ID.	Text	`id`, `attributes.campaignId`
Channel	Criteo sub-channel values associated with the selected entity.	Array	Adriel-derived

Computed Metric

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

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

Conversion Performance

Metric	Description	Data type	API Key
Conversion Value	The monetary value of attributed sales.	Currency	`AdvertiserValue`
Conversions	Attributed sales resulting from Criteo ads.	Number	Adriel-derived
Revenue	Revenue generated by attributed sales.	Currency	`AdvertiserValue`

Creative Attributes

Metric	Description	Data type	API Key
Creative Image	The image used in the ad creative.	Text	Adriel-derived

Impression Click Performance

Metric	Description	Data type	API Key
Clicks (All)	The total number of clicks on the ads.	Number	`Clicks`
CPC	Cost per click — spend divided by clicks.	Currency	Adriel-computed
CPM	Cost per thousand impressions — spend divided by impressions, times 1,000.	Currency	Adriel-computed
CTR	Click-through rate — clicks divided by impressions.	Percentage	Adriel-computed
Impressions	The number of ad impressions served via Criteo.	Number	`Displays`
Link Clicks	The number of clicks on links to the ad’s destination.	Number	`Clicks`
Reach	Share of potential users who have been served an ad.	Number	`Reach`

Criteo-specific

These metrics exist only for Criteo 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
Advertiser All Value	Advertiser value generated by attributed sales, accounting for product margin when available. This includes cross-device sales.	Currency	`AdvertiserAllValue`
Advertiser Cost	Total money spent on Criteo advertising.	Currency	`AdvertiserCost`
Advertiser Value	Advertiser value generated by attributed sales, accounting for product margin when available.	Currency	`AdvertiserValue`
App Installs	The number of app installs attributed to your ads.	Number	`AppInstalls`
Audience	Potential users who could be served an ad.	Number	`Audience`
Average Cart All Client Attribution	Average revenue generated by an attributed sale. This includes cross-device sales and uses Criteo client attribution.	Currency	`AverageCartAllClientAttribution`
Average Cart All Pc1d	Average revenue generated by an attributed sale. This includes cross-device sales and uses 1-day post-click attribution.	Currency	`AverageCartAllPc1d`
Average Cart All Pc30d	Average revenue generated by an attributed sale. This includes cross-device sales and uses 30-day post-click attribution.	Currency	`AverageCartAllPc30d`
Average Cart All Pc30d Pv24h	Average revenue generated by an attributed sale. This includes cross-device sales and uses 30-day post-click and 24-hour post-view attribution.	Currency	`AverageCartAllPc30dPv24h`
Average Cart All Pc7d	Average revenue generated by an attributed sale. This includes cross-device sales and uses 7-day post-click attribution.	Currency	`AverageCartAllPc7d`
Average Cart All Pv24h	Average revenue generated by an attributed sale. This includes cross-device sales and uses 24-hour post-view attribution.	Currency	`AverageCartAllPv24h`
Average Cart Client Attribution	Average revenue generated by an attributed sale. This uses Criteo client attribution.	Currency	`AverageCartClientAttribution`
Average Cart Pc1d	Average revenue generated by an attributed sale. This uses 1-day post-click attribution.	Currency	`AverageCartPc1d`
Average Cart Pc30d	Average revenue generated by an attributed sale. This uses 30-day post-click attribution.	Currency	`AverageCartPc30d`
Average Cart Pc30d Pv24h	Average revenue generated by an attributed sale. This uses 30-day post-click and 24-hour post-view attribution.	Currency	`AverageCartPc30dPv24h`
Average Cart Pc7d	Average revenue generated by an attributed sale. This uses 7-day post-click attribution.	Currency	`AverageCartPc7d`
Average Cart Pv24h	Average revenue generated by an attributed sale. This uses 24-hour post-view attribution.	Currency	`AverageCartPv24h`
Bounce Rate	Share of visits that ended after a single page view.	Percentage	`BounceRate`
Click Through Rate	Percentage of served ads that received a click.	Percentage	`ClickThroughRate`
Clicks	The number of clicks driven by your ads.	Number	`Clicks`
Conversion Rate All Client Attribution	Percentage of attributed sales compared with clicks. This includes cross-device sales and uses Criteo client attribution.	Percentage	`ConversionRateAllClientAttribution`
Conversion Rate All Pc1d	Percentage of attributed sales compared with clicks. This includes cross-device sales and uses 1-day post-click attribution.	Percentage	`ConversionRateAllPc1d`
Conversion Rate All Pc30d	Percentage of attributed sales compared with clicks. This includes cross-device sales and uses 30-day post-click attribution.	Percentage	`ConversionRateAllPc30d`
Conversion Rate All Pc30d Pv24h	Percentage of attributed sales compared with clicks. This includes cross-device sales and uses 30-day post-click and 24-hour post-view attribution.	Percentage	`ConversionRateAllPc30dPv24h`
Conversion Rate All Pc7d	Percentage of attributed sales compared with clicks. This includes cross-device sales and uses 7-day post-click attribution.	Percentage	`ConversionRateAllPc7d`
Conversion Rate All Pv24h	Percentage of attributed sales compared with clicks. This includes cross-device sales and uses 24-hour post-view attribution.	Percentage	`ConversionRateAllPv24h`
Conversion Rate Client Attribution	Percentage of attributed sales compared with clicks. This uses Criteo client attribution.	Percentage	`ConversionRateClientAttribution`
Conversion Rate Pc1d	Percentage of attributed sales compared with clicks. This uses 1-day post-click attribution.	Percentage	`ConversionRatePc1d`
Conversion Rate Pc30d	Percentage of attributed sales compared with clicks. This uses 30-day post-click attribution.	Percentage	`ConversionRatePc30d`
Conversion Rate Pc30d Pv24h	Percentage of attributed sales compared with clicks. This uses 30-day post-click and 24-hour post-view attribution.	Percentage	`ConversionRatePc30dPv24h`
Conversion Rate Pc7d	Percentage of attributed sales compared with clicks. This uses 7-day post-click attribution.	Percentage	`ConversionRatePc7d`
Conversion Rate Pv24h	Percentage of attributed sales compared with clicks. This uses 24-hour post-view attribution.	Percentage	`ConversionRatePv24h`
Conversions All Client Attribution	Attributed sales resulting from Criteo ads. This includes cross-device sales and uses Criteo client attribution.	Number	`SalesAllClientAttribution`
Conversions All Client Attribution: Conversion Value	Revenue generated by attributed online sales. This includes cross-device sales and uses Criteo client attribution.	Currency	`RevenueGeneratedAllClientAttribution`
Conversions Client Attribution	Attributed sales resulting from Criteo ads. This uses Criteo client attribution.	Number	`SalesClientAttribution`
Conversions Client Attribution: Conversion Value	Revenue generated by attributed online sales. This uses Criteo client attribution.	Currency	`RevenueGeneratedClientAttribution`
Cost Of Advertiser Value	Ratio of campaign cost to advertiser value, shown as a percentage.	Percentage	`CostOfAdvertiserValue`
Cost Of Advertiser Value All	Ratio of campaign cost to advertiser value, shown as a percentage. This includes cross-device sales.	Percentage	`CostOfAdvertiserValueAll`
Cost Per Install	Average advertising cost per app install.	Currency	`CostPerInstall`
Cost Per Order All Client Attribution	Average advertising cost for each attributed order. This includes cross-device sales and uses Criteo client attribution.	Currency	`CostPerOrderAllClientAttribution`
Cost Per Order All Pc1d	Average advertising cost for each attributed order. This includes cross-device sales and uses 1-day post-click attribution.	Currency	`CostPerOrderAllPc1d`
Cost Per Order All Pc30d	Average advertising cost for each attributed order. This includes cross-device sales and uses 30-day post-click attribution.	Currency	`CostPerOrderAllPc30d`
Cost Per Order All Pc30d Pv24h	Average advertising cost for each attributed order. This includes cross-device sales and uses 30-day post-click and 24-hour post-view attribution.	Currency	`CostPerOrderAllPc30dPv24h`
Cost Per Order All Pc7d	Average advertising cost for each attributed order. This includes cross-device sales and uses 7-day post-click attribution.	Currency	`CostPerOrderAllPc7d`
Cost Per Order All Pv24h	Average advertising cost for each attributed order. This includes cross-device sales and uses 24-hour post-view attribution.	Currency	`CostPerOrderAllPv24h`
Cost Per Order Client Attribution	Average advertising cost for each attributed order. This uses Criteo client attribution.	Currency	`CostPerOrderClientAttribution`
Cost Per Order Pc1d	Average advertising cost for each attributed order. This uses 1-day post-click attribution.	Currency	`CostPerOrderPc1d`
Cost Per Order Pc30d	Average advertising cost for each attributed order. This uses 30-day post-click attribution.	Currency	`CostPerOrderPc30d`
Cost Per Order Pc30d Pv24h	Average advertising cost for each attributed order. This uses 30-day post-click and 24-hour post-view attribution.	Currency	`CostPerOrderPc30dPv24h`
Cost Per Order Pc7d	Average advertising cost for each attributed order. This uses 7-day post-click attribution.	Currency	`CostPerOrderPc7d`
Cost Per Order Pv24h	Average advertising cost for each attributed order. This uses 24-hour post-view attribution.	Currency	`CostPerOrderPv24h`
Cost Per Visit	Average advertising cost per visit.	Currency	`CostPerVisit`
Cpc	Average cost per click.	Currency	`Cpc`
Displays	The number of ad impressions served via Criteo.	Number	`Displays`
ECos All Client Attribution	Advertising cost per attributed sale. This includes cross-device sales and uses Criteo client attribution.	Percentage	`ECosAllClientAttribution`
ECos All Pc1d	Advertising cost per attributed sale. This includes cross-device sales and uses 1-day post-click attribution.	Percentage	`ECosAllPc1d`
ECos All Pc30d	Advertising cost per attributed sale. This includes cross-device sales and uses 30-day post-click attribution.	Percentage	`ECosAllPc30d`
ECos All Pc30d Pv24h	Advertising cost per attributed sale. This includes cross-device sales and uses 30-day post-click and 24-hour post-view attribution.	Percentage	`ECosAllPc30dPv24h`
ECos All Pc7d	Advertising cost per attributed sale. This includes cross-device sales and uses 7-day post-click attribution.	Percentage	`ECosAllPc7d`
ECos All Pv24h	Advertising cost per attributed sale. This includes cross-device sales and uses 24-hour post-view attribution.	Percentage	`ECosAllPv24h`
ECos Client Attribution	Advertising cost per attributed sale. This uses Criteo client attribution.	Percentage	`ECosClientAttribution`
ECos Pc1d	Advertising cost per attributed sale. This uses 1-day post-click attribution.	Percentage	`ECosPc1d`
ECos Pc30d	Advertising cost per attributed sale. This uses 30-day post-click attribution.	Percentage	`ECosPc30d`
ECos Pc30d Pv24h	Advertising cost per attributed sale. This uses 30-day post-click and 24-hour post-view attribution.	Percentage	`ECosPc30dPv24h`
ECos Pc7d	Advertising cost per attributed sale. This uses 7-day post-click attribution.	Percentage	`ECosPc7d`
ECos Pv24h	Advertising cost per attributed sale. This uses 24-hour post-view attribution.	Percentage	`ECosPv24h`
ECpm	Average cost per 1,000 impressions.	Currency	`ECpm`
Exposed Users	The number of users who were served an ad.	Number	`ExposedUsers`
Install Rate	Percentage of clicks that resulted in an app install.	Percentage	`InstallRate`
Non Viewable Displays	The number of ad impressions that did not meet Criteo viewability criteria.	Number	`NonViewableDisplays`
Overall Competition Win	Share of display opportunities won by Criteo.	Percentage	`OverallCompetitionWin`
Post Install Conversion Rate	Percentage of post-install sales compared with clicks.	Percentage	`PostInstallConversionRate`
Post Install Cost Of Sale	Advertising cost of sale for app install campaigns.	Percentage	`PostInstallCostOfSale`
Post Install Cost Per Order	Average advertising cost for each sale after an app install.	Currency	`PostInstallCostPerOrder`
Post Install Order Value	Revenue generated by sales after an app install.	Currency	`PostInstallOrderValue`
Potential Displays	The number of display opportunities received by Criteo.	Number	`PotentialDisplays`
Qualified Visits	Visits where at least two events or one sale happened within an hour after a click.	Number	`QualifiedVisits`
Reach	Share of potential users who have been served an ad.	Number	`Reach`
Sales All Pc1d	Attributed sales resulting from Criteo ads. This includes cross-device sales and uses 1-day post-click attribution.	Number	`SalesAllPc1d`
Sales All Pc1d: Conversion Value	Revenue generated by attributed online sales. This includes cross-device sales and uses 1-day post-click attribution.	Currency	`RevenueGeneratedAllPc1d`
Sales All Pc30d	Attributed sales resulting from Criteo ads. This includes cross-device sales and uses 30-day post-click attribution.	Number	`SalesAllPc30d`
Sales All Pc30d Pv24h	Attributed sales resulting from Criteo ads. This includes cross-device sales and uses 30-day post-click and 24-hour post-view attribution.	Number	`SalesAllPc30dPv24h`
Sales All Pc30d Pv24h: Conversion Value	Revenue generated by attributed online sales. This includes cross-device sales and uses 30-day post-click and 24-hour post-view attribution.	Currency	`RevenueGeneratedAllPc30dPv24h`
Sales All Pc30d: Conversion Value	Revenue generated by attributed online sales. This includes cross-device sales and uses 30-day post-click attribution.	Currency	`RevenueGeneratedAllPc30d`
Sales All Pc7d	Attributed sales resulting from Criteo ads. This includes cross-device sales and uses 7-day post-click attribution.	Number	`SalesAllPc7d`
Sales All Pc7d: Conversion Value	Revenue generated by attributed online sales. This includes cross-device sales and uses 7-day post-click attribution.	Currency	`RevenueGeneratedAllPc7d`
Sales All Pv24h	Attributed sales resulting from Criteo ads. This includes cross-device sales and uses 24-hour post-view attribution.	Number	`SalesAllPv24h`
Sales All Pv24h: Conversion Value	Revenue generated by attributed online sales. This includes cross-device sales and uses 24-hour post-view attribution.	Currency	`RevenueGeneratedAllPv24h`
Sales Pc1d	Attributed sales resulting from Criteo ads. This uses 1-day post-click attribution.	Number	`SalesPc1d`
Sales Pc1d: Conversion Value	Revenue generated by attributed online sales. This uses 1-day post-click attribution.	Currency	`RevenueGeneratedPc1d`
Sales Pc30d	Attributed sales resulting from Criteo ads. This uses 30-day post-click attribution.	Number	`SalesPc30d`
Sales Pc30d Pv24h	Attributed sales resulting from Criteo ads. This uses 30-day post-click and 24-hour post-view attribution.	Number	`SalesPc30dPv24h`
Sales Pc30d Pv24h: Conversion Value	Revenue generated by attributed online sales. This uses 30-day post-click and 24-hour post-view attribution.	Currency	`RevenueGeneratedPc30dPv24h`
Sales Pc30d: Conversion Value	Revenue generated by attributed online sales. This uses 30-day post-click attribution.	Currency	`RevenueGeneratedPc30d`
Sales Pc7d	Attributed sales resulting from Criteo ads. This uses 7-day post-click attribution.	Number	`SalesPc7d`
Sales Pc7d: Conversion Value	Revenue generated by attributed online sales. This uses 7-day post-click attribution.	Currency	`RevenueGeneratedPc7d`
Sales Pv24h	Attributed sales resulting from Criteo ads. This uses 24-hour post-view attribution.	Number	`SalesPv24h`
Sales Pv24h: Conversion Value	Revenue generated by attributed online sales. This uses 24-hour post-view attribution.	Currency	`RevenueGeneratedPv24h`
Untrackable Displays	The number of ad impressions that could not be tracked for viewability.	Number	`UntrackableDisplays`
Viewable Displays	The number of ads counted as viewable.	Number	`ViewableDisplays`
Visits	Visits where at least one event happened within an hour after a click.	Number	`Visits`

Breakdowns

Basic

Breakdown	Description	API Key
Channel	Channel reported by Criteo for the selected row.	`Channel`

Campaign Structure

Breakdown	Description	API Key
Ad Name	Groups results by ad name.	Adriel-derived
Ad Set Name	Groups results by ad set name.	Adriel-derived
Campaign Name	Groups results by campaign name.	Adriel-derived
Platform	Groups results by the platform where the ads were shown.	Adriel-derived
Status	Status of the selected Criteo entity.	`attributes.schedule.deliveryStatus`, `attributes.schedule.activationStatus`, `attributes.status`

Creatives

Adriel post-processes ad creatives to generate these breakdowns.

Breakdown	Description	API Key
Ad Copy	Groups results by words identified in the ad creative.	Adriel-derived
Color Clustering	Groups results by similar colors identified in the ad creative.	Adriel-derived
Emoji Analysis	Groups results by emojis identified in the ad creative.	Adriel-derived

Date

Criteo’s API returns daily records; all time-grouping breakdowns are Adriel-side aggregations of the same underlying daily data.

Breakdown	Description	API Key
Auto Time Breakdown	Automatic time grouping chosen by Adriel for the current query.	Adriel-side
Daily Breakdown	Calendar day reported by Criteo.	`Day`
Monthly Breakdown	Calendar month reported by Criteo.	`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)	Calendar week grouped from Criteo daily report dates.	`Day`
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	Single bucket that combines all returned rows.	Adriel-side

Criteo-specific

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

Breakdown	Description	API Key
Ad	Ad name reported by Criteo.	`Ad`
Ad Account	Advertiser name reported by Criteo.	`Advertiser`
Ad Set	Ad set name reported by Criteo.	`Adset`
Campaign	Campaign name reported by Criteo.	`Campaign`
Category	Category reported by Criteo for the selected row.	`Category`
Creative Description	Creative description used by the selected ad.	`attributes.description`, `creative.attributes.description`
Creative Headline	Creative title used by the selected ad.	`attributes.name`, `creative.attributes.name`
Device Target	Device type reported by Criteo.	`Device`
Operating System	Operating system reported by Criteo.	`Os`

Limitations

Rotating refresh tokens — every Criteo token refresh issues a new refresh token, which the connector persists automatically. If a refresh response omits the new value, the connection becomes unrecoverable until it is reconnected. This is the single most important operational behavior to monitor.
Reach summed across days may overcount — Reach is a daily count of unique users. When viewed over a date range longer than one day, the total can overstate true unique reach because the same user may be counted on multiple days.
Deleted entities are retained — historical data for deleted campaigns, ad sets, and ads is preserved through the report-derived architecture fallback rather than excluded.
Historical start-date cap — Criteo rejects report queries whose start date is more than 2 years in the past, and a single query cannot span more than 365 days.

Introduction

Data refresh strategy

Architecture data

Reports data

Architecture levels

Date range limits

Metrics

Basic

Campaign Attributes

Campaign Structure

Computed Metric

Conversion Performance

Creative Attributes

Impression Click Performance

Criteo-specific

Breakdowns

Basic

Campaign Structure

Creatives

Date

Others

Criteo-specific

Limitations

API references

See also

​Introduction

​Data refresh strategy

​Architecture data

​Reports data

​Architecture levels

​Date range limits

​Metrics

​Basic

​Campaign Attributes

​Campaign Structure

​Computed Metric

​Conversion Performance

​Creative Attributes

​Impression Click Performance

​Criteo-specific

​Breakdowns

​Basic

​Campaign Structure

​Creatives

​Date

​Others

​Criteo-specific

​Limitations

​API references

​See also

Introduction

Data refresh strategy

Architecture data

Reports data

Architecture levels

Date range limits

Metrics

Basic

Campaign Attributes

Campaign Structure

Computed Metric

Conversion Performance

Creative Attributes

Impression Click Performance

Criteo-specific

Breakdowns

Basic

Campaign Structure

Creatives

Date

Others

Criteo-specific

Limitations

API references

See also