> 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 open source d'analytique web 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 [API HTTP de suivi](https://developer.matomo.org/api-reference/tracking-api).

## Fonctionnalités clés

La destination Matomo fournit 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 [La structure de requête de Matomo](https://developer.matomo.org/api-reference/tracking-api), 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.
* **Hachage automatique**: les informations sont hachées automatiquement conformément aux spécifications du partenaire.
* **É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 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, ces dernières étant dépréciées. Les données de certains champs facultatifs 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 <a href="https://matomo.org/faq/general/faq_19212/">LINK</a>.</p></td></tr><tr><td><code>Nom du cookie de l'ID du visiteur</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>. Ceci a priorité sur le champ suivant <code>Valeur de l'ID du visiteur</code> . Plus de détails sont disponibles en suivant ce <a href="https://matomo.org/faq/general/faq_146/">LINK</a>. (Par ex. la valeur "4e4eb04b31f37eac.1653656637.")</td></tr><tr><td><code>Valeur de l'ID du 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 votre identifiant utilisateur sélectionné pour les utilisateurs connectés. Plus de détails sont disponibles en suivant 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 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>. p. 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 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 également la possibilité de définir une valeur statique de 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 en suivant 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>. p. 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 également la possibilité de définir une valeur statique de 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/dimensions personnalisés sont disponibles en suivant 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 en suivant 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 Matomo, il est recommandé de créer un utilisateur spécifiquement pour accéder à l'"API de tracking", et de lui donner <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 <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 %}

## Correspondances des 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> |
| `valeur`                                                                                                                                                                                                                               | <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 du visiteur</code></p><p><code>Valeur de l'ID du 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>\[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:bleu;">`_pk_id`</mark>pour en extraire l'identifiant du visiteur. Sinon, vous pouvez transmettre la valeur à l'aide d'une propriété de 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 le[`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, and the optional `goal` query parameter:

```
GET https://doc.commandersact.com/fr/fonctionnalites/destinations/destinations-catalog/matomo.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.