Metrics and Dimensions

Report Metrics

Most metrics are available for every report type, with some exceptions to assistedSales and assistedUnits which apply only to Line Item reports
The attributed Transactions report only has two metrics: attributedSales and attributedUnits

Metric	Report Level	Report Types	Description
`impressions`	Campaign, Line-item	summary, pageType, keyword, product category, product	Report Types:* Campaign reports 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 Report Types:* Line Item reports 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 Report Types: *Product and Product Category 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
`clicks`	Campaign, Line-item	summary, pageType, keyword, product category, product	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	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	Sales revenue attributed to a click or impression, exclusive of `assistedSales`
`attributedUnits`	Campaign, Line-item	summary, pageType, keyword, product category, product, attributedTransactions	Units sold attributed to a click or impression, exclusive of.`assistedUnits`
`attributedOrders`	Campaign, Line-item	summary, pageType, keyword, product category, product	Orders (or transactions) attributed to a click or impression
`ctr`	Campaign, Line-item	summary, pageType, keyword, product category, product	Click-through-rate (CTR), calculated by dividing `clicks` by `productImpressions` for Product and Product Category report types; for all other report types, the appropriate `placementImpressions` is used instead
`cpc`	Campaign, Line-item	summary, pageType, keyword, product category, product	Cost-per-click (CPC), calculated by dividing `spend` by `clicks`; inclusive of platform fees
`roas`	Campaign, Line-item	summary, pageType, keyword, product category, product	Return-on-ad-spend (ROAS), calculated by dividing `attributedSales` by `spend`; inclusive of platform fees
`cpo`	Campaign, Line-item	summary, pageType, keyword, product category, product	Cost-per-order (CPO), calculated by dividing`spend` by `attributedOrders`; inclusive of platform fees
`assistedSales`	Line-item	summary, pageType, keyword, product category, product	Sales revenue attributed to a click or impression on the path to purchase leading to the sale, exclusive of `attributedSales`
`assistedUnits`	Line-item	summary, pageType, keyword, product category, product	Units sold attributed to a click or impression on the path to purchase leading to the sale; `attributedUnits`
`uniqueVisitors`	Campaign, Line-item	summary	Number of unique visitors an impression painted for
`frequency`	Campaign, Line-item	summary	An average representing how often an impression has been painted for the same user

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	Date based on the requested time zone
`campaignId`	Campaign, Line-item	summary, pageType, keyword, product category, product, attributedTransactions	Campaign ID of the requested report
`campaignName`	Campaign, Line-item	summary, pageType, keyword, product category, product, attributedTransactions	Campaign name of the request report
`campaignTypeName`	Campaign, Line-item	summary, pageType, keyword, product category, product, attributedTransactions	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	Line item ID of the requested report
`lineItemName`	Line-item	summary, pageType, keyword, product category, product, attributedTransactions	Line item name of the requested report
`retailerId`	Line-item	summary, pageType, keyword, product category, product	Retailer ID of the retailer of the line item served on.
`retailerName`	Line-item	summary, pageType, keyword, product category, product, attributedTransactions	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, such as home page, browse pages, search pages, product detail pages, checkout pages, etc.
`keyword`	Campaign, Line-item	keyword	Keyword or phrase used to land on the search page where an ad creative rendered.
`advProductCategory`	Campaign, Line-item	product category, product, attributedTransactions	Category of the product advertised; categories are standardized across brands and retailers, which may differ from retailer-specific categories.
`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
Learn more about our Attribution Rules in CMax Help Center

Column Name	Column Type	Description	Example
`advDate`	Dimension	Date of advertisement	10/21/2022
`advHour`	Dimension	Hour of advertisement	16
`purchasedDate`	Dimension	Date of the attributed product purchase	2022
`purchasedHour`	Dimension	Hour of the attributed product purchase	10/21/2022
`daysDifference`	Dimension	Days between advertisement and purchase	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	Type of retailer web page an ad creative rendered on, such as home page, browse pages, search pages, product detail pages, checkout pages etc.	category
`keyword`	Dimension	Keyword or phrase used to land on the search page where an ad creative 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	click
`advToPurchasedProductRelationship`	Dimension	Attribution rule used to match the impression or click to a sale	same sku
`salesChannel`	Dimension	Sales channel the attributed purchase was made through	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