# Matomo

[Matomo](https://matomo.org/), anciennement Piwik, est une application d’analyse web open source permettant de suivre les visites en ligne sur un ou plusieurs sites web et d’afficher des rapports sur ces visites à des fins d’analyse.\
Grâce à cette destination, vous pouvez mettre en place un suivi server-side à l’aide de Matomo [Tracking HTTP API](https://developer.matomo.org/api-reference/tracking-api).

## Fonctionnalités clés

La destination Matomo fournit 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 [la structure des requêtes de Matomo](https://developer.matomo.org/api-reference/tracking-api), ce qui signifie que vos données sont correctement bridgées vers les champs attendus, de manière optimisée.
* **Mappings préconfigurés**: le mapping des données pour les destinations basées sur des événements se fait automatiquement, ce qui simplifie les saisies utilisateur.
* **Hachage automatique**: les informations sont automatiquement hachées conformément aux spécifications du partenaire.
* **Événements et propriétés personnalisés**: vous pouvez envoyer librement des événements et propriétés personnalisés selon vos besoins spécifiques.
* **Prise en charge des données multi-articles**: les informations incluses dans le [item ](https://community.commandersact.com/platform-x/developers/tracking/events-reference#item)array sont bridgées vers Matomo.

## Configuration de la destination

{% hint style="info" %}
Matomo recommande d’utiliser des paramètres personnalisés plutôt que des variables personnalisées, ces dernières étant obsolètes. Les données de certains champs optionnels Matomo ne seront pas disponibles dans votre application / couche technique, ce qui est attendu, mais vous devez fournir autant d’informations que possible.
{% endhint %}

### Configuration

<table><thead><tr><th width="315">Paramètres</th><th>Description</th></tr></thead><tbody><tr><td><code>Domaine du serveur</code></td><td><p><em><strong><code>Obligatoire</code></strong></em></p><p>Votre domaine serveur tel que fourni par Matomo. (Par ex. pour https://<mark style="color:blue;"><code>your-matomo-domain.example</code></mark>/matomo.php, incluez uniquement la chaîne blue).</p></td></tr><tr><td><code>ID du site</code></td><td><p><em><strong><code>Obligatoire</code></strong></em></p><p>Votre identifiant de site tel que fourni par Matomo. Plus de détails sont disponibles via ce <a href="https://matomo.org/faq/general/faq_19212/">LINK</a>.</p></td></tr><tr><td><code>Nom du cookie Visitor Id</code></td><td>Nom du cookie contenant quelques détails sur l’utilisateur, comme l’identifiant unique du visiteur. Il commence normalement par la chaîne <code>_pk_id</code>. Cela a priorité sur le champ suivant <code>Visitor Id Value</code> . Plus de détails sont disponibles via ce <a href="https://matomo.org/faq/general/faq_146/">LINK</a>. (Par ex. valeur "4e4eb04b31f37eac.1653656637.")</td></tr><tr><td><code>Visitor Id Value</code></td><td>La valeur de l’identifiant unique du visiteur si vous devez la transmettre sans cookie.</td></tr><tr><td><code>Identifiant utilisateur</code></td><td>Vous pouvez bridger l’identifiant utilisateur que vous avez sélectionné pour les utilisateurs connectés. Plus de détails sont disponibles via ce <a href="https://matomo.org/guide/reports/user-ids/">LINK</a>.</td></tr><tr><td><code>Variables personnalisées Matomo</code></td><td>Mappez vos variables personnalisées Matomo en définissant leurs noms de champ dans <code>Nom de variable personnalisée</code> et en ajoutant le nom du champ contenant la valeur dans <code>propriété d’événement Commanders Act ou valeur statique</code>. Par ex. si vous saisissez<code>size</code>dans <code>Nom de variable personnalisée</code> et <code>items.0.product.size</code> dans <code>propriété d’événement Commanders Act ou valeur statique</code>, vous aurez une variable personnalisée dans Matomo appelée<code>size</code>avec une valeur basée sur le contenu du champ <code>items.0.product.size</code> <strong>[1]</strong>. Vous avez aussi la possibilité de définir une valeur statique de type chaîne/numérique dans <code>propriété d’événement Commanders Act ou valeur statique</code>.<br><br>Plus de détails sur les variables personnalisées sont disponibles via ce <a href="https://matomo.org/faq/how-to/guide-to-using-custom-variables-deprecated/">LINK</a>.</td></tr><tr><td><code>Paramètres personnalisés Matomo</code></td><td>Mappez vos paramètres personnalisés Matomo en définissant leurs noms de champ dans <code>Nom du paramètre personnalisé</code> et en ajoutant le nom du champ contenant la valeur dans <code>propriété d’événement Commanders Act ou valeur statique</code>. Par ex. si vous saisissez<code>size</code>dans <code>Nom du paramètre personnalisé</code> et <code>items.0.product.size</code> dans <code>propriété d’événement Commanders Act ou valeur statique</code>, vous aurez un paramètre personnalisé dans Matomo appelé<code>size</code>avec une valeur basée sur le contenu du champ <code>items.0.product.size</code> <strong>[1]</strong>. Vous avez aussi la possibilité de définir une valeur statique de type chaîne/numérique dans <code>propriété d’événement Commanders Act ou valeur statique</code>.<br><br>Plus de détails sur les paramètres personnalisés / dimensions sont disponibles via ce <a href="https://matomo.org/guide/reporting-tools/custom-dimensions/">LINK</a>.</td></tr><tr><td><code>Objectifs Matomo</code></td><td>Mappez vos objectifs Matomo en définissant le <code>Nom de l’événement Commanders Act</code> dans le champ correspondant et le <code>ID de l’objectif Matomo</code> qui lui est associé.<br><br>Plus de détails sur les objectifs sont disponibles via ce <a href="https://matomo.org/guide/reports/goals-and-conversions/">LINK</a>.</td></tr><tr><td><code>Jeton d’autorisation</code></td><td>Un <a href="https://matomo.org/faq/general/faq_114/">jeton d’autorisation</a> est requis pour envoyer des paramètres supplémentaires. Dans l’interface de Matomo, il est recommandé de créer un utilisateur spécifiquement pour accéder au "Tracking API", et de donner à cet utilisateur uniquement la permission <strong>de </strong><em><strong>write</strong></em><strong> permission</strong> sur le(s) site(s) web. Plus de détails sur les paramètres supplémentaires sont disponibles via ce <a href="https://developer.matomo.org/api-reference/tracking-api#other-parameters-require-authentication-via-token_auth">LINK</a>.</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 %}

## Mappings de champs

{% hint style="info" %}
Propriété Matomo<mark style="color:blue;">`e_c`</mark>est défini statiquement avec<mark style="color:blue;">`ca_event`</mark>.\
Les paramètres e-commerce sont transmis pour les événements [purchase](https://community.commandersact.com/platform-x/developers/tracking/events-reference#purchase) entrants.
{% endhint %}

| Propriétés Commanders Act                                                                                                                                                                                                              | Propriétés Matomo                                                                |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- |
| `ID du site`                                                                                                                                                                                                                           | `idsite`                                                                         |
| `event_name`                                                                                                                                                                                                                           | <p><code>action\_name</code></p><p><code>e\_a</code></p><p><code>e\_n</code></p> |
| `value`                                                                                                                                                                                                                                | <p><code>e\_v</code></p><p><code>revenue</code></p>                              |
| `page.location`                                                                                                                                                                                                                        | `url`                                                                            |
| `device.user_agent`                                                                                                                                                                                                                    | `ua`                                                                             |
| <p><code>Nom du cookie Visitor Id</code></p><p><code>Visitor Id Value</code></p>                                                                                                                                                       | `_id` **\[1]**                                                                   |
| `page.referrer`                                                                                                                                                                                                                        | `urlref`                                                                         |
| `Variables personnalisées Matomo`                                                                                                                                                                                                      | `_cvars`                                                                         |
| <p><code>user.id</code></p><p><code>user.email</code></p><p><code>user.email\_md5</code></p><p><code>user.email\_sha256</code></p><p><code>\[custom\_property]</code></p>                                                              | `uid` **\[2]**                                                                   |
| `search_term`                                                                                                                                                                                                                          | `search`                                                                         |
| `Objectifs Matomo`                                                                                                                                                                                                                     | `idgoal` **\[3]**                                                                |
| `id`                                                                                                                                                                                                                                   | `ec_id`                                                                          |
| \[\[`items.0.id`,`items.0.product.name`,`items.0.product.category_1`,`items.0.product.price`,`items.0.quantity`],`...`,\[`items.N.id`,`items.N.product.name`,`items.N.product.category_1`,`items.N.product.price`,`items.N.quantity`]] | `ec_items` **\[4]**                                                              |
| `revenue`                                                                                                                                                                                                                              | `ec_st`                                                                          |
| `tax_amount`                                                                                                                                                                                                                           | `ec_tx`                                                                          |
| `shipping_amount`                                                                                                                                                                                                                      | `ec_sh`                                                                          |
| `Jeton d’autorisation`                                                                                                                                                                                                                 | `token_auth`                                                                     |
| `device.ip`                                                                                                                                                                                                                            | `cip`                                                                            |
| `event_timestamp`                                                                                                                                                                                                                      | `cdt`                                                                            |

{% hint style="info" %}

> **1.** Si aucun cookie n’est fourni, cette destination recherche un nom de cookie contenant la chaîne<mark style="color:blue;">`_pk_id`</mark>pour récupérer l’identifiant du visiteur. Sinon, vous pouvez transmettre la valeur à l’aide d’une propriété de datalayer. Voir [Configuration ](#configuration)pour plus de détails.\
> **2.** Selon la sélection de la liste déroulante (Voir<mark style="color:blue;">`Identifiant utilisateur`</mark>dans[`Configuration`](#configuration)), une propriété Commanders Act spécifique est utilisée.\
> **3.** Selon votre configuration (Voir<mark style="color:blue;">`Objectifs Matomo`</mark>dans le[`Configuration`](#configuration)), un identifiant spécifique est défini dans ce champ. Avec les événements[`purchase`](https://community.commandersact.com/platform-x/developers/tracking/events-reference#purchase),<mark style="color:blue;">`0`</mark>est bridgé comme identifiant.\
> **4.** Le tableau résultant est encodé.
> {% 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/matomo.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.