# Mapp

[Mapp](https://mapp.com/), anciennement Webtrekk, génère des Insights exploitables pour permettre aux marques d’interagir avec leurs clients et de diffuser des campagnes marketing cross-channel. En utilisant cette destination, vous pouvez implémenter Mapp [server-side tracking](https://documentation.mapp.com/1.0/en/server-to-server-7240721.html).

## Fonctionnalités clés

La destination Mapp 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 [types de requêtes Mapp](https://documentation.mapp.com/1.0/en/which-request-types-are-supported-by-mapp-intelligence-36143348.html), 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 saisies utilisateur.
* **Événements et propriétés personnalisés**: vous pouvez envoyer librement des événements et des propriétés personnalisés en fonction de vos besoins spécifiques.
* **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) tableau est envoyé à Mapp.

## Configuration de la destination

{% hint style="info" %}
Cette destination prend en charge Mapp [paramètres indépendants](https://documentation.mapp.com/1.0/en/implementation-3-setup-options-for-the-tracking-of-elements-7209582.html#id-.Implementation3SetupOptionsfortheTrackingofElementsv1.0-12.2Independentparameters) en les détectant dans<mark style="color:bleu;">`Propriétés d’événement personnalisées`</mark>. Voir [Configuration](#configuration) pour plus de détails.\
Utilisez [**Destination filters**](https://doc.commandersact.com/features/destinations/destination-filters) pour affiner les événements et/ou d’autres propriétés correspondant à vos besoins spécifiques.
{% endhint %}

### Configuration

<table><thead><tr><th width="150">Paramètres</th><th>Description</th></tr></thead><tbody><tr><td><code>Track Domain</code></td><td><p><em><strong><code>Obligatoire</code></strong></em></p><p>Votre track domain fourni par Mapp.</p></td></tr><tr><td><code>Track ID</code></td><td><p><em><strong><code>Obligatoire</code></strong></em></p><p>Votre identifiant de track fourni par Mapp.</p></td></tr><tr><td><code>Propriétés d’événement personnalisées</code></td><td><p>Mappez vos propriétés d’événement personnalisées en définissant leurs noms de champ dans <code>Nom de propriété d’événement</code> et en ajoutant le nom du champ contenant la valeur dans <code>Propriété d’événement Commanders Act</code>. Ex. si vous saisissez<code>size</code>dans la <code>Nom de propriété d’é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 Mapp appelée<code>size</code>avec une valeur basée sur le contenu du champ <code>items.0.product.size</code> <strong>[1]</strong>.</p><p><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>Default (root)</code> car elle correspond mieux à la plupart des cas. 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 en 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 point-virgule (« ; »).</p></td></tr><tr><td><code>Exclure le paramètre Mapp "ct"</code></td><td>Dans les "Advanced Settings", vous avez la possibilité d’exclure le Mapp <code>ct</code> paramètre en cochant cette case. Plus d’informations sur ce paramètre sont disponibles dans le <a href="#field-mappings">Field Mapping</a> section.</td></tr></tbody></table>

{% 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 event. Vous pouvez aussi définir librement des champs personnalisés : il n’y a aucune limite.
{% endhint %}

## Référence rapide

| Événements Commanders Act | Mapp Request Type                               |
| ------------------------- | ----------------------------------------------- |
| `[Tout événement]`        | `page` ou `event` ou `media` ou `form` **\[1]** |

{% hint style="info" %}
**\[1]** Les événements personnalisés sont également pris en charge. Plus de détails sur les types de requêtes Mapp sont disponibles via ce [LIEN](https://documentation.mapp.com/1.0/en/which-request-types-are-supported-by-mapp-intelligence-36143348.html).
{% endhint %}

## Mappages des champs

{% hint style="info" %}
La gestion de la session est effectuée par Mapp à l’aide de l’ever id. Si cette information n’est pas disponible, la session est ճանաչue par l’user agent et l’adresse IP. Plus de détails sont disponibles via ce [LIEN](https://documentation.mapp.com/1.0/en/session-and-visitor-handling-7240758.html).\
Selon les types de requêtes Mapp que vous envoyez, certaines propriétés peuvent ne pas être suivies par Mapp. Plus de détails sont disponibles via ce [LIEN](https://documentation.mapp.com/1.0/en/which-request-types-are-supported-by-mapp-intelligence-36143348.html).
{% endhint %}

<table><thead><tr><th width="418">Propriétés Commanders Act</th><th>Propriétés Mapp</th></tr></thead><tbody><tr><td><code>partners.mapp.version</code>,<code>page.title</code>,0,<code>device.screen.width</code>x<code>device.screen.height</code>,<code>device.density</code>,0,<code>event_timestamp</code>,<code>page.referrer</code>,<code>device.screen.width</code>x<code>device.screen.height</code>,0</td><td><code>p</code> <strong>[1]</strong></td></tr><tr><td><p><code>partners.mapp.ceid</code></p><p><code>device.sdk_id</code></p><p><code>user.tcId</code></p></td><td><code>ceid</code> <strong>[2]</strong></td></tr><tr><td><p><code>partners.mapp.eid</code></p><p><code>cookie</code> <a href="https://documentation.mapp.com/1.0/en/session-and-visitor-handling-7240758.html"><strong>wt3_eid</strong></a></p></td><td><code>eid</code> <strong>[2]</strong></td></tr><tr><td><code>device.ip</code></td><td><code>X-WT-IP</code></td></tr><tr><td><code>device.user_agent</code></td><td><code>X-WT-UA</code> <strong>[3]</strong></td></tr><tr><td><code>page.url</code><br><code>page.location</code></td><td><code>X-WT-RQ</code> <strong>[2][3]</strong></td></tr><tr><td><code>page.lang</code></td><td><code>la</code></td></tr><tr><td><p><code>partners.mapp.event_name</code> ou</p><p><code>event_name</code></p></td><td><code>ct</code> <strong>[2][4]</strong></td></tr><tr><td><code>currency</code></td><td><code>cr</code></td></tr><tr><td><code>id</code></td><td><code>oi</code></td></tr><tr><td><code>value</code></td><td><code>ov</code></td></tr><tr><td><code>(event_name)</code></td><td><code>st</code> <strong>[5]</strong></td></tr><tr><td><code>items.X.product.name</code></td><td><code>ba</code> <strong>[6]</strong></td></tr><tr><td><code>items.X.product.price</code>*<code>items.X.quantity</code></td><td><code>co</code> <strong>[6]</strong></td></tr><tr><td><code>items.X.quantity</code></td><td><code>qn</code> <strong>[6]</strong></td></tr><tr><td><code>items.X.list_position</code></td><td><code>plp</code> <strong>[6]</strong></td></tr><tr><td><code>Propriétés d’événement personnalisées</code></td><td><code>[Custom Property Name]</code> <strong>[7]</strong></td></tr></tbody></table>

{% hint style="info" %}

> **\[1]** Valeur par défaut : <mark style="color:bleu;">`300,0,0,0,0,0,event_timestamp,0,0,0`</mark>.\
> \&#xNAN;**\[2]** L’ordre de priorité est indiqué dans la colonne de gauche.\
> \&#xNAN;**\[3]** Propriété encodée.\
> \&#xNAN;**\[4]** Propriété exclue avec [**page\_view**](https://doc.commandersact.com/developers/tracking/events-reference#page_view) event.\
> \&#xNAN;**\[5]** Si le [**items**](https://community.commandersact.com/platform-x/developers/tracking/events-reference#item) tableau est rempli et selon les événements entrants, cela est défini avec :\
> •<mark style="color:bleu;">**`ajouter`**</mark>, pour [**add\_to\_cart**](https://doc.commandersact.com/developers/tracking/events-reference#add_to_cart) event.\
> •<mark style="color:bleu;">**`conf`**</mark>, pour [**purchase**](https://doc.commandersact.com/developers/tracking/events-reference#purchase) event.\
> •<mark style="color:bleu;">**`view`**</mark>, comme valeur par défaut.\
> \&#xNAN;**\[6]** Les informations produit sont séparées par un point-virgule et les montants calculés sont arrondis à deux décimales.\
> \&#xNAN;**\[7]** Voir<mark style="color:bleu;">`Propriétés d’événement personnalisées`</mark>dans [Configuration ](#configuration)pour plus de détails sur la manière de relier des propriétés personnalisées à Mapp.
> {% endhint %}