> 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/reddit-conversions-api.md).

# Reddit Conversions API

[Reddit](https://redditinc.com/) est un réseau social de forums, d’agrégation d’actualités et d’évaluation de contenus.\
Avec 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 de mesurer et d’optimiser les performances de vos campagnes.

## Fonctionnalités clés

La destination Reddit Conversions API offre les principales fonctionnalités suivantes :

* **Structure des événements** : notre modèle [de référence des événements](https://doc.commandersact.com/developers/tracking/events-reference) couvre [les types d’événements et les é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 permet de faire correspondre correctement vos donné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 s’effectue automatiquement, ce qui simplifie la saisie.
* **Hachage automatique**: les informations sont automatiquement hachées conformément aux spécifications du partenaire.
* **Mappage intelligent**: le mappage des données peut être ajusté à l’aide des champs définis dans votre datalayer.
* **Mappage des événements** : modifiez le mappage standard entre les événements Reddit et les vôtres, ou ajoutez de nouveaux mappages.
* **Prise en charge des données multi-éléments** : les informations incluses dans le tableau [item](https://doc.commandersact.com/developers/tracking/events-reference#item) sont envoyées à Reddit.
* **Prise en charge du mode batch** : consultez <mark style="color:bleu;">`Enable batch mode`</mark> dans [Configuration](#configuration) pour en savoir plus sur les modes.

## 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 nécessaire si vous utilisez le [pixel Reddit](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. Pour en savoir plus sur la déduplication Reddit, suivez ce [LIEN](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>Required</code></strong></em><br>Saisissez votre jeton d’accès. Vous le trouverez dans <a href="https://ads.reddit.com">Reddit Ads</a> en suivant ce <a href="https://ads.reddit.com">LIEN</a> puis, 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>Required</code></strong></em><br>Saisissez l’identifiant de votre pixel. Vous le trouverez dans <a href="https://ads.reddit.com">Reddit Ads</a> en suivant ce <a href="https://ads.reddit.com">LIEN</a> puis, dans le menu de gauche, sélectionnez <code>Event Manager</code> .</td></tr><tr><td><code>Enable batch mode</code></td><td>Lorsque cette option est cochée, plusieurs enregistrements sont envoyés dans une seule requête, plutôt qu’un par un.</td></tr><tr><td><code>Event Mapping</code></td><td>Modifiez la correspondance standard entre les événements Reddit et les vôtres, ou ajoutez de nouvelles correspondances.</td></tr><tr><td><code>Mode test</code></td><td>Activez cette option uniquement pendant le test de vos paramètres. <strong>Désactivez-la en production !</strong></td></tr></tbody></table>

## Référence rapide

| Événements Commanders Act | Événements Reddit      |
| ------------------------- | ---------------------- |
| `add_to_cart`             | `ADD_TO_CART`          |
| `add_to_wishlist`         | `ADD_TO_WISHLIST`      |
| `generate_lead`           | `LEAD`                 |
| `page_view`               | `PAGE_VISIT`           |
| `purchase`                | `PURCHASE`             |
| `search`                  | `SEARCH`               |
| `sign_up`                 | `SIGN_UP`              |
| `view_item`               | `VIEW_CONTENT`         |
| `[Any Event]`             | `[Any Event]` **\[1]** |

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

## Correspondances des champs

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

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

<table><thead><tr><th width="396.6685580062746">Propriétés Commanders Act</th><th>Propriétés Reddit</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>Event Mapping</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>click_id</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>Mode test</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é à gauche. Si <mark style="color:bleu;">`context.device.type`</mark> est défini sur <mark style="color:bleu;">`Android`</mark> ou <mark style="color:bleu;">`iOS`</mark> (sans distinction entre majuscules et minuscules), cette valeur est définie sur <mark style="color:bleu;">`APP`</mark> . Si <mark style="color:bleu;">`type`</mark> est défini sur <mark style="color:bleu;">`offline`</mark> alors cette valeur est définie sur <mark style="color:bleu;">`PHYSICAL_STORE`</mark> . Valeur par défaut : <mark style="color:bleu;">`WEBSITE`</mark> .\
**3.** Voir <mark style="color:bleu;">`Reddit event name`</mark> dans <mark style="color:bleu;">`Event Mapping`</mark> <mark style="color:$primary;">.</mark>\
**4.** Si aucune valeur n’est fournie, elle est récupérée à partir de l’URL de la page en analysant le paramètre <mark style="color:bleu;">`rdt_cid`</mark> .\
**5.** Défini dans le champ <mark style="color:bleu;">`metadata`</mark> .\
**6.** En fonction de la longueur du champ « Smart Mapping » fourni <mark style="color:bleu;">`Item List`</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:bleu;">`user`</mark> .\
**9.** Ces propriétés exigent une valeur correcte, <mark style="color:bleu;">`iOS`</mark> ou <mark style="color:bleu;">`Android`</mark> , pour le champ « Smart Mapping » <mark style="color:bleu;">`Device Platform`</mark> .\
**10.** Haché automatiquement avec SHA256 lorsqu’il est fourni en texte brut.\
**11.** Défini dans le champ <mark style="color:bleu;">`user.data_processing_options`</mark> .\
**12.** Valeur prise en charge : <mark style="color:bleu;">`LDU`</mark> .\
**13.** Défini dans le champ <mark style="color:bleu;">`user.screen_dimensions`</mark> .\
**14.** Défini dans le chemin de base.
{% 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
