# Snapchat Conversions API v2

{% hint style="warning" %}
API Snapchat Conversions **v2** est **obsolète** (Réf. [ici](https://developers.snap.com/api/marketing-api/Conversions-API/Introduction)).\
Snapchat recommande d’utiliser la version la plus récente **v3** et la destination associée est disponible comme suit :
{% endhint %}

{% content-ref url="/pages/7b8fead0c63e30cb3fcacc27f152f3bf8b5457a5" %}
[Snapchat Conversions API v3](/fr/fonctionnalites/destinations/destinations-catalog/snapchat/snapchat-conversions-api-v3.md)
{% endcontent-ref %}

[Snapchat ](https://www.snapchat.com/)est une application et un service de messagerie instantanée multimédia.\
Cette destination exploite l’ [API Snapchat Conversions v2](https://marketingapi.snapchat.com/docs/conversion.html#introduction) pour envoyer des événements web et app à Snapchat.

## Fonctionnalités clés

La destination Snapchat fournit les fonctionnalités clés suivantes :

* **Structure des événements**: notre [Référence des événements](https://community.commandersact.com/platform-x/developers/tracking/events-reference) correspond à [types d’événements Snapchat](https://marketingapi.snapchat.com/docs/conversion.html#conversion-parameters), ce qui signifie que vos données sont correctement reliées aux champs attendus de manière optimisée.
* **Mappings prédéfinis**: le mapping des données pour les destinations basées sur les événements se fait automatiquement, ce qui simplifie les saisies utilisateur.
* **Hachage automatique**: les informations sont automatiquement hachées conformément aux spécifications du partenaire.
* **Mapping intelligent**: le mapping des données peut être réajusté à l’aide des champs définis dans votre datalayer.
* **Événements personnalisés**: vous pouvez librement envoyer des événements personnalisés en fonction de vos besoins spécifiques.
* **Prise en charge des données multi-item**: les informations incluses dans le tableau [item](https://community.commandersact.com/platform-x/developers/tracking/events-reference#item) sont envoyées à Snapchat.

## Configuration de la destination

Avant de commencer avec cette destination, assurez-vous de pouvoir accéder au [Snapchat Ads Manager](https://ads.snapchat.com).

### Configuration

<table><thead><tr><th width="150">Paramètres</th><th>Description</th></tr></thead><tbody><tr><td><code>Identifiants</code></td><td><em><strong><code>Requis si l’API Token n’est pas défini</code></strong></em><br>Vos identifiants avec Snapchat tels que définis dans l’interface Commanders Act en suivant : <code>Administration</code> ➜ <code>Connector Credentials</code> ➜ <code>Ajouter des identifiants de connecteur</code> ➜ <code>Snapchat</code></td></tr><tr><td><code>API Token</code></td><td><em><strong><code>Requis si les identifiants ne sont pas définis</code></strong></em><br>Saisissez votre "API Token", également appelé "Static long lived token", tel que généré dans Snapchat <a href="https://business.snapchat.com/">Business Manager</a> → "Business Details" en suivant ce <a href="https://marketingapi.snapchat.com/docs/conversion.html#static-long-lived-tokens">LIEN</a>. Ce champ est prioritaire sur <code>Identifiants</code>.</td></tr><tr><td><code>Pixel Id (WEB)</code></td><td><em><strong><code>Requis</code></strong></em> pour les <a href="https://marketingapi.snapchat.com/docs/conversion.html#web-parameters">événements WEB</a>.<br>Votre <a href="https://businesshelp.snapchat.com/s/article/pixel-website-install?language=en_US">Pixel Id</a> tel que fourni par Snapchat pour les événements de type "Web". Pour plus de détails, vous pouvez consulter ce qui suit <a href="https://businesshelp.snapchat.com/s/article/pixel-website-install?language=en_US">LIEN</a>.</td></tr><tr><td><code>Snap App Id (APP)</code></td><td><em><strong><code>Requis</code></strong></em> pour les <a href="https://marketingapi.snapchat.com/docs/conversion.html#mobile_app-parameters">Événements MOBILE APP</a> .<br>Votre <a href="https://businesshelp.snapchat.com/s/article/snap-app-id?language=en_US">Snap App Id</a> tel que fourni par Snapchat pour les événements de type "Mobile App". Pour plus de détails, vous pouvez consulter ce qui suit <a href="https://businesshelp.snapchat.com/s/article/snap-app-id?language=en_US">LIEN</a>.</td></tr><tr><td><code>Mapping des événements personnalisés</code></td><td>Snapchat permet de suivre jusqu’à cinq (5) événements personnalisés. Dans <code>Nom d’événement Commanders Act</code> saisissez un nom d’événement, tandis que dans <code>Nom d’événement Snapchat</code> définissez un nom comme suit : <code>CUSTOM_EVENT_X</code> , où <code>X</code> est un nombre compris entre <code>1</code> et <code>5</code> , bornes incluses (par ex. <code>CUSTOM_EVENT_1</code> ).</td></tr><tr><td><code>Propriétés des événements personnalisés</code></td><td>Mappez les propriétés de votre événement personnalisé en définissant leurs noms de champ dans <code>Nom de la propriété de l’événement</code> et en ajoutant le nom du champ contenant la valeur dans <code>propriété d’événement Commanders Act</code> . Par ex. si vous saisissez <code>size</code> dans le <code>Nom de la propriété de l’événement</code> et <code>items.0.product.size</code> <strong>[1]</strong> dans <code>propriété d’événement Commanders Act</code> , vous aurez une propriété d’événement personnalisée dans Snapchat appelée <code>size</code> avec une valeur basée sur le contenu du champ <code>items.0.product.size</code> .</td></tr></tbody></table>

{% hint style="info" %}

> **1.** En utilisant des "points" ("."), vous pouvez naviguer plus en profondeur jusqu’au champ spécifique dont vous souhaitez récupérer la valeur. Voir [Référence des événements](https://community.commandersact.com/platform-x/developers/tracking/events-reference) pour plus de détails sur les noms de champs standards par événement. Vous pouvez également définir librement des champs personnalisés : il n’y a aucune limite.
> {% endhint %}

## Référence rapide

| Événements Commanders Act        | Événements Snapchat       |
| -------------------------------- | ------------------------- |
| `add_payment_info`               | `ADD_BILLING`             |
| `add_to_cart`                    | `ADD_CART`                |
| `add_to_wishlist`                | `ADD_TO_WISHLIST`         |
| `begin_checkout`                 | `START_CHECKOUT`          |
| `generate_lead`                  | `SUBSCRIBE`               |
| `invite`                         | `INVITE`                  |
| `login`                          | `LOGIN`                   |
| `page_view`                      | `PAGE_VIEW`               |
| `purchase`                       | `PURCHASE`                |
| `reserve`                        | `RESERVE`                 |
| `search`                         | `SEARCH`                  |
| `sign_up`                        | `SIGN_UP`                 |
| `view_item`                      | `VIEW_CONTENT`            |
| `view_item_list`                 | `LIST_VIEW`               |
| `Nom d’événement Commanders Act` | `CUSTOM_EVENT_X` **\[1]** |

{% hint style="info" %}

> **1.** Où <mark style="color:bleu;">`X`</mark> est un nombre compris entre `1` et `5` , bornes incluses. Voir <mark style="color:bleu;">Mapping des événements personnalisés</mark> dans [Configuration](#configuration) pour plus de détails sur la manière dont vous pouvez suivre des événements personnalisés avec Snapchat.
> {% endhint %}

## Mappings des champs

{% hint style="info" %}
Cette destination définira l’identifiant unique du visiteur, que vous pouvez fournir si vous utilisez Snapchat Pixel SDK, comme valeur pour la propriété Snapchat <mark style="color:bleu;">`uuid_c1`</mark> en recherchant la propriété <mark style="color:bleu;">`partners.snapchat.uuid_c1`</mark> . Si elle n’est pas présente, le cookie <mark style="color:bleu;">**\_scid**</mark> est utilisé.
{% endhint %}

<table><thead><tr><th width="441">Propriétés Commanders Act</th><th>Propriétés Snapchat</th></tr></thead><tbody><tr><td><code>context.event_timestamp</code></td><td><code>timestamp</code> <strong>[1]</strong></td></tr><tr><td><code>Pixel Id (WEB)</code></td><td><code>pixel_id</code></td></tr><tr><td><code>Snap App Id (APP)</code></td><td><code>snap_app_id</code></td></tr><tr><td><p><code>partners.snapchat.event_conversion_type</code></p><p><code>(context.app.name)</code></p></td><td><code>event_conversion_type</code> <strong>[2]</strong></td></tr><tr><td><code>context.page.url</code></td><td><code>page_url</code></td></tr><tr><td><code>context.app.namespace</code></td><td><code>app_id</code></td></tr><tr><td><code>id</code></td><td><code>client_dedup_id</code> <strong>[3]</strong></td></tr><tr><td><code>items.X.id</code></td><td><code>item_ids.X</code></td></tr><tr><td><code>items.length</code></td><td><code>number_items</code></td></tr><tr><td><code>items.X.id</code></td><td><code>item_ids</code> <strong>[4]</strong></td></tr><tr><td><code>items.X.product.category_1</code></td><td><code>item_category</code> <strong>[4]</strong></td></tr><tr><td><code>value</code></td><td><code>price</code></td></tr><tr><td><code>currency</code></td><td><code>currency</code></td></tr><tr><td><code>id</code></td><td><code>transaction_id</code></td></tr><tr><td><code>method</code></td><td><code>sign_up_method</code></td></tr><tr><td><code>search_term</code></td><td><code>search_string</code></td></tr><tr><td><code>user.email</code></td><td><code>hashed_email</code> <strong>[5]</strong></td></tr><tr><td><code>user.phone</code></td><td><code>hashed_phone_number</code> <strong>[6]</strong></td></tr><tr><td><code>context.device.ip</code></td><td><code>hashed_ip_address</code> <strong>[5]</strong></td></tr><tr><td><code>context.device.user_agent</code></td><td><code>user_agent</code></td></tr><tr><td><code>context.device.advertising_id</code></td><td><code>hashed_mobile_ad_id</code></td></tr><tr><td><code>context.device.idfv</code></td><td><code>hashed_idfv</code></td></tr><tr><td><code>context.device.model</code></td><td><code>device_model</code></td></tr><tr><td><code>context.device.os.version</code></td><td><code>os_version</code></td></tr><tr><td><code>partners.snapchat.uuid_c1</code></td><td><code>uuid_c1</code> <strong>[7]</strong></td></tr><tr><td><code>partners.snapchat.click_id</code></td><td><code>click_id</code></td></tr><tr><td><code>partners.snapchat.att_status</code></td><td><code>att_status</code></td></tr></tbody></table>

{% hint style="info" %}

> **1.** Champ généré automatiquement lorsqu’il n’est pas défini.\
> **2.** L’ordre de priorité est indiqué dans la colonne de gauche. Si <mark style="color:bleu;">`context.app.name`</mark> est défini, alors ce champ est défini avec <mark style="color:bleu;">`MOBILE_APP`</mark> , sinon, <mark style="color:bleu;">`WEB`</mark> .\
> **3.** Si vous remontez des événements en utilisant plusieurs méthodes (par ex. Snap Pixel et API Conversions), vous devez utiliser le même <mark style="color:bleu;">`client_dedup_id`</mark> sur l’ensemble d’entre elles. Cela sera utilisé dans une fenêtre de 48 heures à compter de la première occurrence.\
> **4.** Les informations de chaque item sont envoyées dans le tableau correspondant.\
> **5.** Champ automatiquement haché s’il est fourni en texte clair.\
> **6.** Champ automatiquement haché et [normalisé](https://marketingapi.snapchat.com/docs/conversion.html#data-hygiene).\
> **7.** <mark style="color:bleu;">`partners.snapchat.uuid_c1`</mark> est prioritaire sur le cookie <mark style="color:bleu;">**\_scid**</mark>.
> {% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.commandersact.com/fr/fonctionnalites/destinations/destinations-catalog/snapchat/snapchat-conversions-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.