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 dividingspend 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