# 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 %}


---

# 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/mapp.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.