logo

Before you begin

Make sure you have Admin rights for the Criteo Account:
  1. Go to https://partners.criteo.com/.
  1. Create a new Organization (if it is not already created):
    1. Image without caption
  1. Click the Create New App button:
    1. Image without caption
  1. Fill in the Name and the Description fields and click Next.
    1. Image without caption
  1. Select Client credentials as the authentication method.
    1. Image without caption
  1. In the Service section, choose C-Growth and Marketing Solutions and click Next:
    1. Image without caption
  1. In the Authorizations section, choose the Read value for every Domain in the row and click Activate app:
    1. Image without caption
  1. Scroll to the App Credentials section and click the Create new key button. The browser will download a text file with the API credentials.
    1. Image without caption
  1. Click Generate new URL in the right upper corner:
    1. Image without caption
  1. Click Generate URL and copy-paste it in the address bar of the browser.
  1. Scroll to the Portfolio Access section, choose the Account name and click Ok:
    1. Image without caption

Getting started

  1. Inside the admin panel navigate to the Data Sources page and click + NEW on the top right corner.
  1. Choose Criteo from the list.
  1. Open the downloaded file with the API credentials and copy-paste Client ID and Client Secret.
    1. Image without caption
  1. Click Save.

UTM tagging best practices

Adding a utm_id parameter to your tagging template will guarantee an improved stitching quality of costs to sessions without altering the rest of your existing UTM tags.
Here’s how to set it up:
  1. Go to your Ad Set and navigate to the Ads Tracking option.
  1. In the Track clicks section, find the Tracking suffix field, and append the following parameter that utilises URL marcos to its value.
    1. plain text
      &utm_id={{criteo_campaignid}}_{{adsetid}}_{{adid}}
  1. Click Save and continue.
For a detailed guide on how to set up ad tracking please refer to the Criteo documentation.

Manual UTM matching for campaigns

In case the SegmentStream automatic UTM matching doesn’t result in optimal ad cost to session stitching, you will need to match Criteo campaigns manually inside the SegmentStream admin panel.
By default, the following matching applies for utm_source and utm_medium:
  • utm_source ▸ criteo
  • utm_medium ▸ cpc
This matching can be changed inside the admin panel by specifying appropriate values UTM source and UTM medium options.
For all your Criteo campaigns you need to define matching between the Campaign ID and UTM campaign.
For example, if you have a Criteo campaign with the Campaign ID = Lower Funnel with the following link to the website: http://www.site.com/?utm_source=criteo&utm_medium=retargeting&utm_campaign=lower_funnel, the mapping should be the following:
Image without caption