# Reddit Conversions API

[Reddit](https://redditinc.com/) est un réseau social d’agrégation de news, 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 de mesurer et d’optimiser vos campagnes de performance.

## Key features

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

* **Events structure**: notre [Events reference](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.
* **Prebuilt mappings**: le mapping des données pour les destinations basées sur les events 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.
* **Event mapping**: 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-item**: les informations incluses dans le tableau [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 [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 en suivant ce [LIEN](https://business.reddithelp.com/s/article/event-deduplication).
{% endhint %}

### Configuration

<table><thead><tr><th width="300">Settings</th><th>Description</th></tr></thead><tbody><tr><td><code>Access Token</code></td><td><em><strong><code>Requis</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 <a href="https://ads.reddit.com">LIEN</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>Requis</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">LIEN</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>Lorsqu’elle est cochée, plusieurs enregistrements sont envoyés dans une seule requête, au lieu d’un par un.</td></tr><tr><td><code>Mappage 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ésactivez-la en production !</strong></td></tr></tbody></table>

## Référence rapide

| Commanders Act Events | Reddit Events          |
| --------------------- | ---------------------- |
| `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]** Voir <mark style="color:bleu;">`Mappage des événements`</mark> dans [Configuration](#configuration) pour plus de détails.
{% endhint %}

## Mappages de champs

{% hint style="info" %}
La plupart des propriétés peuvent être remappées à l’aide de notre fonctionnalité « 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 [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. Plus de détails sont disponibles en suivant 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>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>Mappage 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>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 mappage standard.\
> \&#xNAN;**\[2]** Priorité sur le côté 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> (insensible à la casse) alors ceci 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 ceci est défini avec <mark style="color:bleu;">`PHYSICAL_STORE`</mark> . Valeur par défaut : <mark style="color:bleu;">`WEBSITE`</mark> .\
> \&#xNAN;**\[3]** Voir <mark style="color:bleu;">`Reddit event name`</mark> dans <mark style="color:bleu;">`Mappage des événements`</mark> <mark style="color:$primary;">.</mark>\
> \&#xNAN;**\[4]** Si aucune valeur n’est fournie, celle-ci est récupérée depuis l’URL de la page en analysant le paramètre <mark style="color:bleu;">`rdt_cid`</mark> .\
> \&#xNAN;**\[5]** Défini dans <mark style="color:bleu;">`metadata`</mark> field.\
> \&#xNAN;**\[6]** En fonction de la longueur du champ « Smart Mapping » fourni <mark style="color:bleu;">`Item List`</mark> .\
> \&#xNAN;**\[7]** Toutes les catégories fournies sont séparées par le caractère « supérieur à » ( `>` ).\
> \&#xNAN;**\[8]** Défini dans <mark style="color:bleu;">`user`</mark> field.\
> \&#xNAN;**\[9]** Ces propriétés nécessitent une valeur appropriée, <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> .\
> \&#xNAN;**\[10]** Hachée automatiquement via SHA256 lorsqu’elle est fournie en texte clair.\
> \&#xNAN;**\[11]** Défini dans <mark style="color:bleu;">`user.data_processing_options`</mark> field.\
> \&#xNAN;**\[12]** Valeur prise en charge : <mark style="color:bleu;">`LDU`</mark> .\
> \&#xNAN;**\[13]** Défini dans <mark style="color:bleu;">`user.screen_dimensions`</mark> field.\
> \&#xNAN;**\[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.