# Rakuten Events

[Rakuten Advertising](https://rakutenadvertising.com/) est une plateforme d'affiliation qui fournit des produits et des plateformes basés sur les données afin de dynamiser à 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.

## Fonctionnalités clés

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

* **Structure des événements**: notre [Référence des événements](https://community.commandersact.com/platform-x/developers/tracking/events-reference) couvre le suivi lead et des ventes de Rakuten Advertising, 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 les événements se fait automatiquement, ce qui simplifie les entrées utilisateur.
* **Mappage intelligent**: le mappage des données peut être réajusté à l'aide des champs définis dans votre datalayer.
* **Prise en charge des données multi-éléments**: les informations incluses dans le [item ](https://community.commandersact.com/platform-x/developers/tracking/events-reference#item)array sont reliées à Rakuten Advertising.

## Configuration de la destination

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

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

### Configuration

| Paramètres                              | 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 configurant au moins un <code>Rakuten Conversion Type</code> et un <code>Commanders Act Event Name</code>. Une entrée est requise.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| `Propriétés d'événement personnalisées` | <p>Mappez vos propriétés d'événement personnalisées en définissant leurs noms de champ dans <code>Event property name</code> et en ajoutant le nom du champ contenant la valeur dans <code>Commanders Act event property</code>. Par ex., si vous saisissez<code>size</code>dans le <code>Event property name</code> et <code>items.0.product.size</code> dans <code>Commanders Act event property</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>Commanders Act event property position</code> vous devez conserver la valeur par défaut <code>Default</code> car elle convient mieux à la plupart des scénarios. Si vous sélectionnez soit <code>In "items" {items.X}</code> ou <code>In "product" {items.X.product}</code> cette destination recherchera la propriété d'événement saisie en partant 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>respectivement et concaténera 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 gateway 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 profondément jusqu'au champ spécifique dont vous voulez obtenir la valeur. Voir [Référence des événements](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 |
| ----------------------- | ----------------------- |
| `[Tous les événements]` | `Sale` ou `Lead`        |

## Mappages de champs

{% hint style="info" %}
Les propriétés peuvent être remappées à l'aide de notre [Smart Mapping](https://doc.commandersact.com/features/destinations/advanced-mapping#smart-mapping) fonctionnalité.\
Rakuten Advertising dispose de deux endpoints différents : le endpoint commissionnable par défaut "ep" et le pixel d'optimisation média "eventnvppixel". En utilisant le champ <mark style="color:blue;">`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 en termes de paramètres que vous pouvez envoyer lors de la sélection du pixel d'optimisation média "eventnvppixel".\
Pour le <mark style="color:blue;">`Lead`</mark> conversion type, si vous ne fournissez pas d'informations sur les items telles que l'identifiant, la quantité et le nom, les valeurs fixes suivantes sont définies <mark style="color:blue;">`skulist=Lead`</mark> , <mark style="color:blue;">`qlist=1`</mark> et <mark style="color:blue;">`namelist=Lead`</mark>. De plus, si <mark style="color:blue;">`amtlist`</mark> ne peut pas être valorisé avec les informations fournies, il sera défini de manière statique comme suit : <mark style="color:blue;">`amtlist=1`</mark> .\
Plus de détails sur les propriétés Rakuten sont disponibles via ce [LINK](https://rak.app.box.com/s/j3qtvbd300vqa1zyknxklx3itqyi0vlh).
{% endhint %}

<table><thead><tr><th width="503">Propriétés Commanders Act</th><th>Propriétés Rakuten</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.\
> **1.** L'ordre de priorité est सूची dans la colonne de gauche.\
> **2.** <mark style="color:blue;">`partners.rakuten.land`</mark> doit être au format 24 heures : <mark style="color:blue;">`yyyymmdd_hhmm`</mark>.\
> **3.** si les informations des items sont renseignées dans votre liste d'items, cela est calculé à l'aide du prix de l'item et de la quantité de l'item, sinon le <mark style="color:blue;">`revenue`</mark> est utilisé. La multiplication par 100 n'est pas appliquée lorsque <mark style="color:blue;">`currency`</mark> est défini avec <mark style="color:blue;">`JPN`</mark> .`[totalDiscount]`est défini avec <mark style="color:blue;">`discount`</mark>, <mark style="color:blue;">`items.X.discount`</mark> <mark style="color:blue;">(sum)</mark> ou 0, dans cet ordre de priorité présenté.\
> **4.** Les informations produit distinctes sont séparées par un caractère pipe ("|").
> {% 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/rakuten/rakuten-events.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.