> 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 les sites web et d’autres produits numériques. Leur produit est une alternative à Google Analytics, conçue pour respecter des politiques de sécurité strictes et les réglementations en matière de confidentialité.\
À l’aide de cette destination, vous pouvez exploiter Piwik PRO [API HTTP de suivi](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 éventuellement dans les rapports Analytics.

## Fonctionnalités clés

La destination Piwik PRO 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) correspondances du 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 s'effectue automatiquement, ce qui simplifie la saisie utilisateur.
* **Smart mapping**: le mapping des données peut être réajusté à l'aide des champs définis dans votre datalayer.
* **Mappage d'é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>Associez vos identifiants d’objectif en définissant les ID dans <code>identifiants d’objectif Piwik PRO</code> et en ajoutant les noms d’événements dans <code>Nom de votre é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>Associez 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>. p. ex. si vous saisissez<code>size</code>dans le <code>nom de dimension Piwik PRO</code> et <code>items.0.product.size</code> dans <code>Votre valeur</code>, vous aurez dans Piwik PRO une dimension 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>.</p><p><br>Dans la colonne <code>Votre chemin de valeur</code> vous devez conserver la valeur par défaut <code>Par défaut (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 soit <code>Dans "items" {items.X}</code> ou <code>Dans "product" {items.X.product}</code> cette destination recherchera 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>au niveau correspondant et l’ajouter comme dimension de 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 (par 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">LINK</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>Associez 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>. p. ex. si vous saisissez<code>size</code>dans le <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">LINK</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>Associez 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>. p. ex. si vous saisissez<code>size</code>dans le <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">LINK</a> (Voir le paramètre de requête nommé <code>cvar</code>).</td></tr><tr><td><code>Correspondance 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 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 %}

## Référence rapide

| Commanders Act Events | 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 [Correspondance des événements](#configuration) pour plus de détails.
> {% endhint %}

## Correspondances des champs

{% hint style="info" %}
Les propriétés peuvent être remappées à l'aide de notre [Mappage intelligent](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:bleu;">`_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>revenue</code></td><td><p><code>revenue</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 de produit personnalisée Y]</code>: <code>[Valeur de dimension de produit personnalisée Y]</code>, <code>...</code>, <code>[ID de dimension de produit personnalisée Y+N]</code>: <code>[Valeur de dimension de 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 (par ex. nom de connexion, adresse e-mail ou ID utilisateur interne). Plus de détails sont disponibles ici : [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 au lieu d’un identifiant par défaut généré par Piwik PRO analytics. Plus de détails sont disponibles ici : [Reconnaître les visiteurs](https://help.piwik.pro/analytics/recognizing-visitors/?pk_vid=16986795055e8adf). Si vous ne transmettez pas de valeur, cette destination tente de la récupérer à partir du cookie nommé <mark style="color:bleu;">`_pk_id.[Application Id].`</mark> Davantage de détails sont disponibles en suivant ce [LINK](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 (sur la base de la configuration et des plugins installés). Ce paramètre écrase l’identifiant du visiteur envoyé avec <mark style="color:bleu;">`_id`</mark> propriété.\
**4.** 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 en dessous du niveau pays seront anonymisées, <mark style="color:bleu;">`0`</mark> les données disponibles du visiteur 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 d’écran (par ex. 1920x1080).\
**8.** Heure, minute et seconde à laquelle 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:bleu;">`[ID de dimension de produit personnalisée 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 produit.\
**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 d’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 d’horodatage UNIX : nombre de secondes.\
**20.** Catégorie d’événement personnalisée. Plus de détails sont disponibles à la suite de ce [LINK](https://help.piwik.pro/support/reports/custom-event-report/).\
**21.** Action d’événement personnalisée. Plus de détails sont disponibles à la suite de ce [LINK](https://help.piwik.pro/support/reports/custom-event-report/).\
**22.** Valeur de l’événement de contenu. Plus de détails sont disponibles à la suite de ce [LINK](https://help.piwik.pro/support/reports/custom-event-report/).\
**23.** Nom du contenu. Plus de détails sont disponibles à la suite de ce [LINK](https://help.piwik.pro/support/reports/content-performance-report/).\
**24.** Morceau de contenu. Plus de détails sont disponibles à la suite de ce [LINK](https://help.piwik.pro/support/reports/content-performance-report/).\
**25.** Cible du contenu. Plus de détails sont disponibles à la suite de ce [LINK](https://help.piwik.pro/support/reports/content-performance-report/).\
**26.** Interaction avec le contenu. Plus de détails sont disponibles à la suite de ce [LINK](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, and the optional `goal` query parameter:

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