> 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/rakuten/rakuten-events.md).

# Rakuten Events

[Rakuten Advertising](https://rakutenadvertising.com/) est une plateforme d'affiliation qui fournit des produits et des plateformes fondés sur 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 un 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 des 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.
* **Mappings prédéfinis**: le mapping des données pour les destinations basées sur des événements se fait automatiquement, ce qui simplifie la saisie 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-article**: les informations incluses dans le [item ](https://community.commandersact.com/platform-x/developers/tracking/events-reference#item)le tableau est relié à Rakuten Advertising.

## Configuration de la destination

{% hint style="info" %}
Rakuten Advertising ajoute un paramètre d'URL <mark style="color:bleu;">`ranSiteID`</mark> à votre page de destination par défaut. 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 le fournissant 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 également être envoyé à l'aide du champ<mark style="color:bleu;">`Rakuten User Arrival (land)`</mark> **\[1]**. Voir [Correspondances des champs](#field-mappings) pour plus de détails.\
\
**1.** champ « Smart Mapping ».
{% endhint %}

### Configuration

| Paramètres                               | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| ---------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `ID marchand affilié`                    | <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 fourni par Rakuten.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `Correspondance`                         | <p><em><strong><code>Obligatoire</code></strong></em><br>Associez « Rakuten Conversion Types » à vos « événements Commanders Act » en définissant au moins un <code>Type de conversion Rakuten</code> et un <code>Nom de l'événement Commanders Act</code>. Une entrée est requise.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| `Propriétés d'événements personnalisées` | <p>Mappez vos propriétés d'événements personnalisées en définissant 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é d'événement Commanders Act</code>. Par ex. si vous saisissez<code>size</code>dans <code>Nom de la propriété de l'événement</code> et <code>items.0.product.size</code> dans <code>Propriété d'événement Commanders Act</code>, vous aurez dans Rakuten Advertising une propriété d'événement personnalisée 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é d'é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 cas. Si vous sélectionnez soit <code>Dans "items" {items.X}</code> ou <code>Dans "product" {items.X.product}</code> cette destination cherchera la propriété d'événement d'entrée à partir du <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 le caractère barre verticale ("</p> |
| `Nom du cookie Gateway`                  | Vos liens é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 en profondeur vers le champ spécifique dont vous souhaitez 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   | Type de conversion Rakuten |
| ----------------------- | -------------------------- |
| `[Tous les événements]` | `Vente` ou `Lead`          |

## Mappages de 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é.\
Rakuten Advertising dispose de deux points de terminaison différents : le point de terminaison commissionnable 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 choisir lequel utiliser : définissez « mop » pour l'optimisation média « eventnvppixel » ou « ep » pour le point de terminaison standard. Veuillez noter qu'il existe des limitations quant aux paramètres que vous pouvez envoyer lorsque vous sélectionnez le 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 statiquement comme suit : <mark style="color:bleu;">`amtlist=1`</mark> .\
Davantage 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>ID marchand affilié</code></td><td><code>mid</code> <strong>[*][1]</strong></td></tr><tr><td><code>partners.rakuten.land</code><br><code>Nom du cookie Gateway</code></td><td><code>land</code> <strong>[*][1][2]</strong></td></tr><tr><td><code>partners.rakuten.tr</code><br><code>Nom du cookie Gateway</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 indiqué dans la colonne de gauche.\
**2.** <mark style="color:bleu;">`partners.rakuten.land`</mark> doit être au format 24 heures : <mark style="color:bleu;">`yyyymmdd_hhmm`</mark>.\
**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é de l'article, 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;">(somme)</mark> ou 0, dans cet ordre de priorité présenté.\
**4.** Les informations distinctes sur le produit sont séparées par le caractère barre verticale (« | »).
{% 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/rakuten/rakuten-events.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.