Metrics and Dimensions

Report Metrics

Most metrics are available for every report types with the exception of certain metrics that are only available at one report level or for certain report types. The table below breaks the the report level and report types where each metrics is found.

Metric	Report Level	Report Types	Description
`impressions`	Campaign, Line-item	summary, pageType keyword, product category, product, served category, environment	Campaign Report Types Measured when an ad creative renders on a page; an ad creative may display products from one or more campaigns; each unique campaign is counted once; used in all report types except for Product and Product Category reports Line-Item Report Types Measured when an ad creative renders on a page; an ad creative may display products from one or more line items; each unique line item is counted once; used in all report types except for Product and Product Category reports Product, Product Category and Served Category Report Types Measured when a promoted product is rendered on the page, whether as a single ad creative or as one of many products in an ad creative; each product is counted once separately 💡 More Info: Product & Placement Impression Help Center article
`clicks`	Campaign, Line-item	summary, pageType, keyword, product category, product, served category, environment	Measured when an ad creative is clicked on, which incurs a cost to the advertiser for open auction campaigns
`spend`	Campaign, Line-item	summary, pageType, keyword, product category, product, served category, environment	For open auctions campaigns, the total cost of clicks for the advertiser, inclusive of platform fees
`attributedSales`	Campaign, Line-item	summary, pageType, keyword, product-category, product, attributedTransactions, served category, environment	A sale that was a direct result of your marketing campaign (in accordance with your attribution rules). Also, a measure of the conversions of your campaign. Formula: Sum of all Sales Important: _Sales are deduplicated between off-site and on-site, however the Criteo API will only report on on-site campaigns only*. A sale can only be attributed to one line item across all campaigns._
`attributedUnits`	Campaign, Line-item	summary, pageType, keyword, product category, product, attributedTransactions, served category, environment	Units sold attributed to a click or impression. Attributed units are exclusive of.`assistedUnits` meaning assisted units are not counted in the attribution. Example:* If a shopper purchases one order of two products, the number of Attributed Units is two.
`attributedOrders`	Campaign, Line-item	summary, pageType, keyword, product category, product, environment	Orders or buy transactions attributed to a click or an impression (can vary based on your attribution settings) Example:* If a shopper purchases one order of two products, the number of Attributed Orders is one.
`ctr`	Campaign, Line-item	summary, pageType, keyword, product category, product, served category, environment	The percentage of shoppers who clicked an ad rendered on a page. Product and Product Category Report Types Formula: `clicks` / `productImpressions` All other report types Formula: `clicks` / `placementImpressions` 💡 Note: there are two types of impressions that can be measured to know the success of your ads: `placementImpressions` and `productImpressions`. Preferred deals have placement impressions, while open auction uses product impressions. For more info: Product & Placement Impression Help Center article
`cpc`	Campaign, Line-item	summary, pageType, keyword, product category, product, served category, environment	The average cost you are paying per click. Available for On-site Sponsored Products campaigns only. Value is inclusive of platform fees. Formula: `spend` / `clicks`
`roas`	Campaign, Line-item	summary, pageType, keyword, product category, product, served category, environment	A measurement of the revenue you will receive for every unit of currency you spend on ads. ROAS can vary based on your attribution settings. This metric is inclusive of platform fees. Formula: `attributedSales` / `spend`
`cpo`	Campaign, Line-item	summary, pageType, keyword, product category, product	The amount spent on advertising that resulted in a purchase order from a shopper. Formula: `spend` / `attributedOrders` Example: *If you spend $100 on advertising and you have 5 orders placed, the CPO would be $20 ($100/5)
`assistedSales`	Campaigns Line-item	summary, pageType, keyword, product category, product, served category, environment	Sales revenue attributed to a click or impression of all the ads that appeared on a page within the chosen attribution window (specified at the campaign level) but were not determined to be the `attributedSales` (the last ad before the customer purchased). 💡 More Info: Demand Side Metrics Help Center article
`assistedUnits`	Campaign Line-item	summary, pageType, keyword, product category, product, served category, environment	The number of events that occurred that helped generated a sale. Assisted units are excluded from `attributedUnits`. This means its not counted in the attributed units calculation.
`uniqueVisitors`	Campaign, Line-item	summary, environment	The number of distinct shoppers exposed to an ad within the reporting period. Each shopper is counted once using the retailer cookie ID. Criteo uses retailer cookie IDs to identify users across sessions on the same device. Each ID can last up to a year, provided the user does not clear their cookies. 💡 More Info: Demand Side Metrics Help Center article
`frequency`	Campaign, Line-item	summary, environment	An average representing how often an impression has been shown to the same user
`videoViews`	Line-item	Multi-dimension reporting only. Use the `dimension []`array to retrieve data	The number of times at least 50% of the video ad appeared for at least 2 seconds (MRC standard).
`videosStarted`	Line-item	Multi-dimension reporting only. Use the `dimension []`array to retrieve data	The percentage of videos printed that started playing. Formula*: Video Starts / Placement Impressions
`videosPlayedTo25`	Line-item	Multi-dimension reporting only. Use the `dimension []`array to retrieve data	The number of times one of your videos played to at least 25% of its duration.
`videosPlayedTo50`	Line-item	Multi-dimension reporting only. Use the `dimension []`array to retrieve data	The number of times one of your videos played to at least 50% of its duration.
`videosPlayedTo75`	Line-item	Multi-dimension reporting only. Use the `dimension []`array to retrieve data	The number of times one of your videos played to at least 75% of its duration.
`videosPlayedTo100`	Line-item	Multi-dimension reporting only. Use the `dimension []`array to retrieve data	The number of times one of your videos played to 100% of its duration.
`videoPlayingRate`	Line-item	Multi-dimension reporting only. Use the `dimension []`array to retrieve data	The average played percentage of a started video. Formula*: Sum of Quartiles x 0.25 / (4 x Video starts)
`videoCompletionRate`	Line-item	Multi-dimension reporting only. Use the `dimension []`array to retrieve data	The percentage of started videos that played for their entire duration. Formula: Number of videos that played to completion / Total number of videos started 100
`winRate`	Campaign, Line-item	Multi-dimension reporting only. Use the `dimension []`array to retrieve data	The number of times Sponsored Product SKUs won in the auction. Win Rate is calculated by taking the number of total impressions won and dividing it by the total number of impressions that were bid on.

