# Reddit Conversions API

[Reddit](https://redditinc.com/) est un réseau social d’agrégation de actualités, de notation de contenu et de forum.\
En utilisant cette destination, vous pouvez exploiter [Reddit Conversions API](https://ads-api.reddit.com/docs/v3/operations/Post%20Conversion%20Events) (CAPI) pour partager directement vos données de conversion web avec Reddit afin que vous puissiez mesurer et optimiser vos campagnes de performance.

## Fonctionnalités clés

La destination Reddit Conversions API fournit les fonctionnalités clés suivantes :

* **Structure des événements** : notre [Référence des événements](https://doc.commandersact.com/developers/tracking/events-reference) modèle couvre [Les types d’événements et événements personnalisés de Reddit](https://ads-api.reddit.com/docs/v2/#tag/Conversions/paths/~1api~1v2.0~1conversions~1events~1{account_id}/post) , ce qui signifie que vos données sont correctement bridgées vers les 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 les saisies utilisateur.
* **Hachage automatique** : les informations sont automatiquement hachées conformément aux spécifications du partenaire.
* **Smart mapping** : le mapping des données peut être réajusté à l’aide des champs définis dans votre datalayer.
* **Mapping des événements**: modifiez le mapping standard entre les événements Reddit et les vôtres ou ajoutez de nouveaux mappings.
* **Prise en charge des données multi-éléments** : les informations incluses dans le [item](https://doc.commandersact.com/developers/tracking/events-reference#item) le tableau est envoyé à Reddit.
* **Prise en charge du mode batch**: voir <mark style="color:blue;">`Activer le mode batch`</mark> dans [Configuration](#configuration) pour plus de détails sur le mode.

## Configuration de la destination

{% hint style="info" %}
Avant de configurer cette destination, vous devez avoir accès à [Reddit Ads Manager](https://ads.reddit.com/).\
[La déduplication des événements](https://business.reddithelp.com/s/article/event-deduplication) est requise si vous utilisez [Reddit pixel](https://business.reddithelp.com/s/article/reddit-pixel) avec cette destination. Reddit recommande de transmettre des identifiants de conversion uniques via son pixel et cette destination pour tous les événements. Plus de détails sur la déduplication Reddit sont disponibles via ce [LINK](https://business.reddithelp.com/s/article/event-deduplication).
{% endhint %}

### Configuration

<table><thead><tr><th width="300">Paramètres</th><th>Description</th></tr></thead><tbody><tr><td><code>Access Token</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Saisissez votre access token. Vous pouvez le trouver dans <a href="https://ads.reddit.com">Reddit Ads</a> en suivant ce <a href="https://ads.reddit.com">LINK</a> et, dans le menu de gauche, sélectionnez <code>Event Manager</code> → <code>Conversions API</code> et cliquez sur <code>Generate Access Token</code> .</td></tr><tr><td><code>Pixel Id</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Saisissez l’identifiant de votre pixel. Vous pouvez le trouver dans <a href="https://ads.reddit.com">Reddit Ads</a> en suivant ce <a href="https://ads.reddit.com">LINK</a> et, dans le menu de gauche, sélectionnez <code>Event Manager</code> .</td></tr><tr><td><code>Activer le mode batch</code></td><td>Lorsque cette option est cochée, plusieurs enregistrements sont envoyés, en une seule requête, au lieu d’un par un.</td></tr><tr><td><code>Mapping des événements</code></td><td>Modifiez le mapping standard entre les événements Reddit et les vôtres ou ajoutez de nouveaux mappings.</td></tr><tr><td><code>Test Mode</code></td><td>Activez cette option uniquement pendant le test de vos paramètres. <strong>Désactiver en production !</strong></td></tr></tbody></table>

## Référence rapide

| Commanders Act Events        | Reddit Events                         |
| ---------------------------- | ------------------------------------- |
| `ADD_CART`                   | `ADD_TO_CART`                         |
| `ADD_TO_WISHLIST`            | `begin_checkout`                      |
| `generate_lead`              | `LEAD`                                |
| `page_view`                  | `PAGE_VISIT`                          |
| `purchase`                   | `reserve`                             |
| `SEARCH`                     | `sign_up`                             |
| `sign_up`                    | `view_item`                           |
| `VIEW_CONTENT`               | `view_item_list`                      |
| `[N'importe quel événement]` | `[N'importe quel événement]` **\[1]** |

{% hint style="info" %}
**1.** Voir <mark style="color:blue;">`Mapping des événements`</mark> dans [Configuration](#configuration) pour plus de détails.
{% endhint %}

## Mappings de champs

{% hint style="info" %}
Les propriétés peuvent être remappées en utilisant notre fonctionnalité [Smart Mapping](https://doc.commandersact.com/features/destinations/advanced-mapping#smart-mapping) fonctionnalité.\
Toutes les propriétés Reddit sont définies dans le chemin <mark style="color:blue;">`data.events.X`</mark> .
{% endhint %}

{% hint style="warning" %}
Reddit recommande d’activer [auto-advanced matching](https://business.reddithelp.com/s/article/automated-advanced-matching) et d’envoyer autant d’identifiants/clés de correspondance que possible afin d’améliorer la précision de l’attribution et d’améliorer les performances. Plus de détails sont disponibles via ce [LINK ](https://business.reddithelp.com/s/article/about-match-keys).
{% endhint %}

<table><thead><tr><th width="396.6685580062746">Propriétés Commanders Act</th><th>Reddit Properties</th></tr></thead><tbody><tr><td><code>context.event_timestamp</code></td><td><code>event_at</code></td></tr><tr><td><code>event_name</code></td><td><code>type.tracking_type</code> <strong>[1]</strong></td></tr><tr><td><p><code>partners.reddit.action_source</code></p><p><code>(context.device.type)</code></p><p><code>(type)</code></p></td><td><code>action_source</code> <strong>[2]</strong></td></tr><tr><td><code>Mapping des événements</code></td><td><code>type.custom_event_name</code> <strong>[3]</strong></td></tr><tr><td><code>partners.reddit.click_id</code></td><td><code>partners.snapchat.att_status</code> <strong>[4]</strong></td></tr><tr><td><code>id</code></td><td><code>conversion_id</code> <strong>[5]</strong></td></tr><tr><td><code>value</code></td><td><code>value</code> <strong>[5]</strong></td></tr><tr><td><code>currency</code></td><td><code>currency</code> <strong>[5]</strong></td></tr><tr><td><code>items</code></td><td><code>item_count</code> <strong>[5][6]</strong></td></tr><tr><td><code>items.X.id</code></td><td><code>products.X.id</code> <strong>[5]</strong></td></tr><tr><td><code>items.X.product.name</code></td><td><code>products.X.name</code> <strong>[5]</strong></td></tr><tr><td><p><code>items.X.product.category_1</code></p><p><code>items.X.product.category_2</code></p><p><code>items.X.product.category_3</code></p><p><code>items.X.product.category_4</code></p><p><code>items.X.product.category_5</code></p></td><td><code>products.X.category</code> <strong>[5][7]</strong></td></tr><tr><td><code>context.device.advertising_id</code></td><td><p><code>idfa</code> <strong>[8][9][10]</strong></p><p><code>aaid</code> <strong>[8][9][10]</strong></p></td></tr><tr><td><code>user.email</code></td><td><code>email</code> <strong>[8][10]</strong></td></tr><tr><td><code>user.id</code></td><td><code>external_id</code> <strong>[8][10]</strong></td></tr><tr><td><code>user.phone</code></td><td><code>phone_number</code> <strong>[8][10]</strong></td></tr><tr><td><code>context.device.ip</code></td><td><code>ip_address</code> <strong>[8][10]</strong></td></tr><tr><td><code>context.device.user_agent</code></td><td><code>user_agent</code> <strong>[8]</strong></td></tr><tr><td><code>parters.reddit.uuid</code></td><td><code>uuid</code> <strong>[8]</strong></td></tr><tr><td><code>user.country</code></td><td><code>country</code> <strong>[11]</strong></td></tr><tr><td><code>user.region</code></td><td><code>region</code> <strong>[11]</strong></td></tr><tr><td><code>parters.reddit.data_proc_mode</code></td><td><code>modes[0]</code> <strong>[11][12]</strong></td></tr><tr><td><code>context.device.screen.width</code></td><td><code>width</code> <strong>[13]</strong></td></tr><tr><td><code>context.device.screen.height</code></td><td><code>height</code> <strong>[13]</strong></td></tr><tr><td><code>Test Mode</code></td><td><code>test_mode</code> <strong>[14]</strong></td></tr></tbody></table>

{% hint style="info" %}
**1.** Voir [Référence rapide](#quick-reference) pour plus de détails sur le mapping standard.\
**2.** Priorité sur le côté gauche. Si <mark style="color:blue;">`context.device.type`</mark> est défini avec <mark style="color:blue;">`Android`</mark> ou <mark style="color:blue;">`iOS`</mark> (insensible à la casse), alors cela est défini avec <mark style="color:blue;">`APP`</mark> . Si <mark style="color:blue;">`type`</mark> est défini avec <mark style="color:blue;">`offline`</mark> alors cela est défini avec <mark style="color:blue;">`PHYSICAL_STORE`</mark> . Valeur par défaut : <mark style="color:blue;">`WEBSITE`</mark> .\
**3.** Voir <mark style="color:blue;">`Reddit event name`</mark> dans <mark style="color:blue;">`Mapping des événements`</mark> <mark style="color:$primary;">.</mark>\
**4.** Si aucune valeur n’est fournie, elle est récupérée depuis l’URL de la page en analysant le paramètre <mark style="color:blue;">`rdt_cid`</mark> .\
**5.** Défini dans le champ <mark style="color:blue;">`metadata`</mark> .\
**6.** En fonction de la longueur du champ fourni « Smart Mapping » <mark style="color:blue;">`Liste d’articles`</mark> .\
**7.** Toutes les catégories fournies sont séparées par le caractère « supérieur à » ( `>` ).\
**8.** Défini dans le champ <mark style="color:blue;">`user`</mark> .\
**9.** Ces propriétés nécessitent une valeur appropriée, <mark style="color:blue;">`iOS`</mark> ou <mark style="color:blue;">`Android`</mark> , pour le champ « Smart Mapping » <mark style="color:blue;">`Device Platform`</mark> .\
**10.** Automatiquement haché via SHA256 lorsqu’il est fourni en texte brut.\
**11.** Défini dans le champ <mark style="color:blue;">`user.data_processing_options`</mark> .\
**12.** Valeur prise en charge : <mark style="color:blue;">`LDU`</mark> .\
**13.** Défini dans le champ <mark style="color:blue;">`user.screen_dimensions`</mark> .\
**14.** Défini dans le chemin de base.
{% 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/reddit-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.