> 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 d’agrégation de contenus, de notation de contenus et de forums.\
En utilisant cette destination, vous pouvez tirer parti de [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 vos campagnes de performance.

## Fonctionnalités clés

La destination Reddit Conversions API offre 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) Le modèle 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 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 s'effectue automatiquement, ce qui simplifie la saisie utilisateur.
* **Hachage automatique**: les informations sont hachées automatiquement 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.
* **Mappage d'événements**: modifier le mappage standard entre les événements Reddit et les vôtres ou ajouter de nouveaux mappages.
* **Prise en charge des données multi-items**: 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:bleu;">`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 le [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 lien [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>jeton d’accès</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Saisissez votre jeton d’accès. Vous pouvez le trouver dans <a href="https://ads.reddit.com">Reddit Ads</a> en suivant ce lien <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 lien <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’être envoyés un par un.</td></tr><tr><td><code>Correspondance des événements</code></td><td>Modifier le mappage standard entre les événements Reddit et les vôtres ou ajouter de nouveaux mappages.</td></tr><tr><td><code>Mode test</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 | É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`              |
| `[Tout événement]`    | `[Tout événement]` **\[1]** |

{% hint style="info" %}
**1.** Voir <mark style="color:bleu;">`Correspondance des événements`</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 [Mappage intelligent](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:bleu;">`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 les performances. Plus de détails sont disponibles via ce lien [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>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>Correspondance 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>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>valeur</code></td><td><code>valeur</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 la correspondance standard.\
**2.** Priorité à gauche. Si <mark style="color:bleu;">`context.device.type`</mark> est défini avec <mark style="color:bleu;">`Android`</mark> ou <mark style="color:bleu;">`iOS`</mark> (sensible à la casse) alors ce champ est défini avec <mark style="color:bleu;">`APP`</mark> . Si <mark style="color:bleu;">`type`</mark> est défini avec <mark style="color:bleu;">`offline`</mark> alors ce champ est défini avec <mark style="color:bleu;">`PHYSICAL_STORE`</mark> . Valeur par défaut : <mark style="color:bleu;">`WEBSITE`</mark> .\
**3.** Voir <mark style="color:bleu;">`nom de l’événement Reddit`</mark> dans <mark style="color:bleu;">`Correspondance 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:bleu;">`rdt_cid`</mark> .\
**5.** Défini dans le <mark style="color:bleu;">`metadata`</mark> champ.\
**6.** En fonction de la longueur du champ « Smart Mapping » fourni <mark style="color:bleu;">`Liste des articles`</mark> .\
**7.** Toutes les catégories fournies sont séparées par le caractère « supérieur à » ( `>` ).\
**8.** Défini dans le <mark style="color:bleu;">`user`</mark> champ.\
**9.** Ces propriétés nécessitent 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;">`Plateforme de l’appareil`</mark> .\
**10.** Haché automatiquement via SHA256 lorsqu’il est fourni en texte brut.\
**11.** Défini dans le <mark style="color:bleu;">`user.data_processing_options`</mark> champ.\
**12.** Valeur prise en charge : <mark style="color:bleu;">`LDU`</mark> .\
**13.** Défini dans le <mark style="color:bleu;">`user.screen_dimensions`</mark> champ.\
**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 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/reddit-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.