> 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-v3.md).

# Snapchat Conversions API v3

[Snapchat](https://www.snapchat.com/) est une application et un service de messagerie instantanée multimédia.\
Cette destination exploite les dernières [Snapchat Conversions API v3](https://developers.snap.com/api/marketing-api/Conversions-API/Introduction) pour envoyer les événements web et app vers Snapchat, ce qui permet d’optimiser les campagnes publicitaires, d’améliorer le ciblage et de mesurer les conversions issues de vos campagnes 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) prend en charge [Événements Snapchat](https://developers.snap.com/api/marketing-api/Conversions-API/Parameters#server-parameters), 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 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.
* **Smart Mapping**: le mappage des données peut être réajusté à l'aide de vos champs définis dans le data layer.
* **Événements personnalisés**: vous pouvez envoyer librement des événements personnalisés selon vos besoins spécifiques.
* **Prise en charge des données multi-items** : 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

### Configuration

<table><thead><tr><th width="242">Paramètres</th><th>Description</th></tr></thead><tbody><tr><td><code>Identifiants</code></td><td><em><strong><code>Requis 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 des identifiants du connecteur</code> ➜ <code>Snapchat</code></td></tr><tr><td><code>jeton API</code></td><td><em><strong><code>Requis 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 ceci <a href="https://marketingapi.snapchat.com/docs/conversion.html#static-long-lived-tokens">LIEN</a>. Ce champ a la 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> tel qu’indiqué 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>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> tel qu’indiqué 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>Envoyer l'adresse IP</code></td><td>Cochez cette option pour envoyer l'adresse IP telle que définie dans le <code>Smart Mapping</code> champ <code>Adresse IP de l’appareil</code> .</td></tr><tr><td><code>Mappage d'événements personnalisé</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>Associez vos propriétés d'événements personnalisées en définissant leurs noms de champ dans <code>nom de propriété Snapchat</code> et en ajoutant la valeur dans <code>La valeur de votre événement</code> .</td></tr></tbody></table>

## Référence rapide

| Propriétés Commanders Act                                           | Événements Snapchat       |
| ------------------------------------------------------------------- | ------------------------- |
| `achievement_unlocked`                                              | `ACHIEVEMENT_UNLOCKED`    |
| `ad_click`                                                          | `AD_CLICK`                |
| `ad_view`                                                           | `AD_VIEW`                 |
| <p><code>add\_payment\_info</code><br><code>add\_billing</code></p> | `ADD_BILLING`             |
| `add_to_cart`                                                       | `ADD_CART`                |
| `add_to_wishlist`                                                   | `ADD_TO_WISHLIST`         |
| `app_open`                                                          | `APP_OPEN`                |
| `begin_checkout`                                                    | `START_CHECKOUT`          |
| `complete_tutorial`                                                 | `COMPLETE_TUTORIAL`       |
| `generate_lead`                                                     | `SUBSCRIBE`               |
| `invite`                                                            | `INVITE`                  |
| `level_complete`                                                    | `LEVEL_COMPLETE`          |
| `login`                                                             | `LOGIN`                   |
| `page_view`                                                         | `PAGE_VIEW`               |
| `purchase`                                                          | `PURCHASE`                |
| `rate`                                                              | `RATE`                    |
| `reserve`                                                           | `RESERVE`                 |
| `save`                                                              | `SAVE`                    |
| `search`                                                            | `SEARCH`                  |
| `share`                                                             | `SHARE`                   |
| `sign_up`                                                           | `SIGN_UP`                 |
| `spent_credits`                                                     | `SPENT_CREDITS`           |
| `start_trial`                                                       | `START_TRIAL`             |
| `view_item`                                                         | `VIEW_CONTENT`            |
| `view_item_list`                                                    | `LIST_VIEW`               |
| `[ANY EVENT]`                                                       | `CUSTOM_EVENT_X` **\[1]** |

{% hint style="info" %}
**1.** Où <mark style="color:bleue;">`X`</mark> est un nombre compris entre `1` et `5` , bornes incluses. Voir <mark style="color:bleue;">Mappage d'événements personnalisé</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="warning" %}
Au moins l’un des éléments suivants doit être fourni :

• `user_data.em` (E-mail de l’utilisateur)

• `user_data.ph` (Numéro de téléphone de l’utilisateur)

• `user_data.madid` (Identifiant mobile de l'appareil)

• `user_data.client_ip_address` ET `user_data.client_user_agent`
{% endhint %}

{% hint style="info" %}
Les propriétés peuvent être remappées à l'aide de notre [Smart Mapping](https://doc.commandersact.com/features/destinations/advanced-mapping#smart-mapping) fonctionnalité.\
Toutes les propriétés Snapchat sont définies dans le chemin de base <mark style="color:bleue;">`data.0`</mark> .
{% endhint %}

<table><thead><tr><th width="374">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>event_time</code></td></tr><tr><td><code>(event_name)</code></td><td><code>event_name</code> <strong>[1]</strong></td></tr><tr><td><code>partners.snapchat.event_conversion_type</code><br><code>(context.app.name)</code></td><td><code>action_source</code> <strong>[2]</strong></td></tr><tr><td><code>context.page.url</code></td><td><code>event_source_url</code></td></tr><tr><td><code>ID</code></td><td><code>event_id</code> <strong>[3]</strong></td></tr><tr><td><code>partners.snapchat.dpo</code></td><td><code>data_processing_options</code></td></tr><tr><td><code>partners.snapchat.test_code</code></td><td><code>test_event_code</code></td></tr><tr><td><code>items.X.id</code></td><td><code>custom_data.content_ids</code> <strong>[4]</strong></td></tr><tr><td><code>items.X.product.category_1</code></td><td><code>custom_data.content_category</code> <strong>[5]</strong></td></tr><tr><td><code>context.page.title</code></td><td><code>custom_data.content_name</code></td></tr><tr><td><code>partners.snapchat.content_type</code></td><td><code>custom_data.content_type</code> <strong>[6]</strong></td></tr><tr><td><code>items.X.id</code></td><td><code>custom_data.contents.X.id</code></td></tr><tr><td><code>items.X.quantity</code></td><td><code>custom_data.contents.X.quantity</code></td></tr><tr><td><code>items.X.product.price</code></td><td><code>custom_data.contents.X.item_price</code></td></tr><tr><td><code>items.X.product.delivery_category</code></td><td><code>custom_data.contents.X.delivery_category</code></td></tr><tr><td><code>items.length</code></td><td><code>custom_data.num_items</code></td></tr><tr><td><code>value</code></td><td><code>custom_data.value</code></td></tr><tr><td><code>devise</code></td><td><code>custom_data.currency</code></td></tr><tr><td><code>ID</code></td><td><code>custom_data.order_id</code></td></tr><tr><td><code>partners.snapchat.predicted_ltv</code></td><td><code>custom_data.predicted_ltv</code></td></tr><tr><td><code>search_term</code></td><td><code>custom_data.search_string</code></td></tr><tr><td><code>partners.snapchat.checkin_date</code></td><td><code>custom_data.checkin_date</code> <strong>[7]</strong></td></tr><tr><td><code>partners.snapchat.travel_end</code></td><td><code>custom_data.travel_end</code></td></tr><tr><td><code>partners.snapchat.travel_start</code></td><td><code>custom_data.travel_start</code></td></tr><tr><td><code>partners.snapchat.suggest_dest</code></td><td><code>custom_data.suggested_destinations</code> <strong>[8]</strong></td></tr><tr><td><code>partners.snapchat.dest_airport</code></td><td><code>custom_data.destination_airport</code> <strong>[9]</strong></td></tr><tr><td><code>partners.snapchat.dest_country</code></td><td><code>custom_data.country</code> <strong>[10]</strong></td></tr><tr><td><code>partners.snapchat.dest_city</code></td><td><code>custom_data.city</code> <strong>[11]</strong></td></tr><tr><td><code>partners.snapchat.dest_region</code></td><td><code>custom_data.region</code> <strong>[12]</strong></td></tr><tr><td><code>partners.snapchat.dest_neigh</code></td><td><code>custom_data.neighborhood</code> <strong>[13]</strong></td></tr><tr><td><code>méthode</code></td><td><code>custom_data.sign_up_method</code></td></tr><tr><td><code>context.device.user_agent</code></td><td><code>user_data.client_user_agent</code></td></tr><tr><td><code>context.app.namespace</code></td><td><code>app_data.app_id</code><br><code>extinfo.1</code></td></tr><tr><td><code>context.device.advertising_id</code></td><td><code>user_data.madid</code></td></tr><tr><td><code>context.device.idfv</code></td><td><code>user_data.idfv</code> <strong>[14]</strong></td></tr><tr><td><code>(context.device.os.name)</code></td><td><code>extinfo.0</code> <strong>[15]</strong></td></tr><tr><td><code>context.app.version</code></td><td><code>extinfo.2</code></td></tr><tr><td><code>context.app.version_long</code></td><td><code>extinfo.3</code></td></tr><tr><td><code>context.device.os.version</code></td><td><code>custom_data.os_version</code><br><code>extinfo.4</code></td></tr><tr><td><code>context.device.model</code></td><td><code>custom_data.device_model</code><br><code>extinfo.5</code></td></tr><tr><td><code>context.device.language</code></td><td><code>extinfo.6</code></td></tr><tr><td><code>context.device.timezone_short</code></td><td><code>extinfo.7</code></td></tr><tr><td><code>context.device.network.carrier</code></td><td><code>extinfo.8</code></td></tr><tr><td><code>context.device.screen.width</code></td><td><code>extinfo.9</code></td></tr><tr><td><code>context.device.screen.height</code></td><td><code>extinfo.10</code></td></tr><tr><td><code>context.device.screen.density</code></td><td><code>extinfo.11</code></td></tr><tr><td><code>context.device.cpu_core</code></td><td><code>extinfo.12</code></td></tr><tr><td><code>context.device.storage</code></td><td><code>extinfo.13</code></td></tr><tr><td><code>context.device.ex_storage</code></td><td><code>extinfo.14</code></td></tr><tr><td><code>context.device.timezone</code></td><td><code>extinfo.15</code></td></tr><tr><td><code>context.device.ad_tracking_enabled</code></td><td><code>app_data.advertiser_tracking_enabled</code></td></tr><tr><td><code>user.email</code></td><td><code>user_data.em</code> <strong>[16]</strong></td></tr><tr><td><code>user.phone</code></td><td><code>user_data.ph</code> <strong>[16]</strong></td></tr><tr><td><code>user.firstname</code></td><td><code>user_data.fn</code> <strong>[16]</strong></td></tr><tr><td><code>user.lastname</code></td><td><code>user_data.ln</code> <strong>[16]</strong></td></tr><tr><td><code>user.gender</code></td><td><code>user_data.ge</code> <strong>[16]</strong></td></tr><tr><td><code>user.city</code></td><td><code>user_data.ct</code> <strong>[16]</strong></td></tr><tr><td><code>user.state_short</code></td><td><code>user_data.st</code> <strong>[16]</strong></td></tr><tr><td><code>user.zipcode</code></td><td><code>user_data.zp</code> <strong>[16]</strong></td></tr><tr><td><code>user.country</code></td><td><code>user_data.country</code> <strong>[16]</strong></td></tr><tr><td><code>context.device.ip</code></td><td><code>user_data.client_ip_address</code></td></tr><tr><td><code>user.id</code></td><td><code>user_data.external_id</code></td></tr><tr><td><code>partners.snapchat.sub_id</code></td><td><code>user_data.subscription_id</code></td></tr><tr><td><code>partners.snapchat.lead_id</code></td><td><code>user_data.lead_id</code></td></tr><tr><td><code>partners.snapchat.app_install_id</code></td><td><code>user_data.anon_id</code></td></tr><tr><td><code>partners.snapchat.download_id</code></td><td><code>user_data.download_id</code></td></tr><tr><td><code>partners.snapchat.partner_id</code></td><td><code>user_data.partner_id</code></td></tr><tr><td><code>partners.snapchat.uuid_c1</code><br><code>cookie _scid</code></td><td><code>user_data.sc_cookie1</code> <strong>[17]</strong></td></tr><tr><td><code>partners.snapchat.click_id</code></td><td><code>user_data.sc_click_id</code></td></tr></tbody></table>

{% hint style="info" %}
**1.** Voir [Référence rapide](#quick-reference) pour plus de détails.\
**2.** Priorité sur le côté gauche. Si `context.app.name` est défini `MOBILE_APP` est renvoyé. Valeurs autorisées : `OFFLINE` , `MOBILE_APP` et `WEB` . Valeur par défaut : `WEB` .\
**3.** Si vous signalez des événements via plusieurs méthodes (Snap Pixel, App Ads Kit , Conversions API), vous devez utiliser le même identifiant d’événement pour toutes les méthodes. Si vous utilisez [Snap Pixel](https://businesshelp.snapchat.com/s/article/snap-pixel-about?language=en_US), cela doit correspondre au `client_dedup_id` pour l’événement correspondant.\
**4.** Tous les identifiants d’article sont inclus.\
**5.** Toutes les catégories sont incluses.\
**6.** Indique ce que représentent les clés dans `content_ids` ou `contents` représentent. Définissez avec `product` pour les articles individuels ou `product_group` pour les articles qui comportent plusieurs options de taille, de couleur ou toute autre variation. Valeur par défaut : `product` .\
**7.** La date d’arrivée souhaitée à l’hôtel, dans le fuseau horaire de l’hôtel. Les formats acceptés sont : `YYYYMMDD` , `YYYY-MM-DD` , `YYYY-MM-DDThh:mmTZD` et `YYYY-MM-DDThh:mm:ssTZD` .\
**8.** Destinations suggérées. Liste de destinations séparées par des virgules (p. ex. `destination1,destination2` ou `["destination1", "destination2"]` ).\
**9.** Code IATA.\
**10.** Le pays correspondant au lieu que l’utilisateur souhaite visiter.\
**11.** La ville correspondant au lieu que l’utilisateur souhaite visiter.\
**12.** Il peut s’agir de l’État, du district ou de la région qui intéresse l’utilisateur.\
**13.** Le quartier qui intéresse l’utilisateur.\
**14.** iOS IDFV. S’il est transmis en clair, il est automatiquement haché via SHA256.\
**15.** Défini avec `a2` si `context.device.os.name` est `Android` (insensible à la casse) ou `i2` si `context.device.os.name` est `iOS` (insensible à la casse).\
**16.** S’il est transmis en clair, il est normalisé puis automatiquement haché via SHA256.\
**17.** Priorité à gauche.
{% 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-v3.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.