> 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 les analyses produit et marketing, tout en garantissant la qualité des données.\
Vos données seront envoyées server-side pour 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 uniquement disponible 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 davantage d'Insights sur les fonctionnalités prises en charge par produit.
{% endhint %}

## Fonctionnalités clés

La destination Collection API de Piano Analytics 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 [Piano Analytics' one](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 s'effectue automatiquement, ce qui simplifie la saisie utilisateur.
* **Événements personnalisés**: vous pouvez librement envoyer 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) array 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 du visiteur client-side est recommandé et est récupéré en prenant la valeur du [**`_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:bleu;">**`xtidc`**</mark> cookie dans cet ordre de priorité. Valeur par défaut : <mark style="color:bleu;">`user.consistent_anonymous_id`</mark>. Voir <mark style="color:bleu;">`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 les données appartiennent (p. ex. <code>628087</code>). Cela peut être trouvé dans l'interface Piano Analytics en suivant <img src="/files/fea7d3e82a381ef90a8bcf36e2eb09cf4cb779a7" alt=""> ➜ <code>PARAMÈTRES</code> ➜ <code>Portail de collecte des 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>). Cela peut être trouvé dans l'interface Piano Analytics en suivant <img src="/files/fea7d3e82a381ef90a8bcf36e2eb09cf4cb779a7" alt=""> ➜ <code>PARAMÈTRES</code><br><code>Portail de collecte des 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">LINK</a>.</td></tr><tr><td><code>Propriété personnalisée</code></td><td>Lorsque vous sélectionnez "[Custom Property]" comme valeur pour le <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 n'aboutissent pas à une valeur valide, il s'agit de votre identifiant unique du 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">LINK</a>.</td></tr><tr><td><code>Propriété personnalisée</code></td><td>Lorsque vous sélectionnez "[Custom Property]" comme valeur pour le <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" associé</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 avec Piano <code>product.page_display</code> correspondra à l'é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:bleu;"><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">LINK</a>.</td></tr><tr><td><code>Ne pas écraser</code></td><td>Lorsque <code>Envoyer toutes les propriétés</code> est coché, vous pouvez éviter d'écraser des propriétés déjà définies/présentes.</td></tr><tr><td><code>Propriétés d'événement personnalisées</code></td><td><p>Mappez vos propriétés d'événement 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> . p. ex. si vous saisissez <code>size</code> dans le <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>Le chemin de votre propriété d'événement</code> vous devez conserver la valeur par défaut <code>Par défaut (root)</code> car elle 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 à 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 garantir que les propriétés d'événements personnalisés 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>Data Management</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 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>P. ex. si vous saisissez <code>customer_zipcode</code> dans <code>nom de 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 garantir 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>Data Management</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 video/audio](https://developers.atinternet-solutions.com/piano-analytics-tagging-en/event-tagging-piano-analytics-en/standard-event-tagging-en/#audio-video_31) sont pris en charge par [notre modèle d'événements](https://doc.commandersact.com/developers/tracking/events-reference/video-event-reference).
{% endhint %}

| Commanders Act Events                                                                                                                                                               | É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]**                                                               |
| `refund`                                                                                                                                                                            | `refund` **\[\*]**                                                                                                       |
| `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` **\[\*]**                                                                                          |
| `[Tout autre événement]`                                                                                                                                                            | `[Événement personnalisé]` **\[\*]**                                                                                     |

