Metrics and Dimensions (SSP)

In this page, you will find all the metrics and dimensions that are currently supported in the reports for Supply Side accounts

  • Revenue Report: providing attributed performance data from campaigns (available in stable versions)
  • Fill Rate Report: provides summary of placement opportunities and impression filled in retailer(s) environment (currently available in Preview only)
📘

The endpoints and functionalities covered in this page refers to features available exclusively in Preview for now, which doesn't mean that they are the only ones available for this domain/scope.

For more complete information about our API capabilities, check the Stable version in Welcome to Criteo Retail Media API

Please note that many of the metrics and dimensions listed here are currently supported only through the API.


Dimensions

Dimensions

Report Type

Description

date

Revenue
Fill Rate

The date of when reported activity took place occurred

hour

Revenue

The hour of the day when rendered ad received an event

parentAccount

Revenue

The associated account that is connected to the supply or demand account

accountId

Revenue

The computed and unique identifier of the supply or demand account

accountName

Revenue

The supply or demand account name

accountTypeName

Revenue

The 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

advertiserType

Revenue

The advertiser account type where the ad activity originated from. Options includes:

  • retailer - ad activity sold directly in the supply account
  • brand ad activity sold to a demand brand account in the Criteo network or through private market
  • seller ad activity sold to a demand seller account in the Criteo network or through private market

campaignId

Revenue

The computed unique campaign identifier of the demand or supply account that generated the activity

campaignName

Revenue

The campaign name of the demand or supply account that generated the activity

campaignTypeName

Revenue

The campaign type available. Available options are "Open Auction" or Preferred Deals"

campaignStartDate

Revenue

The start date set for the campaign

campaignEndDate

Revenue

The end date set for campaign

lineItemId

Revenue

The computed unique identifier of a line-item

lineItemName

Revenue

The line-item name provided by the advertiser

lineItemStartDate

Revenue

The start date set for the line-item

lineItemEndDate

Revenue

The end date set for the line-item

lineItemStatus

Revenue

The 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 Campaign & Line Item Status for more details on available values and their behaviors.

retailerId

Revenue
Fill Rate

The retailer ID that is associated with the report activities . This will be the same id provided in the API call

retailerName

Revenue
Fill Rate

The retailer name that is associated to the report activity.

brandId

Revenue

The brand ID provided by the retailer brand ID associated with the advertised SKU

brandName

Revenue

The retailer brand name associated with the advertised SKU

placementId

Revenue
Fill Rate

The id of the placement where the ad creative was displayed.

placementName

Revenue
Fill Rate

The name of the placement where the ad creative was displayed.

pageTypeName

Revenue
Fill Rate

The page type where the ad was rendered

environment

Revenue
Fill Rate

The environment where the ad was rendered on. Options will include web, mobile and app

soldBy

Revenue

The source of where activities originated from. Options will include "Direct Sold", "Indirect Sold" or "Private Market"

buyType

Revenue

The campaign buying strategy. Options will include auction, preferredDeals, or sponsorship

salesChannel

Revenue

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.

attributionSettings

Revenue

The 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

activityType

Revenue

The type of ad engagement the sale was attributed to. Available options will include imp for impressions or click for clicks

keyword

Revenue

Keyword or phrase used to land on the search page where an ad creative rendered.

servedCategory

Fill Rate

The category breadcrumb of the retailer page where ads are rendered

Example: "beauty and grooming > fragrances > deodorants > sprays > jive sprays > jive moon dream 9 piece body spray - for men & women"

  • *Note**: available in Preview only

skuRelation

Revenue

Attribution 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

advProductId

Revenue

Advertised product ID; this references the same product ID of the retailer Catalogs

advProductName

Revenue

Advertised product name

advProductGtin

Revenue

Advertised product GTIN

advProductMpn

Revenue

Advertised product MPN

pageCategory

Revenue

The category root level of retailer page where ads are rendered

Example: "jive moon dream 9 piece body spray - for men & women"

