> 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é pour suivre et analyser le comportement des utilisateurs sur des sites web et d'autres produits numériques. Leur produit est une alternative à Google Analytics, conçue pour se conformer à des politiques de sécurité strictes et à des réglementations en matière de confidentialité.\
Grâce à cette destination, vous pouvez exploiter Piwik PRO [API HTTP de tracking](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 puis apparaîtront dans les rapports Analytics.

## Fonctionnalités clés

La destination Piwik PRO 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) correspondances de modèle [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 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 se fait automatiquement, ce qui simplifie la saisie utilisateur.
* **Smart Mapping**: le mappage des données peut être réajusté à l'aide de vos champs définis dans le data layer.
* **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 multi-items** : les informations incluses dans le [item](https://community.commandersact.com/platform-x/developers/tracking/events-reference#item) le tableau est envoyé à 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>Nom de l'instance</code></td><td><p><em><strong><code>Obligatoire</code></strong></em></p><p>Le nom de votre instance tel que fourni par Piwik PRO (par ex. pour https://<strong>InstanceName</strong>.piwik.pro/ppms.php, incluez la <strong>chaîne en gras</strong> uniquement).</p></td></tr><tr><td><code>ID de l’application</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>L'identifiant de votre application (anciennement « Website ID ») tel que fourni par Piwik PRO.</td></tr><tr><td><code>Identifiants d'objectif</code></td><td>Mappez vos identifiants d'objectif en définissant les ID dans <code>identifiants d'objectif Piwik PRO</code> et en ajoutant des noms d'événements dans <code>Votre nom d'événement</code>. L'ID d'objectif « 0 » est réservé au suivi du panier e-commerce.</td></tr><tr><td><code>Dimensions personnalisées</code></td><td><p>Mappez vos dimensions personnalisées en définissant leurs noms de champ dans <code>nom de dimension Piwik PRO</code> et en ajoutant sa valeur dans <code>Votre valeur</code>. Par ex. si vous saisissez<code>size</code>dans <code>nom de dimension Piwik PRO</code> et <code>items.0.product.size</code> dans <code>Votre valeur</code>, vous aurez une dimension personnalisée dans Piwik PRO appelée<code>size</code>avec une valeur basée sur le contenu du champ <code>items.0.product.size</code> <strong>[1]</strong>.</p><p><br>Dans la colonne <code>Le chemin de votre valeur</code> vous devez conserver la valeur par défaut <code>Par défaut (racine)</code> car cela ajoutera une dimension personnalisée au niveau de la requête de base, ce qui convient mieux à la plupart des scénarios. Dans le cas où vous sélectionnez soit <code>Dans "items" {items.X}</code> ou <code>Dans "product" {items.X.product}</code> cette destination cherchera la propriété d'événement d'entrée à partir du <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>niveau respectif et l'ajoutera comme dimension produit personnalisée. Dans ce scénario, <code>nom de dimension Piwik PRO</code> doit être un identifiant numérique sous forme de chaîne (p. ex. <code>1</code>, <code>2</code>, ..., <code>N</code>). Plus de détails sont disponibles en suivant 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>Variables de session personnalisées</code></td><td>Mappez vos variables de session personnalisées en définissant leurs noms de champ dans <code>nom de variable Piwik PRO</code> et en ajoutant sa valeur dans <code>Votre valeur</code>. Par ex. si vous saisissez<code>size</code>dans <code>nom de variable Piwik PRO</code> et <code>items.0.product.size</code> dans <code>Votre valeur</code>, vous aurez dans Piwik PRO une variable de session 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>. Plus de détails sont disponibles en suivant 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>Variables d'événement personnalisées</code></td><td>Mappez vos variables d'événement personnalisées en définissant leurs noms de champ dans <code>nom de variable Piwik PRO</code> et en ajoutant sa valeur dans <code>Votre valeur</code>. Par ex. si vous saisissez<code>size</code>dans <code>nom de variable Piwik PRO</code> et <code>items.0.product.size</code> dans <code>Votre valeur</code>, vous aurez dans Piwik PRO une variable d'événement 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>. Plus de détails sont disponibles en suivant 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>Mappage des événements</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.** En utilisant des « points » (« . »), vous pouvez naviguer plus profondément jusqu'au champ spécifique dont vous voulez 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 champ standard par événement. Vous pouvez aussi définir librement des champs personnalisés : il n'y a aucune limite.
{% endhint %}

## Référence rapide

| Propriétés 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`                |
| `[Tout événement]`        | `[Tout événement]` **\[1]**  |

{% hint style="info" %}

> **1.** Voir [Mappage des événements](#configuration) pour plus de détails.
> {% endhint %}

## Mappages de champs

{% hint style="info" %}
Les propriétés peuvent être remappées à l'aide de notre [Smart Mapping](https://doc.commandersact.com/features/destinations/advanced-mapping#smart-mapping) fonctionnalité.\
Il est recommandé d'inclure l'identifiant du visiteur dans vos requêtes - Voir la propriété Piwik Pro <mark style="color:bleue;">`_id`</mark> pour plus de détails.
{% 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>ID de l’application</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>Variables de session personnalisées</code></td><td><code>_cvar</code> <strong>[5]</strong></td></tr><tr><td><code>Variables d'événement personnalisées</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>Dimensions personnalisées</code></td><td><code>[Dimension personnalisée]</code> <strong>[9]</strong></td></tr><tr><td><code>search_term</code></td><td><code>search</code></td></tr><tr><td><code>Identifiants d'objectif</code></td><td><code>idgoal</code> <strong>[10]</strong></td></tr><tr><td><code>revenu</code></td><td><p><code>revenu</code></p><p><code>ec_st</code></p></td></tr><tr><td>Voir <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>[ID de dimension produit personnalisée Y]</code>: <code>[Valeur de dimension produit personnalisée Y]</code>, <code>...</code>, <code>[ID de dimension produit personnalisée Y+N]</code>: <code>[Valeur de dimension produit personnalisée 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 (p. ex. nom de connexion, adresse e-mail ou ID utilisateur interne). Plus de détails sont disponibles ici : [Reconnaissance des visiteurs](https://help.piwik.pro/analytics/recognizing-visitors/?pk_vid=16986795055e8adf).\
**2.** Cela vous permet d'utiliser l'identifiant d'application d'un visiteur au lieu d'un identifiant par défaut généré par Piwik PRO analytics. Plus de détails sont disponibles ici : [Reconnaissance des visiteurs](https://help.piwik.pro/analytics/recognizing-visitors/?pk_vid=16986795055e8adf). Si vous ne transmettez pas de valeur, cette destination essaie de la récupérer à partir du cookie nommé <mark style="color:bleue;">`_pk_id.[Application ID].`</mark> Davantage de détails sont disponibles en suivant ce [LIEN](https://help.piwik.pro/support/privacy/cookies-created-for-visitors-by-piwik-pro/).\
**3.** Hachage semi-unique généré pour le navigateur du visiteur (basé sur la configuration et les plugins installés). Ce paramètre écrase l'identifiant du visiteur envoyé avec <mark style="color:bleue;">`_id`</mark> la propriété.\
**4.** Si l'utilisateur doit être suivi de manière anonyme : <mark style="color:bleue;">`1`</mark> tous les octets d'adresse IP seront masqués (0.0.0.0), les données GeoIP en dessous du niveau pays seront anonymisées, <mark style="color:bleue;">`0`</mark> les données du visiteur disponibles seront ajoutées à la session.\
**5.** Voir [Variables de session personnalisées](#configuration) pour plus de détails.\
**6.** Voir [Variables d'événement personnalisées](#configuration) pour plus de détails.\
**7.** Résolution de l'écran (p. ex. 1920x1080).\
**8.** Heure, minute et seconde auxquelles la requête a été effectuée.\
**9.** Voir [Dimensions personnalisées](#configuration) pour plus de détails.\
**10.** Voir [Identifiants d'objectif](#configuration) pour plus de détails.\
**11.** <mark style="color:bleue;">`[ID de dimension produit personnalisée Y]`</mark> doit être un identifiant numérique commençant à <mark style="color:bleue;">`1`</mark> et doit être incrémenté pour chaque nouvelle dimension 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é lors du chargement de la page.\
**14.** Forcer le début d'une nouvelle visite lorsque la valeur est <mark style="color:bleue;">`1`</mark> . Valeurs autorisées : <mark style="color:bleue;">`0`</mark> ou <mark style="color:bleue;">`1`</mark> .\
**15.** Compteur de visites.\
**16.** Heure de la visite précédente au format horodatage 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 e-commerce au format horodatage UNIX : nombre de secondes.\
**20.** Catégorie d'événement personnalisée. Plus de détails sont disponibles en suivant ce [LIEN](https://help.piwik.pro/support/reports/custom-event-report/).\
**21.** Action d'événement personnalisée. Plus de détails sont disponibles en suivant ce [LIEN](https://help.piwik.pro/support/reports/custom-event-report/).\
**22.** Valeur d'événement de contenu. Plus de détails sont disponibles en suivant ce [LIEN](https://help.piwik.pro/support/reports/custom-event-report/).\
**23.** Nom du contenu. Plus de détails sont disponibles en suivant ce [LIEN](https://help.piwik.pro/support/reports/content-performance-report/).\
**24.** Morceau de contenu. Plus de détails sont disponibles en suivant ce [LIEN](https://help.piwik.pro/support/reports/content-performance-report/).\
**25.** Cible du contenu. Plus de détails sont disponibles en suivant ce [LIEN](https://help.piwik.pro/support/reports/content-performance-report/).\
**26.** Interaction de contenu. Plus de détails sont disponibles en suivant 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 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/piwik-pro.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.