Report Dimensions

Available dimensions vary by report type
The Attributed Transactions report is documented separately below

Dimension	Report Level	Report Types	Description
`date`	Campaign, Line-item	summary, pageType, keyword, product category, product, served category, environment	The date of when events occurred for the requested line-item or campaign report. If there are no results to show for the requested dates, the API will return no results. Note:* Dates are reflected based on the API call requested time zone. Dates are also reported at either the campaign level or line-item level.
`hour`	Campaign, Line-item	Multi-dimension reporting only. Use the `dimensions []`array to retrieve data	The hour of when events occurred for the requested line-item or campaign report. If there are no results to show for the requested dates, the API will return no results.
`campaignId`	Campaign, Line-item	summary, pageType, keyword, product category, product, attributedTransactions, served category, environment	The campaign ID of the requested report
`campaignName`	Campaign, Line-item	summary, pageType, keyword, product category, product, attributedTransactions, served category, environment	The Campaign name of the request report
`campaignTypeName`	Campaign, Line-item	summary, pageType, keyword, product category, product, attributedTransactions, served category, environment	The type of of campaign. Available options are `Open Auction` or `Preferred Deals` Note*: Offsite is not yet available through the API
`lineItemId`	Line-item	summary, pageType, keyword, product category, product, attributedTransactions, served category, environment	Line item ID of the requested report
`lineItemName`	Line-item	summary, pageType, keyword, product category, product, attributedTransactions, served category, environment	Line item name of the requested report
`retailerId`	Line-item	summary, pageType, keyword, product category, product, served category	Retailer ID of the retailer of the line item served on
`retailerName`	Line-item	summary, pageType, keyword, product category, product, attributedTransactions, served category	Retailer name of the retailer the line item served on
`pageTypeName`	Campaign, Line-item	pageType, attributedTransactions	Type of retailer web page an ad creative rendered on. Current page types include home, category, productDetail, confirmation, checkout, merchandising, deals, and search.
`environment`	Campaign, Line-item	environment	Type of environment an ad creative rendered on, such as web, mobile, and app
`keyword`	Campaign, Line-item	keyword	Keyword or phrase used to land on the search page where an ad creative rendered. This is the normalized keyword submitted by the advertisers. Criteo also refers this as the `stemmed search term`
`searchTerm`	Campaign, Line-item	Multi-dimension reporting only. Use the `dimensions []`array to retrieve data.	Searched keyword or phrase used by the shopper on a retailer's website.
`servedCategory`	Campaign, Line-item	served category	Category of the browser page the were ads served on. Note*: Served category reports will be specific to the retailer while all other category report types will have standardized categories across brands and retailers.
`advProductCategory`	Campaign, Line-item	product category, product, attributedTransactions	Category of the product advertised.
`advProductId`	Campaign, Line-item	product, attributedTransactions	Advertised product ID; this references the same ID used in Catalogs
`advProductName`	Campaign, Line-item	product, attributedTransactions	Advertised product name
`brandId`	Campaign, Line-item	product	Advertised product brand ID
`brandName`	Campaign, Line-item	product	Advertised product brand name; names are standardized across retailers

