Criteo Retail Media: Most-used fields#
The table below gives information about most-used fields that you can import from Criteo Retail Media. 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.
accountCompanyName Dimension
The name of the company associated with the Criteo Retail Media account from which data is collected.
accountCountries Dimension
Countries associated with the account. Represented as 2-character ISO-3166 alpha-2 codes (e.g., US, FR).
accountCurrency Dimension
Default currency for billing, budgeting, bid settings, and campaign performance metrics. Represented as 3-character ISO-4217 currency codes (e.g., USD, EUR).
accountId Dimension
The unique identifier of the account, which can be a demand or supply account (generated internally by Criteo).
accountName Dimension
The name of the account, defined at the time of account creation.
accountTimeZone Dimension
The time zone associated with the account, using IANA (TZ database) identifiers (e.g., America/New_York, Europe/Paris).
accountType Dimension
The type of the account, indicating whether it is a 'supply' account for Retailers or a 'demand' account for advertisers (brands, marketplace sellers, agencies).
activitySellerId Dimension
The unique identifier for the seller whose advertising activity is being reported.
activitySellerName Dimension
The name of the seller associated with the advertising activity.
advDate Dimension
The date on which the advertisement event occurred. Dates are reflected based on the API call requested time zone.
advEngagement Dimension
A metric indicating user interaction or engagement with an advertisement or campaign.
advHour Dimension
The hour of the day when the advertisement event occurred.
advProductCategory Dimension
The category of the advertised product.
advProductGtin Dimension
The Global Trade Item Number (GTIN) for the product that was advertised.
advProductId Dimension
The unique identifier of the advertised product.
advProductMpn Dimension
The Manufacturer Part Number (MPN) of the advertised product.
advProductName Dimension
The name of the advertised product.
assistedUnits Metric
The number of units where the ad played a supporting role in generating a sale but was not the final attributing factor. These units are excluded from attributed units.
attributedOrders Metric
The number of orders directly linked to retail media campaign interactions.
attributedSales Metric
The sales revenue directly attributed to your marketing campaign, in accordance with your attribution rules, and serving as a measure of campaign conversions.
attributedUnits Metric
The number of units sold that are a direct result of your marketing campaign.
attributionWindow Dimension
The look-back window (e.g., 7 days, 30 days) used to attribute sales or conversions to an advertisement.
brandId Dimension
The unique identifier of the brand for the advertised product.
brandName Dimension
The name of the brand for the advertised product.
budget Metric
The allocated budget for a campaign.
budgetRemaining Metric
The portion of the allocated campaign budget that has not yet been spent.
budgetSpent Metric
The total amount of budget that has been spent on the campaign.
campaignEndDate Dimension
The date on which the advertising campaign is scheduled to end.
campaignId Dimension
The unique identifier for a campaign within the Criteo Retail Media platform.
campaignName Dimension
The name of the campaign.
campaignStartDate Dimension
The date on which the advertising campaign is scheduled to begin.
campaignTypeName Dimension
The type of the campaign, such as 'Open Auction' or 'Preferred Deals'.
category Dimension
The category of the product being advertised.
categoryId Dimension
The unique identifier of the product category.
clickAttributionScope Dimension
Defines the attribution window and rules used to attribute sales or conversions to clicks on ads.
clickAttributionWindow Dimension
The lookback window, in days, for attributing conversions to clicks.
clickSpend Metric
The total amount of money spent on clicks for the associated campaign or product.
clicks Metric
The total number of clicks recorded for an ad.
cpc Metric
The Cost Per Click (CPC) for an ad, representing the cost incurred for each click.
cpm Metric
The Cost Per Mille (CPM), representing the cost for one thousand advertisement impressions.
createdAt Dimension
The timestamp when the campaign or line item was initially created.
ctr Metric
The Click-Through Rate (CTR) of an ad, calculated as the number of clicks divided by the number of impressions.
dailyPacing Metric
The target or actual daily spending rate for a campaign or line item.
date Dimension
The date on which the reported activity or event occurred.
endDate Dimension
The specified end date for a campaign.
gtin Dimension
The Global Trade Item Number (GTIN) of the product.
imageUrl Dimension
The URL of an image for the product.
impressions Metric
The number of times an ad renders on a page. For Sponsored Products, this is when the SKU renders; for Commerce Display, it's when the entire banner renders.
isInStock Dimension
Indicates whether a product is currently available in stock.
keyword Dimension
The keyword associated with an advertising campaign or ad group, available in keyword reports.
lineItemBudget Metric
The optional budget allocated specifically for a line item.
lineItemBudgetremaining Metric
The remaining budget allocated specifically to a particular line item within a campaign.
lineItemBudgetspent Metric
The amount of budget that has been spent on a specific line item within a campaign.
lineItemCreatedat Dimension
The timestamp when the specific line item was created.
lineItemEnddate Dimension
The specified end date for a line item.
lineItemId Dimension
The unique identifier for a line item within a campaign.
lineItemName Dimension
The name of the line item as specified in the report.
lineItemStartdate Dimension
The specified start date for a line item.
lineItemStatus Dimension
The current operational status of the line item (e.g., active, paused, archived).
lineItemTargetretailerid Dimension
The ID of the specific retailer targeted by this line item, as each line item is restricted to a single retailer.
lineItemType Dimension
The specific type or category of an advertising line item.
lineItemUpdatedat Dimension
The timestamp when the specific line item was last updated.
minBid Metric
The minimum allowed bid for a product or keyword.
monthlyPacing Metric
The target or actual monthly spending rate for a campaign or line item.
mpn Dimension
The Manufacturer Part Number (MPN) of the product.
name Dimension
The name of the account, which is an arbitrary value defined during account creation.
newToBrandAttributedSales Metric
The total number of attributed sales that were new to brand.
newToBrandAttributedUnits Metric
The number of attributed units that were considered new to brand.
pageTypeName Dimension
The type of retailer web page where an ad creative was displayed, such as a home page, browse page, or product detail page.
price Metric
The price of the product.
productClicks Metric
The total number of clicks recorded for the specific product or product group.
productCpc Metric
The average cost-per-click (CPC) for a product, calculated as the total spend divided by the total number of clicks.
productCpo Metric
The average cost-per-order (CPO) for a product, representing the cost incurred for each successful order attributed to the product's advertising efforts.
productCtr Metric
The click-through rate (CTR) for a product, indicating the percentage of impressions that resulted in a click, calculated as (clicks / impressions) * 100.
productImpressions Metric
The total number of times a product's ad was displayed to users.
productRoas Metric
The return on ad spend (ROAS) for a product, indicating the revenue generated for every unit of currency spent on advertising for that product.
promotedBrandIds Dimension
Identifiers of the brands that are being promoted through the campaign or line item.
purchasedDate Dimension
The date when a product was purchased as a result of an attributed transaction.
purchasedHour Dimension
The hour when a product was purchased as a result of an attributed transaction.
purchasedProductCategory Dimension
The category of the product that was purchased.
purchasedProductGtin Dimension
The Global Trade Item Number (GTIN) for the product that was purchased.
purchasedProductId Dimension
The unique identifier for the product that was purchased.
purchasedProductMpn Dimension
The Manufacturer Part Number (MPN) of a product that was purchased, often found in product or attributed transaction reports.
purchasedProductName Dimension
The name of the product that was purchased.
retailerId Dimension
The unique identifier of the retailer associated with the reported activities.
retailerName Dimension
The name of the retailer associated with the reported activities.
roas Metric
Return On Ad Spend (ROAS), measuring the revenue generated for every unit of currency spent on ads, inclusive of platform fees.
saleSellerId Dimension
The unique identifier for the seller associated with the recorded sale.
saleSellerName Dimension
The name of the seller associated with the recorded sale.
salesChannel Dimension
The channel through which a sale or conversion occurred (e.g., online, in-store).
searchTerm Dimension
The actual search query entered by the user that triggered an ad. Criteo also refers to this as the 'stemmed search term'.
sellerId Dimension
The unique identifier for a seller, either associated with an advertising event or a sale.
sellerName Dimension
The name of a seller, either associated with an advertising event or a sale.
spend Metric
The total cost incurred for advertising, inclusive of platform fees.
startDate Dimension
The specified start date for a campaign.
status Dimension
The current operational status of the campaign (e.g., active, paused, archived).
type Dimension
The type of the account. This can be 'supply' for Retailers or 'demand' for various types of advertisers such as brands, marketplace sellers, or agencies.
uniqueVisitors Metric
The number of distinct shoppers exposed to an ad within the specified reporting period, identified by retailer cookie IDs.
updatedAt Dimension
The timestamp when the campaign or line item data was last updated.
videoCompletionRate Metric
The percentage of video ad plays that were completed to 100%.
videoMuted Metric
The number of times users clicked the “mute” button on your video.
videoPaused Metric
The number of times users activated the pause control on the video.
videoPlayingRate Metric
The average played percentage of a started video.
videoResumed Metric
The number of times users activated the resume control after the creative had been stopped and paused.
videoStartingRate Metric
The percentage of video ads that began playing after being served.
videoUnmuted Metric
The number of times users clicked the “unmute” button on your video.
videoViewability Metric
A metric indicating whether video advertisements met industry standards for being considered viewable (e.g., 50% of pixels in view for at least 2 consecutive seconds).
videoViews Metric
The number of times at least 50% of the video ad appeared for at least 2 seconds (MRC standard).
videosPlayedTo100 Metric
The number of times a video advertisement was played to 100% completion.
videosPlayedTo25 Metric
The number of times one of your videos played to at least 25% of its duration.
videosPlayedTo50 Metric
The number of times one of your videos played to at least 50% of its duration.
videosPlayedTo75 Metric
The number of times one of your videos played to at least 75% of its duration.
videosStarted Metric
The total number of times a video advertisement began playing.
viewAttributionScope Dimension
Defines the attribution window and rules used to attribute sales or conversions to views (impressions) of ads.
viewAttributionWindow Dimension
The lookback window, in days, for attributing conversions to ad views.