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

# v2022.04 Release Notes

Documentation for the latest version of the Retail Media API is now live! See what's new in v2022.04

<Info>
  **Version 2022.04 of the Criteo API is live as of April 5th, 2022. This version will be supported until **April 4th, 2023****
</Info>

This version introduces several new capabilities to Criteo Retail Media API and introduces changes in previously existing endpoints. This page aims at listing all changes that happened endpoint per endpoint. Only endpoints with changes are listed here.

## New Base URL

We are moving from:\
`https://api.criteo.com/2021-10/retail-media/{endpoint}`\
to\
`https://api.criteo.com/2022-04/retail-media/{endpoint}`

## What's New in v2022.04

🆕 **New Capability to Pause or Unpause the Serving of an SKU**

In this new version, we have introduced two new endpoints that allow to pause or unpause products belonging to a line item. The new endpoints also provide the option to apply a bid override. The new endpoints include

```text theme={null}
POST - https://api.criteo.com/2022-04/retail-media/line-items/{lineItemId}/products/pause
POST - https://api.criteo.com/2022-04/retail-media/line-items/{lineItemId}/products/unpause
```

* See the [Line item endpoints guide](/retail-media/docs/promoted-products) for more details

📊 **Updates Made to Report Field Names, and Metric Calculations**

<ins>Metric Calculation Changes</ins>\
We changed impression calculation for preferred deals and open auction campaigns. These changes in the API are now reflecting the same reporting logic for impressions used by reports within the Retail Media Platform.

For the following reports, the API will report impressions as follows:

* For Preferred Deals campaigns - the sum of *placement* impressions
* For Open Auction campaigns - the sum of *product* impressions

**Summary Report**\
Metrics changed by impression calculation change:\
\-  Campaign: *CampaignCtr and CampaignFrequency*\
\- Line Item: *lineItemCtr and lineItemFrequency*

**pageType Report**\
Metrics changed by impression calculation change:\
\-  Campaign: *CampaignCtr*\
\- Line Item: *lineItemCtr*

**Keyword Report**\
Metrics changed by impression calculation change:\
\-  Campaign: *CampaignCtr and CampaignFrequency*\
\- Line Item: *lineItemCtr and lineItemFrequency*

<ins>Report Field Names</ins>\
In this version, we also updated some report field names. For example, in previous versions where the reports fields such as  *productCPC* or *productRoas*, in the latest version, we renamed to simply CPC or ROAS.

<Info>
  **NOTE**

  Besides metrics that utilize impressions for calculations, no other report metric had its calculation logic modified.
</Info>

**Campaing Reports**

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

      <th />

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

  <tbody>
    <tr>
      <td>
        <p>
          Product
        </p>
      </td>

      <td>
        <ul>
          <li>
            productClicks
          </li>

          <li>
            productImpressions
          </li>

          <li>
            productCtr
          </li>

          <li>
            productCpc
          </li>

          <li>
            productCpo
          </li>

          <li>
            productRoas
          </li>

          <li>
            clickSpend
          </li>
        </ul>
      </td>

      <td>
        <ul>
          <li>
            clicks
          </li>

          <li>
            impressions
          </li>

          <li>
            ctr
          </li>

          <li>
            cpc
          </li>

          <li>
            cpo
          </li>

          <li>
            roas
          </li>

          <li>
            spend
          </li>
        </ul>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          ProductCategory
        </p>
      </td>

      <td>
        <ul>
          <li>
            productClicks
          </li>

          <li>
            productImpressions
          </li>

          <li>
            productCtr
          </li>

          <li>
            productCpc
          </li>

          <li>
            productCpo
          </li>

          <li>
            productRoas
          </li>

          <li>
            clickSpend
          </li>
        </ul>
      </td>

      <td>
        <ul>
          <li>
            clicks
          </li>

          <li>
            impressions
          </li>

          <li>
            ctr
          </li>

          <li>
            cpc
          </li>

          <li>
            cpo
          </li>

          <li>
            roas
          </li>

          <li>
            spend
          </li>
        </ul>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          Summary
        </p>
      </td>

      <td>
        <ul>
          <li>
            campaignPlacementImpressions
          </li>

          <li>
            campaignCtr
          </li>
        </ul>
      </td>

      <td>
        <ul>
          <li>
            impressions
          </li>

          <li>
            ctr
          </li>
        </ul>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          Page Type
        </p>
      </td>

      <td>
        <ul>
          <li>
            campaignCtr
          </li>

          <li>
            campaignFrequency
          </li>

          <li>
            campaignPlacementImpressions
          </li>
        </ul>
      </td>

      <td>
        <ul>
          <li>
            ctr
          </li>

          <li>
            frequency
          </li>

          <li>
            impressions
          </li>
        </ul>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          keyword
        </p>
      </td>

      <td>
        <ul>
          <li>
            CampaignPlacementImpressions
          </li>

          <li>
            campaignCtr
          </li>
        </ul>
      </td>

      <td>
        <ul>
          <li>
            impressions
          </li>

          <li>
            ctr
          </li>
        </ul>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          attributedTransactions
        </p>
      </td>

      <td>
        <p>
          No Change
        </p>
      </td>

      <td>
        <p>
          No Change
        </p>
      </td>
    </tr>
  </tbody>