Attributed Transactions Report Dimensions & Metrics

Note this report contains historical data, so you can always determine how each sale was attributed according to the data and rules enforced at the time.
Keep this in mind when comparing data against other reports - properties such as advProductCategory could drift as product categories may evolve.
All columns are available for both the campaign and line-item levels

📘
Help Center Article
For more details on attribution check out our Help Center articles

Attribution 101

Campaign Attribution Settings

Column Name	Column Type	Description	Example
`advDate`	Dimension	The date the ad was delivered	10/21/2022
`advHour`	Dimension	The hour the ad was delivered	16
`purchasedDate`	Dimension	The date the attributed product was purchased	2022
`purchasedHour`	Dimension	The hour the attributed product was purchased	10/21/2022
`daysDifference`	Dimension	The difference in hours divided by 24. The metric will display the number of days between when the ad was served and the attributed purchase occurred. Example: an 11pm ad leading to a 1 am sale the next day would have a 0 day difference*	2
`campaignId`	Dimension	Campaign ID of the requested report	1234567890
`campaignName`	Dimension	Campaign name of the request report	Fall Promotional Sale
`lineItemId`	Dimension	Line item ID of the requested report	10987654321
`lineItemName`	Dimension	Line item name of the requested report	Fall Sale - Camping Gear
`retailerName`	Dimension	Retailer name of the retailer the line item served on	Camping Shop
`pageTypeName`	Dimension	Retailer page type where the ad was served. Page types include: `home`, `search`, `productDetail`, `category`, `confirmation`, `checkout`, `merchandising`, `deals`	category
`keyword`	Dimension	Keyword or phrase used to land on the search page where an ad creative was rendered
`advProductId`	Dimension	Advertised product ID; this references the same ID used in Catalogs	426456
`advProductName`	Dimension	Advertised product name	Camping Jacket, W small
`advProductCategory`	Dimension	Category of product advertised; categories are standardized across brands and retailers, which may differ from retailer-specific categories	camping > clothing > women
`advProductGtin`	Dimension	Advertised product Global Trade Item Number (GTIN), if available; also known as European Article Number (EAN) or Universal Product Code (UPC)
`advProductMpn`	Dimension	Advertised product Manufacturer Part Number (MPN), if available
`purchasedProductId`	Dimension	Purchased product ID; this references the same ID used in Catalogs	426456
`purchasedProductName`	Dimension	Purchased product name
`purchasedProductCategory`	Dimension	Category of product purchased; categories are standardized across brands and retailers, which may differ from retailer-specific categories	Camping Jacket, W small
`purchasedProductGtin`	Dimension	Purchased product Global Trade Item Number (GTIN), if available; also known as European Article Number (EAN) or Universal Product Code (UPC)
`purchasedProductMpn`	Dimension	Purchased product Manufacturer Part Number (MPN), if available
`advEngagement`	Dimension	Type of ad engagement the purchase was attributed to. Available options are: `imp` for impression or `click` for clicks	click
`advToPurchasedProductRelationship`	Dimension	Attribution rule used to match the impression or click to a sale. Available options are: `same sku`, `same parent sku`, `same taxonomy`, `same brand`, `same seller`	same sku
`salesChannel`	Dimension	Sales channel the attributed purchase was made through. Available options are: `online` for sales attributed to an ad that was served and purchased online or in-app `offline` for sales to an ad that was served online but purchase in store. Note: Offline sales are available for certain retailers only. See moreSales Channels details in our help center*. Offline sales data is only available through our analytics api.	online
`attributionWindow`	Dimension	Lookback click and view attribution window of the requested report. The attribution window is based on the parameters selected in the report API request. See Get Started Post-Click (C) lookback window 7, 14, 30 days Post-view (V) lookback window 0, 1, 7, 14, 30 days Example: A `C14V07` means that the click attribution (C) window was 14 days and view (V) attribution window was 7 days. Note**: that the Post-View lookback window cannot be greater than the Post-Click lookback window.	C07V07
`attributedSales`	Metric	Sales revenue attributed to a click or impression	8.68
`attributedUnits`	Metric	Units sold attributed to a click or impression	1