Criteo V2021 Walkthrough
  • 13 Apr 2021
  • 2 Minutes to read
  • Dark
    Light
  • PDF

Criteo V2021 Walkthrough

  • Dark
    Light
  • PDF

The Criteo V1 version is going to be deprecated on June 15th, 2021. Therefore, all Criteo’s rivers should be migrated to the new Criteo Marketing API of the v2021 version that has the following changes:

Reports:

* The Campaign Performance report is now renamed to Statistics.

* A Transaction report has been added.

* The Categories report will not be available for the new version.

* Budget is now a property of an Ad Set (Under the Campaigns report).

More information regarding endpoints changes can be found here

Main Changes for Statistics (former Campaign Performance) Report:

* The maximum number of returned rows per request is limited to 100,000. As a result, you may need to fetch highly granular data by using smaller interval chunks.

* New dimensions were added: Device, Os, Category.

* Campaign dimension has been renamed to Adset.

* CampaignId dimension has been renamed to AdsetId.

More information regarding Statistics report changes can be found here


This guide will show you how to get the data from Criteo into Rivery.

Prerequisites

Criteo Reports in Rivery

  1. Make sure to select the correct Criteo connection. Change it or create a new one if necessary.
  2. Select a report in the 'Report' input:

  3. Reports Filters - Filter the report by Advertisers (leave this filter empty for getting a report for all Advertisers):


Campaigns Performance Report:


Reports' Time Period

Select the time period of the report: 

All the reports support two kinds of the time period:  

  •  Date Range      
    • Pulls data in the date range between the start and end date provided, including the end date.
    •  You must select a start date.
    • Leaving the end date empty will pull data according to the current time of the river's run.
    • Select a timezone offset to send dates considering the offset.
    • Use the "Last Days Back For Each Run" to expend the start date and pull data a given number of days back before the chosen start date.
  •  Predefined date  - A date range defined by Rivery:
    • Day - Yesterday.
    • Week (From Monday to Sunday) - Week to date, Previous week, Previous week to date.
    • Month - Month to date, Previous month, Previous month to date.
    • Year - Year to date.


Interval Chunks

Rivery can run over the increment using chunks, in order to make the loading more efficient and more precise. You can choose from:

  • Don't Split - Rivery will pull the data from the chosen start date to the end date in one bulk.
  • Daily - The run will be chunked daily from the start to the end date.
  • Monthly - The run will be chunked monthly from the start to the end date.
  • Yearly (Less Recommended) -  The run will be chunked yearly from the start to the end date.

Interval Size - Set the size of each interval.  

For example - setting the Interval Size to 4 with a Daily Interval Chunk will split the date period into 4 days chunks. Running from the 01/01/2020 until the 08/01/2020 will be split to two intervals: from the 01/01/2020 until the 04/01/2020 and from the 05/01/2020 until the 08/01/2020.


Was this article helpful?