# Rakuten Events

[Rakuten Advertising](https://rakutenadvertising.com/) est une plateforme d’affiliation qui fournit des produits et des plateformes pilotés par les données pour alimenter à grande échelle les connexions entre annonceurs et éditeurs, en créant des correspondances pertinentes qui activent les audiences et accélèrent les performances. En utilisant cette destination, vous pouvez mettre en place le suivi server-side.

## Key features

La destination Rakuten Advertising fournit les fonctionnalités clés suivantes :

* **Events structure**: notre [Events reference](https://community.commandersact.com/platform-x/developers/tracking/events-reference) couvre le suivi des lead et des ventes de Rakuten Advertising, ce qui signifie que vos données sont correctement rapprochées des 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.
* **Smart mapping**: le mapping des données peut être réajusté à l’aide des champs définis dans votre datalayer.
* **Prise en charge des données multi-item**: les informations incluses dans le tableau [item ](https://community.commandersact.com/platform-x/developers/tracking/events-reference#item)Le tableau est rapproché de Rakuten Advertising.

## Configuration de la destination

{% hint style="info" %}
Rakuten Advertising ajoute par défaut un paramètre d’URL <mark style="color:bleu;">`ranSiteID`</mark> à votre page d’atterrissage. Cette valeur obligatoire est généralement stockée dans un cookie appelé <mark style="color:bleu;">**rmStore**</mark>, qui doit être inclus dans vos événements. Sinon, vous avez la possibilité d’envoyer ses valeurs en les renseignant dans le champ <mark style="color:bleu;">`Rakuten Affiliate Tracking Id (tr)`</mark> **\[1]**. Le cookie <mark style="color:bleu;">**rmStore**</mark> est également utilisé pour récupérer la propriété obligatoire <mark style="color:bleu;">`land`</mark> , qui peut aussi être envoyée à l’aide du champ<mark style="color:bleu;">`Rakuten User Arrival (land)`</mark> **\[1]**. Consultez [Field Mappings](#field-mappings) pour plus de détails.

> **\[1]** champ « Smart Mapping ».
> {% endhint %}

### Configuration

| Settings                  | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Affiliate Merchant Id`   | <p><em><strong><code>Requis si</code></strong></em><strong><code>Rakuten Affiliate Merchant Id (mid) n’est pas défini</code></strong></p><p>Votre « Affiliate Merchant Id » unique tel que fourni par Rakuten.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `Mappage`                 | <p><em><strong><code>Requis</code></strong></em><br>Mappez « Rakuten Conversion Types » avec vos « Commanders Act events » en définissant au moins un <code>Rakuten Conversion Type</code> et un <code>Commanders Act Event Name</code>. Une entrée est requise.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| `Custom Event Properties` | <p>Mappez vos propriétés custom d'event en renseignant leurs noms de champ dans <code>Nom de la propriété de l’événement</code> et en ajoutant le nom du champ contenant la valeur dans <code>propriété de l’événement Commanders Act</code>. Par ex. si vous saisissez<code>size</code>dans le <code>Nom de la propriété de l’événement</code> et <code>items.0.product.size</code> dans <code>propriété de l’événement Commanders Act</code>, vous aurez une propriété d’événement personnalisée dans Rakuten Advertising appelée<code>size</code>avec une valeur basée sur le contenu du champ <code>items.0.product.size</code> <strong>\[1]</strong>.<br><br>Dans la colonne <code>position de la propriété de l’événement Commanders Act</code> vous devez conserver la valeur par défaut <code>Par défaut</code> car elle convient mieux à la plupart des scénarios. Si vous sélectionnez <code>In "items" {items.X}</code> ou <code>In "product" {items.X.product}</code> cette destination recherchera la propriété d'event d'entrée à partir du niveau <a href="https://community.commandersact.com/platform-x/developers/tracking/events-reference#item">items </a>ou <a href="https://community.commandersact.com/platform-x/developers/tracking/events-reference#product">product </a>niveau respectivement et concaténez les valeurs séparées par un caractère pipe ("</p> |
| `Gateway Cookie Name`     | Vos liens d’éditeur dans Rakuten Advertising redirigeront les utilisateurs vers une page passerelle qui définit un cookie contenant des valeurs clés. Si vous n’utilisez pas le nom de cookie par défaut ("rmStore"), saisissez ici son nouveau nom.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |

{% hint style="info" %}
**\[1]** En utilisant des « points » (« . »), vous pouvez naviguer plus en profondeur jusqu’au champ spécifique dont vous souhaitez obtenir la valeur. Consultez [Events reference](https://community.commandersact.com/platform-x/developers/tracking/events-reference) pour plus de détails sur les noms de champs standard par événement. Vous pouvez également définir librement des champs personnalisés : il n’y a aucune limite.
{% endhint %}

## Référence rapide

| Commanders Act Events | Rakuten Conversion Type |
| --------------------- | ----------------------- |
| `[All events]`        | `Vente` ou `Lead`       |

## Mappages de champs

{% hint style="info" %}
La plupart des propriétés peuvent être remappées à l’aide de notre fonctionnalité « Smart Mapping ».\
Rakuten Advertising dispose de deux endpoints différents : le endpoint commissionable par défaut « ep » et le pixel d’optimisation média « eventnvppixel ». En utilisant le champ « Smart Mapping » <mark style="color:bleu;">`Rakuten Tracking Endpoint`</mark> vous pouvez sélectionner celui que vous souhaitez utiliser : définissez « mop » pour l’optimisation média « eventnvppixel » ou « ep » pour le endpoint standard. Veuillez noter qu’il existe des limitations concernant les paramètres que vous pouvez envoyer lors de la sélection du pixel d’optimisation média « eventnvppixel ».\
Pour le <mark style="color:bleu;">`Lead`</mark> type de conversion, si vous ne fournissez pas d’informations sur l’article telles que l’identifiant, la quantité et le nom, les valeurs fixes suivantes sont définies <mark style="color:bleu;">`skulist=Lead`</mark> , <mark style="color:bleu;">`qlist=1`</mark> et <mark style="color:bleu;">`namelist=Lead`</mark>. De plus, si <mark style="color:bleu;">`amtlist`</mark> ne peut pas être valorisé avec les informations fournies, il sera défini de manière statique comme suit : <mark style="color:bleu;">`amtlist=1`</mark> .\
Plus de détails sur les propriétés Rakuten sont disponibles en suivant ce [LIEN](https://rak.app.box.com/s/j3qtvbd300vqa1zyknxklx3itqyi0vlh).
{% endhint %}

<table><thead><tr><th width="503">Propriétés Commanders Act</th><th>Rakuten Properties</th></tr></thead><tbody><tr><td><code>Rakuten Affiliate Merchant Id (mid)</code><br><code>Affiliate Merchant Id</code></td><td><code>mid</code> <strong>[*][1]</strong></td></tr><tr><td><code>partners.rakuten.land</code><br><code>Gateway Cookie Name</code></td><td><code>land</code> <strong>[*][1][2]</strong></td></tr><tr><td><code>partners.rakuten.tr</code><br><code>Gateway Cookie Name</code></td><td><code>tr</code> <strong>[*][1]</strong></td></tr><tr><td><code>currency</code></td><td><code>cur</code> <strong>[*]</strong></td></tr><tr><td>((<code>items.X.product.price</code> * <code>items.X.quantity</code>) - (<code>[totalDiscount]</code> * (<code>items.X.product.price</code> * <code>items.X.quantity</code>)) / <code>[totalOrderFromItems]</code>) * 100</td><td><code>amtlist</code> <strong>[*][3][4]</strong></td></tr><tr><td><code>items.X.id</code></td><td><code>skulist</code> <strong>[*][4]</strong></td></tr><tr><td><code>items.X.quantity</code></td><td><code>qlist</code> <strong>[*][4]</strong></td></tr><tr><td><code>items.X.product.brand</code></td><td><code>brandlist</code> <strong>[4]</strong></td></tr><tr><td><code>items.X.product.category_1</code> > <code>items.X.product.category_2</code> > <code>items.X.product.category_3</code> > <code>items.X.product.category_4</code> > <code>items.X.product.category_5</code></td><td><code>catlist</code> <strong>[4]</strong></td></tr><tr><td><code>items.X.coupon</code></td><td><code>couponlist</code> <strong>[4]</strong></td></tr><tr><td><code>items.X.product.name</code></td><td><code>namelist</code> <strong>[4]</strong></td></tr><tr><td><code>id</code></td><td><code>ord</code></td></tr><tr><td><code>id_variant</code></td><td><code>altord</code></td></tr><tr><td><code>context.device.advertising_id</code></td><td><code>did</code></td></tr><tr><td><code>discount</code></td><td><code>discount</code></td></tr><tr><td><code>discount</code></td><td><code>disamt</code></td></tr><tr><td><code>user.id</code></td><td><code>custid</code></td></tr><tr><td><code>user.status</code></td><td><code>custstatus</code></td></tr><tr><td><code>coupon</code></td><td><code>coupon</code></td></tr><tr><td><code>status</code></td><td><code>ordstatus</code></td></tr></tbody></table>

{% hint style="info" %}

> **\[\*]** Propriété obligatoire.\
> \&#xNAN;**\[1]** L’ordre de priorité est indiqué dans la colonne de gauche.\
> \&#xNAN;**\[2]** <mark style="color:bleu;">`partners.rakuten.land`</mark> doit être au format 24 heures : <mark style="color:bleu;">`yyyymmdd_hhmm`</mark>.\
> \&#xNAN;**\[3]** si les informations sur les articles sont indiquées dans votre liste d’articles, cela est calculé à l’aide du prix de l’article et de la quantité d’articles ; sinon, le <mark style="color:bleu;">`revenue`</mark> est utilisé. La multiplication par 100 n’est pas appliquée lorsque <mark style="color:bleu;">`currency`</mark> est défini avec <mark style="color:bleu;">`JPN`</mark> .`[totalDiscount]`est défini avec <mark style="color:bleu;">`discount`</mark>, <mark style="color:bleu;">`items.X.discount`</mark> <mark style="color:bleu;">(sum)</mark> ou 0, dans cet ordre de priorité présenté.\
> \&#xNAN;**\[4]** Les informations distinctes sur les produits sont séparées par un caractère pipe ("|").
> {% endhint %}