# Mapp

[Mapp](https://mapp.com/), anciennement Webtrekk, génère des Insights exploitables pour les marques afin d'interagir avec leurs clients et de lancer 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).

## Principales fonctionnalités

La destination Mapp fournit les fonctionnalités clés suivantes :

* **Structure des events**: notre [Events reference](https://community.commandersact.com/platform-x/developers/tracking/events-reference) couvre [Types de requête 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 mappées vers les champs attendus de manière optimisée.
* **Mappings préconçus**: le mapping des données pour les destinations basées sur des événements se fait automatiquement, ce qui simplifie les entrées utilisateur.
* **Événements et propriétés personnalisés** : vous pouvez librement envoyer des événements et des propriétés personnalisés selon vos besoins spécifiques.
* **Support des données multi-item**: les informations incluses dans le [item](https://community.commandersact.com/platform-x/developers/tracking/events-reference#item) array 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:blue;">`Custom Event Properties`</mark>Voir [Configuration](#configuration) pour plus de détails.\
Utilisez [**Filtres de destination**](https://doc.commandersact.com/features/destinations/destination-filters) pour affiner les événements et/ou autres propriétés en fonction de vos besoins spécifiques.
{% endhint %}

### Configuration

<table><thead><tr><th width="150">Settings</th><th>Description</th></tr></thead><tbody><tr><td><code>Track Domain</code></td><td><p><em><strong><code>Requis</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>Requis</code></strong></em></p><p>Votre identifiant de track fourni par Mapp.</p></td></tr><tr><td><code>Custom Event Properties</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>. Par ex. si vous saisissez<code>size</code>dans le <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 disposerez d'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 devriez conserver la valeur par défaut <code>Default (root)</code> car elle correspond mieux à la plupart des scénarios. Dans le cas où vous sélectionnez soit <code>In "items" {items.X}</code> ou <code>In "product" {items.X.product}</code> cette destination cherchera la propriété d'événement d'entrée en commençant par le 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 "ct" de Mapp</code></td><td>Sous les « Paramètres avancés », vous avez la possibilité d'exclure le <code>ct</code> paramètre en cochant cette case. Plus d'informations sur ce paramètre sont disponibles dans la <a href="#field-mappings">Field Mapping</a> section.</td></tr></tbody></table>

{% hint style="info" %}
**\[1]** En utilisant des "dots" (".") vous pouvez naviguer plus profondément jusqu'au champ spécifique dont vous souhaitez obtenir la valeur. Voir [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 pas de limites.
{% endhint %}

## Référence rapide

| Commanders Act Events | Type de requête Mapp                                |
| --------------------- | --------------------------------------------------- |
| `[Any Event]`         | `page` ou `événement` 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ête Mapp sont disponibles en suivant ce [LINK](https://documentation.mapp.com/1.0/en/which-request-types-are-supported-by-mapp-intelligence-36143348.html).
{% endhint %}

## Mappages de champs

{% hint style="info" %}
La gestion de la session est effectuée par Mapp en utilisant l'ever id. Si cette information n'est pas disponible, la session est reconnue par l'user agent et l'adresse IP. Plus de détails sont disponibles en suivant ce [LINK](https://documentation.mapp.com/1.0/en/session-and-visitor-handling-7240758.html).\
Selon les types de requête Mapp que vous envoyez, certaines propriétés peuvent ne pas être suivies par Mapp. Plus de détails sont disponibles en suivant ce [LINK](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>valeurs</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>Custom Event Properties</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:blue;">`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) array est rempli et selon les événements entrants, ceci est défini avec :\
> •<mark style="color:blue;">**`add`**</mark>, pour [**add\_to\_cart**](https://doc.commandersact.com/developers/tracking/events-reference#add_to_cart) event.\
> •<mark style="color:blue;">**`conf`**</mark>, pour [**purchase**](https://doc.commandersact.com/developers/tracking/events-reference#purchase) event.\
> •<mark style="color:blue;">**`view`**</mark>, comme valeur par défaut.  \
> \&#xNAN;**\[6]** Informations produit séparées par un point-virgule et montants calculés arrondis à deux décimales.  \
> \&#xNAN;**\[7]** Voir<mark style="color:blue;">`Custom Event Properties`</mark>dans [Configuration ](#configuration)pour plus de détails sur la façon dont vous pouvez relier les propriétés personnalisées à Mapp.
> {% endhint %}