> For the complete documentation index, see [llms.txt](https://doc.commandersact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.commandersact.com/fr/fonctionnalites/destinations/destinations-catalog/snapchat/snapchat-conversions-api.md).

# Snapchat Conversions API v2

{% hint style="warning" %}
Snapchat Conversions API **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 correspondante 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 s'appuie sur la [Snapchat Conversions API 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 offre 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) correspond [Types d'événements Snapchat](https://marketingapi.snapchat.com/docs/conversion.html#conversion-parameters)Google, 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 des événements se fait automatiquement, ce qui simplifie la saisie utilisateur.
* **Hachage automatique**: les informations sont automatiquement hachées conformément aux spécifications du partenaire.
* **Mappage intelligent**: le mappage des données peut être réajusté à l’aide des champs définis dans votre datalayer.
* **Events personnalisés**: vous pouvez envoyer librement des événements personnalisés selon vos besoins spécifiques.
* **Prise en charge des données multi-article**: les informations incluses dans le [item](https://community.commandersact.com/platform-x/developers/tracking/events-reference#item) le tableau est envoyé à Snapchat.

## Configuration de la destination

Avant de commencer avec cette destination, assurez-vous de pouvoir accéder à [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>Obligatoire si API Token n'est pas défini</code></strong></em><br>Vos identifiants Snapchat, tels que définis dans l'interface Commanders Act, comme suit : <code>Administration</code> ➜ <code>Identifiants du connecteur</code> ➜ <code>Ajouter les identifiants du connecteur</code> ➜ <code>Snapchat</code></td></tr><tr><td><code>API Token</code></td><td><em><strong><code>Obligatoire si Credentials n'est pas défini</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 lien <a href="https://marketingapi.snapchat.com/docs/conversion.html#static-long-lived-tokens">LINK</a>. Ce champ a priorité sur <code>Identifiants</code>.</td></tr><tr><td><code>Pixel Id (WEB)</code></td><td><em><strong><code>Obligatoire</code></strong></em> pour <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> fourni par Snapchat pour les événements de type "Web". Pour plus de détails, vous pouvez consulter le <a href="https://businesshelp.snapchat.com/s/article/pixel-website-install?language=en_US">LINK</a>.</td></tr><tr><td><code>Snap App Id (APP)</code></td><td><em><strong><code>Obligatoire</code></strong></em> pour <a href="https://marketingapi.snapchat.com/docs/conversion.html#mobile_app-parameters">MOBILE APP</a> événements.<br>Votre <a href="https://businesshelp.snapchat.com/s/article/snap-app-id?language=en_US">Snap App Id</a> fourni par Snapchat pour les événements de type "Mobile App". Pour plus de détails, vous pouvez consulter le <a href="https://businesshelp.snapchat.com/s/article/snap-app-id?language=en_US">LINK</a>.</td></tr><tr><td><code>Mappage des événements personnalisés</code></td><td>Snapchat permet de suivre jusqu'à cinq (5) événements personnalisés. Dans <code>Nom de l'événement Commanders Act</code> saisissez un nom d'événement, tandis que dans <code>Nom de l'é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 (p. ex. <code>CUSTOM_EVENT_1</code> ).</td></tr><tr><td><code>Propriétés d'événements personnalisées</code></td><td>Mappez vos propriétés d'événements personnalisées 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 <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é 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 vers le champ spécifique dont vous souhaitez obtenir 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 standard par événement. Vous pouvez également définir librement des champs personnalisés : il n'y a aucune limite.
{% endhint %}

## Référence rapide

| Commanders Act Events               | É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 de l'é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;">Mappage des événements personnalisés</mark> dans [Configuration](#configuration) pour plus de détails sur la manière de suivre des événements personnalisés avec Snapchat.
{% endhint %}

## Mappages de 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 Snapchat <mark style="color:bleu;">`uuid_c1`</mark> propriété en recherchant <mark style="color:bleu;">`partners.snapchat.uuid_c1`</mark> propriété. S'il n'est pas présent, 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 renseigné avec <mark style="color:bleu;">`MOBILE_APP`</mark> , sinon, <mark style="color:bleu;">`WEB`</mark> .\
**3.** Si vous signalez des événements à l'aide de plusieurs méthodes (p. ex. Snap Pixel et Conversions API), vous devez utiliser le même <mark style="color:bleu;">`client_dedup_id`</mark> pour toutes. Cela sera utilisé dans une fenêtre de 48 heures à partir de la première occurrence.\
**4.** Les informations de chaque élément sont envoyées dans le tableau associé.\
**5.** Champ haché automatiquement s'il est fourni en texte clair.\
**6.** Champ haché automatiquement et [normalisés](https://marketingapi.snapchat.com/docs/conversion.html#data-hygiene).\
**7.** <mark style="color:bleu;">`partners.snapchat.uuid_c1`</mark> a priorité sur le cookie <mark style="color:bleu;">**\_scid**</mark>.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.