{% 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` ➜ `Data Management` ➜ `Modèle de données` ➜`Événements`.\
**1.** Si <mark style="color:bleu;">`page_type`</mark> est égal à <mark style="color:bleu;">`product`</mark> ensuite <mark style="color:bleu;">`product.page_display`</mark> est envoyé, sinon, <mark style="color:bleu;">`page.display`</mark> .\
**2.** Un <mark style="color:bleu;">`product.purchased`</mark> sera envoyé pour chaque produit acheté.\
**3.** Activation <mark style="color:bleu;">`Mappage d'événements personnalisés : "view_item" associé à Piano "product.page_display"`</mark> (voir [Configuration de la destination](#destination-setup)) mappe votre <mark style="color:bleu;">`view_item`</mark> avec Piano <mark style="color:bleu;">`product.page_display`</mark> , sinon votre événement sera associé à Piano <mark style="color:bleu;">`product.display`</mark> .
{% endhint %}

## Correspondances des 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`                                                                                                              |
| `valeur`                                                                                                                                                                  | <p><code>generate\_lead\_value</code></p><p><code>cart\_turnovertaxincluded</code></p>                              |
| `currency`                                                                                                                                                                | <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`                                                                                               |
| `method`                                                                                                                                                                  | <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`                                                                                                           |
| `revenue`                                                                                                                                                                 | `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]**                                                                                            |
| <p><code>page.url</code><br><code>page.location.href</code></p>                                                                                                           | `src_medium` **\[7]**                                                                                               |
| <p><code>page.url</code><br><code>page.location.href</code></p>                                                                                                           | `src_campaign` **\[8]**                                                                                             |
| <p><code>page.url</code><br><code>page.location.href</code></p>                                                                                                           | `src_variant` **\[9]**                                                                                              |
| <p><code>page.url</code><br><code>page.location.href</code></p>                                                                                                           | `src_format` **\[10]**                                                                                              |
| <p><code>page.url</code><br><code>page.location.href</code></p>                                                                                                           | `src_[property]` **\[11]**                                                                                          |
| `video_session_id`                                                                                                                                                        | `av_session_id`                                                                                                     |
| `cursor_position`                                                                                                                                                         | `av_position`                                                                                                       |
| `prev_cursor_position`                                                                                                                                                    | `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`                                                                                                        |
| `digital`                                                                                                                                                                 | `av_channel`                                                                                                        |
| `publisher`                                                                                                                                                               | `av_author`                                                                                                         |
| `content_version`                                                                                                                                                         | `av_content_version`                                                                                                |
| `content_duration_range`                                                                                                                                                  | `av_content_duration_range`                                                                                         |
| `(livestream)`                                                                                                                                                            | `av_broadcasting_type` **\[12]**                                                                                    |
| `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 correspondant au moment où l'événement a eu lieu. Les horodatages de 10 ou 13 chiffres sont pris en charge : avec les seconds, 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:bleu;">`add_to_cart`</mark> , <mark style="color:bleu;">`page_view (product.page_display)`</mark> , <mark style="color:bleu;">`view_item`</mark> , <mark style="color:bleu;">`purchase (product.purchased)`</mark> , <mark style="color:bleu;">`remove_from_cart`</mark> , <mark style="color:bleu;">`add_to_wishlist`</mark> , et <mark style="color:bleu;">`select_item`</mark> .\
**3.** Valeur booléenne : <mark style="color:bleu;">`true`</mark> ou <mark style="color:bleu;">`false`</mark> .\
**4.** Additionner tout <mark style="color:bleu;">`items.X.quantity`</mark> .\
**5.** Selon la sélection dans la liste déroulante (Voir <mark style="color:bleu;">`Identifiant utilisateur`</mark> dans le[<mark style="color:bleu;">`Configuration`</mark>](#configuration)section), une propriété spécifique de Commanders Act est utilisée.\
**6.** Champ converti en chaîne.\
**7.** Analysé à partir du <mark style="color:bleu;">`utm_medium`</mark> ou <mark style="color:bleu;">`at_medium`</mark> paramètre dans l'URL fournie. Le premier paramètre a priorité sur le second.\
**8.** Analysé à partir du <mark style="color:bleu;">`utm_campaign`</mark> ou <mark style="color:bleu;">`at_campaign`</mark> paramètre dans l'URL fournie. Le premier paramètre a priorité sur le second.\
**9.** Analysé à partir du <mark style="color:bleu;">`utm_content`</mark> ou <mark style="color:bleu;">`at_variant`</mark> paramètre dans l'URL fournie. Le premier paramètre a priorité sur le second.\
**10.** Analysé à partir du <mark style="color:bleu;">`utm_creative_format`</mark> ou <mark style="color:bleu;">`at_creative_format`</mark> paramètre dans l'URL fournie. Le premier paramètre a priorité sur le second.\
**11.** Analysé à partir du <mark style="color:bleu;">`at_[property]`</mark> paramètre dans l'URL fournie.\
**12.** Il s'agit soit de "Live" soit de "Recorded Broadcast".
{% endhint %}

#### Paramètres d'en-tête

| 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 de [*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": "Auto-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": "Auto-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 "Paramètre avancé" 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 les données appartiennent (p. ex. `628087`). Cela peut être trouvé dans l'interface Piano Analytics en suivant ➜ `PARAMÈTRES` ➜ `Portail de collecte des 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`). Cela peut être trouvé dans l'interface Piano Analytics en suivant ➜ `PARAMÈTRES` `Portail de collecte des 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 LINK.
`Propriété personnalisée`	Lorsque vous sélectionnez "[Custom Property]" comme valeur pour le `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 n'aboutissent pas à une valeur valide, il s'agit de votre identifiant unique du 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 LINK.
`Propriété personnalisée`	Lorsque vous sélectionnez "[Custom Property]" comme valeur pour le `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" associé` `avec Piano` `"product.page_display"`	En activant cette option, votre `view_item` événement avec Piano `product.page_display` correspondra à l'é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 LINK.
`Ne pas écraser`	Lorsque `Envoyer toutes les propriétés` est coché, vous pouvez éviter d'écraser des propriétés déjà définies/présentes.
`Propriétés d'événement personnalisées`	Mappez vos propriétés d'événement 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` . p. ex. si vous saisissez `size` dans le `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 `Le chemin de votre propriété d'événement` vous devez conserver la valeur par défaut `Par défaut (root)` car elle convient mieux à la plupart des scénarios. Si vous sélectionnez soit `Dans "items" {items.X}` ou `Dans "product" {items.X.product}` cette destination recherchera 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 garantir que les propriétés d'événements personnalisés soient prises en compte par Piano Analytics, vous devez d'abord les créer en suivant ➜ `PARAMÈTRES` ➜ `Data Management` ➜ `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 propriété utilisateur` et en ajoutant le nom du champ contenant la valeur dans `Propriété d'événement Commanders Act ou valeur statique` . P. ex. si vous saisissez `customer_zipcode` dans `nom de 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 garantir 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` ➜ `Data Management` ➜ `Modèle de données` ➜ `Propriétés` .