> 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/piano-analytics/at-internet.md).

# Piano Analytics Collection API

[Piano Analytics](https://piano.io/) est le successeur de AT Internet Analytics Suite 2 (AS2).\
C'est un outil centré sur l'utilisateur qui simplifie l'analyse produit et marketing, tout en garantissant la qualité des données.\
Vos données seront envoyées server-side afin de tirer le meilleur parti de Piano Analytics' [Collection API](https://developers.atinternet-solutions.com/piano-analytics/data-collection/how-to-send-events/collection-api) et sous forme de [événements](https://developers.atinternet-solutions.com/piano-analytics/data-collection/how-to-send-events/standard-events).

{% hint style="info" %}
Le [Collection API](https://developers.atinternet-solutions.com/piano-analytics/data-collection/how-to-send-events/collection-api) est disponible uniquement pour [Piano Analytics](https://developers.atinternet-solutions.com/piano-analytics/#what-is-piano-analytics).\
Vous pouvez consulter le [tableau de compatibilité](https://developers.atinternet-solutions.com/piano-analytics/#before-i-start) pour obtenir plus d'Insights sur les fonctionnalités prises en charge par produit.
{% endhint %}

## Fonctionnalités clés

La destination Piano Analytics Collection API 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) correspond [L'array one de Piano Analytics](https://developers.atinternet-solutions.com/piano-analytics/data-collection/how-to-send-events/standard-events), 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.
* **Événements personnalisés**: vous pouvez envoyer librement des événements personnalisés selon vos besoins spécifiques.
* **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) est envoyé à Piano Analytics.
* **Identifiant utilisateur**: vous pouvez sélectionner librement un champ d'identifiant utilisateur pour les utilisateurs connectés.
* **Prise en charge des événements autopromo**: incluez des événements autopromo préconfigurés dans vos requêtes. Voir [Événements autopromo](#autopromo-events) pour plus de détails.
* **Envoyer toutes les propriétés**: envoyez toutes les propriétés de vos événements à Piano Analytics en un seul clic.

## Configuration de la destination

Avant de commencer avec cette destination, assurez-vous d'avoir accès à [Piano Analytics](https://developers.atinternet-solutions.com/piano-analytics/#what-is-piano-analytics).

{% hint style="warning" %}
L'identifiant unique de visiteur client-side est recommandé et est récupéré en obtenant la valeur de [**`_pcid`**](https://developers.atinternet-solutions.com/piano-analytics/data-collection/general/cookie-storage#since-670) **,** [**`pa_vid`**](https://developers.atinternet-solutions.com/piano-analytics/data-collection/general/cookie-storage#piano-analytics-mobile-sdks) , [**`atuserid`**](https://developers.atinternet-solutions.com/piano-analytics/data-collection/general/cookie-storage#legacy-cookie-management) , ou <mark style="color:bleue;">**`xtidc`**</mark> cookie dans cet ordre de priorité. Valeur par défaut : <mark style="color:bleue;">`user.consistent_anonymous_id`</mark>. Voir <mark style="color:bleue;">`Identifiant client`</mark> dans [Configuration](#configuration) pour personnaliser davantage cette valeur.
{% endhint %}

### Configuration

<table><thead><tr><th width="283">Paramètres</th><th>Description</th></tr></thead><tbody><tr><td><code>ID du site</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>L'identifiant du site auquel appartiennent les données (p. ex. <code>628087</code>). Vous pouvez le trouver dans l'interface Piano Analytics en suivant <img src="/files/fea7d3e82a381ef90a8bcf36e2eb09cf4cb779a7" alt=""> ➜ <code>PARAMÈTRES</code> ➜ <code>Portail de collecte de données</code> ➜ <code>Outils</code> ➜ <code>Gestion du site</code> et en sélectionnant votre site. Ce paramètre prend en charge des valeurs dynamiques <strong>[1].</strong></td></tr><tr><td><code>Domaine de collecte sécurisé</code></td><td><em><strong><code>Obligatoire</code></strong></em><br>Le domaine SSL sur lequel les informations sont collectées (p. ex. <code>logs1412.xiti.com</code>). Vous pouvez le trouver dans l'interface Piano Analytics en suivant <img src="/files/fea7d3e82a381ef90a8bcf36e2eb09cf4cb779a7" alt=""> ➜ <code>PARAMÈTRES</code><br><code>Portail de collecte de données</code> ➜ <code>Outils</code> ➜ <code>Gestion du site</code> et en sélectionnant votre site.</td></tr><tr><td><code>Identifiant utilisateur</code></td><td>Vous pouvez définir votre identifiant utilisateur pour les utilisateurs connectés. Plus de détails sont disponibles en suivant ce <a href="https://developers.atinternet-solutions.com/piano-analytics/data-collection/how-to-send-events/collection-api#users">LIEN</a>.</td></tr><tr><td><code>Propriété personnalisée</code></td><td>Lorsque vous sélectionnez « [Custom Property] » comme valeur pour le champ ci-dessus <code>Identifiant utilisateur</code>, ce champ apparaîtra afin que vous puissiez spécifier un champ personnalisé contenant la valeur de l'identifiant utilisateur.</td></tr><tr><td><code>Identifiant client</code></td><td>Vous pouvez définir un identifiant client spécifique comme notre <code>context.device.sdk_id</code> ou une propriété personnalisée contenant sa valeur. Lorsque vous conservez la valeur « Default », ou si les premières options mentionnées ne renvoient pas une valeur valide, il s'agit de votre identifiant unique de visiteur client-side provenant des cookies, comme détaillé dans le <a href="#destination-setup">Configuration de la destination</a>. Si aucun cookie n'est disponible, la propriété <code>user.tcId</code> est utilisée. Plus de détails sont disponibles en suivant ce <a href="https://developers.atinternet-solutions.com/piano-analytics/data-collection/how-to-send-events/collection-api#pattern-1">LIEN</a>.</td></tr><tr><td><code>Propriété personnalisée</code></td><td>Lorsque vous sélectionnez « [Custom Property] » comme valeur pour le champ ci-dessus <code>Identifiant client</code>, ce champ apparaîtra afin que vous puissiez spécifier un champ personnalisé contenant la valeur de l'identifiant client.</td></tr><tr><td><code>Mappage d'événements personnalisés :</code><br><code>"view_item" correspond</code><br><code>avec Piano</code><br><code>"product.page_display"</code></td><td>En activant cette option, votre <code>view_item</code> événement sera associé à Piano <code>product.page_display</code> événement. Voir <a href="#quick-reference">Référence rapide</a> pour plus d'informations sur le mappage d'événements.</td></tr><tr><td><code>Envoyer les événements autopromo</code></td><td>Cela active les événements autopromo. Voir <a href="#autopromo-events">Événements autopromo</a> pour plus de détails.</td></tr><tr><td><code>Envoyer toutes les propriétés</code></td><td>Lorsque vous activez cette option, toutes les propriétés incluses à la racine de vos événements sont également envoyées, <strong>sans aucune modification</strong>, à Piano Analytics dans l' <mark style="color:bleue;"><code>data</code></mark> objet. Plus de détails sont disponibles en suivant ce <a href="https://developers.atinternet-solutions.com/piano-analytics/data-collection/how-to-send-events/collection-api#event-object">LIEN</a>.</td></tr><tr><td><code>Ne pas écraser</code></td><td>Lorsque <code>Envoyer toutes les propriétés</code> est cochée, vous pouvez éviter d'écraser les propriétés déjà définies/présentes.</td></tr><tr><td><code>Propriétés d'événements personnalisées</code></td><td><p>Associez vos propriétés d'événements personnalisées en définissant leurs noms de champ dans <code>Nom de propriété Piano Analytics</code> et en ajoutant le nom du champ contenant la valeur dans <code>Votre propriété d'événement</code> . Par ex. si vous saisissez <code>size</code> dans <code>Nom de propriété Piano Analytics</code> et <code>items.0.product.size</code> dans <code>Votre propriété d'événement</code> , vous aurez une propriété d'événement personnalisée dans Piano Analytics appelée <code>size</code> avec une valeur basée sur le contenu du champ <code>items.0.product.size</code>.</p><p>Dans la colonne <code>Votre chemin de propriété d'événement</code> vous devez conserver la valeur par défaut <code>Par défaut (racine)</code> car elle convient mieux à la plupart des scénarios. Si vous sélectionnez l'un ou l'autre <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 correspondant et ajoutez ses valeurs comme propriété d'élément personnalisée.</p><p><br>Pour que les propriétés d'événements personnalisées soient prises en compte par Piano Analytics, vous devez d'abord les créer en suivant <img src="/files/fea7d3e82a381ef90a8bcf36e2eb09cf4cb779a7" alt=""> ➜ <code>PARAMÈTRES</code> ➜ <code>Gestion des données</code> ➜ <code>Modèle de données</code> ➜ <code>Propriétés</code> .</p></td></tr><tr><td><code>Propriétés utilisateur personnalisées</code></td><td><p>Mappez vos propriétés utilisateur personnalisées en définissant leurs noms de champ dans <code>Nom de la propriété utilisateur</code> et en ajoutant le nom du champ contenant la valeur dans <code>propriété d'événement Commanders Act ou valeur statique</code> .<br>Par ex. si vous saisissez <code>customer_zipcode</code> dans <code>Nom de la propriété utilisateur</code> et <code>user.zipcode</code> dans <code>propriété d'événement Commanders Act ou valeur statique</code> , vous aurez une propriété utilisateur personnalisée dans Piano Analytics appelée <code>customer_zipcode</code> avec une valeur basée sur le contenu du champ <code>user.zipcode</code> . Vous avez également la possibilité de définir une valeur statique de chaîne/numérique dans <code>propriété d'événement Commanders Act ou valeur statique</code> .<br></p><p>Pour que les propriétés utilisateur personnalisées soient prises en compte par Piano Analytics, vous devez d'abord les créer en suivant <img src="/files/fea7d3e82a381ef90a8bcf36e2eb09cf4cb779a7" alt=""> ➜ <code>PARAMÈTRES</code> ➜ <code>Gestion des données</code> ➜ <code>Modèle de données</code> ➜ <code>Propriétés</code> .</p></td></tr></tbody></table>

## Référence rapide

{% hint style="info" %}
[Piano Analytics vidéo/audio](https://developers.atinternet-solutions.com/piano-analytics-tagging-en/event-tagging-piano-analytics-en/standard-event-tagging-en/#audio-video_31) les événements sont pris en charge par [notre modèle d'événements](https://doc.commandersact.com/developers/tracking/events-reference/video-event-reference).
{% endhint %}

| Propriétés Commanders Act                                                                                                                                                           | Événements Piano Analytics                                                                                               |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| `add_payment_info`                                                                                                                                                                  | `cart.payment`                                                                                                           |
| `add_shipping_info`                                                                                                                                                                 | `cart.delivery`                                                                                                          |
| `add_to_cart`                                                                                                                                                                       | `product.add_to_cart`                                                                                                    |
| `add_to_wishlist`                                                                                                                                                                   | `product.add_to_wishlist` **\[\*]**                                                                                      |
| `begin_checkout`                                                                                                                                                                    | `cart.begin_checkout` **\[\*]**                                                                                          |
| `generate_lead`                                                                                                                                                                     | `generate_lead` **\[\*]**                                                                                                |
| `login`                                                                                                                                                                             | `user.login` **\[\*]**                                                                                                   |
| `page_view`                                                                                                                                                                         | `page.display` ou `product.page_display` **\[1]**                                                                        |
| `purchase`                                                                                                                                                                          | `transaction.confirmation` et `product.purchased` **\[2]**                                                               |
| `remboursement`                                                                                                                                                                     | `remboursement` **\[\*]**                                                                                                |
| `remove_from_cart`                                                                                                                                                                  | `product.remove_from_cart`                                                                                               |
| `search`                                                                                                                                                                            | `internal_search_result.display`                                                                                         |
| `select_content`                                                                                                                                                                    | `select_content` **\[\*]**                                                                                               |
| `select_item`                                                                                                                                                                       | `page.select_item` **\[\*]**                                                                                             |
| `sign_up`                                                                                                                                                                           | `user.sign_up` **\[\*]**                                                                                                 |
| <p><code>video\_ad\_complete</code></p><p><code>video\_ad\_stop</code></p><p><code>video\_complete</code></p><p><code>video\_content\_complete</code></p>                           | `av.stop`                                                                                                                |
| `video_ad_click`                                                                                                                                                                    | `av.ad.click`                                                                                                            |
| <p><code>video\_ad\_playing</code></p><p><code>video\_content\_playing</code></p><p><code>video\_ad\_break\_complete</code></p><p><code>video\_content\_quarter\_reached</code></p> | `av.heartbeat`                                                                                                           |
| <p><code>video\_content\_start</code></p><p><code>video\_ad\_start</code></p><p><code>video\_ad\_break\_start</code></p>                                                            | `av.start`                                                                                                               |
| `video_ad_skip`                                                                                                                                                                     | `av.ad.skip`                                                                                                             |
| `video_buffer_start`                                                                                                                                                                | `av.buffer.start`                                                                                                        |
| `video_buffer_complete`                                                                                                                                                             | `av.buffer.heartbeat`                                                                                                    |
| `video_error`                                                                                                                                                                       | `av.error`                                                                                                               |
| `video_fullscreen_off`                                                                                                                                                              | `av.fullscreen.off`                                                                                                      |
| `video_fullscreen_on`                                                                                                                                                               | `av.fullscreen.on`                                                                                                       |
| `video_pause`                                                                                                                                                                       | `av.pause`                                                                                                               |
| `video_quality`                                                                                                                                                                     | `av.quality`                                                                                                             |
| `video_resume`                                                                                                                                                                      | `av.resume`                                                                                                              |
| `video_seek_start`                                                                                                                                                                  | `av.seek.start`                                                                                                          |
| `video_share`                                                                                                                                                                       | `av.share`                                                                                                               |
| `video_speed`                                                                                                                                                                       | `av.speed`                                                                                                               |
| `video_start`                                                                                                                                                                       | `av.play`                                                                                                                |
| `video_subtitle_off`                                                                                                                                                                | `av.subtitle.off`                                                                                                        |
| `video_subtitle_on`                                                                                                                                                                 | `av.subtitle.on`                                                                                                         |
| `video_volume`                                                                                                                                                                      | `av.volume`                                                                                                              |
| `view_cart`                                                                                                                                                                         | `cart.display`                                                                                                           |
| `view_item`                                                                                                                                                                         | <p><code>product.display</code> <strong>\[3]</strong></p><p><code>product.page\_display</code> <strong>\[3]</strong></p> |
| `view_item_list`                                                                                                                                                                    | `page.view_item_list` **\[\*]**                                                                                          |
| `[Any Other Event]`                                                                                                                                                                 | `[Custom Event]` **\[\*]**                                                                                               |

{% hint style="info" %}
**\*** Les événements personnalisés doivent d'abord être ajoutés au modèle de données de Piano Analytics, sinon ils ne seront pas traités. Vous pouvez ajouter de nouveaux événements en suivant ![](/files/fea7d3e82a381ef90a8bcf36e2eb09cf4cb779a7) ➜ `PARAMÈTRES` ➜ `Gestion des données` ➜ `Modèle de données` ➜`Événements`.\
**1.** Si <mark style="color:bleue;">`page_type`</mark> est égal à <mark style="color:bleue;">`product`</mark> alors <mark style="color:bleue;">`product.page_display`</mark> est envoyé, sinon, <mark style="color:bleue;">`page.display`</mark> .\
**2.** Un <mark style="color:bleue;">`product.purchased`</mark> sera envoyé pour chaque produit acheté.\
**3.** En cochant <mark style="color:bleue;">`Mappage d'événements personnalisés : "view_item" correspond à Piano "product.page_display"`</mark> (Voir [Configuration de la destination](#destination-setup)) associe votre <mark style="color:bleue;">`view_item`</mark> avec Piano <mark style="color:bleue;">`product.page_display`</mark> , sinon votre événement sera associé à Piano <mark style="color:bleue;">`product.display`</mark> .
{% endhint %}

## Mappages de champs

| Propriétés Commanders Act                                                                                                                                                 | Propriétés Piano Analytics                                                                                          |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| `event_timestamp`                                                                                                                                                         | `device_timestamp_utc` **\[1]**                                                                                     |
| `context.page.referrer`                                                                                                                                                   | `previous_url`                                                                                                      |
| `page_name`                                                                                                                                                               | `page`                                                                                                              |
| `value`                                                                                                                                                                   | <p><code>generate\_lead\_value</code></p><p><code>cart\_turnovertaxincluded</code></p>                              |
| `devise`                                                                                                                                                                  | <p><code>generate\_lead\_currency</code></p><p><code>cart\_currency</code></p>                                      |
| `ID`                                                                                                                                                                      | <p><code>transaction\_id</code></p><p><code>generate\_lead\_id</code></p>                                           |
| `item_list_name`                                                                                                                                                          | `view_item_list_name`                                                                                               |
| `méthode`                                                                                                                                                                 | <p><code>login\_method</code></p><p><code>sign\_up\_method</code></p>                                               |
| `content_type`                                                                                                                                                            | `content_type`                                                                                                      |
| `item_id`                                                                                                                                                                 | `item_id`                                                                                                           |
| `search_term`                                                                                                                                                             | `ise_keyword`                                                                                                       |
| `items.X.id`                                                                                                                                                              | `product_id` **\[2]**                                                                                               |
| `items.X.product.name`                                                                                                                                                    | `product` **\[2]**                                                                                                  |
| `items.X.variant`                                                                                                                                                         | `product_variant` **\[2]**                                                                                          |
| `items.X.product.brand`                                                                                                                                                   | `product_brand` **\[2]**                                                                                            |
| `(items.X.discount > 0)`                                                                                                                                                  | `product_discount` **\[2]\[3]**                                                                                     |
| `items.X.product.price`                                                                                                                                                   | `product_pricetaxincluded` **\[2]**                                                                                 |
| `items.X.product.currency`                                                                                                                                                | `product_currency` **\[2]**                                                                                         |
| `items.X.product.category_1`                                                                                                                                              | `product_category1` **\[2]**                                                                                        |
| `items.X.product.category_2`                                                                                                                                              | `product_category2` **\[2]**                                                                                        |
| `items.X.product.category_3`                                                                                                                                              | `product_category3` **\[2]**                                                                                        |
| `items.X.product.category_4`                                                                                                                                              | `product_category4` **\[2]**                                                                                        |
| `items.X.quantity`                                                                                                                                                        | <p><code>product\_quantity</code> <strong>\[2]</strong></p><p><code>cart\_quantity</code> <strong>\[4]</strong></p> |
| `items.X.coupon`                                                                                                                                                          | `product_promocode` **\[2]**                                                                                        |
| `coupon`                                                                                                                                                                  | `transaction_promocode`                                                                                             |
| `payment_method`                                                                                                                                                          | `payment_mode`                                                                                                      |
| `shipping_amount`                                                                                                                                                         | `shipping_costtaxincluded`                                                                                          |
| `shipping_tier`                                                                                                                                                           | `shipping_delivery`                                                                                                 |
| `cart_id`                                                                                                                                                                 | `cart_id`                                                                                                           |
| `revenu`                                                                                                                                                                  | `cart_turnovertaxfree`                                                                                              |
| `items.length`                                                                                                                                                            | `cart_nbdistinctproduct`                                                                                            |
| <p><code>user.id</code></p><p><code>user.email</code></p><p><code>user.email\_md5</code></p><p><code>user.email\_sha256</code></p><p><code>\[custom\_property]</code></p> | `user_id` **\[5]**                                                                                                  |
| `context.device.manufacturer`                                                                                                                                             | `device_manufacturer`                                                                                               |
| `context.device.model`                                                                                                                                                    | `device_model`                                                                                                      |
| `context.device.screen.height`                                                                                                                                            | `device_screen_height`                                                                                              |
| `context.device.screen.width`                                                                                                                                             | `device_screen_width`                                                                                               |
| `content_asset_id`                                                                                                                                                        | `av_content_id` **\[6]**                                                                                            |
| `(page.url)` ou `(page.location.href)`                                                                                                                                    | `src_medium` **\[7]**                                                                                               |
| `(page.url)` ou `(page.location.href)`                                                                                                                                    | `src_campaign` **\[8]**                                                                                             |
| `(page.url)` ou `(page.location.href)`                                                                                                                                    | `src_variant` **\[9]**                                                                                              |
| `(page.url)` ou `(page.location.href)`                                                                                                                                    | `src_format` **\[10]**                                                                                              |
| `video_session_id`                                                                                                                                                        | `av_session_id`                                                                                                     |
| `cursor_position * 1000`                                                                                                                                                  | `av_position`                                                                                                       |
| `prev_cursor_position * 1000`                                                                                                                                             | `av_previous_position`                                                                                              |
| `time_prev_event`                                                                                                                                                         | `av_duration`                                                                                                       |
| `prev_event_name`                                                                                                                                                         | `av_previous_event`                                                                                                 |
| `video_title`                                                                                                                                                             | `av_content`                                                                                                        |
| `video_category`                                                                                                                                                          | `av_content_type`                                                                                                   |
| `total_length * 1000`                                                                                                                                                     | `av_content_duration`                                                                                               |
| `content_linked`                                                                                                                                                          | `av_content_linked`                                                                                                 |
| `airdate`                                                                                                                                                                 | `av_publication_date`                                                                                               |
| `keywords`                                                                                                                                                                | `av_content_genre`                                                                                                  |
| `program`                                                                                                                                                                 | `av_show`                                                                                                           |
| `season`                                                                                                                                                                  | `av_show_season`                                                                                                    |
| `episode`                                                                                                                                                                 | `av_episode_id`                                                                                                     |
| `episode_label`                                                                                                                                                           | `av_episode`                                                                                                        |
| `channel`                                                                                                                                                                 | `av_channel`                                                                                                        |
| `publisher`                                                                                                                                                               | `av_author`                                                                                                         |
| `content_version`                                                                                                                                                         | `av_content_version`                                                                                                |
| `content_duration_range`                                                                                                                                                  | `av_content_duration_range`                                                                                         |
| `(livestream)`                                                                                                                                                            | `av_broadcasting_type` **\[11]**                                                                                    |
| `broadcaster_name`                                                                                                                                                        | `av_broadcaster`                                                                                                    |
| `ad_type`                                                                                                                                                                 | `av_ad_type`                                                                                                        |
| `video_player`                                                                                                                                                            | `av_player`                                                                                                         |
| `video_player_version`                                                                                                                                                    | `av_player_version`                                                                                                 |
| `auto_play`                                                                                                                                                               | `av_auto_mode`                                                                                                      |
| `video_language`                                                                                                                                                          | `av_language`                                                                                                       |
| `video_subtitles_language`                                                                                                                                                | `av_subtitles`                                                                                                      |
| `video_launch_reason`                                                                                                                                                     | `av_launch_reason`                                                                                                  |
| `interruption_method`                                                                                                                                                     | `av_player_error`                                                                                                   |
| `seek_position`                                                                                                                                                           | `av_seek_position`                                                                                                  |
| `bitrate`                                                                                                                                                                 | `av_bitrate`                                                                                                        |
| `framerate`                                                                                                                                                               | `av_framerate`                                                                                                      |
| `sound`                                                                                                                                                                   | `av_sound`                                                                                                          |
| `full_screen`                                                                                                                                                             | `av_fullscreen`                                                                                                     |
| `ad_enabled`                                                                                                                                                              | `av_ad_enabled`                                                                                                     |
| `image_quality`                                                                                                                                                           | `av_image_quality`                                                                                                  |
| <p><code>content\_pod\_id</code></p><p><code>ad\_pod\_id</code></p>                                                                                                       | `av_pod_id` **\[6]**                                                                                                |
| `video_description`                                                                                                                                                       | `av_description`                                                                                                    |
| `full_episode`                                                                                                                                                            | `av_full_episode`                                                                                                   |

{% hint style="info" %}
**1.** L'horodatage lié au moment où l'événement a eu lieu. Les horodatages à 10 ou 13 chiffres sont pris en charge : dans ce dernier cas, l'horodatage est converti au format décimal (p. ex. `1756195156953` est défini comme `1756195156.953` ). Vous pouvez également définir directement le format décimal avec des horodatages à 13 chiffres.\
**2.** Champ inclus pour les événements suivants : <mark style="color:bleue;">`add_to_cart`</mark> , <mark style="color:bleue;">`page_view (product.page_display)`</mark> , <mark style="color:bleue;">`view_item`</mark> , <mark style="color:bleue;">`purchase (product.purchased)`</mark> , <mark style="color:bleue;">`remove_from_cart`</mark> , <mark style="color:bleue;">`add_to_wishlist`</mark> , et <mark style="color:bleue;">`select_item`</mark> .\
**3.** Valeur booléenne : <mark style="color:bleue;">`true`</mark> ou <mark style="color:bleue;">`false`</mark> .\
**4.** Tout additionner <mark style="color:bleue;">`items.X.quantity`</mark> .\
**5.** Selon la sélection dans la liste déroulante (voir <mark style="color:bleue;">`Identifiant utilisateur`</mark> dans[<mark style="color:bleue;">`Configuration`</mark>](#configuration)section), une propriété spécifique Commanders Act est utilisée.\
**6.** Champ converti en chaîne.\
**7.** Analysé à partir du <mark style="color:bleue;">`utm_medium`</mark> paramètre dans l'URL fournie.\
**8.** Analysé à partir du <mark style="color:bleue;">`utm_campaign`</mark> paramètre dans l'URL fournie.\
**9.** Analysé à partir du <mark style="color:bleue;">`utm_content`</mark> paramètre dans l'URL fournie.\
**10.** Analysé à partir du <mark style="color:bleue;">`utm_creative_format`</mark> paramètre dans l'URL fournie.\
**11.** Il s'agit soit de "Live" soit de "Recorded Broadcast".
{% endhint %}

#### Paramètres des en-têtes

| Propriétés Commanders Act                                          | Champs Piano Analytics |
| ------------------------------------------------------------------ | ---------------------- |
| `device.user_agent`                                                | `User-Agent`           |
| <p><code>page.url</code></p><p><code>page.location.href</code></p> | `Referer`              |
| `device.ip`                                                        | `X-Forwarded-For`      |

## Événements autopromo

Lors de l'envoi [*page\_view*](https://doc.commandersact.com/developers/tracking/events-reference/common-events#page_view) et *click.action* événements, vous pouvez ajouter des autopromotions en définissant le champ de tableau `autopromos` . Voir l'exemple suivant :

```json
...
"autopromos": [
        {
          "name": "self_promotion.display",
          "data": {
            "onsitead_type": "Self promotion",
            "onsitead_campaign": "trv_tem",
            "onsitead_category": "opt_tem",
            "onsitead_creation": "https://mysite.com/hp-autopromo.png",
            "onsitead_detailed_placement": "hp_autopromo"
          }
        },
        {
          "name": "self_promotion.display",
          "data": {
            "onsitead_type": "Self promotion",
            "onsitead_campaign": "trv_tem2",
            "onsitead_category": "opt_tem2",
            "onsitead_creation": "https://mysite.com/hp-autopromo-2.png",
            "onsitead_detailed_placement": "hp_autopromo_2"
          }
        }
],
...
```

Chaque position du tableau doit inclure un événement Piano Analytics valide et est transmise telle quelle.\
Dans l'exemple ci-dessus, deux événements supplémentaires sont inclus dans une seule requête à Piano Analytics.\
Cette fonctionnalité doit être activée dans le "Advanced Setting" en cochant l'option "Send Autopromo Events" - Voir [Configuration](#configuration) pour plus de détails.


---

# 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/piano-analytics/at-internet.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.
Paramètres	Description
`ID du site`	`Obligatoire` L'identifiant du site auquel appartiennent les données (p. ex. `628087`). Vous pouvez le trouver dans l'interface Piano Analytics en suivant ➜ `PARAMÈTRES` ➜ `Portail de collecte de données` ➜ `Outils` ➜ `Gestion du site` et en sélectionnant votre site. Ce paramètre prend en charge des valeurs dynamiques [1].
`Domaine de collecte sécurisé`	`Obligatoire` Le domaine SSL sur lequel les informations sont collectées (p. ex. `logs1412.xiti.com`). Vous pouvez le trouver dans l'interface Piano Analytics en suivant ➜ `PARAMÈTRES` `Portail de collecte de données` ➜ `Outils` ➜ `Gestion du site` et en sélectionnant votre site.
`Identifiant utilisateur`	Vous pouvez définir votre identifiant utilisateur pour les utilisateurs connectés. Plus de détails sont disponibles en suivant ce LIEN.
`Propriété personnalisée`	Lorsque vous sélectionnez « [Custom Property] » comme valeur pour le champ ci-dessus `Identifiant utilisateur`, ce champ apparaîtra afin que vous puissiez spécifier un champ personnalisé contenant la valeur de l'identifiant utilisateur.
`Identifiant client`	Vous pouvez définir un identifiant client spécifique comme notre `context.device.sdk_id` ou une propriété personnalisée contenant sa valeur. Lorsque vous conservez la valeur « Default », ou si les premières options mentionnées ne renvoient pas une valeur valide, il s'agit de votre identifiant unique de visiteur client-side provenant des cookies, comme détaillé dans le Configuration de la destination. Si aucun cookie n'est disponible, la propriété `user.tcId` est utilisée. Plus de détails sont disponibles en suivant ce LIEN.
`Propriété personnalisée`	Lorsque vous sélectionnez « [Custom Property] » comme valeur pour le champ ci-dessus `Identifiant client`, ce champ apparaîtra afin que vous puissiez spécifier un champ personnalisé contenant la valeur de l'identifiant client.
`Mappage d'événements personnalisés :` `"view_item" correspond` `avec Piano` `"product.page_display"`	En activant cette option, votre `view_item` événement sera associé à Piano `product.page_display` événement. Voir Référence rapide pour plus d'informations sur le mappage d'événements.
`Envoyer les événements autopromo`	Cela active les événements autopromo. Voir Événements autopromo pour plus de détails.
`Envoyer toutes les propriétés`	Lorsque vous activez cette option, toutes les propriétés incluses à la racine de vos événements sont également envoyées, sans aucune modification, à Piano Analytics dans l' `data` objet. Plus de détails sont disponibles en suivant ce LIEN.
`Ne pas écraser`	Lorsque `Envoyer toutes les propriétés` est cochée, vous pouvez éviter d'écraser les propriétés déjà définies/présentes.
`Propriétés d'événements personnalisées`	Associez vos propriétés d'événements personnalisées en définissant leurs noms de champ dans `Nom de propriété Piano Analytics` et en ajoutant le nom du champ contenant la valeur dans `Votre propriété d'événement` . Par ex. si vous saisissez `size` dans `Nom de propriété Piano Analytics` et `items.0.product.size` dans `Votre propriété d'événement` , vous aurez une propriété d'événement personnalisée dans Piano Analytics appelée `size` avec une valeur basée sur le contenu du champ `items.0.product.size`. Dans la colonne `Votre chemin de propriété d'événement` vous devez conserver la valeur par défaut `Par défaut (racine)` car elle convient mieux à la plupart des scénarios. Si vous sélectionnez l'un ou l'autre `Dans "items" {items.X}` ou `Dans "product" {items.X.product}` cette destination cherchera la propriété d'événement d'entrée à partir du items ou product niveau correspondant et ajoutez ses valeurs comme propriété d'élément personnalisée. Pour que les propriétés d'événements personnalisées soient prises en compte par Piano Analytics, vous devez d'abord les créer en suivant ➜ `PARAMÈTRES` ➜ `Gestion des données` ➜ `Modèle de données` ➜ `Propriétés` .
`Propriétés utilisateur personnalisées`	Mappez vos propriétés utilisateur personnalisées en définissant leurs noms de champ dans `Nom de la propriété utilisateur` et en ajoutant le nom du champ contenant la valeur dans `propriété d'événement Commanders Act ou valeur statique` . Par ex. si vous saisissez `customer_zipcode` dans `Nom de la propriété utilisateur` et `user.zipcode` dans `propriété d'événement Commanders Act ou valeur statique` , vous aurez une propriété utilisateur personnalisée dans Piano Analytics appelée `customer_zipcode` avec une valeur basée sur le contenu du champ `user.zipcode` . Vous avez également la possibilité de définir une valeur statique de chaîne/numérique dans `propriété d'événement Commanders Act ou valeur statique` . Pour que les propriétés utilisateur personnalisées soient prises en compte par Piano Analytics, vous devez d'abord les créer en suivant ➜ `PARAMÈTRES` ➜ `Gestion des données` ➜ `Modèle de données` ➜ `Propriétés` .