# Criteo - Events

[Criteo ](https://www.criteo.com/)est une entreprise de publicité qui fournit des publicités display en ligne.\
En utilisant le [Criteo Server-side API](https://guides.criteotilt.com/onetag/s2s/#sending-events) vous pouvez suivre les événements web que vous avez l’habitude de reporter via [Criteo OneTag client-side JS (pixel)](https://help.criteo.com/kb/guide/en/all-criteo-onetag-events-and-parameters-vZbzbEeY86/Steps/775825). Cela est normalement requis pour des raisons techniques et légales.

## Fonctionnalités clés

La destination Criteo - Events fournit les principales fonctionnalités suivantes :

* **Structure des événements**: notre [Référence des événements](https://community.commandersact.com/platform-x/developers/tracking/events-reference) prend en charge [les events de Criteo](https://help.criteo.com/kb/guide/en/all-criteo-onetag-events-and-parameters-vZbzbEeY86/Steps/775825), ce qui signifie que vos données sont correctement reliées aux champs attendus de manière optimisée.
* **Mappages prédéfinis**: le mappage des données pour les destinations basées sur les événements se fait automatiquement, ce qui simplifie les saisies utilisateur.
* **Données enrichies**: vous pouvez envoyer librement des informations supplémentaires en fonction de vos besoins spécifiques (par ex. l’ajout d’events personnalisés, de propriétés d’event et d’utilisateur personnalisées).
* **Prise en charge des données multi-éléments**: les informations incluses dans le [item ](https://community.commandersact.com/platform-x/developers/tracking/events-reference#item)array sont transmises à Criteo.

## Configuration de la destination

{% hint style="danger" %}
**Le** [**Criteo salted user ID (GUM ID)**](https://guides.criteotilt.com/onetag/s2s/#criteo-gum-call) **est requis**: cette valeur doit être transmise à cette destination en incluant le cookie <mark style="color:bleu;">**`crto_mapped_user_id`**</mark>.\
La façon la plus simple de gérer ce cookie est d’ **utiliser ce client-side tags dans notre tag library :&#x20;**<mark style="color:bleu;">**Criteo - User Identification**</mark> dans votre conteneur web.
{% endhint %}

### Configuration

| Paramètres     | Description                                                                                                                                                                                                                  |
| -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `ID du compte` | <p><em><strong><code>Obligatoire</code></strong></em><br>Le Criteo du retailer <a href="https://marketing.criteo.com/">ID du compte</a> se trouve dans le <a href="https://marketing.criteo.com/">Management Center</a>.</p> |
| `Caller Id`    | Le Caller Id est utilisé pour identifier l’utilisateur et il est fourni par Criteo sur demande.                                                                                                                              |

## Référence rapide

| Événements Commanders Act                                   | 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]** Si <mark style="color:bleu;">`page.type`</mark> est <mark style="color:bleu;">`home`</mark> alors <mark style="color:bleu;">`viewHome`</mark> est aussi envoyé avec <mark style="color:bleu;">`viewPage`</mark>, sinon, seul <mark style="color:bleu;">`viewPage`</mark> est transmis.
{% endhint %}

## Mappages des champs

| Propriétés Commanders Act | Criteo Properties                                                                                 |
| ------------------------- | ------------------------------------------------------------------------------------------------- |
| `event_timestamp`         | `timestamp` **\[1]**                                                                              |
| `ID du compte`            | `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> et</p><p><code>id.email.sha256\_md5</code> <strong>\[3]</strong></p> |
| `user.email_sha256`       | `id.email.sha256`                                                                                 |

{% hint style="info" %}
**\[1]** Converti automatiquement au [format ISO 8601](https://en.wikipedia.org/wiki/ISO_8601).\
\&#xNAN;**\[2]** Il s’agit soit de <mark style="color:bleu;">`m`</mark> ou <mark style="color:bleu;">`d`</mark>, selon que <mark style="color:bleu;">`app.name`</mark> est défini ou non.\
\&#xNAN;**\[3]** <mark style="color:bleu;">`id.email.sha256_md5`</mark> est automatiquement haché.
{% endhint %}