# Criteo - Events

[Criteo ](https://www.criteo.com/)is an advertising company that provides online display advertisements.\
Using the [Criteo Server-side API](https://guides.criteotilt.com/onetag/s2s/#sending-events) you can track web events you are used to report via [Criteo OneTag client-side JS (pixel)](https://help.criteo.com/kb/guide/en/all-criteo-onetag-events-and-parameters-vZbzbEeY86/Steps/775825). This is normally required for technical and legal reasons.

## Key features

The Criteo - Events destination provides the following key features:

* **Events structure**: our [Events reference](https://community.commandersact.com/platform-x/developers/tracking/events-reference) supports [Criteo's events](https://help.criteo.com/kb/guide/en/all-criteo-onetag-events-and-parameters-vZbzbEeY86/Steps/775825), meaning that your data is properly bridged to the expected fields in an optimized way.
* **Prebuilt mappings**: data mapping for event-based destinations happens automatically, which simplifies user inputs.
* **Refined data**: you can freely push additional information based on your specific needs (E.g. adding custom events, custom event and user properties).
* **Support for multi-item data**: information included in the [item ](https://community.commandersact.com/platform-x/developers/tracking/events-reference#item)array is brought to Criteo.

## Destination setup

{% hint style="danger" %}
**The** [**Criteo salted user ID (GUM ID)**](https://guides.criteotilt.com/onetag/s2s/#criteo-gum-call) **is required**: this value must be passed to this destination by including the cookie <mark style="color:blue;">**`crto_mapped_user_id`**</mark>.\
The easiest way to manage this cookie is to **use this client-side tags in our tag library :&#x20;**<mark style="color:blue;">**Criteo - User Identification**</mark> in your web container.
{% endhint %}

### Configuration

| Settings     | Description                                                                                                                                                                                                               |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Account Id` | <p><em><strong><code>Required</code></strong></em><br>The retailer’s Criteo <a href="https://marketing.criteo.com/">Account Id</a> can be found in the <a href="https://marketing.criteo.com/">Management Center</a>.</p> |
| `Caller Id`  | The Caller Id is used for identifying the user and it's provided by Criteo upon request.                                                                                                                                  |

## Quick reference

| Commanders Act Events                                       | Criteo Events                                                                      |
| ----------------------------------------------------------- | ---------------------------------------------------------------------------------- |
| `add_payment_info`                                          | `addPaymentInfo`                                                                   |
| `add_to_cart`                                               | `addToCart`                                                                        |
| `begin_checkout`                                            | `beginCheckout`                                                                    |
| `login`                                                     | `login`                                                                            |
| `page_view`                                                 | <p><code>viewHome</code> and/or<br><code>viewPage</code> <strong>\[1]</strong></p> |
| `purchase`                                                  | `trackTransaction`                                                                 |
| <p><code>search</code><br><code>view\_item\_list</code></p> | `viewList`                                                                         |
| `view_cart`                                                 | `viewBasket`                                                                       |
| `view_item`                                                 | `viewItem`                                                                         |

{% hint style="info" %}
**\[1]** If <mark style="color:blue;">`page.type`</mark> is <mark style="color:blue;">`home`</mark> then <mark style="color:blue;">`viewHome`</mark> is also sent with <mark style="color:blue;">`viewPage`</mark>, otherwise, just <mark style="color:blue;">`viewPage`</mark> is forwarded.
{% endhint %}

## Field mappings

| Commanders Act Properties | Criteo Properties                                                                                  |
| ------------------------- | -------------------------------------------------------------------------------------------------- |
| `event_timestamp`         | `timestamp` **\[1]**                                                                               |
| `Account Id`              | `account`                                                                                          |
| `device.ip`               | `ip`                                                                                               |
| `page.location.href`      | `full_url`                                                                                         |
| `page.referrer`           | `previous_url`                                                                                     |
| `(app.name)`              | `site_type` **\[2]**                                                                               |
| `device.user_agent`       | `useragent`                                                                                        |
| `user.id`                 | `retailer_visitor_id`                                                                              |
| `Caller Id`               | `id.mapping_key`                                                                                   |
| `user.email`              | `id.email.raw`                                                                                     |
| `user.email_md5`          | <p><code>id.email.md5</code> and</p><p><code>id.email.sha256\_md5</code> <strong>\[3]</strong></p> |
| `user.email_sha256`       | `id.email.sha256`                                                                                  |

{% hint style="info" %}
**\[1]** Automatically converted in the [ISO 8601 format](https://en.wikipedia.org/wiki/ISO_8601).  \
\&#xNAN;**\[2]** This is either <mark style="color:blue;">`m`</mark> or <mark style="color:blue;">`d`</mark>, depending if <mark style="color:blue;">`app.name`</mark> is defined or not.  \
\&#xNAN;**\[3]** <mark style="color:blue;">`id.email.sha256_md5`</mark> is automatically hashed.
{% endhint %}