Criteo Marketing Solutions: Most-used fields
The table below gives information about most-used fields that you can import from Criteo Marketing Solutions. 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.
AdDimension
The name or identifier of the individual ad creative.
AdIdDimension
The unique identifier for the individual ad creative.
AdsetDimension
The name of the ad set.
Adset.endDateDimension
The end date of the Ad Set's schedule, defining when the ad delivery should cease. This date is in ISO 8601 format.
Adset.frequencyCapping.frequencyDimension
The time period over which the maximum impression limit for the Ad Set is calculated. Possible values include 'hourly', 'daily', or 'lifetime'.
Adset.frequencyCapping.maximumImpressionsDimension
This field defines the maximum number of times an ad from the Ad Set can be shown to a unique user within a specified frequency capping period (e.g., hourly, daily, or lifetime).
Adset.mediaTypeDimension
This field specifies the type of creative asset used in the ad set, such as 'Display' or 'Video'.
Adset.objectiveMetric
The marketing objective configured for a specific ad set.
Adset.startDateDimension
The start date of the Ad Set's schedule, defining when the ad delivery should begin. This date is in ISO 8601 format and must be earlier than the end date.
Adset.typeDimension
The type of the Ad Set entity, indicating its data structure or purpose within the Criteo Marketing Solutions API. For example, 'AdSet' for creation requests or 'ReadAdSet' for retrieved data.
AdsetIdDimension
The unique identifier for the ad set.
AdvertiserDimension
The name of the advertiser.
AdvertiserAllValueMetric
The total revenue generated by each product, considering margin, including cross-device sales.
AdvertiserCostMetric
The total cost spent by the advertiser on Criteo advertising campaigns.
AdvertiserIdDimension
The unique identifier for the advertiser.
AdvertiserValueMetric
The total revenue generated by each product, considering margin (if provided in your product catalog).
AppInstallsMetric
The total number of successful installations of the advertised mobile application.
AudienceMetric
This field represents a collection of users targeted by advertising campaigns, built from audience segments which group users based on Criteo data, lookalike models, or advertiser's own data. These audiences are linked to ad sets to define target demographics.
AverageCartAllClientAttributionMetric
The average revenue generated per conversion or sale, including cross-device sales, attributed using client-defined attribution rules.
AverageCartAllPc1dMetric
The average revenue generated per conversion or sale, including cross-device sales, with a 1-day post-click lookback window.
AverageCartAllPc30dMetric
The average revenue generated per conversion or sale, including cross-device sales, with a 30-day post-click lookback window.
AverageCartAllPc30dPv24hMetric
The average revenue generated per conversion or sale, including cross-device sales, considering a 30-day post-click or a 24-hour post-view lookback window.
AverageCartAllPc7dMetric
The average revenue generated per conversion or sale, including cross-device sales, with a 7-day post-click lookback window.
AverageCartAllPv24hMetric
The average revenue generated per conversion or sale, including cross-device sales, with a 24-hour post-view lookback window.
AverageCartClientAttributionMetric
The average revenue generated per conversion or sale, attributed using client-defined attribution rules.
AverageCartPc1dMetric
The average revenue generated per conversion or sale, with a 1-day post-click lookback window.
AverageCartPc30dMetric
The average revenue generated per conversion or sale, with a 30-day post-click lookback window.
AverageCartPc30dPv24hMetric
The average revenue generated per conversion or sale, considering a 30-day post-click or a 24-hour post-view lookback window.
AverageCartPc7dMetric
The average revenue generated per conversion or sale, with a 7-day post-click lookback window.
AverageCartPv24hMetric
The average revenue generated per conversion or sale, with a 24-hour post-view lookback window.
BounceRateMetric
The percentage of website visitors who navigate away from the site after viewing only one page.
CampaignDimension
The name of the marketing campaign.
Campaign.spendLimit.spendLimitAmountMetric
This field represents the maximum monetary amount allocated for a campaign, which can be defined for a specific period like daily, monthly, or for the entire campaign lifetime. If the campaign's spend limit type is set to uncapped, this value will be null.
CampaignIdDimension
The unique identifier for the marketing campaign.
CategoryDimension
The product category associated with the advertised items or the page where the ad was displayed.
CategoryIdMetric
The unique identifier for the product category.
ChannelDimension
The advertising channel through which the campaign or ad was delivered.
ChannelIdMetric
The unique identifier for the advertising channel.
ClickThroughRateMetric
The percentage of ad impressions that resulted in a click.
ClicksMetric
The total number of times an ad creative was clicked by users.
ConversionRateAllClientAttributionMetric
The percentage of conversions or sales compared to clicks, including cross-device sales, attributed using client-defined attribution rules.
ConversionRateAllPc1dMetric
The percentage of conversions or sales compared to clicks, including cross-device sales, with a 1-day post-click lookback window.
ConversionRateAllPc30dMetric
The percentage of conversions or sales compared to clicks, including cross-device sales, with a 30-day post-click lookback window.
ConversionRateAllPc30dPv24hMetric
The percentage of conversions or sales compared to clicks, including cross-device sales, considering a 30-day post-click or a 24-hour post-view lookback window.
ConversionRateAllPc7dMetric
The percentage of conversions or sales compared to clicks, including cross-device sales, with a 7-day post-click lookback window.
ConversionRateAllPv24hMetric
The percentage of conversions or sales compared to clicks, including cross-device sales, with a 24-hour post-view lookback window.
ConversionRateClientAttributionMetric
The percentage of conversions or sales compared to clicks, attributed using client-defined attribution rules.
ConversionRatePc1dMetric
The percentage of conversions or sales compared to clicks, with a 1-day post-click lookback window.
ConversionRatePc30dMetric
The percentage of conversions or sales compared to clicks, with a 30-day post-click lookback window.
ConversionRatePc30dPv24hMetric
The percentage of conversions or sales compared to clicks, considering a 30-day post-click or a 24-hour post-view lookback window.
ConversionRatePc7dMetric
The percentage of conversions or sales compared to clicks, with a 7-day post-click lookback window.
ConversionRatePv24hMetric
The percentage of conversions or sales compared to clicks, with a 24-hour post-view lookback window.
CostPerInstallMetric
The average cost incurred for each app installation.
CostPerOrderAllClientAttributionMetric
The advertising cost per order, including cross-device sales, attributed using client-defined attribution rules.
CostPerOrderAllPc1dMetric
The advertising cost per order, including cross-device sales, with a 1-day post-click lookback window.
CostPerOrderAllPc30dMetric
The advertising cost per order, including cross-device sales, with a 30-day post-click lookback window.
CostPerOrderAllPc30dPv24hMetric
The advertising cost per order, including cross-device sales, considering a 30-day post-click or a 24-hour post-view lookback window.
CostPerOrderAllPc7dMetric
The advertising cost per order, including cross-device sales, with a 7-day post-click lookback window.
CostPerOrderAllPv24hMetric
The advertising cost per order, including cross-device sales, with a 24-hour post-view lookback window.
CostPerOrderClientAttributionMetric
The advertising cost per order, attributed using client-defined attribution rules.
CostPerOrderPc1dMetric
The advertising cost per order, with a 1-day post-click lookback window.
CostPerOrderPc30dMetric
The advertising cost per order, with a 30-day post-click lookback window.
CostPerOrderPc30dPv24hMetric
The advertising cost per order, considering a 30-day post-click or a 24-hour post-view lookback window.
CostPerOrderPc7dMetric
The advertising cost per order, with a 7-day post-click lookback window.
CostPerOrderPv24hMetric
The advertising cost per order, with a 24-hour post-view lookback window.
CostPerVisitMetric
The average amount of money spent on advertising for each visit to the website or app.
CouponDimension
The name or identifier of the coupon used in the ad campaign.
CouponIdMetric
The unique identifier for the coupon used in the ad campaign.
CpcMetric
The average cost incurred for each click on an advertisement.
CurrencyDimension
The currency code (e.g., USD, EUR) used for reporting financial metrics in the campaign.
DayDimension
The specific day for which the campaign performance data is reported.
DeviceDimension
The type of device (e.g., desktop, mobile, tablet) on which the ad was displayed.
DisplaysMetric
The total number of ad impressions served to users.
ECosAllClientAttributionMetric
The advertising cost per conversion or sale, including cross-device sales, attributed using client-defined attribution rules.
ECosAllPc1dMetric
The advertising cost per conversion or sale, including cross-device sales, with a 1-day post-click lookback window.
ECosAllPc30dMetric
The advertising cost per conversion or sale, including cross-device sales, with a 30-day post-click lookback window.
ECosAllPc30dPv24hMetric
The advertising cost per conversion or sale, including cross-device sales, considering a 30-day post-click or a 24-hour post-view lookback window.
ECosAllPc7dMetric
The advertising cost per conversion or sale, including cross-device sales, with a 7-day post-click lookback window.
ECosAllPv24hMetric
The advertising cost per conversion or sale, including cross-device sales, with a 24-hour post-view lookback window.
ECosClientAttributionMetric
The advertising cost per conversion or sale, attributed using client-defined attribution rules.
ECosPc1dMetric
The advertising cost per conversion or sale, with a 1-day post-click lookback window.
ECosPc30dMetric
The advertising cost per conversion or sale, with a 30-day post-click lookback window.
ECosPc30dPv24hMetric
The advertising cost per conversion or sale, considering a 30-day post-click or a 24-hour post-view lookback window.
ECosPc7dMetric
The advertising cost per conversion or sale, with a 7-day post-click lookback window.
ECosPv24hMetric
The advertising cost per conversion or sale, with a 24-hour post-view lookback window.
ECpmMetric
The effective cost per thousand ad impressions (Mille).
ExposedUsersMetric
The total number of unique users who were served an advertisement.
HourDimension
The specific hour for which the campaign performance data is reported.
InstallRateMetric
The percentage of app installations relative to the number of clicks on the ad.
MarketingObjectiveDimension
The marketing objective associated with the campaign or ad set.
MarketingObjectiveIdMetric
The unique identifier for the marketing objective associated with the campaign or ad set.
MonthDimension
The specific month for which the campaign performance data is reported.
NonViewableDisplaysMetric
The number of ad impressions that were not considered viewable based on Criteo's criteria.
OmniChannelRevenuePc30dMetric
The revenue generated by online and offline sales, with a 30-day post-click lookback window.
OmniChannelRoasPc30dMetric
The return on ad spend, considering both online and offline revenue, with a 30-day post-click lookback window.
OmniChannelSalesPc30dMetric
The number of online and offline transactions or conversions attributed to Criteo ads, with a 30-day post-click lookback window.
OmnichannelRevenueAllPc30dMetric
The revenue generated by all online and offline sales, including cross-device sales, with a 30-day post-click lookback window.
OmnichannelRevenueAllPv24hMetric
The revenue generated by all online and offline sales, including cross-device sales, with a 24-hour post-view lookback window.
OmnichannelRevenueClientAttributionMetric
The revenue generated by online and offline sales, attributed using client-defined attribution rules.
OmnichannelRevenuePc30dMetric
The revenue generated by online and offline sales, with a 30-day post-click lookback window.
OmnichannelRevenuePv24hMetric
The revenue generated by online and offline sales, with a 24-hour post-view lookback window.
OmnichannelRoasAllPc30dMetric
The return on ad spend, considering all online and offline revenue, including cross-device sales, with a 30-day post-click lookback window.
OmnichannelRoasAllPv24hMetric
The return on ad spend, considering all online and offline revenue, including cross-device sales, with a 24-hour post-view lookback window.
OmnichannelRoasClientAttributionMetric
The return on ad spend, considering online and offline revenue, attributed using client-defined attribution rules.
OmnichannelRoasPv24hMetric
The return on ad spend, considering online and offline revenue, with a 24-hour post-view lookback window.
OmnichannelSalesAllPc30dMetric
The number of all online and offline transactions or conversions attributed to Criteo ads, including cross-device sales, with a 30-day post-click lookback window.
OmnichannelSalesAllPv24hMetric
The number of all online and offline transactions or conversions attributed to Criteo ads, including cross-device sales, with a 24-hour post-view lookback window.
OmnichannelSalesClientAttributionMetric
The number of online and offline transactions or conversions attributed to Criteo ads, using client-defined attribution rules.
OmnichannelSalesPc30dMetric
The total number of online and offline transactions or conversions attributed to Criteo ads, using a 30-day post-click lookback window for attribution.
OmnichannelSalesPv24hMetric
The number of online and offline transactions or conversions attributed to Criteo ads, with a 24-hour post-view lookback window.
OsDimension
The operating system (e.g., iOS, Android, Windows) of the device on which the ad was displayed.
PlacementDimension
The location or context where an ad creative is displayed.
PostInstallConversionRateMetric
The percentage of post-install sales relative to the clicks that occurred.
PostInstallCostOfSaleMetric
The cost of sale specifically for app install campaigns.
PostInstallCostPerOrderMetric
The cost per order for sales that occurred after an app installation.
PostInstallOrderValueMetric
The total revenue generated by sales that occurred after an app installation.
PostInstallRoasMetric
The return on ad spend specifically for sales that occurred after an app installation.
PostInstallSalesMetric
The number of completed sales events that occurred after an app installation.
PotentialDisplaysMetric
The total number of available display opportunities or bid requests received for an ad.
ReachMetric
The share of potential users who were served an ad, indicating the unique audience reached.
RevenueGeneratedAllClientAttributionMetric
The total revenue generated from sales attributed to Criteo ads using client-defined attribution rules and including cross-device sales.
RevenueGeneratedAllPc1dMetric
The total revenue generated from sales attributed to ads, including cross-device sales, with a 1-day post-click lookback window.
RevenueGeneratedAllPc30dMetric
The total revenue generated from sales attributed to ads, including cross-device sales, with a 30-day post-click lookback window.
RevenueGeneratedAllPc30dPv24hMetric
The total revenue generated from sales attributed to ads, including cross-device sales, considering a 30-day post-click or a 24-hour post-view lookback window.
RevenueGeneratedAllPc7dMetric
The total revenue generated from sales attributed to ads, including cross-device sales, with a 7-day post-click lookback window.
RevenueGeneratedAllPv24hMetric
The total revenue generated from sales attributed to ads, including cross-device sales, with a 24-hour post-view lookback window.
RevenueGeneratedClientAttributionMetric
The total revenue generated from sales attributed to Criteo ads using client-defined attribution rules.
RevenueGeneratedOfflinePc30dMetric
The total revenue generated from offline (in-store) sales attributed to ads, with a 30-day post-click lookback window.
RevenueGeneratedOfflinePv24hMetric
The total revenue generated from offline (in-store) sales attributed to ads, with a 24-hour post-view lookback window.
RevenueGeneratedPc1dMetric
The total revenue generated from sales attributed to ads, with a 1-day post-click lookback window.
RevenueGeneratedPc30dMetric
The total revenue generated from sales attributed to ads, with a 30-day post-click lookback window.
RevenueGeneratedPc30dPv24hMetric
The total revenue generated from sales attributed to ads, considering a 30-day post-click or a 24-hour post-view lookback window.
RevenueGeneratedPc7dMetric
The total revenue generated from sales attributed to ads, with a 7-day post-click lookback window.
RevenueGeneratedPv24hMetric
The total revenue generated from sales attributed to ads, with a 24-hour post-view lookback window.
RoasAllClientAttributionMetric
The return on ad spend, including cross-device revenue, attributed using client-defined attribution rules.
RoasAllPc1dMetric
The return on ad spend, including cross-device revenue, with a 1-day post-click lookback window.
RoasAllPc30dMetric
The return on ad spend, including cross-device revenue, with a 30-day post-click lookback window.
RoasAllPc30dPv24hMetric
The return on ad spend, including cross-device revenue, considering a 30-day post-click or a 24-hour post-view lookback window.
RoasAllPc7dMetric
The return on ad spend, including cross-device revenue, with a 7-day post-click lookback window.
RoasAllPv24hMetric
The return on ad spend, including cross-device revenue, with a 24-hour post-view lookback window.
RoasClientAttributionMetric
The return on ad spend, attributed using client-defined attribution rules.
RoasOfflinePc30dMetric
The return on ad spend, considering offline (in-store) revenue, with a 30-day post-click lookback window.
RoasOfflinePv24hMetric
The return on ad spend, considering offline (in-store) revenue, with a 24-hour post-view lookback window.
RoasPc1dMetric
The return on ad spend with a 1-day post-click lookback window.
RoasPc30dMetric
The return on ad spend with a 30-day post-click lookback window.
RoasPc30dPv24hMetric
The return on ad spend, considering a 30-day post-click or a 24-hour post-view lookback window.
RoasPc7dMetric
The return on ad spend with a 7-day post-click lookback window.
RoasPv24hMetric
The return on ad spend with a 24-hour post-view lookback window.
SalesAllClientAttributionMetric
The total number of transactions or conversions attributed to Criteo ads using client-defined attribution rules and including cross-device sales.
SalesAllPc1dMetric
The total number of transactions or conversions attributed to ads, including cross-device sales, with a 1-day post-click lookback window.
SalesAllPc30dMetric
The total number of transactions or conversions attributed to ads, including cross-device sales, with a 30-day post-click lookback window.
SalesAllPc30dPv24hMetric
The total number of transactions or conversions attributed to ads, including cross-device sales, considering a 30-day post-click or a 24-hour post-view lookback window.
SalesAllPc7dMetric
The total number of transactions or conversions attributed to ads, including cross-device sales, with a 7-day post-click lookback window.
SalesAllPv24hMetric
The total number of transactions or conversions attributed to ads, including cross-device sales, with a 24-hour post-view lookback window.
SalesClientAttributionMetric
The total number of transactions or conversions attributed to Criteo ads using client-defined attribution rules.
SalesOfflinePc30dMetric
The number of completed offline (in-store) transactions or purchases attributed to ads, with a 30-day post-click lookback window.
SalesOfflinePv24hMetric
The number of completed offline (in-store) transactions or purchases attributed to ads, with a 24-hour post-view lookback window.
SalesPc1dMetric
The total number of transactions or conversions attributed to ads, with a 1-day post-click lookback window.
SalesPc30dMetric
The total number of transactions or conversions attributed to ads, with a 30-day post-click lookback window.
SalesPc30dPv24hMetric
The number of transactions or conversions attributed to ads, considering a 30-day post-click or a 24-hour post-view lookback window.
SalesPc7dMetric
The total number of transactions or conversions attributed to ads, with a 7-day post-click lookback window.
SalesPv24hMetric
The total number of transactions or conversions attributed to ads, with a 24-hour post-view lookback window.
UntrackableDisplaysMetric
The number of ad impressions that were served but did not meet the criteria to be considered a viewed display (e.g., less than 50% of the ad on screen for at least one second).
ViewableDisplaysMetric
The number of ad impressions that were considered viewable, meaning at least 50% of the ad appeared on screen for at least one second.
VisitsMetric
The number of users who visited the target website or app, with at least one event occurring within an hour following a click.
WeekDimension
The specific week for which the campaign performance data is reported.
YearDimension
The specific year for which the campaign performance data is reported.