> 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 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 la performance. En utilisant cette destination, vous pouvez mettre en place le suivi server-side.

## Fonctionnalités clés

La destination Rakuten Advertising fournit les principales fonctionnalité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 Rakuten Advertising, ce qui signifie que vos données sont correctement mappées vers les champs attendus de manière optimisée.
* **Mappages prédéfinis**: le mappage des données pour les destinations basées sur des événements s'effectue automatiquement, ce qui simplifie la saisie 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-items**: les informations incluses dans le [item ](https://community.commandersact.com/platform-x/developers/tracking/events-reference#item)Le tableau est mappé vers Rakuten Advertising.

## Configuration de la destination

{% hint style="info" %}
Rakuten Advertising ajoute un paramètre d'URL <mark style="color:bleu;">`ranSiteID`</mark> à votre landing page 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. Alternativement, vous avez la possibilité d'envoyer ses valeurs en le 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 également être envoyée en utilisant le champ<mark style="color:bleu;">`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                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `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 « ID marchand affilié » unique tel que fourni par Rakuten.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| `Mappage`                               | <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>Rakuten Conversion Type</code> et un <code>Nom de l'événement Commanders Act</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>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>. p. 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é d'é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é 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 scénarios. Si vous sélectionnez soit <code>Dans "items" {items.X}</code> ou <code>Dans "product" {items.X.product}</code> cette destination recherchera 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 respectif et concaténez les valeurs séparées par le caractère pipe ("</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 son nouveau nom ici.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |

{% hint style="info" %}
**1.** En utilisant des « points » ("."), vous pouvez naviguer plus profondément jusqu'au 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   | Rakuten Conversion Type |
| ----------------------- | ----------------------- |
| `[Tous les événements]` | `Vente` ou `Lead`       |

## Correspondances des 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 endpoints différents : le endpoint 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 endpoint standard. Veuillez noter qu'il existe des limites concernant les 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 d'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> .\
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>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 renseignées dans votre liste d'articles, ceci est calculé à partir du prix 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;">(sum)</mark> ou 0, dans cet ordre de priorité présenté.\
**4.** Les informations produit distinctes sont séparées par le caractère pipe ("|").
{% 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.