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.
Ad Dimension
The name or identifier of the individual ad creative.
AdId Dimension
The unique identifier for the individual ad creative.
Adset Dimension
The name of the ad set.
Adset.endDate Dimension
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.frequency Dimension
The time period over which the maximum impression limit for the Ad Set is calculated. Possible values include 'hourly', 'daily', or 'lifetime'.
Adset.frequencyCapping.maximumImpressions Dimension
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.mediaType Dimension
This field specifies the type of creative asset used in the ad set, such as 'Display' or 'Video'.
Adset.objective Metric
The marketing objective configured for a specific ad set.
Adset.startDate Dimension
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.type Dimension
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.
AdsetId Dimension
The unique identifier for the ad set.
Advertiser Dimension
The name of the advertiser.
AdvertiserAllValue Metric
The total revenue generated by each product, considering margin, including cross-device sales.
AdvertiserCost Metric
The total cost spent by the advertiser on Criteo advertising campaigns.
AdvertiserId Dimension
The unique identifier for the advertiser.
AdvertiserValue Metric
The total revenue generated by each product, considering margin (if provided in your product catalog).
AppInstalls Metric
The total number of successful installations of the advertised mobile application.
Audience Metric
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.
AverageCartAllClientAttribution Metric
The average revenue generated per conversion or sale, including cross-device sales, attributed using client-defined attribution rules.
AverageCartAllPc1d Metric
The average revenue generated per conversion or sale, including cross-device sales, with a 1-day post-click lookback window.
AverageCartAllPc30d Metric
The average revenue generated per conversion or sale, including cross-device sales, with a 30-day post-click lookback window.
AverageCartAllPc30dPv24h Metric
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.
AverageCartAllPc7d Metric
The average revenue generated per conversion or sale, including cross-device sales, with a 7-day post-click lookback window.
AverageCartAllPv24h Metric
The average revenue generated per conversion or sale, including cross-device sales, with a 24-hour post-view lookback window.
AverageCartClientAttribution Metric
The average revenue generated per conversion or sale, attributed using client-defined attribution rules.
AverageCartPc1d Metric
The average revenue generated per conversion or sale, with a 1-day post-click lookback window.
AverageCartPc30d Metric
The average revenue generated per conversion or sale, with a 30-day post-click lookback window.
AverageCartPc30dPv24h Metric
The average revenue generated per conversion or sale, considering a 30-day post-click or a 24-hour post-view lookback window.
AverageCartPc7d Metric
The average revenue generated per conversion or sale, with a 7-day post-click lookback window.
AverageCartPv24h Metric
The average revenue generated per conversion or sale, with a 24-hour post-view lookback window.
BounceRate Metric
The percentage of website visitors who navigate away from the site after viewing only one page.
Campaign Dimension
The name of the marketing campaign.
Campaign.spendLimit.spendLimitAmount Metric
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.
CampaignId Dimension
The unique identifier for the marketing campaign.
Category Dimension
The product category associated with the advertised items or the page where the ad was displayed.
CategoryId Metric
The unique identifier for the product category.
Channel Dimension
The advertising channel through which the campaign or ad was delivered.
ChannelId Metric
The unique identifier for the advertising channel.
ClickThroughRate Metric
The percentage of ad impressions that resulted in a click.
Clicks Metric
The total number of times an ad creative was clicked by users.
ConversionRateAllClientAttribution Metric
The percentage of conversions or sales compared to clicks, including cross-device sales, attributed using client-defined attribution rules.
ConversionRateAllPc1d Metric
The percentage of conversions or sales compared to clicks, including cross-device sales, with a 1-day post-click lookback window.
ConversionRateAllPc30d Metric
The percentage of conversions or sales compared to clicks, including cross-device sales, with a 30-day post-click lookback window.
ConversionRateAllPc30dPv24h Metric
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.
ConversionRateAllPc7d Metric
The percentage of conversions or sales compared to clicks, including cross-device sales, with a 7-day post-click lookback window.
ConversionRateAllPv24h Metric
The percentage of conversions or sales compared to clicks, including cross-device sales, with a 24-hour post-view lookback window.
ConversionRateClientAttribution Metric
The percentage of conversions or sales compared to clicks, attributed using client-defined attribution rules.
ConversionRatePc1d Metric
The percentage of conversions or sales compared to clicks, with a 1-day post-click lookback window.
ConversionRatePc30d Metric
The percentage of conversions or sales compared to clicks, with a 30-day post-click lookback window.
ConversionRatePc30dPv24h Metric
The percentage of conversions or sales compared to clicks, considering a 30-day post-click or a 24-hour post-view lookback window.
ConversionRatePc7d Metric
The percentage of conversions or sales compared to clicks, with a 7-day post-click lookback window.
ConversionRatePv24h Metric
The percentage of conversions or sales compared to clicks, with a 24-hour post-view lookback window.
CostPerInstall Metric
The average cost incurred for each app installation.
CostPerOrderAllClientAttribution Metric
The advertising cost per order, including cross-device sales, attributed using client-defined attribution rules.
CostPerOrderAllPc1d Metric
The advertising cost per order, including cross-device sales, with a 1-day post-click lookback window.
CostPerOrderAllPc30d Metric
The advertising cost per order, including cross-device sales, with a 30-day post-click lookback window.
CostPerOrderAllPc30dPv24h Metric
The advertising cost per order, including cross-device sales, considering a 30-day post-click or a 24-hour post-view lookback window.
CostPerOrderAllPc7d Metric
The advertising cost per order, including cross-device sales, with a 7-day post-click lookback window.
CostPerOrderAllPv24h Metric
The advertising cost per order, including cross-device sales, with a 24-hour post-view lookback window.
CostPerOrderClientAttribution Metric
The advertising cost per order, attributed using client-defined attribution rules.
CostPerOrderPc1d Metric
The advertising cost per order, with a 1-day post-click lookback window.
CostPerOrderPc30d Metric
The advertising cost per order, with a 30-day post-click lookback window.
CostPerOrderPc30dPv24h Metric
The advertising cost per order, considering a 30-day post-click or a 24-hour post-view lookback window.
CostPerOrderPc7d Metric
The advertising cost per order, with a 7-day post-click lookback window.
CostPerOrderPv24h Metric
The advertising cost per order, with a 24-hour post-view lookback window.
CostPerVisit Metric
The average amount of money spent on advertising for each visit to the website or app.
Coupon Dimension
The name or identifier of the coupon used in the ad campaign.
CouponId Metric
The unique identifier for the coupon used in the ad campaign.
Cpc Metric
The average cost incurred for each click on an advertisement.
Currency Dimension
The currency code (e.g., USD, EUR) used for reporting financial metrics in the campaign.
Day Dimension
The specific day for which the campaign performance data is reported.
Device Dimension
The type of device (e.g., desktop, mobile, tablet) on which the ad was displayed.
Displays Metric
The total number of ad impressions served to users.
ECosAllClientAttribution Metric
The advertising cost per conversion or sale, including cross-device sales, attributed using client-defined attribution rules.
ECosAllPc1d Metric
The advertising cost per conversion or sale, including cross-device sales, with a 1-day post-click lookback window.
ECosAllPc30d Metric
The advertising cost per conversion or sale, including cross-device sales, with a 30-day post-click lookback window.
ECosAllPc30dPv24h Metric
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.
ECosAllPc7d Metric
The advertising cost per conversion or sale, including cross-device sales, with a 7-day post-click lookback window.
ECosAllPv24h Metric
The advertising cost per conversion or sale, including cross-device sales, with a 24-hour post-view lookback window.
ECosClientAttribution Metric
The advertising cost per conversion or sale, attributed using client-defined attribution rules.
ECosPc1d Metric
The advertising cost per conversion or sale, with a 1-day post-click lookback window.
ECosPc30d Metric
The advertising cost per conversion or sale, with a 30-day post-click lookback window.
ECosPc30dPv24h Metric
The advertising cost per conversion or sale, considering a 30-day post-click or a 24-hour post-view lookback window.
ECosPc7d Metric
The advertising cost per conversion or sale, with a 7-day post-click lookback window.
ECosPv24h Metric
The advertising cost per conversion or sale, with a 24-hour post-view lookback window.
ECpm Metric
The effective cost per thousand ad impressions (Mille).
ExposedUsers Metric
The total number of unique users who were served an advertisement.
Hour Dimension
The specific hour for which the campaign performance data is reported.
InstallRate Metric
The percentage of app installations relative to the number of clicks on the ad.
MarketingObjective Dimension
The marketing objective associated with the campaign or ad set.
MarketingObjectiveId Metric
The unique identifier for the marketing objective associated with the campaign or ad set.
Month Dimension
The specific month for which the campaign performance data is reported.
NonViewableDisplays Metric
The number of ad impressions that were not considered viewable based on Criteo's criteria.
OmniChannelRevenuePc30d Metric
The revenue generated by online and offline sales, with a 30-day post-click lookback window.
OmniChannelRoasPc30d Metric
The return on ad spend, considering both online and offline revenue, with a 30-day post-click lookback window.
OmniChannelSalesPc30d Metric
The number of online and offline transactions or conversions attributed to Criteo ads, with a 30-day post-click lookback window.
OmnichannelRevenueAllPc30d Metric
The revenue generated by all online and offline sales, including cross-device sales, with a 30-day post-click lookback window.
OmnichannelRevenueAllPv24h Metric
The revenue generated by all online and offline sales, including cross-device sales, with a 24-hour post-view lookback window.
OmnichannelRevenueClientAttribution Metric
The revenue generated by online and offline sales, attributed using client-defined attribution rules.
OmnichannelRevenuePc30d Metric
The revenue generated by online and offline sales, with a 30-day post-click lookback window.
OmnichannelRevenuePv24h Metric
The revenue generated by online and offline sales, with a 24-hour post-view lookback window.
OmnichannelRoasAllPc30d Metric
The return on ad spend, considering all online and offline revenue, including cross-device sales, with a 30-day post-click lookback window.
OmnichannelRoasAllPv24h Metric
The return on ad spend, considering all online and offline revenue, including cross-device sales, with a 24-hour post-view lookback window.
OmnichannelRoasClientAttribution Metric
The return on ad spend, considering online and offline revenue, attributed using client-defined attribution rules.
OmnichannelRoasPv24h Metric
The return on ad spend, considering online and offline revenue, with a 24-hour post-view lookback window.
OmnichannelSalesAllPc30d Metric
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.
OmnichannelSalesAllPv24h Metric
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.
OmnichannelSalesClientAttribution Metric
The number of online and offline transactions or conversions attributed to Criteo ads, using client-defined attribution rules.
OmnichannelSalesPc30d Metric
The total number of online and offline transactions or conversions attributed to Criteo ads, using a 30-day post-click lookback window for attribution.
OmnichannelSalesPv24h Metric
The number of online and offline transactions or conversions attributed to Criteo ads, with a 24-hour post-view lookback window.
Os Dimension
The operating system (e.g., iOS, Android, Windows) of the device on which the ad was displayed.
Placement Dimension
The location or context where an ad creative is displayed.
PostInstallConversionRate Metric
The percentage of post-install sales relative to the clicks that occurred.
PostInstallCostOfSale Metric
The cost of sale specifically for app install campaigns.
PostInstallCostPerOrder Metric
The cost per order for sales that occurred after an app installation.
PostInstallOrderValue Metric
The total revenue generated by sales that occurred after an app installation.
PostInstallRoas Metric
The return on ad spend specifically for sales that occurred after an app installation.
PostInstallSales Metric
The number of completed sales events that occurred after an app installation.
PotentialDisplays Metric
The total number of available display opportunities or bid requests received for an ad.
Reach Metric
The share of potential users who were served an ad, indicating the unique audience reached.
RevenueGeneratedAllClientAttribution Metric
The total revenue generated from sales attributed to Criteo ads using client-defined attribution rules and including cross-device sales.
RevenueGeneratedAllPc1d Metric
The total revenue generated from sales attributed to ads, including cross-device sales, with a 1-day post-click lookback window.
RevenueGeneratedAllPc30d Metric
The total revenue generated from sales attributed to ads, including cross-device sales, with a 30-day post-click lookback window.
RevenueGeneratedAllPc30dPv24h Metric
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.
RevenueGeneratedAllPc7d Metric
The total revenue generated from sales attributed to ads, including cross-device sales, with a 7-day post-click lookback window.
RevenueGeneratedAllPv24h Metric
The total revenue generated from sales attributed to ads, including cross-device sales, with a 24-hour post-view lookback window.
RevenueGeneratedClientAttribution Metric
The total revenue generated from sales attributed to Criteo ads using client-defined attribution rules.
RevenueGeneratedOfflinePc30d Metric
The total revenue generated from offline (in-store) sales attributed to ads, with a 30-day post-click lookback window.
RevenueGeneratedOfflinePv24h Metric
The total revenue generated from offline (in-store) sales attributed to ads, with a 24-hour post-view lookback window.
RevenueGeneratedPc1d Metric
The total revenue generated from sales attributed to ads, with a 1-day post-click lookback window.
RevenueGeneratedPc30d Metric
The total revenue generated from sales attributed to ads, with a 30-day post-click lookback window.
RevenueGeneratedPc30dPv24h Metric
The total revenue generated from sales attributed to ads, considering a 30-day post-click or a 24-hour post-view lookback window.
RevenueGeneratedPc7d Metric
The total revenue generated from sales attributed to ads, with a 7-day post-click lookback window.
RevenueGeneratedPv24h Metric
The total revenue generated from sales attributed to ads, with a 24-hour post-view lookback window.
RoasAllClientAttribution Metric
The return on ad spend, including cross-device revenue, attributed using client-defined attribution rules.
RoasAllPc1d Metric
The return on ad spend, including cross-device revenue, with a 1-day post-click lookback window.
RoasAllPc30d Metric
The return on ad spend, including cross-device revenue, with a 30-day post-click lookback window.
RoasAllPc30dPv24h Metric
The return on ad spend, including cross-device revenue, considering a 30-day post-click or a 24-hour post-view lookback window.
RoasAllPc7d Metric
The return on ad spend, including cross-device revenue, with a 7-day post-click lookback window.
RoasAllPv24h Metric
The return on ad spend, including cross-device revenue, with a 24-hour post-view lookback window.
RoasClientAttribution Metric
The return on ad spend, attributed using client-defined attribution rules.
RoasOfflinePc30d Metric
The return on ad spend, considering offline (in-store) revenue, with a 30-day post-click lookback window.
RoasOfflinePv24h Metric
The return on ad spend, considering offline (in-store) revenue, with a 24-hour post-view lookback window.
RoasPc1d Metric
The return on ad spend with a 1-day post-click lookback window.
RoasPc30d Metric
The return on ad spend with a 30-day post-click lookback window.
RoasPc30dPv24h Metric
The return on ad spend, considering a 30-day post-click or a 24-hour post-view lookback window.
RoasPc7d Metric
The return on ad spend with a 7-day post-click lookback window.
RoasPv24h Metric
The return on ad spend with a 24-hour post-view lookback window.
SalesAllClientAttribution Metric
The total number of transactions or conversions attributed to Criteo ads using client-defined attribution rules and including cross-device sales.
SalesAllPc1d Metric
The total number of transactions or conversions attributed to ads, including cross-device sales, with a 1-day post-click lookback window.
SalesAllPc30d Metric
The total number of transactions or conversions attributed to ads, including cross-device sales, with a 30-day post-click lookback window.
SalesAllPc30dPv24h Metric
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.
SalesAllPc7d Metric
The total number of transactions or conversions attributed to ads, including cross-device sales, with a 7-day post-click lookback window.
SalesAllPv24h Metric
The total number of transactions or conversions attributed to ads, including cross-device sales, with a 24-hour post-view lookback window.
SalesClientAttribution Metric
The total number of transactions or conversions attributed to Criteo ads using client-defined attribution rules.
SalesOfflinePc30d Metric
The number of completed offline (in-store) transactions or purchases attributed to ads, with a 30-day post-click lookback window.
SalesOfflinePv24h Metric
The number of completed offline (in-store) transactions or purchases attributed to ads, with a 24-hour post-view lookback window.
SalesPc1d Metric
The total number of transactions or conversions attributed to ads, with a 1-day post-click lookback window.
SalesPc30d Metric
The total number of transactions or conversions attributed to ads, with a 30-day post-click lookback window.
SalesPc30dPv24h Metric
The number of transactions or conversions attributed to ads, considering a 30-day post-click or a 24-hour post-view lookback window.
SalesPc7d Metric
The total number of transactions or conversions attributed to ads, with a 7-day post-click lookback window.
SalesPv24h Metric
The total number of transactions or conversions attributed to ads, with a 24-hour post-view lookback window.
UntrackableDisplays Metric
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).
ViewableDisplays Metric
The number of ad impressions that were considered viewable, meaning at least 50% of the ad appeared on screen for at least one second.
Visits Metric
The number of users who visited the target website or app, with at least one event occurring within an hour following a click.
Week Dimension
The specific week for which the campaign performance data is reported.
Year Dimension
The specific year for which the campaign performance data is reported.