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.
accountCompanyNameDimension
The name of the company associated with the Criteo Retail Media account from which data is collected.
accountCountriesDimension
Countries associated with the account. Represented as 2-character ISO-3166 alpha-2 codes (e.g., US, FR).
accountCurrencyDimension
Default currency for billing, budgeting, bid settings, and campaign performance metrics. Represented as 3-character ISO-4217 currency codes (e.g., USD, EUR).
accountIdDimension
The unique identifier of the account, which can be a demand or supply account (generated internally by Criteo).
accountNameDimension
The name of the account, defined at the time of account creation.
accountTimeZoneDimension
The time zone associated with the account, using IANA (TZ database) identifiers (e.g., America/New_York, Europe/Paris).
accountTypetypeDimension
The type of the account, indicating whether it is a 'supply' account for Retailers or a 'demand' account for advertisers (brands, marketplace sellers, agencies).
activitySellerIdDimension
The unique identifier for the seller whose advertising activity is being reported.
activitySellerNameDimension
The name of the seller associated with the advertising activity.
advDateDimension
The date on which the advertisement event occurred. Dates are reflected based on the API call requested time zone.
advEngagementDimension
A metric indicating user interaction or engagement with an advertisement or campaign.
advHourDimension
The hour of the day when the advertisement event occurred.
advProductCategoryDimension
The category of the advertised product.
advProductGtinDimension
The Global Trade Item Number (GTIN) for the product that was advertised.
advProductIdDimension
The unique identifier of the advertised product.
advProductMpnDimension
The Manufacturer Part Number (MPN) of the advertised product.
advProductNameDimension
The name of the advertised product.
advertisedDateDimension
The date on which the advertisement was delivered.
advertisedEngagementDimension
The type of ad engagement (e.g., impression or click) to which a purchase was attributed.
advertisedProductCategoryDimension
The standardized category of the product that was advertised.
advertisedProductIdMetric
The unique identifier for the advertised product, referencing the ID used in retailer catalogs.
advertisedProductNameDimension
The name of the product that was advertised.
assistedUnitsMetric
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.
attributedOrdersMetric
The number of orders directly linked to retail media campaign interactions.
attributedSalesMetric
The sales revenue directly attributed to your marketing campaign, in accordance with your attribution rules, and serving as a measure of campaign conversions.
attributedUnitsMetric
The number of units sold that are a direct result of your marketing campaign.
attributionWindowDimension
The look-back window (e.g., 7 days, 30 days) used to attribute sales or conversions to an advertisement.
brandIdDimension
The unique identifier of the brand for the advertised product.
brandNameDimension
The name of the brand for the advertised product.
budgetMetric
The allocated budget for a campaign.
budgetModelDimension
The budget model used for the line item, such as CriteoBudget or RetailerBudget.
budgetRemainingMetric
The portion of the allocated campaign budget that has not yet been spent.
budgetSpentMetric
The total amount of budget that has been spent on the campaign.
buyTypeDimension
The buying model for the line item, such as auction, preferredDeals, or sponsorship.
campaignEndDateDimension
The date on which the advertising campaign is scheduled to end.
campaignIdDimension
The unique identifier for a campaign within the Criteo Retail Media platform.
campaignNameDimension
The name of the campaign.
campaignStartDateDimension
The date on which the advertising campaign is scheduled to begin.
campaignTypeDimension
The type of campaign, such as Open Auction or Preferred Deals.
campaignTypeNameDimension
The type of the campaign, such as 'Open Auction' or 'Preferred Deals'.
categoryDimension
The category of the product being advertised.
categoryIdDimension
The unique identifier of the product category.
clickAttributionScopeDimension
Defines the attribution window and rules used to attribute sales or conversions to clicks on ads.
clickAttributionWindowDimension
The lookback window, in days, for attributing conversions to clicks.
clickSpendMetric
The total cost of clicks for an advertiser's open auction campaigns, including platform fees.
clicksMetric
The total number of clicks recorded for an ad.
cpcMetric
The Cost Per Click (CPC) for an ad, representing the cost incurred for each click.
cpmMetric
The Cost Per Mille (CPM), representing the cost for one thousand advertisement impressions.
createdAtDimension
The timestamp when the campaign or line item was initially created.
creativeIdMetric
The unique identifier for the creative used in the advertisement. This field is typically for Onsite Display Campaigns only.
creativeNameDimension
The name of the creative used in the advertisement. This field is typically for Onsite Display Campaigns only.
ctrMetric
The Click-Through Rate (CTR) of an ad, calculated as the number of clicks divided by the number of impressions.
dailyPacingMetric
The target or actual daily spending rate for a campaign or line item.
dateDimension
The date on which the reported activity or event occurred.
endDateDimension
The specified end date for a campaign.
gtinDimension
The Global Trade Item Number (GTIN) of the product.
imageUrlDimension
The URL of an image for the product.
impressionsMetric
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.
isInStockDimension
Indicates whether a product is currently available in stock.
keywordDimension
The keyword associated with an advertising campaign or ad group, available in keyword reports.
lineItemBudgetMetric
The optional budget allocated specifically for a line item.
lineItemBudgetremainingMetric
The remaining budget allocated specifically to a particular line item within a campaign.
lineItemBudgetspentMetric
The amount of budget that has been spent on a specific line item within a campaign.
lineItemCreatedatDimension
The timestamp when the specific line item was created.
lineItemEnddateDimension
The specified end date for a line item.
lineItemIdDimension
The unique identifier for a line item within a campaign.
lineItemNameDimension
The name of the line item as specified in the report.
lineItemStartdateDimension
The specified start date for a line item.
lineItemStatusDimension
The current operational status of the line item (e.g., active, paused, archived).
lineItemTargetretaileridDimension
The ID of the specific retailer targeted by this line item, as each line item is restricted to a single retailer.
lineItemTypeDimension
The specific type or category of an advertising line item.
lineItemUpdatedatDimension
The timestamp when the specific line item was last updated.
mediaTypeDimension
The type of creative asset used in the ad, such as Display or Video.
minBidMetric
The minimum allowed bid for a product or keyword.
monthlyPacingMetric
The target or actual monthly spending rate for a campaign or line item.
mpnDimension
The Manufacturer Part Number (MPN) of the product.
nameDimension
The name of the account, which is an arbitrary value defined during account creation.
newToBrandAttributedSalesMetric
The total number of attributed sales that were new to brand.
newToBrandAttributedUnitsMetric
The number of attributed units that were considered new to brand.
pageTypeDimension
The type of retailer web page where the ad creative was rendered, including types like home, search, category, or productDetail.
pageTypeNameDimension
The type of retailer web page where an ad creative was displayed, such as a home page, browse page, or product detail page.
priceMetric
The price of the product.
productCategoryDimension
The standardized category of a product relevant to the report.
productClicksMetric
The number of clicks on ad creatives, which incurs a cost to the advertiser for open auction campaigns.
productCpcMetric
The average cost incurred for each click on a product advertisement.
productCpoMetric
The average cost incurred for each order attributed to advertising, calculated as cost per sale unit.
productCtrMetric
The Click-Through Rate (CTR) for product advertisements, calculated as the number of clicks divided by the number of impressions.
productIdDimension
The unique identifier for a product, referencing the ID used in retailer catalogs.
productImpressionsMetric
The number of times a promoted product is rendered on a page, whether as a single ad creative or as one of many products in an ad creative.
productNameDimension
The name of a product relevant to the report.
productRoasMetric
The Return On Ad Spend (ROAS), which is the revenue generated by attributed sales divided by the advertising cost.
promotedBrandIdsDimension
Identifiers of the brands that are being promoted through the campaign or line item.
purchasedDateDimension
The date when a product was purchased as a result of an attributed transaction.
purchasedHourDimension
The hour when a product was purchased as a result of an attributed transaction.
purchasedProductCategoryDimension
The category of the product that was purchased.
purchasedProductGtinDimension
The Global Trade Item Number (GTIN) for the product that was purchased.
purchasedProductIdDimension
The unique identifier for the product that was purchased.
purchasedProductMpnDimension
The Manufacturer Part Number (MPN) of a product that was purchased, often found in product or attributed transaction reports.
purchasedProductNameDimension
The name of the product that was purchased.
retailerIdDimension
The unique identifier of the retailer associated with the reported activities.
retailerNameDimension
The name of the retailer associated with the reported activities.
roasMetric
Return On Ad Spend (ROAS), measuring the revenue generated for every unit of currency spent on ads, inclusive of platform fees.
saleSellerIdDimension
The unique identifier for the seller associated with the recorded sale.
saleSellerNameDimension
The name of the seller associated with the recorded sale.
salesChannelDimension
The channel through which a sale or conversion occurred (e.g., online, in-store).
searchTermDimension
The actual search query entered by the user that triggered an ad. Criteo also refers to this as the 'stemmed search term'.
sellerIdDimension
The unique identifier for a seller, either associated with an advertising event or a sale.
sellerNameDimension
The name of a seller, either associated with an advertising event or a sale.
spendMetric
The total cost incurred for advertising, inclusive of platform fees.
startDateDimension
The specified start date for a campaign.
statusDimension
The current operational status of the campaign (e.g., active, paused, archived).
typeDimension
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.
uniqueVisitorsMetric
The number of distinct shoppers exposed to an ad within the specified reporting period, identified by retailer cookie IDs.
updatedAtDimension
The timestamp when the campaign or line item data was last updated.
videoCPCVMetric
The average cost per completed video view.
videoCompletionRateMetric
The percentage of video ad plays that were completed to 100%.
videoImpressionsMetric
The count of video advertisement impressions.
videoMutedMetric
The number of times users clicked the “mute” button on your video.
videoPausedMetric
The number of times users activated the pause control on the video.
videoPlayingRateMetric
The average played percentage of a started video.
videoResumedMetric
The number of times users activated the resume control after the creative had been stopped and paused.
videoStartingRateMetric
The percentage of video ads that began playing after being served.
videoUnmutedMetric
The number of times users clicked the “unmute” button on your video.
videoViewabilityMetric
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).
videoViewsMetric
The number of times at least 50% of the video ad appeared for at least 2 seconds (MRC standard).
videosPlayedTo100Metric
The number of times a video advertisement was played to 100% completion.
videosPlayedTo25Metric
The number of times one of your videos played to at least 25% of its duration.
videosPlayedTo50Metric
The number of times one of your videos played to at least 50% of its duration.
videosPlayedTo75Metric
The number of times one of your videos played to at least 75% of its duration.
videosStartedMetric
The total number of times a video advertisement began playing.
viewAttributionScopeDimension
Defines the attribution window and rules used to attribute sales or conversions to views (impressions) of ads.
viewAttributionWindowDimension
The lookback window, in days, for attributing conversions to ad views.