Skip to content
Book a demo

Connect documentation

All documentation
Documentation

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.

FieldAdverity UI nameType
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.