# Reddit Conversions API

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

## 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 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 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-items** : les informations incluses dans le [item](https://doc.commandersact.com/developers/tracking/events-reference#item) array sont envoyées à Reddit.
* **Prise en charge du mode batch** : consultez <mark style="color:blue;">`Enable batch mode`</mark>  dans [Configuration](#configuration) pour les détails du 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 en suivant 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>Enable batch mode</code></td><td>Lorsqu’elle est cochée, plusieurs enregistrements sont envoyés en une seule requête, au lieu d’un par un.</td></tr><tr><td><code>Event Mapping</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 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]** Voir <mark style="color:blue;">`Event Mapping`</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: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/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 [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>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>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.\
> \&#xNAN;**\[2]** Priorité à gauche. Si <mark style="color:blue;">`context.device.type`</mark> est défini sur <mark style="color:blue;">`Android`</mark> ou <mark style="color:blue;">`iOS`</mark> (insensible à la casse), alors cette valeur est définie sur <mark style="color:blue;">`APP`</mark> . Si <mark style="color:blue;">`type`</mark> est défini sur <mark style="color:blue;">`offline`</mark> alors cette valeur est définie sur <mark style="color:blue;">`PHYSICAL_STORE`</mark> . Valeur par défaut : <mark style="color:blue;">`WEBSITE`</mark> .\
> \&#xNAN;**\[3]** Voir <mark style="color:blue;">`Nom de l’événement Reddit`</mark>  dans <mark style="color:blue;">`Event Mapping`</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> .  \
> \&#xNAN;**\[5]** Défini dans le champ <mark style="color:blue;">`metadata`</mark> .  \
> \&#xNAN;**\[6]** En fonction de la longueur du champ "Smart Mapping" fourni <mark style="color:blue;">`Liste d’articles`</mark> .  \
> \&#xNAN;**\[7]** Toutes les catégories fournies sont séparées par le caractère "supérieur à" ( `>` ).  \
> \&#xNAN;**\[8]** Défini dans le champ <mark style="color:blue;">`user`</mark> .  \
> \&#xNAN;**\[9]** Ces propriétés nécessitent une valeur correcte, <mark style="color:blue;">`iOS`</mark> ou <mark style="color:blue;">`Android`</mark>  , pour le champ "Smart Mapping" <mark style="color:blue;">`Plateforme de l’appareil`</mark> .  \
> \&#xNAN;**\[10]** Automatiquement haché via SHA256 lorsqu’il est fourni en clair.  \
> \&#xNAN;**\[11]** Défini dans le champ <mark style="color:blue;">`user.data_processing_options`</mark> .  \
> \&#xNAN;**\[12]** Valeur prise en charge : <mark style="color:blue;">`LDU`</mark> .  \
> \&#xNAN;**\[13]** Défini dans le champ <mark style="color:blue;">`user.screen_dimensions`</mark> .\
> \&#xNAN;**\[14]** Défini dans le chemin de base.
> {% endhint %}