</table>

**Line Item Reports**

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

      <th>
        <p>
          Old Field Name
        </p>
      </th>

      <th>
        <p>
          New Field Name in v2022.04
        </p>
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        <p>
          Product
        </p>
      </td>

      <td>
        <ul>
          <li>
            productClicks
          </li>

          <li>
            productImpressions
          </li>

          <li>
            productCtr
          </li>

          <li>
            productCpc
          </li>

          <li>
            productCpo
          </li>

          <li>
            productRoas
          </li>

          <li>
            clickSpend
          </li>
        </ul>
      </td>

      <td>
        <ul>
          <li>
            clicks
          </li>

          <li>
            impressions
          </li>

          <li>
            ctr
          </li>

          <li>
            cpc
          </li>

          <li>
            cpo
          </li>

          <li>
            roas
          </li>

          <li>
            spend
          </li>
        </ul>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          ProductCategory
        </p>
      </td>

      <td>
        <ul>
          <li>
            productClicks
          </li>

          <li>
            productImpressions
          </li>

          <li>
            productCtr
          </li>

          <li>
            productCpc
          </li>

          <li>
            productCpo
          </li>

          <li>
            productRoas
          </li>

          <li>
            clickSpend
          </li>
        </ul>
      </td>

      <td>
        <ul>
          <li>
            clicks
          </li>

          <li>
            impressions
          </li>

          <li>
            ctr
          </li>

          <li>
            cpc
          </li>

          <li>
            cpo
          </li>

          <li>
            roas
          </li>

          <li>
            spend
          </li>
        </ul>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          Summary
        </p>
      </td>

      <td>
        <ul>
          <li>
            lineItemPlacementImpressions
          </li>

          <li>
            lineItemFrequency
          </li>

          <li>
            lineItemCtr
          </li>
        </ul>
      </td>

      <td>
        <ul>
          <li>
            impressions
          </li>

          <li>
            frequency
          </li>

          <li>
            ctr
          </li>
        </ul>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          PageType
        </p>
      </td>

      <td>
        <ul>
          <li>
            lineItemPlacementImpressions
          </li>

          <li>
            lineItemCtr
          </li>
        </ul>
      </td>

      <td>
        <ul>
          <li>
            impressions
          </li>
        </ul>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          keyword
        </p>
      </td>

      <td>
        <ul>
          <li>
            lineItemPlacementImpressions
          </li>

          <li>
            lineItemCtr
          </li>
        </ul>
      </td>

      <td>
        <ul>
          <li>
            impressions
          </li>
        </ul>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          attributedTransactions
        </p>
      </td>

      <td>
        <p>
          No Changes
        </p>
      </td>

      <td>
        <p>
          No Changes
        </p>
      </td>
    </tr>
  </tbody>
</table>