Configure destination for Criteo¶
Note
This topic contains information about configuring a destination that sends query results to Criteo using orchestrations. To configure a destination that sends audiences to Criteo using campaigns see this topic .
Criteo is a commerce media platform that helps marketers and media owners manage and scale campaigns. Send audiences to Criteo, and then advertise to customers across paid media, including connected TV (CTV), banner ads, and video ads.
Note
This destination uses the Criteo API .
Your brand can send custom audiences and offline events to Criteo:
|
Custom audiences Use Custom audiences to help find who can be activated using Criteo. |
|
|
Transactions data Use transactions data to help your brand track offline conversions from your marketing campaigns. |
Send transactions data¶
You can send transactions data (offline events) to Criteo as a CSV or TSV file using SFTP.
Review the requirements for using SFTP to send transactions data to Criteo , and then configure Amperity to connect to Criteo using the SFTP destination.
After the SFTP destination is configured, use a query to map a customer’s email address and transactions data to the fields that can be sent to Criteo. For example:
SELECT
uit.amperity_id AS user_crmid
,mc.email AS user_email
,uit.order_id AS event_id
,uit.item_quantity AS event_item_quantity
,uit.product_id AS event_item_id
,uit.currency AS event_currency
,uit.item_revenue AS event_item_price
,uit.order_datetime AS event_timestamp
,uit.store_id AS store_id
--,uit.purchase_brand AS event_item_brand --optional
--,uit.product_category AS event_item_category --optional
FROM Merged_Customers mc
INNER JOIN Unified_Itemized_Transactions uit
ON mc.amperity_id = uit.amperity_id
WHERE mc.email IS NOT NULL
AND uit.is_return = false
AND uit.is_cancellation = false
Use an orchestration to send transactions to Criteo using the SFTP destination.
Get details¶
Review the following details before configuring credentials for Criteo and before configuring Amperity to send email lists to Criteo.
|
Credential settings Refresh token
Important When configuring OAuth for Criteo you must select the portfolios to which access will be granted. Criteo will only create the credential if the account you are using has not already granted Amperity access. If you need to create a new credential, revoke access for Amperity , and then reconfigure OAuth using the newly-generated link. |
|
|
Required configuration settings Advertiser ID
Audience name (Required at orchestration)
Audience primary key
|
Configure credentials¶
Configure credentials for Criteo before adding a destination.
An individual with access to Criteo should use SnapPass to securely share “refresh token” details with the individual who configures Amperity.
Important
When configuring OAuth for Criteo you must select the portfolios to which access will be granted.
Criteo will only create the credential if the account you are using has not already granted Amperity access. If you need to create a new credential, revoke access for Amperity , and then reconfigure OAuth using the newly-generated link.
To configure credentials for Criteo
|
From the Settings page, select the Credentials tab, and then click the Add credential button. |
|
In the Credentials settings dialog box, do the following: From the Plugin dropdown, select Criteo. Assign the credential a name and description that ensures other users of Amperity can recognize when to use this destination. |
|
The settings that are available for a credential vary by credential type. For the “criteo” credential type, configure settings, and then click Save. Refresh token
|
Reauthorize Amperity¶
You may need to reauthorize access to Criteo. This is necessary when an authorization token has expired or when it has been removed by someone with permission to manage access within Criteo. To reauthorize access to Criteo, follow the steps to configure OAuth and create a new credential.
Add destination¶
Use a sandbox to configure a destination for Criteo. Before promoting your changes, send a test audience, and then verify the results in Criteo. After verifying the end-to-end workflow, push the destination from the sandbox to production.
To add a destination for Criteo
|
|
Open the Destinations page, and then click the Add destination button. 
To configure a destination for Criteo, do one of the following:
|
|
|
Select the credential for Criteo from the Credential dropdown, and then click Continue. Tip Click the “Test connection” link on the “Configure destination” page to verify that Amperity can connect to Criteo. |
|
|
In the “Destination settings” dialog box, assign the destination a name and description that ensures other users of Amperity can recognize when to use this destination. Configure business user access By default a destination is available to all users who have permission to view personally identifiable information (PII). Enable the Admin only checkbox to restrict access to only users assigned to the Datagrid Operator and Datagrid Administrator policies. Enable the PII setting checkbox to allow limited access to PII for this destination. Use the Restrict PII access policy option to prevent users from viewing data marked as PII anywhere in Amperity and from sending data to downstream workflows. |
|
Configure the following settings, and then click “Save”. Advertiser ID
Audience name (Required at orchestration)
Audience primary key
|
|
After configuring this destination users may use:
|