> 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 qui permet de suivre les visites en ligne sur un ou plusieurs sites Web et d’afficher des rapports sur ces visites à des fins d’analyse.\
Cette destination vous permet de mettre en œuvre le tracking server-side avec Matomo [Tracking HTTP API](https://developer.matomo.org/api-reference/tracking-api).

## Fonctionnalités clés

La destination Matomo 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 [la structure des requêtes de Matomo](https://developer.matomo.org/api-reference/tracking-api), ce qui permet de faire correspondre correctement vos donné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 les saisies des utilisateurs.
* **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 des propriétés personnalisés en fonction de vos besoins spécifiques.
* **Prise en charge des données contenant plusieurs éléments**: les informations incluses dans le [tableau ](https://community.commandersact.com/platform-x/developers/tracking/events-reference#item)item sont associées à 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 facultatifs de Matomo ne seront pas disponibles dans votre application / couche technique, ce qui est normal, 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>Server Domain</code></td><td><p><em><strong><code>Required</code></strong></em></p><p>Votre domaine de serveur tel qu’indiqué par Matomo. (Par exemple, pour https://<mark style="color:bleu;"><code>your-matomo-domain.example</code></mark>/matomo.php, indiquez uniquement la chaîne bleue).</p></td></tr><tr><td><code>Site Id</code></td><td><p><em><strong><code>Required</code></strong></em></p><p>L’identifiant de votre site tel qu’indiqué par Matomo. Pour en savoir plus, consultez ce <a href="https://matomo.org/faq/general/faq_19212/">LIEN</a>.</p></td></tr><tr><td><code>Visitor Id Cookie Name</code></td><td>Nom du cookie contenant quelques informations sur l’utilisateur, comme l’identifiant unique du visiteur. Il commence généralement par la chaîne <code>_pk_id</code>. Ce champ est prioritaire sur le champ suivant <code>Visitor Id Value</code> . Pour en savoir plus, consultez ce <a href="https://matomo.org/faq/general/faq_146/">LIEN</a>. (Par exemple, la 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>User Identifier</code></td><td>Vous pouvez associer l’identifiant utilisateur de votre choix pour les utilisateurs connectés. Pour en savoir plus, consultez ce <a href="https://matomo.org/guide/reports/user-ids/">LIEN</a>.</td></tr><tr><td><code>Matomo Custom Variables</code></td><td>Associez vos variables personnalisées Matomo en indiquant leurs noms de champ dans <code>Custom Variable Name</code> et en ajoutant le nom du champ contenant la valeur dans <code>Commanders Act event property or static value</code>. Par exemple, si vous saisissez<code>size</code>dans <code>Custom Variable Name</code> et <code>items.0.product.size</code> dans <code>Commanders Act event property or static value</code>, une variable personnalisée appelée<code>size</code>sera créée dans Matomo avec une valeur basée sur le contenu du champ <code>items.0.product.size</code> <strong>[1]</strong>. Vous pouvez également définir une valeur statique sous forme de chaîne ou de nombre dans <code>Commanders Act event property or static value</code>.<br><br>Pour en savoir plus sur les variables personnalisées, consultez ce <a href="https://matomo.org/faq/how-to/guide-to-using-custom-variables-deprecated/">LIEN</a>.</td></tr><tr><td><code>Matomo Custom Parameters</code></td><td>Mappez vos paramètres personnalisés Matomo en définissant leurs noms de champ dans <code>Custom Parameter Name</code> et en ajoutant le nom du champ contenant la valeur dans <code>Commanders Act event property or static value</code>. Par exemple, si vous saisissez<code>size</code>dans <code>Custom Parameter Name</code> et <code>items.0.product.size</code> dans <code>Commanders Act event property or static value</code>, vous disposerez d'un paramètre personnalisé dans Matomo appelé<code>size</code>dont la valeur sera basée sur le contenu du champ <code>items.0.product.size</code> <strong>[1]</strong>. Vous pouvez également définir une valeur statique sous forme de chaîne ou de nombre dans <code>Commanders Act event property or static value</code>.<br><br>Pour en savoir plus sur les paramètres et dimensions personnalisés, consultez ce <a href="https://matomo.org/guide/reporting-tools/custom-dimensions/">LIEN</a>.</td></tr><tr><td><code>Matomo Goals</code></td><td>Mappez vos objectifs Matomo en définissant le <code>Commanders Act Event Name</code> dans le champ correspondant et le <code>Matomo Goal Id</code> qui lui est associé.<br><br>Pour en savoir plus sur les objectifs, consultez ce <a href="https://matomo.org/guide/reports/goals-and-conversions/">LIEN</a>.</td></tr><tr><td><code>Authorization Token</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 dédié à l'accès à la « Tracking API » et de lui accorder uniquement <strong>l'autorisation </strong><em><strong>d'écriture</strong></em><strong> sur le ou les sites web. Pour en savoir plus sur les paramètres supplémentaires, consultez ce</strong> LINK <a href="https://developer.matomo.org/api-reference/tracking-api#other-parameters-require-authentication-via-token_auth">LIEN</a>.</td></tr></tbody></table>

{% hint style="info" %}
**1.** À l’aide de « points » (« . »), vous pouvez naviguer plus en profondeur jusqu’au champ spécifique dont vous souhaitez obtenir la valeur. Consultez la [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 sur<mark style="color:bleu;">`ca_event`</mark>.\
Les paramètres e-commerce sont transmis pour les événements [d'achat](https://community.commandersact.com/platform-x/developers/tracking/events-reference#purchase) entrants.
{% endhint %}

| Propriétés Commanders Act                                                                                                                                                                                                              | Propriétés Matomo                                                                |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- |
| `Site Id`                                                                                                                                                                                                                              | `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>Visitor Id Cookie Name</code></p><p><code>Visitor Id Value</code></p>                                                                                                                                                         | `_id` **\[1]**                                                                   |
| `page.referrer`                                                                                                                                                                                                                        | `urlref`                                                                         |
| `Matomo Custom Variables`                                                                                                                                                                                                              | `_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`                                                                         |
| `Matomo Goals`                                                                                                                                                                                                                         | `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`                                                                          |
| `Authorization Token`                                                                                                                                                                                                                  | `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’identifiant du visiteur. Vous pouvez également transmettre la valeur à l’aide d’une propriété du datalayer. Voir [Configuration ](#configuration)pour plus de détails.\
**2.** Selon la sélection dans la liste déroulante (voir<mark style="color:bleu;">`User Identifier`</mark>dans[`Configuration`](#configuration)), une propriété spécifique de Commanders Act est utilisée.\
**3.** Selon votre configuration (voir<mark style="color:bleu;">`Matomo Goals`</mark>dans[`Configuration`](#configuration)), un identifiant spécifique est défini dans ce champ. Pour les événements[`purchase`](https://community.commandersact.com/platform-x/developers/tracking/events-reference#purchase),<mark style="color:bleu;">`0`</mark>est transmis comme identifiant.\
**4.** Le tableau obtenu 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 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/matomo.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.
