> ## 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](/retail-media/docs/revenue-report-ssp): provides attributed performance data from campaigns.
* [Fill Rate Report](/retail-media/docs/fill-rate-report): provides summary of placement opportunities and impression filled and covered in retailer(s) inventory.

<Info>
  Please note that some of the metrics and dimensions listed here are currently supported only through the API.
</Info>

***

# Fill Rate Report

## Dimensions

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

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

  <tbody>
    <tr>
      <td>
        <p>
          <code>
            date
          </code>
        </p>
      </td>

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

    <tr>
      <td>
        <p>
          <code>
            retailerId
          </code>
        </p>
      </td>

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

          <code>
            id
          </code>

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

    <tr>
      <td>
        <p>
          <code>
            retailerName
          </code>
        </p>
      </td>

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

    <tr>
      <td>
        <p>
          <code>
            environment
          </code>
        </p>
      </td>

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

    <tr>
      <td>
        <p>
          <code>
            pageTypeName
          </code>
        </p>
      </td>

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

    <tr>
      <td>
        <p>
          <code>
            placementId
          </code>
        </p>
      </td>

      <td>
        <p>
          The

          <code>
            id
          </code>

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

    <tr>
      <td>
        <p>
          <code>
            placementName
          </code>
        </p>
      </td>

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

    <tr>
      <td>
        <p>
          <code>
            adServerType
          </code>
        </p>
      </td>

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

        <p>
          Value:

          <code>
            Criteo
          </code>

          and

          <code>
            GAM
          </code>
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <code>
            retailerCategoryId
          </code>
        </p>
      </td>

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

    <tr>
      <td>
        <p>
          <code>
            retailerCategoryName
          </code>
        </p>
      </td>

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

    <tr>
      <td>
        <p>
          <code>
            servedCategory
          </code>
        </p>
      </td>

      <td>
        <p>
          The category breadcrumb of the retailer page where ads are rendered
        </p>

        <p>
          Example: "*beauty and grooming > fragrances > deodorants > sprays > jive sprays > jive moon dream 9 piece body spray - for men & women*"
        </p>
      </td>
    </tr>
  </tbody>
</table>

***

## Metrics

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

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

  <tbody>
    <tr>
      <td>
        <p>
          <code>
            availablePlacements
          </code>
        </p>
      </td>

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

    <tr>
      <td>
        <p>
          <code>
            clicks
          </code>
        </p>
      </td>

      <td>
        <p>
          The total count of all click events
        </p>

        <p>
          <b>
            Formula
          </b>

          :

          <code>
            placementClicks
          </code>

          *

          <code>
            productClicks
          </code>
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <code>
            coverageRate
          </code>
        </p>
      </td>

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

    <tr>
      <td>
        <p>
          <code>
            coveredPlacements
          </code>
        </p>
      </td>

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

    <tr>
      <td>
        <p>
          <code>
            cpc
          </code>
        </p>
      </td>

      <td>
        <p>
          Average cost-per-click
        </p>

        <p>
          <b>
            Formula
          </b>

          :

          <code>
            openAuctionRevenue
          </code>

          /

          <code>
            clicks
          </code>

          or

          <code>
            preferredDealsRevenue
          </code>

          /

          <code>
            clicks
          </code>
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <code>
            cpm
          </code>
        </p>
      </td>

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

        <p>
          <b>
            Formula
          </b>

          :

          <code>
            preferredDealsRevenue
          </code>

          /

          <code>
            impressions
          </code>

          * 1000
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <code>
            deliverablePlacements
          </code>
        </p>
      </td>

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

    <tr>
      <td>
        <p>
          <code>
            fillRate
          </code>
        </p>
      </td>

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

        <p>
          <b>
            Formula
          </b>

          :

          <code>
            placementImpressions
          </code>

          /

          <code>
            deliverablePlacements
          </code>
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <code>
            impressions
          </code>
        </p>
      </td>

      <td>
        <p>
          An impression represents each time an ad renders on a page, regardless of clicks or views.
        </p>

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

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

        <p>
          An impression for a display banner ad is when the creative banner renders on the page.
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <code>
            netRevenue
          </code>
        </p>
      </td>

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

    <tr>
      <td>
        <p>
          <code>
            nonDeliverablePlacements
          </code>
        </p>
      </td>

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

    <tr>
      <td>
        <p>
          <code>
            pageViews
          </code>
        </p>
      </td>

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

          <code>
            pageTypeName
          </code>

          ,

          <code>
            placementId
          </code>

          or

          <code>
            placementName
          </code>

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

    <tr>
      <td>
        <p>
          <code>
            placementClicks
          </code>
        </p>
      </td>

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

    <tr>
      <td>
        <p>
          <code>
            placementImpressions
          </code>
        </p>
      </td>

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

    <tr>
      <td>
        <p>
          <code>
            placementImpressionsCTR
          </code>
        </p>
      </td>

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

        <p>
          <b>
            Formula
          </b>

          : (

          <code>
            placementClicks
          </code>

          *

          <code>
            productClicks
          </code>

          ) /

          <code>
            placementImpressions
          </code>
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <code>
            placementImpressionsRevenue
          </code>
        </p>
      </td>

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

    <tr>
      <td>
        <p>
          <code>
            placementsWithCandidates
          </code>
        </p>
      </td>

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

    <tr>
      <td>
        <p>
          <code>
            productClicks
          </code>
        </p>
      </td>

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

    <tr>
      <td>
        <p>
          <code>
            productClicksRevenue
          </code>
        </p>
      </td>

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

    <tr>
      <td>
        <p>
          <code>
            productImpressions
          </code>
        </p>
      </td>

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

    <tr>
      <td>
        <p>
          <code>
            productImpressionsCTR
          </code>
        </p>
      </td>

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

        <p>
          <b>
            Formula
          </b>

          :

          <code>
            productClicks
          </code>

          /

          <code>
            productImpressions
          </code>
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <code>
            revenue
          </code>
        </p>
      </td>

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

          <code>
            revenue
          </code>

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

          <code>
            openAuctionRevenue
          </code>

          and

          <code>
            preferredDealsRevenue
          </code>
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <code>
            unfilledPlacements
          </code>
        </p>
      </td>

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

    <tr>
      <td>
        <p>
          <code>
            workingMedia
          </code>
        </p>
      </td>

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

