# Piwik PRO

[Piwik PRO](https://piwik.pro/) "Analytics Suite" est une plateforme axée sur la confidentialité pour le suivi et l'analyse du comportement des utilisateurs sur les sites web et autres produits numériques. Leur produit est une alternative à Google Analytics, conçue pour se conformer aux politiques de sécurité strictes et aux réglementations sur la confidentialité.\
En utilisant cette destination, vous pouvez tirer parti de 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 éventuellement dans les rapports Analytics.

## Fonctionnalités clés

La destination Piwik PRO fournit 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) modèle correspond [aux 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.
* **Mappings préconstruits** : le mapping des données pour les destinations basées sur les événements se fait automatiquement, ce qui simplifie les saisies utilisateur.
* **Smart mapping** : le mapping des données peut être réajusté en utilisant les champs définis dans votre datalayer.
* **Mapping des événements** : modifiez le mapping standard entre les événements de vos partenaires et les vôtres ou ajoutez de nouveaux mappings.
* **Prise en charge des données multi-articles** : les informations incluses dans le [tableau item](https://community.commandersact.com/platform-x/developers/tracking/events-reference#item) sont envoyées à 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> seulement).</p></td></tr><tr><td><code>Application Id</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Votre identifiant d'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 ids dans <code>Identifiants d'objectif Piwik PRO</code> et en ajoutant les noms d'événement 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 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>Chemin de votre 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 scénarios. 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 en partant du <a href="https://community.commandersact.com/platform-x/developers/tracking/events-reference#item">niveau items </a>ou <a href="https://community.commandersact.com/platform-x/developers/tracking/events-reference#product">niveau product </a>respectivement et l'ajoutera en tant que 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 (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">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 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 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 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 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>Mapping des événements</code></td><td>Modifiez le mapping standard entre les événements de Piwik PRO et les vôtres ou ajoutez de nouveaux mappings.</td></tr></tbody></table>

{% hint style="info" %}
**\[1]** En utilisant des "dots" (".") 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 champs standard par événement. Vous pouvez également définir librement des champs personnalisés : il n'y a pas de limites.
{% 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 [Mapping des événements](#configuration) pour plus de détails.
{% endhint %}

## Mappings de champs

{% hint style="info" %}
La plupart des propriétés peuvent être remappées en utilisant notre fonctionnalité "Smart Mapping".\
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>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 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>[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ée 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 en suivant : [Reconnaissance des visiteurs](https://help.piwik.pro/analytics/recognizing-visitors/?pk_vid=16986795055e8adf).  \
> \&#xNAN;**\[2]** Ceci 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 en suivant : [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 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 remplace l'identifiant du visiteur envoyé avec la propriété <mark style="color:bleu;">`_id`</mark> .  \
> \&#xNAN;**\[4]** Indique 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 de visiteur disponibles 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 où la requête a été effectuée.  \
> \&#xNAN;**\[9]** Voir [Dimensions personnalisées](#configuration) pour plus de détails.  \
> \&#xNAN;**\[10]** Voir [Identifiants d'objectif](#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 à partir de <mark style="color:bleu;">`1`</mark> et doit être incrémenté pour chaque nouvelle dimension produit personnalisée définie dans [Dimensions personnalisées](#configuration).  \
> \&#xNAN;**\[12]** Somme de tous les remises produit.  \
> \&#xNAN;**\[13]** Identifiant unique de vue de page généré lorsque la page est chargée.  \
> \&#xNAN;**\[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> .  \
> \&#xNAN;**\[15]** Compteur de visites.  \
> \&#xNAN;**\[16]** Heure de la visite précédente au format timestamp UNIX : nombre de secondes.  \
> \&#xNAN;**\[17]** Heure de la première visite.  \
> \&#xNAN;**\[18]** URL du fichier téléchargé.  \
> \&#xNAN;**\[19]** Heure de la dernière commande e-commerce au format timestamp UNIX : nombre de secondes.  \
> \&#xNAN;**\[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/).  \
> \&#xNAN;**\[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/).  \
> \&#xNAN;**\[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/).  \
> \&#xNAN;**\[23]** Nom du contenu. Plus de détails sont disponibles en suivant ce [LIEN](https://help.piwik.pro/support/reports/content-performance-report/).  \
> \&#xNAN;**\[24]** Morceau de contenu. Plus de détails sont disponibles en suivant ce [LIEN](https://help.piwik.pro/support/reports/content-performance-report/).  \
> \&#xNAN;**\[25]** Cible du contenu. Plus de détails sont disponibles en suivant ce [LIEN](https://help.piwik.pro/support/reports/content-performance-report/).  \
> \&#xNAN;**\[26]** Interaction de contenu. Plus de détails sont disponibles en suivant ce [LIEN](https://help.piwik.pro/support/reports/content-performance-report/).
> {% endhint %}