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.

API name	Adverity UI name	Description	Use in Adverity
accountCountries	accountCountries	Countries associated with the account. Represented as 2-character ISO-3166 alpha-2 codes (e.g., US, FR).	dimension
accountCurrency	accountCurrency	Default currency for billing, budgeting, bid settings, and campaign performance metrics. Represented as 3-character ISO-4217 currency codes (e.g., USD, EUR).	dimension
accountId	accountId	The unique identifier of the account, which can be a demand or supply account (generated internally by Criteo).	metric
accountName	accountName	The name of the account, defined at the time of account creation.	dimension
accountTimeZone	accountTimeZone	The time zone associated with the account, using IANA (TZ database) identifiers (e.g., America/New_York, Europe/Paris).	dimension
accountType	accountType	The type of the account, indicating whether it is a ‘supply’ account for Retailers or a ‘demand’ account for advertisers (brands, marketplace sellers, agencies).	dimension
advProductCategory	advProductCategory	The category of the advertised product.	dimension
advProductId	advProductId	The unique identifier of the advertised product.	dimension
advProductName	advProductName	The name of the advertised product.	dimension
assistedSales	assistedSales	Sales that were influenced by an ad but not directly attributed to it.	metric
assistedUnits	assistedUnits	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.	metric
attributedOrders	attributedOrders	The number of orders directly linked to retail media campaign interactions.	metric
attributedSales	attributedSales	The sales revenue directly attributed to your marketing campaign, in accordance with your attribution rules, and serving as a measure of campaign conversions.	metric
attributedUnits	attributedUnits	The number of units sold that are a direct result of your marketing campaign.	metric
brandId	brandId	The unique identifier of the brand for the advertised product.	metric
brandName	brandName	The name of the brand for the advertised product.	dimension
budget	budget	The allocated budget for a campaign.	metric
budgetRemaining	budgetRemaining	The portion of the allocated campaign budget that has not yet been spent.	metric
budgetSpent	budgetSpent	The total amount of budget that has been spent on the campaign.	metric
campaignId	campaignId	The unique identifier for a campaign within the Criteo Retail Media platform.	metric
campaignName	campaignName	The name of the campaign.	dimension
campaignTypeName	campaignTypeName	The type of the campaign, such as ‘Open Auction’ or ‘Preferred Deals’.	dimension
category	category	The category of the product being advertised.	dimension
categoryId	categoryId	The unique identifier of the product category.	metric
clickAttributionScope	clickAttributionScope	Defines the attribution window and rules used to attribute sales or conversions to clicks on ads.	dimension
clickAttributionWindow	clickAttributionWindow	The lookback window, in days, for attributing conversions to clicks.	dimension
clicks	clicks	The total number of clicks recorded for an ad.	metric
cpc	cpc	The Cost Per Click (CPC) for an ad, representing the cost incurred for each click.	dimension
createdAt	createdAt	The timestamp when the campaign or line item was initially created.	dimension
ctr	ctr	The Click-Through Rate (CTR) of an ad, calculated as the number of clicks divided by the number of impressions.	dimension
dailyPacing	dailyPacing	The target or actual daily spending rate for a campaign or line item.	dimension
date	date	The date on which the reported activity or event occurred.	dimension
drawableBalanceIds	drawableBalanceIds		dimension
endDate	endDate	The specified end date for a campaign.	dimension
frequency	frequency	The average number of times an impression has been shown to the same user.	metric
gtin	gtin	The Global Trade Item Number (GTIN) of the product.	metric
imageUrl	imageUrl	The URL of an image for the product.	dimension
impressions	impressions	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.	metric
isAutoDailyPacing	isAutoDailyPacing	Indicates whether a campaign’s budget is automatically distributed on a daily basis.	dimension
isInStock	isInStock	Indicates whether a product is currently available in stock.	dimension
lineItemBudget	lineItemBudget	The optional budget allocated specifically for a line item.	metric
lineItemBudgetremaining	lineItemBudgetremaining	The remaining budget allocated specifically to a particular line item within a campaign.	metric
lineItemBudgetspent	lineItemBudgetspent	The amount of budget that has been spent on a specific line item within a campaign.	metric
lineItemCreatedat	lineItemCreatedat	The timestamp when the specific line item was created.	dimension
lineItemEnddate	lineItemEnddate	The specified end date for a line item.	dimension
lineItemId	lineItemId	The unique identifier for a line item within a campaign.	metric
lineItemName	lineItemName	The name of the line item as specified in the report.	dimension
lineItemStartdate	lineItemStartdate	The specified start date for a line item.	dimension
lineItemStatus	lineItemStatus	The current operational status of the line item (e.g., active, paused, archived).	dimension
lineItemTargetretailerid	lineItemTargetretailerid	The ID of the specific retailer targeted by this line item, as each line item is restricted to a single retailer.	metric
lineItemType	lineItemType	The specific type or category of an advertising line item.	dimension
lineItemUpdatedat	lineItemUpdatedat	The timestamp when the specific line item was last updated.	dimension
minBid	minBid	The minimum allowed bid for a product or keyword.	metric
monthlyPacing	monthlyPacing	The target or actual monthly spending rate for a campaign or line item.	dimension
mpn	mpn	The Manufacturer Part Number (MPN) of the product.	dimension
newToBrandAttributedSales	newToBrandAttributedSales	The total sales revenue generated from customers who made their first purchase from the brand, attributed to retail media campaigns.	metric
newToBrandAttributedUnits	newToBrandAttributedUnits	The total number of units sold to customers who made their first purchase from the brand, attributed to retail media campaigns.	metric
pageTypeName	pageTypeName	The type of retailer web page where an ad creative was rendered (e.g., home page, browse page, search page, product detail page).	dimension
price	price	The price of the product.	metric
promotedBrandIds	promotedBrandIds	Identifiers of the brands that are being promoted through the campaign or line item.	dimension
retailerId	retailerId	The unique identifier of the retailer associated with the reported activities.	metric
retailerName	retailerName	The name of the retailer associated with the reported activities.	dimension
roas	roas	Return On Ad Spend (ROAS), measuring the revenue generated for every unit of currency spent on ads, inclusive of platform fees.	dimension
salesChannel	salesChannel	The sales channel through which an attributed purchase was made.	dimension
sellerId	sellerId	The unique identifier of the seller responsible for the advertising event or sale.	dimension
sellerName	sellerName	The name of the seller responsible for the advertising event or sale.	dimension
spend	spend	The total cost incurred for advertising, inclusive of platform fees.	metric
startDate	startDate	The specified start date for a campaign.	dimension
status	status	The current operational status of the campaign (e.g., active, paused, archived).	dimension
uniqueVisitors	uniqueVisitors	The number of distinct shoppers exposed to an ad within the specified reporting period, identified by retailer cookie IDs.	metric
updatedAt	updatedAt	The timestamp when the campaign or line item data was last updated.	dimension
viewAttributionScope	viewAttributionScope	Defines the attribution window and rules used to attribute sales or conversions to views (impressions) of ads.	dimension
viewAttributionWindow	viewAttributionWindow	The lookback window, in days, for attributing conversions to ad views.	dimension