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

# Mapp

[Mapp](https://mapp.com/), anciennement Webtrekk, génère des Insights exploitables pour aider les marques à interagir avec leurs clients et à diffuser des campagnes marketing cross-channel. À l'aide de 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 des événements s'effectue automatiquement, ce qui simplifie la saisie 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.
* **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 envoyé à Mapp.

## Configuration de la destination

{% hint style="info" %}
Cette destination prend en charge les paramètres indépendants de Mapp [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 [**filtres de destination**](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>Domaine de suivi</code></td><td><p><em><strong><code>Obligatoire</code></strong></em></p><p>Votre domaine de suivi tel que fourni par Mapp.</p></td></tr><tr><td><code>ID de suivi</code></td><td><p><em><strong><code>Obligatoire</code></strong></em></p><p>Votre identifiant de suivi tel que 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 la 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>. p. ex. si vous saisissez<code>size</code>dans le <code>Nom de la 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>Par défaut (root)</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>au niveau respectif et concaténer les valeurs séparées par un point-virgule (";").</p></td></tr><tr><td><code>Exclure le paramètre Mapp "ct"</code></td><td>Sous les « Paramètres avancés », vous avez la possibilité d'exclure le paramètre Mapp <code>ct</code> en cochant cette case. Davantage d'informations sur ce paramètre sont disponibles dans le <a href="#field-mappings">Mappage des champs</a> section.</td></tr></tbody></table>

{% 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 | Type de requête Mapp                                      |
| --------------------- | --------------------------------------------------------- |
| `[Tout événement]`    | `page` ou `événement` ou `média` ou `formulaire` **\[1]** |

{% hint style="info" %}
**1.** Les événements personnalisés sont également pris en charge. Davantage de détails sur les types de requêtes 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 %}

## Correspondances des champs

{% hint style="info" %}
La gestion de session est effectuée par Mapp à l'aide de l'ever id. Si cette information n'est pas disponible, la session est reconnue par l'agent utilisateur et l'adresse IP. Davantage 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êtes Mapp que vous envoyez, certaines propriétés peuvent ne pas être suivies par Mapp. Davantage 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>valeur</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>.\
**2.** L'ordre de priorité est indiqué dans la colonne de gauche.\
**3.** Propriété encodée.\
**4.** Propriété exclue avec [**page\_view**](https://doc.commandersact.com/developers/tracking/events-reference#page_view) événement générique.\
**5.** Si le [**items**](https://community.commandersact.com/platform-x/developers/tracking/events-reference#item) le 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) événement.\
•<mark style="color:bleu;">**`conf`**</mark>, pour [**purchase**](https://doc.commandersact.com/developers/tracking/events-reference#purchase) événement.\
•<mark style="color:bleu;">**`view`**</mark>, comme valeur par défaut.\
**6.** Les informations produit sont séparées par un point-virgule et les montants calculés sont arrondis à deux décimales.\
**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
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/mapp.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.
