# 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 des réglementations sur la vie privée.\
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 finiront par apparaître dans les rapports Analytics.

## Key features

La destination Piwik PRO fournit les principales fonctionnalités suivantes :

* **Events structure**: notre [Events reference](https://community.commandersact.com/platform-x/developers/tracking/events-reference) correspondances de modèle [Les 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.
* **Prebuilt mappings**: le mapping des données pour les destinations basées sur les events se fait automatiquement, ce qui simplifie les saisies utilisateur.
* **Smart mapping**: le mapping des données peut être réajusté à l’aide des champs définis dans votre datalayer.
* **Event mapping**: 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-item**: les informations incluses dans le tableau [item](https://community.commandersact.com/platform-x/developers/tracking/events-reference#item) tableau est envoyé à Piwik PRO.

## Configuration de la destination

### Configuration

<table><thead><tr><th width="307">Settings</th><th>Description</th></tr></thead><tbody><tr><td><code>Nom de l’instance</code></td><td><p><em><strong><code>Requis</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 uniquement la <strong>chaîne en gras</strong> ).</p></td></tr><tr><td><code>Application Id</code></td><td><em><strong><code>Requis</code></strong></em><br>Votre identifiant d’application (anciennement « Website Id ») tel que fourni par Piwik PRO.</td></tr><tr><td><code>Identifiants de objectifs</code></td><td>Mappez les identifiants de vos objectifs en définissant les IDs dans <code>les identifiants de objectifs 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>Mappez vos dimensions personnalisées en définissant leurs noms de champ dans <code>nom de dimension Piwik PRO</code> et en ajoutant leur valeur dans <code>Votre valeur</code>. Par 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 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>Votre chemin de valeur</code> vous devez conserver 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 scénarios. Si vous choisissez <code>In "items" {items.X}</code> ou <code>In "product" {items.X.product}</code> cette destination recherchera la propriété d'event 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>au niveau respectif 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 à la suite de 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 leur valeur dans <code>Votre valeur</code>. Par 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 une variable de session 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>. Plus de détails sont disponibles à la suite de 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 leur valeur dans <code>Votre valeur</code>. Par 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 une variable d’événement 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>. Plus de détails sont disponibles à la suite de 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 en profondeur jusqu’au champ spécifique dont vous souhaitez obtenir la valeur. Consultez [Events reference](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`                |
| `[Any Event]`         | `[Any Event]` **\[1]**       |

{% hint style="info" %}
**\[1]** Voir [Mappage des événements](#configuration) pour plus de détails.
{% endhint %}

## Mappages de champs

{% hint style="info" %}
La plupart des propriétés peuvent être remappées à l’aide de notre fonctionnalité « Smart Mapping ».\
Il est recommandé d’inclure l’identifiant du visiteur dans vos requets - 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>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>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>[Custom Dimension]</code> <strong>[9]</strong></td></tr><tr><td><code>search_term</code></td><td><code>search</code></td></tr><tr><td><code>Identifiants de objectifs</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>[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.\
> \&#xNAN;**\[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).\
> \&#xNAN;**\[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 les analyses Piwik PRO. 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 depuis le cookie nommé <mark style="color:bleu;">`_pk_id.[Application Id].`</mark> Plus de détails sont disponibles en suivant ce [LIEN](https://help.piwik.pro/support/privacy/cookies-created-for-visitors-by-piwik-pro/).\
> \&#xNAN;**\[3]** Hash 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:bleu;">`_id`</mark> property.\
> \&#xNAN;**\[4]** Si l’utilisateur doit être suivi de manière anonyme : <mark style="color:bleu;">`1`</mark> tous les octets 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.\
> \&#xNAN;**\[5]** Voir [Variables de session personnalisées](#configuration) pour plus de détails.\
> \&#xNAN;**\[6]** Voir [Variables d’événement personnalisées](#configuration) pour plus de détails.\
> \&#xNAN;**\[7]** Résolution d’écran (par ex. 1920x1080).\
> \&#xNAN;**\[8]** Heure, minute et seconde à laquelle la requête a été effectuée.\
> \&#xNAN;**\[9]** Voir [Dimensions personnalisées](#configuration) pour plus de détails.\
> \&#xNAN;**\[10]** Voir [Identifiants de objectifs](#configuration) pour plus de détails.\
> \&#xNAN;**\[11]** <mark style="color:bleu;">`[Custom Product Dimension Id Y]`</mark> doit être un identifiant numérique commençant par <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).\
> \&#xNAN;**\[12]** Somme de toutes les remises produits.\
> \&#xNAN;**\[13]** Identifiant unique de page vue généré lorsque la page est chargée.\
> \&#xNAN;**\[14]** Forcer le démarrage d’une nouvelle session 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> .\
> \&#xNAN;**\[15]** Compteur de session.\
> \&#xNAN;**\[16]** Heure de la session précédente au format horodatage UNIX : nombre de secondes.\
> \&#xNAN;**\[17]** Heure de la première session.\
> \&#xNAN;**\[18]** URL du fichier téléchargé.\
> \&#xNAN;**\[19]** Heure de la dernière commande e-commerce au format horodatage UNIX : nombre de secondes.\
> \&#xNAN;**\[20]** Catégorie d’événement personnalisée. Plus de détails sont disponibles à la suite de ceci [LIEN](https://help.piwik.pro/support/reports/custom-event-report/).\
> \&#xNAN;**\[21]** Action d’événement personnalisée. Plus de détails sont disponibles à la suite de ceci [LIEN](https://help.piwik.pro/support/reports/custom-event-report/).\
> \&#xNAN;**\[22]** Valeur d’événement de contenu. Plus de détails sont disponibles à la suite de ceci [LIEN](https://help.piwik.pro/support/reports/custom-event-report/).\
> \&#xNAN;**\[23]** Nom du contenu. Plus de détails sont disponibles à la suite de ceci [LIEN](https://help.piwik.pro/support/reports/content-performance-report/).\
> \&#xNAN;**\[24]** Morceau de contenu. Plus de détails sont disponibles à la suite de ceci [LIEN](https://help.piwik.pro/support/reports/content-performance-report/).\
> \&#xNAN;**\[25]** Cible du contenu. Plus de détails sont disponibles à la suite de ceci [LIEN](https://help.piwik.pro/support/reports/content-performance-report/).\
> \&#xNAN;**\[26]** Interaction de contenu. Plus de détails sont disponibles à la suite de ceci [LIEN](https://help.piwik.pro/support/reports/content-performance-report/).
> {% endhint %}


---

# Agent Instructions: 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.