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

# 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.\
En utilisant cette destination, vous pouvez mettre en place le suivi server-side avec Matomo [API HTTP de suivi](https://developer.matomo.org/api-reference/tracking-api).

## Fonctionnalités clés

La destination Matomo 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 [La structure de requête de Matomo](https://developer.matomo.org/api-reference/tracking-api)Google, ce qui signifie que vos données sont correctement reliées aux champs attendus de manière optimisée.
* **Mappings prédéfinis**: le mapping des données pour les destinations basées sur des événements se fait automatiquement, ce qui simplifie la saisie 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-article**: les informations incluses dans le [item ](https://community.commandersact.com/platform-x/developers/tracking/events-reference#item)le tableau est transmis à Matomo.

## Configuration de la destination

{% hint style="info" %}
Matomo recommande d’utiliser des paramètres personnalisés plutôt que des variables personnalisées, car ces dernières sont obsolètes. Les données de certains champs optionnels de 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 exemple, pour https://<mark style="color:bleu;"><code>your-matomo-domain.example</code></mark>/matomo.php, incluez uniquement la chaîne bleue).</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 en suivant ce lien <a href="https://matomo.org/faq/general/faq_19212/">LINK</a>.</p></td></tr><tr><td><code>Nom du cookie de l’ID visiteur</code></td><td>Nom du cookie contenant quelques détails sur l’utilisateur, comme l’identifiant unique du visiteur. Il commence généralement par la chaîne <code>_pk_id</code>. Celui-ci a priorité sur le champ suivant <code>Valeur de l’ID visiteur</code> . Plus de détails sont disponibles en suivant ce lien <a href="https://matomo.org/faq/general/faq_146/">LINK</a>. (Par exemple, la valeur "4e4eb04b31f37eac.1653656637.")</td></tr><tr><td><code>Valeur de l’ID visiteur</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 transmettre l’identifiant utilisateur sélectionné pour les utilisateurs connectés. Plus de détails sont disponibles en suivant ce lien <a href="https://matomo.org/guide/reports/user-ids/">LINK</a>.</td></tr><tr><td><code>Variables personnalisées Matomo</code></td><td>Faites correspondre vos variables personnalisées Matomo en définissant leurs noms de champ dans <code>Nom de la 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 la 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 dans Matomo une variable personnalisée 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 également la possibilité de définir une valeur statique de type chaîne ou 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 en suivant ce lien <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>Faites correspondre 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 dans Matomo un paramètre personnalisé 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 également la possibilité de définir une valeur statique de type chaîne ou 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/dimensions personnalisés sont disponibles en suivant ce lien <a href="https://matomo.org/guide/reporting-tools/custom-dimensions/">LINK</a>.</td></tr><tr><td><code>Objectifs Matomo</code></td><td>Faites correspondre vos objectifs Matomo en définissant le <code>Nom de l'événement Commanders Act</code> dans le champ associé et le <code>ID de l’objectif Matomo</code> qui lui est associé.<br><br>Plus de détails sur les objectifs sont disponibles en suivant ce lien <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 à la "Tracking API", et d’accorder à cet utilisateur <strong>uniquement </strong><em><strong>écriture</strong></em><strong> autorisation</strong> sur le ou les sites web. Plus de détails sur les paramètres supplémentaires sont disponibles en suivant ce lien <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 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 événement. Vous pouvez également définir librement des champs personnalisés : il n'y a aucune limite.
{% endhint %}

## Mappages de champs

{% hint style="info" %}
propriété Matomo<mark style="color:bleu;">`e_c`</mark>est défini statiquement avec<mark style="color:bleu;">`ca_event`</mark>.\
Les paramètres e-commerce sont transmis pour les [purchase](https://community.commandersact.com/platform-x/developers/tracking/events-reference#purchase) événements.
{% 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 de l’ID visiteur</code></p><p><code>Valeur de l’ID visiteur</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>\[propriété personnalisée]</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:bleu;">`_pk_id`</mark>pour en récupérer l’ID du visiteur. Vous pouvez également transmettre la valeur à l’aide d’une propriété du data layer. Voir [Configuration ](#configuration)pour plus de détails.\
**2.** Selon la sélection dans la liste déroulante (voir<mark style="color:bleu;">`Identifiant utilisateur`</mark>dans[`Configuration`](#configuration)), une propriété Commanders Act spécifique est utilisée.\
**3.** Selon votre configuration (voir<mark style="color:bleu;">`Objectifs Matomo`</mark>dans[`Configuration`](#configuration)), un identifiant spécifique est défini dans ce champ. Avec[`purchase`](https://community.commandersact.com/platform-x/developers/tracking/events-reference#purchase)les événements,<mark style="color:bleu;">`0`</mark>est transmis comme identifiant.\
**4.** Le tableau résultant est encodé.
{% 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:

```
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.