***

### Fill Rate Unfilled Reasons

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

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

  <tbody>
    <tr>
      <td>
        <p>
          <b>
            Uncovered
          </b>
        </p>
      </td>

      <td />
    </tr>

    <tr>
      <td>
        <p>
          <code>
            totalUnfilledPlacements
          </code>
        </p>
      </td>

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

    <tr>
      <td>
        <p>
          <code>
            unfilledNotEnoughDemand
          </code>
        </p>
      </td>

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

    <tr>
      <td>
        <p>
          <code>
            uncoveredBrokenPlacement
          </code>
        </p>
      </td>

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

    <tr>
      <td>
        <p>
          <code>
            uncoveredFilteredOutDemand
          </code>
        </p>
      </td>

      <td>
        <p>
          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,
        </p>

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

    <tr>
      <td>
        <p>
          <code>
            uncoveredNoDemandBrandedKeywordConquestingDisabled
          </code>
        </p>
      </td>

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

    <tr>
      <td>
        <p>
          <code>
            uncoveredNoDemandBrandedKeywordConquestingEnabled
          </code>
        </p>
      </td>

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

    <tr>
      <td>
        <p>
          <code>
            uncoveredNoDemandUnbrandedInventory
          </code>
        </p>
      </td>

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

    <tr>
      <td>
        <p>
          <code>
            uncoveredNotPainted
          </code>
        </p>
      </td>

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

    <tr>
      <td>
        <p>
          <code>
            uncoveredSearchTermWithoutCategory
          </code>
        </p>
      </td>

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

        <p>
          categorize.
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <b>
            Undeliverable
          </b>
        </p>
      </td>

      <td />
    </tr>

    <tr>
      <td>
        <p>
          <code>
            nondeliverableBlockedOptOut
          </code>
        </p>
      </td>

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

    <tr>
      <td>
        <p>
          <code>
            nonDeliverableBlockedPageCategory
          </code>
        </p>
      </td>

      <td>
        <p>
          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)
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <code>
            nonDeliverableInsufficientOrganicResults
          </code>
        </p>
      </td>

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

    <tr>
      <td>
        <p>
          <code>
            nonDeliverableTestPlacement
          </code>
        </p>
      </td>

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

    <tr>
      <td>
        <p>
          <code>
            nonDeliverableUnmappedCategories
          </code>
        </p>
      </td>

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

    <tr>
      <td>
        <p>
          <code>
            nonDeliverablePagesWithUnknownProducts
          </code>
        </p>
      </td>

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

***

<br />

## What's next

* [Fill Rate Report](/retail-media/docs/fill-rate-report)