retailerCategoryId

Revenue
Fill Rate

The retailer category provides the type of product the SKU belongs to. This fields provides the id of that product type

retailerCategoryName

Revenue
Fill Rate

The name of that product type

taxonomyBreadcrumb

Revenue

The 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

Revenue

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

Revenue

The name SKU's taxonomy. If a SKU does not have an additional taxonomy level, the report will default to "unknown."


Metrics

Dimensions

Report Type

Description

numberOfCampaigns

Revenue

the total count of campaigns associated with the selected report dimension.

numberOfLineItems

Revenue

The total count of line-items associated with the selected report dimension.

numberOfSkus

Revenue

The total count of SKUs associated with the selected report dimension.

skuUnitPrice

Revenue

The 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.

pageViews

Revenue
Fill Rate

The 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.

impressions

Revenue
Fill Rate

An 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.

availablePlacements

Fill Rate

The number of available placements to fill.

  • *Note**: available in Preview only

unfilledPlacements

Fill Rate

The number of unfilled placements.

  • *Note**: available in Preview only

fillRate

Fill Rate

Percentage of placements that have been filled

  • *Formula**= placementImpressions / availablePlacements
  • *Note**: available in Preview only

placementImpressions

Fill Rate

The number of placement impressions.

  • *Note**: available in Preview only

productImpressions

Fill Rate

The number of filled product impressions.

  • *Note**: available in Preview only

productClicks

Revenue
Fill Rate

Total count of the click events that occur when a user clicks a product in a placement

placementClicks

Revenue
Fill Rate

Total count of the click events that occur when a user clicks a placement

clicks

Revenue
Fill Rate

The total count of all click events

  • *Formula**: placementClicks + productClicks

sales

Revenue

The total attributed revenue from product sales

units

Revenue

The total attributed product units sold

assistedSales

Revenue

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).

assistedUnits

Revenue

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

openAuctionRevenue

Revenue

The total amount of open auction revenue generated on the set date

preferredDealsRevenue

Revenue

The total amount of preferred deals revenue generated on the set date

revenue

Revenue
Fill Rate

The total revenue generated on the set date. The revenue metric take the total revenue generated across preferred deals or auction campaigns for that period and is computed the same way as the openAuctionRevenue and preferredDealsRevenue.

transactions

Revenue

The total attributed orders/transactions

ctr

Revenue

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

cr

Revenue

The number of conversion generated by the visitors to the retailer site.

  • *Formula**: number of conversions / clicks * 100

cpc

Revenue
Fill Rate

Average cost-per-click, calculated by:

  • *Formula**: openAuctionRevenue / clicks or preferredDealsRevenue / clicks

cpm

Revenue
Fill Rate

Average cost per mille, calculated by:

  • *Formula**: preferredDealsRevenue / impressions * 1000

roas

Revenue

Return-on-ad-spend (ROAS), calculated by:

  • *Formula**: sales / openAuctionRevenue or sales / preferredDealsRevenue

placementImpressionsCTR

Fill Rate

The percentage of shoppers who clicked an ad placement rendered on a page

  • *Formula**: (placementClicks + productClicks) / placementImpressions
  • *Note**: available in Preview only

productImpressionsCTR

Fill Rate

The percent of shoppers who clicked on a product rendered on a placement

  • *Formula**: productClicks / productImpressions
  • *Note**: available in Preview only

workingMedia

Revenue
Fill Rate

The total spend paid by the brand

netRevenue

Revenue
Fill Rate

The total revenue from brand spend for the retailer

placementImpressionsRevenue

Fill Rate

The total revenue generated by placement impressions of CPM ads

  • *Note**: available in Preview only

productClicksRevenue

Fill Rate

The total revenue generated by product clicks of CPC ads

  • *Note**: available in Preview only

uniqueVisitors

Revenue
Fill Rate

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.

frequency

Revenue
Fill Rate

An average representing how often an impression has been shown to the same user