GuidesAPI ReferenceChangelog
GuidesAPI ReferenceChangelogLog In

Metrics and Dimensions (SSP)

In this page you will find all the metrics and dimensions that are currently support with the Revenue Report. Please note that many of the metrics and dimensions listed here are currently supported only through the API.

Dimensions

DimensionsDescription
dateThe date of when reported activity took place occurred
hourThe hour of the day when rendered ad received an event
parentAccountThe associated account that is connected to the supply or demand account
accountIdThe computed and unique identifier of the supply or demand account
accountNameThe supply or demand account name
accountTypeNameThe account type of the reported activity. Options will include:
- "Demand" for revenue generated from an indirect sold or private market demand account.
- "Supply" - revenue was generated from direct sold campaigns
campaignIdThe computed unique campaign identifier of the demand or supply account that generated the activity
campaignNameThe campaign name of the demand or supply account that generated the activity
campaignTypeNameThe campaign type available. Available options are "Open Auction" or Preferred Deals"
campaignStartDateThe start date set for the campaign
campaignEndDateThe end date set for campaign
lineItemIdThe computed unique identifier of a line-item
lineItemNameThe line-item name provided by the advertiser
lineItemStartDateThe start date set for the line-item
lineItemEndDateThe end date set for the line-item
lineItemStatusThe status of the line-item associated with the selected dimension, such as the date or hour indicating of when the event took place. Check out the Statuses page for more details on available values and their behaviors.
retailerIdThe retailer ID that is associated with the report activities . This will be the same id provided in the API call
retailerNameThe retailer name that is associated to the report activity.
brandIdThe brand ID provided by the retailer brand ID associated with the advertised SKU
brandNameThe retailer brand name associated with the advertised SKU
placementIdThe id of the placement where the ad creative was displayed.
placementNameThe name of the placement where the ad creative was displayed.
pageTypeNameThe page type where the ad was rendered
environmentThe environment where the ad was rendered on. Options will include web, mobile and app
soldByThe source of where activities originated from. Options will include "Direct Sold", "Indirect Sold" or "Private Market"
salesChannelSales 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.
attributionSettingsThe lookback click and view attribution window of the requested report. The attribution window is based on the parameters selected in the report API request. The attributedSettingsfield will be based on the lookback windows provided in the API call.

Post-Click (C) lookback window
none, 7, 14, 30 days

Post-view (V) lookback window
none, 1, 7, 14, 30 days
activityTypeThe type of ad engagement the sale was attributed to. Available options will include imp for impressions or click for clicks
keywordKeyword or phrase used to land on the search page where an ad creative rendered.
skuRelationAttribution rule used to match the impression or click to a sale. Available options are: Same SKU, Same Parent SKU, Same Category, Same Brand or Same Seller
advProductIdAdvertised product ID; this references the same product ID of the retailer Catalogs
advProductNameAdvertised product name
advProductGtinAdvertised product GTIN
advProductMpnAdvertised product MPN
pageCategoryThe retailer defined category of the page where ads are rendered
retailerCategoryIdThe retailer category provides the type of product the SKU belongs to. This fields provides the id of that product type
retailerCategoryNameThe name of that product type
taxonomyBreadcrumbThe category breadcrumb of the product using retailer product taxonomies (L1, L2 L3 etc.). This is for analysis where SKUs are present in the displays
taxonomy1Id
taxonomy2Id
taxonomy3Id
taxonomy4Id
taxonomy5Id
taxonomy6Id
taxonomy7Id
The ID SKU's taxonomy. The revenue report provides the option to select level 1 through level 7.

ℹ️ Note: SKUs will normally have at least the primary sku taxonomy (L1). All following levels are considered additional taxonomies. If a SKU does not have an additional taxonomy level, the report will default to "unknown."
taxonomy1Name
taxonomy2Name
taxonomy3Name
taxonomy4Name
taxonomy5Name
taxonomy6Name
taxonomy7Name
The name SKU's taxonomy. If a SKU does not have an additional taxonomy level, the report will default to "unknown."

Metrics

DimensionsDescription
numberOfCampaignsthe total count of campaigns associated with the selected report dimension.
numberOfLineItemsThe total count of line-items associated with the selected report dimension.
numberOfSkusThe total count of skus associated with the selected report dimension.
skuUnitPriceThe total price of each SKU unit.

Note: It is recommended to utilize metrics such as advProductId, advProductGtin, and advProductMpn to access individual SKU prices. However, when considering other dimensions at the line-item, campaign, or account level, the sum of all SKU prices will be calculated.
pageViewsThe count of unique ad calls on a retailer network. Use this metric when referencing to dimensions that relates to itself to receive a more comprehensive data. Using dimensions such as pageTypeName, placementIdor placementNamewill provide you data to understand the performance of this metric.
impressionsAn impression represents each time an ad renders on a page, regardless of clicks or views.

An impression for a Sponsored Product ad is when the sponsored SKU renders on the page (the product being the ad).

An impression for a Commerce Display ad is when the entire banner (creative + product) renders on the page.

An impression for a Display banner ad is when the creative banner renders on the page.
productClicksTotal count of the click events that occur when a user clicks a product in a placement
placementClicksTotal count of the click events that occur when a user clicks a placement
clicksThe total count of all click events
Formula: placementClicks + productClicks
salesThe total attributed revenue from product sales
unitsThe total attributed product units sold
assitedSalesSales 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).
assistedUnitsThe 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
openAuctionRevenueThe total amount of open auction revenue generated on the set date
preferredDealsRevenueThe total amount of preferred deals revenue generated on the set date
transactionsThe total total attributed orders/transactions
ctrThe 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
crThe number of conversion generated by the visitors to the retailer site.

Formula: number of conversions / clicks * 100
cpcAverage cost-per-click calculated by dividing openAuctionRevenue / clicks or preferredDealsRevenue / clicks
cpmAverage cost per mille calculated by diving preferredDealsRevenue / impressions * 1000
roasReturn-on-ad-spend (ROAS), calculated by dividing sales / openAuctionRevenue or sales / preferredDealsRevenue
workingMediaThe total spend paid by the brand
netRevenueThe total revenue from brand spend for the retailer
uniqueVisitorsThe 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.
frequencyAn average representing how often an impression has been shown to the same user