> ## Documentation Index
> Fetch the complete documentation index at: https://developers.criteo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Metrics & Dimensions (Fill Rate Report)

## Introduction

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

* [Revenue Report](https://developers.criteo.com/retail-media/docs/revenue-report-ssp.md): provides attributed performance data from campaigns.
* [Fill Rate Report](https://developers.criteo.com/retail-media/experimental/docs/fill-rate-report.md): provides summary of placement opportunities and impression filled and covered in retailer(s) inventory.

> [!NOTE]
>
> Please note that some of the metrics and dimensions listed here are currently supported only through the API.

***

# Fill Rate Report

## Dimensions

<table>
  <thead>
    <tr>
      <th>
        Dimensions
      </th>

      <th>
        Description
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        `date`
      </td>

      <td>
        The date of when reported activity took place occurred
      </td>
    </tr>

    <tr>
      <td>
        `retailerId`
      </td>

      <td>
        The retailer ID that is associated with the report activities. This will be the same

        `id`

        provided in the API call
      </td>
    </tr>

    <tr>
      <td>
        `retailerName`
      </td>

      <td>
        The retailer name that is associated to the report activity.
      </td>
    </tr>

    <tr>
      <td>
        `environment`
      </td>

      <td>
        The environment where the ad was rendered on. Options will include web, mobile and app
      </td>
    </tr>

    <tr>
      <td>
        `pageTypeName`
      </td>

      <td>
        The page type where the ad was rendered
      </td>
    </tr>

    <tr>
      <td>
        `placementId`
      </td>

      <td>
        The

        `id`

        of the placement where the ad creative was displayed.
      </td>
    </tr>

    <tr>
      <td>
        `placementName`
      </td>

      <td>
        The name of the placement where the ad creative was displayed.
      </td>
    </tr>

    <tr>
      <td>
        `adServerType`
      </td>

      <td>
        The ad server where the ad was rendered on.

        Value:

        `Criteo`

        and

        `GAM`
      </td>
    </tr>

    <tr>
      <td>
        `retailerCategoryId`
      </td>

      <td>
        The retailer category provides the type of product the SKU belongs to. This field provides the ID of that product type.
      </td>
    </tr>

    <tr>
      <td>
        `retailerCategoryName`
      </td>

      <td>
        The name of that product type
      </td>
    </tr>

    <tr>
      <td>
        `servedCategory`
      </td>

      <td>
        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*"
      </td>
    </tr>
  </tbody>
</table>

***

## Metrics

<table>
  <thead>
    <tr>
      <th>
        Dimensions
      </th>

      <th>
        Description
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        `availablePlacements`
      </td>

      <td>
        The number of available placements that were available to fill, including non-deliverable and deliverable placements.
      </td>
    </tr>

    <tr>
      <td>
        `clicks`
      </td>

      <td>
        The total count of all click events

        **Formula**

        :

        `placementClicks`

        *

        `productClicks`
      </td>
    </tr>

    <tr>
      <td>
        `coverageRate`
      </td>

      <td>
        The number of covered placements divided by the number of deliverable placements
      </td>
    </tr>

    <tr>
      <td>
        `coveredPlacements`
      </td>

      <td>
        A placement with candidates where Criteo has provided SKUs or line-items in the ad response
      </td>
    </tr>

    <tr>
      <td>
        `coveredSlots`
      </td>

      <td>
        Sum of the ads returned across all deliverable placements.
      </td>
    </tr>

    <tr>
      <td>
        `cpc`
      </td>

      <td>
        Average cost-per-click

        **Formula**

        :

        `openAuctionRevenue`

        /

        `clicks`

        or

        `preferredDealsRevenue`

        /

        `clicks`
      </td>
    </tr>

    <tr>
      <td>
        `cpm`
      </td>

      <td>
        Average cost per *mille*, calculated by:

        **Formula**

        :

        `preferredDealsRevenue`

        /

        `impressions`

        * 1000
      </td>
    </tr>

    <tr>
      <td>
        `deliverablePlacements`
      </td>

      <td>
        Available placement that the retailer allowed Criteo to run an auction for
      </td>
    </tr>

    <tr>
      <td>
        `deliverableSlotsInferred`
      </td>

      <td>
        Inferred number of paintable slots across all deliverable placements.

        **Formula**

        :

        `deliverablePlacements`

        x

        `inferredMaxPaintableAds`

        `inferredMaxPaintableAds` is the inferred number of slots in a placement: the maximum product impressions observed for that placement over a rolling 24-hour window. It is modeled from observed impressions, not a directly logged signal. The value returned is the overall total across deliverable placements, not a per-placement value.
      </td>
    </tr>

    <tr>
      <td>
        `fillRate`
      </td>

      <td>
        The number of times a deliverable placement on a page was populated with an ad (even if the impression was not viewable). Calculated by dividing the placement impressions by deliverable placements.

        **Formula**

        :

        `placementImpressions`

        /

        `deliverablePlacements`
      </td>
    </tr>

    <tr>
      <td>
        `impressions`
      </td>

      <td>
        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.
      </td>
    </tr>

    <tr>
      <td>
        `netRevenue`
      </td>

      <td>
        The total revenue from brand spend for the retailer
      </td>
    </tr>

    <tr>
      <td>
        `nonDeliverablePlacements`
      </td>

      <td>
        A non-deliverable placement is a placement against which Criteo is not allowed by the retailer to run an auction.
      </td>
    </tr>

    <tr>
      <td>
        `pageViews`
      </td>

      <td>
        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`

        ,

        `placementId`

        or

        `placementName`

        will provide you data to understand the performance of this metric.
      </td>
    </tr>

    <tr>
      <td>
        `placementClicks`
      </td>

      <td>
        Total count of the click events that occur when a user clicks a placement
      </td>
    </tr>

    <tr>
      <td>
        `placementImpressions`
      </td>

      <td>
        The number of placement impressions.
      </td>
    </tr>

    <tr>
      <td>
        `placementImpressionsCTR`
      </td>

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

        **Formula**

        : (

        `placementClicks`

        *

        `productClicks`

        ) /

        `placementImpressions`
      </td>
    </tr>

    <tr>
      <td>
        `placementImpressionsRevenue`
      </td>

      <td>
        The total revenue generated by placement impressions of CPM ads
      </td>
    </tr>

    <tr>
      <td>
        `placementsWithCandidates`
      </td>

      <td>
        A placement with candidates is a placement for which Criteo is allowed by the retailer to run an auction and has sufficient information and demand to run it.
      </td>
    </tr>

    <tr>
      <td>
        `productClicks`
      </td>

      <td>
        Total count of the click events that occur when a user clicks a product in a placement
      </td>
    </tr>

    <tr>
      <td>
        `productClicksRevenue`
      </td>

      <td>
        The total revenue generated by product clicks of CPC ads
      </td>
    </tr>

    <tr>
      <td>
        `productImpressions`
      </td>

      <td>
        The number of filled product impressions
      </td>
    </tr>

    <tr>
      <td>
        `productImpressionsCTR`
      </td>

      <td>
        The number of clicks divided by the number of product impressions

        **Formula**

        :

        `productClicks`

        /

        `productImpressions`
      </td>
    </tr>

    <tr>
      <td>
        `revenue`
      </td>

      <td>
        The total revenue generated on the set date. The

        `revenue`

        metric takes the total revenue generated across preferred deals or auction campaigns for that period and is computed the same way as the

        `openAuctionRevenue`

        and

        `preferredDealsRevenue`
      </td>
    </tr>

    <tr>
      <td>
        `unfilledPlacements`
      </td>

      <td>
        The number of unfilled placements
      </td>
    </tr>

    <tr>
      <td>
        `workingMedia`
      </td>

      <td>
        The total spend paid by the brand
      </td>
    </tr>
  </tbody>
</table>

***

### Fill Rate Unfilled Reasons

<table>
  <thead>
    <tr>
      <th>
        Reason
      </th>

      <th>
        Definition
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        **Uncovered**
      </td>

      <td />
    </tr>

    <tr>
      <td>
        `totalUnfilledPlacements`
      </td>

      <td>
        The number of available ad placements that did not serve any impressions.
      </td>
    </tr>

    <tr>
      <td>
        `unfilledNotEnoughDemand`
      </td>

      <td>
        There is not enough line items eligible to the placement for run of site placements.
      </td>
    </tr>

    <tr>
      <td>
        `uncoveredBrokenPlacement`
      </td>

      <td>
        Ads returned to the retailer, but on placements that the retailer rarely paints. If a placement has a painted rate of less than 1% over the last 7 days, it can be considered as broken.
      </td>
    </tr>

    <tr>
      <td>
        `uncoveredFilteredOutDemand`
      </td>

      <td>
        Filtering reasons are the set of reasons for which line items can and will be excluded from pre-auctions, which decreases the number of ad opportunities overall. Filtering reasons may be of technical, supply, or demand nature (out of stock, dayparting,

        audience targeting, capping…)
      </td>
    </tr>

    <tr>
      <td>
        `uncoveredNoDemandBrandedKeywordConquestingDisabled`
      </td>

      <td>
        Available opportunities without candidate campaigns, that happen on branded keywords on retailers that disabled [conquesting](https://help.cyield.criteo.com/kb/guide/en/introduction-to-sponsored-product-monetization-AxSEWMrrWZ/Steps/3358079,4578439) (on that particular placement). No demand on branded keyword conquesting disabled
      </td>
    </tr>

    <tr>
      <td>
        `uncoveredNoDemandBrandedKeywordConquestingEnabled`
      </td>

      <td>
        Available opportunities without candidate campaigns, that happen on branded keywords on retailers that enabled [conquesting](https://help.cyield.criteo.com/kb/guide/en/introduction-to-sponsored-product-monetization-AxSEWMrrWZ/Steps/3358079,4578439) (on that particular placement)
      </td>
    </tr>

    <tr>
      <td>
        `uncoveredNoDemandUnbrandedInventory`
      </td>

      <td>
        Ad placements available on general (non-branded) inventory, but no campaigns are set up to use them
      </td>
    </tr>

    <tr>
      <td>
        `uncoveredNotPainted`
      </td>

      <td>
        Ads returned to the retailer but not displayed (on placements that aren't broken).
      </td>
    </tr>

    <tr>
      <td>
        `uncoveredSearchTermWithoutCategory`
      </td>

      <td>
        Ad placements on keywords that the keyword model cannot

        categorize.
      </td>
    </tr>

    <tr>
      <td>
        **Undeliverable**
      </td>

      <td />
    </tr>

    <tr>
      <td>
        `nondeliverableBlockedOptOut`
      </td>

      <td>
        Ad placements for opt-out users that are not delivering because you have not enabled ads for these users
      </td>
    </tr>

    <tr>
      <td>
        `nonDeliverableBlockedPageCategory`
      </td>

      <td>
        Ad placements on pages where you have blocked Criteo from running auctions (e.g., some categories on which you do not want any ads to be served)
      </td>
    </tr>

    <tr>
      <td>
        `nonDeliverableInsufficientOrganicResults`
      </td>

      <td>
        Ad placements where the page does not have enough organic results to display ads. For example, if an ad is meant to appear on line 5 but fewer than 5 lines of products exist.
      </td>
    </tr>

    <tr>
      <td>
        `nonDeliverableTestPlacement`
      </td>

      <td>
        These are ad placements that are still in testing and not fully enabled.
      </td>
    </tr>

    <tr>
      <td>
        `nonDeliverableUnmappedCategories`
      </td>

      <td>
        Ad placements on category and merchandising pages that aren't deliverable because their category keys are missing from the retailer’s product feed.
      </td>
    </tr>

    <tr>
      <td>
        `nonDeliverablePagesWithUnknownProducts`
      </td>

      <td>
        Product pages where items can't be identified in the retailer's product feed.
      </td>
    </tr>
  </tbody>
</table>

***

## What's next

* [Fill Rate Report](https://developers.criteo.com/retail-media/experimental/docs/fill-rate-report.md)
