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

# Piwik PRO

[Piwik PRO](https://piwik.pro/) « Analytics Suite » est une plateforme axée sur la confidentialité, qui permet de suivre et d’analyser le comportement des utilisateurs sur les sites Web et d’autres produits numériques. Ce produit est une alternative à Google Analytics, conçue pour répondre à des politiques de sécurité strictes et aux réglementations en matière de confidentialité.\
En utilisant cette destination, vous pouvez exploiter Piwik PRO [Tracking HTTP API](https://developers.piwik.pro/en/latest/data_collection/api/http_api.html) pour envoyer des événements. Les données envoyées à cette API seront traitées et apparaîtront ensuite dans les rapports Analytics.

## Fonctionnalités clés

La destination Piwik PRO 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) correspond au modèle des [types d’événements de Piwik PRO](https://developers.piwik.pro/en/latest/data_collection/api/http_api.html#/paths/~1ppms.php/get) (voir le paramètre de requête `e_t` ), ce qui signifie 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.
* **Mappage intelligent**: le mappage des données peut être ajusté à l’aide des champs définis dans votre datalayer.
* **Mappage des événements** : modifiez le mappage standard entre les événements de vos partenaires et les vôtres, ou ajoutez de nouveaux mappages.
* **Prise en charge des données à plusieurs éléments** : les informations incluses dans le tableau [item](https://community.commandersact.com/platform-x/developers/tracking/events-reference#item) sont transmises à Piwik PRO.

## Configuration de la destination

### Configuration

<table><thead><tr><th width="307">Paramètres</th><th>Description</th></tr></thead><tbody><tr><td><code>Instance Name</code></td><td><p><em><strong><code>Obligatoire</code></strong></em></p><p>Le nom de votre instance, tel qu’il vous a été fourni par Piwik PRO (par exemple, pour https://<strong>InstanceName</strong>.piwik.pro/ppms.php, indiquez uniquement la <strong>chaîne en gras</strong> ).</p></td></tr><tr><td><code>Application Id</code></td><td><em><strong><code>Required</code></strong></em><br>L’identifiant de votre application (anciennement « Website Id »), tel qu’il vous a été fourni par Piwik PRO.</td></tr><tr><td><code>Goal Identifiers</code></td><td>Associez vos identifiants d’objectif en définissant les ID dans <code>Piwik PRO goal identifiers</code> et en ajoutant les noms d’événement dans <code>Your event name</code>. L’ID d’objectif « 0 » est réservé au suivi des paniers e-commerce.</td></tr><tr><td><code>Custom Dimensions</code></td><td><p>Associez vos dimensions personnalisées en indiquant le nom de leur champ dans <code>Piwik PRO dimension name</code> et en ajoutant sa valeur dans <code>Your value</code>. Par exemple, si vous saisissez<code>size</code>dans <code>Piwik PRO dimension name</code> et <code>items.0.product.size</code> dans <code>Your value</code>, vous obtiendrez dans Piwik PRO une dimension personnalisée appelée<code>size</code>dont la valeur sera basée sur le contenu du champ <code>items.0.product.size</code> <strong>[1]</strong>.</p><p><br>Dans la colonne <code>Your value path</code> conservez la valeur par défaut <code>Default (root)</code> car cela ajoutera une dimension personnalisée au niveau de la requête de base, ce qui convient mieux à 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é de l’événement d’entrée à partir du niveau <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>respectivement et l’ajoutera en tant que dimension de produit personnalisée. Dans ce scénario, <code>Piwik PRO dimension name</code> doit être un identifiant sous forme de chaîne numérique (par ex. : <code>1</code>, <code>2</code>, ..., <code>N</code>). Pour plus de détails, consultez ce <a href="https://developers.piwik.pro/en/latest/data_collection/api/http_api.html#/paths/~1ppms.php/get">LIEN</a> (voir le paramètre de requête nommé <code>ec_products</code>).</p></td></tr><tr><td><code>Custom Session Variables</code></td><td>Mappez vos variables de session personnalisées en définissant le nom de leur champ dans <code>Piwik PRO variable name</code> et en ajoutant sa valeur dans <code>Your value</code>. Par exemple, si vous saisissez<code>size</code>dans <code>Piwik PRO variable name</code> et <code>items.0.product.size</code> dans <code>Your value</code>, vous aurez dans Piwik PRO une variable de session personnalisée appelée<code>size</code>dont la valeur sera basée sur le contenu du champ <code>items.0.product.size</code> <strong>[1]</strong>. Pour plus de détails, consultez ce <a href="https://developers.piwik.pro/en/latest/data_collection/api/http_api.html#/paths/~1ppms.php/get">LIEN</a> (voir le paramètre de requête nommé <code>_cvar</code>).</td></tr><tr><td><code>Custom Event Variables</code></td><td>Mappez vos variables d’événement personnalisées en définissant le nom de leur champ dans <code>Piwik PRO variable name</code> et en ajoutant sa valeur dans <code>Your value</code>. Par exemple, si vous saisissez<code>size</code>dans <code>Piwik PRO variable name</code> et <code>items.0.product.size</code> dans <code>Your value</code>, vous aurez dans Piwik PRO une variable d’événement personnalisée appelée<code>size</code>dont la valeur sera basée sur le contenu du champ <code>items.0.product.size</code> <strong>[1]</strong>. Pour plus de détails, consultez ce <a href="https://developers.piwik.pro/en/latest/data_collection/api/http_api.html#/paths/~1ppms.php/get">LIEN</a> (voir le paramètre de requête nommé <code>cvar</code>).</td></tr><tr><td><code>Event Mapping</code></td><td>Modifiez le mappage standard entre les événements de Piwik PRO et les vôtres, ou ajoutez de nouveaux mappages.</td></tr></tbody></table>

{% hint style="info" %}
**1.** À l’aide de « points » (« . »), vous pouvez naviguer plus en profondeur jusqu’au champ précis 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 en savoir plus 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 %}

## Référence rapide

| Événements Commanders Act | Types d’événements Piwik PRO |
| ------------------------- | ---------------------------- |
| `add_to_cart`             | `add-to-cart`                |
| `purchase`                | `order`                      |
| `remove_from_cart`        | `remove-from-cart`           |
| `update_cart`             | `cart-update`                |
| `[Any Event]`             | `[Any Event]` **\[1]**       |

{% hint style="info" %}

> **1.** Consultez la [Mappage des événements](#configuration) pour en savoir plus.
> {% endhint %}

## Correspondances des champs

{% hint style="info" %}
Les propriétés peuvent être remappées à l’aide de notre fonctionnalité [Smart Mapping](https://doc.commandersact.com/features/destinations/advanced-mapping#smart-mapping) Il est recommandé d’inclure l’identifiant du visiteur dans vos requêtes. Consultez la propriété Piwik Pro <mark style="color:bleu;">`_id`</mark> pour en savoir plus.
{% endhint %}

<table><thead><tr><th width="451">Propriétés Commanders Act</th><th>Propriétés Piwik Pro</th></tr></thead><tbody><tr><td><code>Application Id</code></td><td><code>idsite</code> <strong>[*]</strong></td></tr><tr><td><code>context.page.url</code></td><td><p><code>url</code></p><p><code>link</code></p></td></tr><tr><td><code>event_name</code></td><td><code>action_name</code></td></tr><tr><td><code>user.id</code></td><td><code>uid</code> <strong>[1]</strong></td></tr><tr><td><code>partners.piwik_pro.visitor_id</code></td><td><code>_id</code> <strong>[2]</strong></td></tr><tr><td><code>partners.piwik_pro.config_id</code></td><td><code>cid</code> <strong>[3]</strong></td></tr><tr><td><code>partners.piwik_pro.anon_tracking</code></td><td><code>uia</code> <strong>[4]</strong></td></tr><tr><td><code>context.page.referrer</code></td><td><code>urlref</code></td></tr><tr><td><code>Custom Session Variables</code></td><td><code>_cvar</code> <strong>[5]</strong></td></tr><tr><td><code>Custom Event Variables</code></td><td><code>cvar</code> <strong>[6]</strong></td></tr><tr><td><code>context.device.ip</code></td><td><code>cip</code></td></tr><tr><td><code>context.device.screen.width</code>x<br><code>context.device.screen.height</code></td><td><code>res</code> <strong>[7]</strong></td></tr><tr><td>(<code>context.event_timestamp</code>)</td><td><code>h</code>, <code>m</code>, <code>s</code> <strong>[8]</strong></td></tr><tr><td><code>context.device.user_agent</code></td><td><code>ua</code></td></tr><tr><td><code>context.device.lang</code></td><td><code>lang</code></td></tr><tr><td><code>user.country</code></td><td><code>country</code></td></tr><tr><td><code>user.city</code></td><td><code>city</code></td></tr><tr><td><code>Custom Dimensions</code></td><td><code>[Custom Dimension]</code> <strong>[9]</strong></td></tr><tr><td><code>search_term</code></td><td><code>search</code></td></tr><tr><td><code>Goal Identifiers</code></td><td><code>idgoal</code> <strong>[10]</strong></td></tr><tr><td><code>revenue</code></td><td><p><code>revenue</code></p><p><code>ec_st</code></p></td></tr><tr><td>Consultez la <a href="#quick-reference">Référence rapide</a></td><td><code>e_t</code></td></tr><tr><td><code>id</code></td><td><code>ec_id</code></td></tr><tr><td>[[<code>items.X.id</code>,<code>items.X.product.name</code>,[<code>items.X.product.category_1</code>, <code>...</code>, <code>items.X.product.category_5</code>], <code>items.X.product.price</code>,<code>items.X.quantity</code>,<code>items.X.product.brand</code>,<code>items.X.variant</code>, { <code>[Custom Product Dimension Id Y]</code>: <code>[Custom Product Dimension Value Y]</code>, <code>...</code>, <code>[Custom Product Dimension Id Y+N]</code>: <code>[Custom Product Dimension Value Y+N]</code>}]]</td><td><code>ec_products</code> <strong>[11]</strong></td></tr><tr><td><code>tax_amount</code></td><td><code>ec_tx</code></td></tr><tr><td><code>shipping_amount</code></td><td><code>ec_sh</code></td></tr><tr><td>(<code>items.X.discount</code>)</td><td><code>ec_dt</code> <strong>[12]</strong></td></tr><tr><td><code>partners.piwik_pro.page_view_id</code></td><td><code>pv_id</code> <strong>[13]</strong></td></tr><tr><td><code>partners.piwik_pro.force_new_visit</code></td><td><code>new_visit</code> <strong>[14]</strong></td></tr><tr><td><code>partners.piwik_pro.visit_counter</code></td><td><code>_idvc</code> <strong>[15]</strong></td></tr><tr><td><code>partners.piwik_pro.prev_visit</code></td><td><code>_viewts</code> <strong>[16]</strong></td></tr><tr><td><code>partners.piwik_pro.first_visit</code></td><td><code>_idts</code> <strong>[17]</strong></td></tr><tr><td><code>partners.piwik_pro.download_url</code></td><td><code>download</code> <strong>[18]</strong></td></tr><tr><td><code>partners.piwik_pro.search_categories</code></td><td><code>search_cats</code></td></tr><tr><td><code>partners.piwik_pro.search_count</code></td><td><code>search_count</code></td></tr><tr><td><code>partners.piwik_pro.last_order_timestamp</code></td><td><code>_ects</code> <strong>[19]</strong></td></tr><tr><td><code>partners.piwik_pro.custom_event_category</code></td><td><code>e_c</code> <strong>[20]</strong></td></tr><tr><td><code>partners.piwik_pro.custom_event_action</code></td><td><code>e_a</code> <strong>[21]</strong></td></tr><tr><td><code>partners.piwik_pro.custom_event_value</code></td><td><code>e_v</code> <strong>[22]</strong></td></tr><tr><td><code>partners.piwik_pro.content_name</code></td><td><code>c_n</code> <strong>[23]</strong></td></tr><tr><td><code>partners.piwik_pro.content_piece</code></td><td><code>c_p</code> <strong>[24]</strong></td></tr><tr><td><code>partners.piwik_pro.content_target</code></td><td><code>c_t</code> <strong>[25]</strong></td></tr><tr><td><code>partners.piwik_pro.content_interaction</code></td><td><code>c_i</code> <strong>[26]</strong></td></tr></tbody></table>

{% hint style="info" %}
**\*** Propriété obligatoire.\
**1.** Peut être utilisé pour identifier le visiteur par l’application (par ex. nom de connexion, adresse e-mail ou ID utilisateur interne). Pour plus de détails, consultez : [Reconnaître les visiteurs](https://help.piwik.pro/analytics/recognizing-visitors/?pk_vid=16986795055e8adf).\
**2.** Cela vous permet d’utiliser l’identifiant d’application d’un visiteur à la place de l’identifiant par défaut généré par Piwik PRO analytics. Pour en savoir plus, consultez : [Reconnaître les visiteurs](https://help.piwik.pro/analytics/recognizing-visitors/?pk_vid=16986795055e8adf). Si vous ne transmettez aucune valeur, cette destination essaie de la récupérer depuis le cookie nommé <mark style="color:bleu;">`_pk_id.[Application Id].`</mark> Pour en savoir plus, consultez ce [LIEN](https://help.piwik.pro/support/privacy/cookies-created-for-visitors-by-piwik-pro/).\
**3.** Hash semi-unique généré pour le navigateur du visiteur (en fonction de la configuration et des plugins installés). Ce paramètre remplace l’identifiant du visiteur envoyé avec <mark style="color:bleu;">`_id`</mark> propriété.\
**4.** Indique si l’utilisateur doit être suivi de manière anonyme : <mark style="color:bleu;">`1`</mark> tous les octets de l’adresse IP seront masqués (0.0.0.0), les données GeoIP au niveau inférieur au pays seront anonymisées, <mark style="color:bleu;">`0`</mark> les données disponibles sur le visiteur seront ajoutées à la session.\
**5.** Voir [Variables de session personnalisées](#configuration) pour en savoir plus.\
**6.** Voir [Variables d’événement personnalisées](#configuration) pour en savoir plus.\
**7.** Résolution de l’écran (par exemple, 1920x1080).\
**8.** Heure, minute et seconde auxquelles la requête a été effectuée.\
**9.** Voir [Dimensions personnalisées](#configuration) pour en savoir plus.\
**10.** Voir [Identifiants d’objectif](#configuration) pour en savoir plus.\
**11.** <mark style="color:bleu;">`[Custom Product Dimension Id Y]`</mark> doit être un identifiant numérique commençant à <mark style="color:bleu;">`1`</mark> et doit être incrémenté pour chaque nouvelle dimension de produit personnalisée définie dans [Dimensions personnalisées](#configuration).\
**12.** Somme de toutes les remises sur les produits.\
**13.** Identifiant unique de vue de page généré au chargement de la page.\
**14.** Forcer le démarrage d’une nouvelle visite lorsque la valeur est <mark style="color:bleu;">`1`</mark> . Valeurs autorisées : <mark style="color:bleu;">`0`</mark> ou <mark style="color:bleu;">`1`</mark> .\
**15.** Compteur de visites.\
**16.** Heure de la visite précédente au format timestamp UNIX : nombre de secondes.\
**17.** Heure de la première visite.\
**18.** URL du fichier téléchargé.\
**19.** Heure de la dernière commande ecommerce au format timestamp UNIX : nombre de secondes.\
**20.** Catégorie d’événement personnalisée. Pour en savoir plus, consultez ce [LIEN](https://help.piwik.pro/support/reports/custom-event-report/).\
**21.** Action d’événement personnalisée. Pour en savoir plus, consultez ce [LIEN](https://help.piwik.pro/support/reports/custom-event-report/).\
**22.** Valeur de l’événement de contenu. Pour en savoir plus, consultez ce [LIEN](https://help.piwik.pro/support/reports/custom-event-report/).\
**23.** Nom du contenu. Pour en savoir plus, consultez ce [LIEN](https://help.piwik.pro/support/reports/content-performance-report/).\
**24.** Élément de contenu. Pour en savoir plus, consultez ce [LIEN](https://help.piwik.pro/support/reports/content-performance-report/).\
**25.** Cible du contenu. Pour en savoir plus, consultez ce [LIEN](https://help.piwik.pro/support/reports/content-performance-report/).\
**26.** Interaction avec le contenu. Pour en savoir plus, consultez ce [LIEN](https://help.piwik.pro/support/reports/content-performance-report/).
{% 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/piwik-pro.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.
