> 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 permettant aux marques d’interagir avec leurs clients et de déployer des campagnes marketing cross-canal. Cette destination vous permet d’implémenter le tracking server-side de 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 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 [les types de requêtes Mapp](https://documentation.mapp.com/1.0/en/which-request-types-are-supported-by-mapp-intelligence-36143348.html), ce qui garantit que vos données sont correctement associé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 s’effectue automatiquement, ce qui simplifie la saisie.
* **Événements et propriétés personnalisés** : vous pouvez envoyer librement des événements et des propriétés personnalisés selon vos besoins spécifiques.
* **Prise en charge des données multi-éléments** : les informations incluses dans le tableau [item](https://community.commandersact.com/platform-x/developers/tracking/events-reference#item) sont transmises à 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;">`Custom Event Properties`</mark>. Consultez la section [Configuration](#configuration) pour en savoir plus.\
Utilisez les [**filtres de destination**](https://doc.commandersact.com/features/destinations/destination-filters) pour affiner les événements et/ou les autres propriétés en fonction de 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 domaine de tracking, tel que 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 tracking, tel que fourni par Mapp.</p></td></tr><tr><td><code>Propriétés d’événement personnalisées</code></td><td><p>Associez vos propriétés d’événement personnalisées en renseignant leurs noms de champ dans <code>Event property name</code> et en ajoutant le nom du champ contenant la valeur dans <code>Commanders Act event property</code>. Par exemple, si vous saisissez<code>size</code>dans <code>Event property name</code> et <code>items.0.product.size</code> dans <code>Commanders Act event property</code>, vous aurez dans Mapp une propriété d’événement personnalisée appelée<code>size</code>dont la valeur dépend du contenu du champ <code>items.0.product.size</code> <strong>[1]</strong>.</p><p><br>Dans la colonne <code>Commanders Act event property position</code> conservez la valeur par défaut <code>Default (root)</code> car elle convient à 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’événement saisie à partir de <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éner les valeurs séparées par un point-virgule (";").</p></td></tr><tr><td><code>Exclude Mapp "ct" Parameter</code></td><td>Dans les « Paramètres avancés », vous pouvez exclure le paramètre Mapp <code>ct</code> en cochant cette case. Vous trouverez plus d’informations sur ce paramètre dans la section <a href="#field-mappings">Mappage des champs</a> .</td></tr></tbody></table>

{% hint style="info" %}
**1.** Les « points » (".") permettent d’accéder à des champs plus profonds pour récupérer la valeur souhaitée. Consultez la section [Référence des événements](https://community.commandersact.com/platform-x/developers/tracking/events-reference) pour en savoir plus sur les noms de champs standard par événement. Vous pouvez également définir librement des champs personnalisés : aucune limite ne s’applique.
{% endhint %}

## Référence rapide

| Événements Commanders Act | Type de requête Mapp                            |
| ------------------------- | ----------------------------------------------- |
| `[Any Event]`             | `page` ou `event` ou `media` ou `form` **\[1]** |

{% hint style="info" %}
**1.** Les événements personnalisés sont également pris en charge. Pour en savoir plus sur les types de requêtes Mapp, consultez ce [LIEN](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 des sessions est assurée par Mapp à l’aide de l’ever id. Si ces informations ne sont pas disponibles, la session est identifiée à l’aide de l’agent utilisateur et de l’adresse IP. Pour en savoir plus, consultez 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. Pour en savoir plus, consultez 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>.\
**2.** L’ordre de priorité est indiqué dans la colonne de gauche.\
**3.** Propriété encodée.\
**4.** Propriété exclue de l’événement [**page\_view**](https://doc.commandersact.com/developers/tracking/events-reference#page_view) event.\
**5.** Si le tableau [**items**](https://community.commandersact.com/platform-x/developers/tracking/events-reference#item) est renseigné et selon les événements reçus, cette valeur est définie comme suit :\
•<mark style="color:bleu;">**`add`**</mark>, pour l’événement [**add\_to\_cart**](https://doc.commandersact.com/developers/tracking/events-reference#add_to_cart) \
•<mark style="color:bleu;">**`conf`**</mark>, pour l’événement [**purchase**](https://doc.commandersact.com/developers/tracking/events-reference#purchase) \
•<mark style="color:bleu;">**`view`**</mark>, comme valeur par défaut.\
**6.** Les informations sur les produits sont séparées par des points-virgules et les montants calculés sont arrondis à deux décimales.\
**7.** Consultez<mark style="color:bleu;">`Custom Event Properties`</mark>dans [Configuration ](#configuration)pour en savoir plus sur la manière de transmettre 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://doc.commandersact.com/fr/fonctionnalites/destinations/destinations-catalog/mapp.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
