> 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 d'AT Internet Analytics Suite 2 (AS2).\
C'est un outil centré sur l'utilisateur qui simplifie l'analyse produit & 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 uniquement disponible pour [Piano Analytics](https://developers.atinternet-solutions.com/piano-analytics/#what-is-piano-analytics).\
Vous pouvez consulter le tableau de compatibilité suivant [tableau de compatibilité](https://developers.atinternet-solutions.com/piano-analytics/#before-i-start) pour obtenir davantage d'informations sur les fonctionnalités prises en charge par produit.
{% endhint %}

## Fonctionnalités clés

La destination Piano Analytics Collection API offre 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 à [celui 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 mapping des données pour les destinations basées sur les é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-item**: les informations incluses dans le [item](https://community.commandersact.com/platform-x/developers/tracking/events-reference#item) array est transmis à Piano Analytics.
* **Identifiant utilisateur**: vous pouvez librement sélectionner 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 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:blue;">**`xtidc`**</mark> cookie dans cet ordre de priorité. Valeur par défaut : <mark style="color:blue;">`user.consistent_anonymous_id`</mark>. Voir <mark style="color:blue;">`Identifiant client`</mark> dans [Configuration](#configuration) pour personnaliser davantage cette valeur.
{% endhint %}

### Configuration

<table><thead><tr><th width="283">Paramètres</th><th width="465">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="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-5aed90690b9e24f27ec864bad486d53d8dda30e9%2F1.png?alt=media" 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 les 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="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-5aed90690b9e24f27ec864bad486d53d8dda30e9%2F1.png?alt=media" 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énement personnalisé :</code><br><code>"view_item" associé</code><br><code>à Piano</code><br><code>"product.page_display"</code></td><td>En cochant 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 des é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 cette option est activée, 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'objet <mark style="color:blue;"><code>data</code></mark> . 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é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 dans Piano Analytics une propriété d'événement personnalisée appelée <code>size</code> avec une valeur basée sur le contenu du champ <code>items.0.product.size</code>.</p><p>Dans la colonne <code>Chemin de votre propriété d'événement</code> vous devez conserver la valeur par défaut <code>Default (racine)</code> car cela convient mieux à la plupart des scénarios. Si vous sélectionnez <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 respectivement et ajoutera ses valeurs comme propriété d'item personnalisée.</p><p><br>Pour garantir que les propriétés d'événement personnalisées soient prises en compte par Piano Analytics, vous devez d'abord les créer en suivant <img src="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-5aed90690b9e24f27ec864bad486d53d8dda30e9%2F1.png?alt=media" 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 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="https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-5aed90690b9e24f27ec864bad486d53d8dda30e9%2F1.png?alt=media" 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 %}

<table data-header-hidden="false" data-header-sticky><thead><tr><th>Événements Commanders Act</th><th width="451">Événements Piano Analytics</th></tr></thead><tbody><tr><td><code>add_payment_info</code></td><td><code>cart.payment</code></td></tr><tr><td><code>add_shipping_info</code></td><td><code>cart.delivery</code></td></tr><tr><td><code>add_to_cart</code></td><td><code>product.add_to_cart</code></td></tr><tr><td><code>add_to_wishlist</code></td><td><code>product.add_to_wishlist</code> <strong>[*]</strong></td></tr><tr><td><code>begin_checkout</code></td><td><code>cart.begin_checkout</code> <strong>[*]</strong></td></tr><tr><td><code>generate_lead</code></td><td><code>transaction.generate_lead</code> <strong>[*]</strong></td></tr><tr><td><code>login</code></td><td><code>user.login</code> <strong>[*]</strong></td></tr><tr><td><code>page_view</code></td><td><code>page.display</code> ou <code>product.page_display</code> <strong>[1]</strong></td></tr><tr><td><code>purchase</code></td><td><code>transaction.confirmation</code> et <code>product.purchased</code> <strong>[2]</strong></td></tr><tr><td><code>refund</code></td><td><code>refund</code> <strong>[*]</strong></td></tr><tr><td><code>remove_from_cart</code></td><td><code>product.remove_from_cart</code></td></tr><tr><td><code>search</code></td><td><code>internal_search_result.display</code></td></tr><tr><td><code>select_content</code></td><td><code>select_content</code> <strong>[*]</strong></td></tr><tr><td><code>select_item</code></td><td><code>page.select_item</code> <strong>[*]</strong></td></tr><tr><td><code>sign_up</code></td><td><code>user.sign_up</code> <strong>[*]</strong></td></tr><tr><td><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></td><td><code>av.stop</code></td></tr><tr><td><code>video_ad_click</code></td><td><code>av.ad.click</code></td></tr><tr><td><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></td><td><code>av.heartbeat</code></td></tr><tr><td><p><code>video_content_start</code></p><p><code>video_ad_start</code></p><p><code>video_ad_break_start</code></p></td><td><code>av.start</code></td></tr><tr><td><code>video_ad_skip</code></td><td><code>av.ad.skip</code></td></tr><tr><td><code>video_buffer_start</code></td><td><code>av.buffer.start</code></td></tr><tr><td><code>video_buffer_complete</code></td><td><code>av.buffer.heartbeat</code></td></tr><tr><td><code>video_error</code></td><td><code>av.error</code></td></tr><tr><td><code>video_fullscreen_off</code></td><td><code>av.fullscreen.off</code></td></tr><tr><td><code>video_fullscreen_on</code></td><td><code>av.fullscreen.on</code></td></tr><tr><td><code>video_pause</code></td><td><code>av.pause</code></td></tr><tr><td><code>video_quality</code></td><td><code>av.quality</code></td></tr><tr><td><code>video_resume</code></td><td><code>av.resume</code></td></tr><tr><td><code>video_seek_start</code></td><td><code>av.seek.start</code></td></tr><tr><td><code>video_share</code></td><td><code>av.share</code></td></tr><tr><td><code>video_speed</code></td><td><code>av.speed</code></td></tr><tr><td><code>video_start</code></td><td><code>av.play</code></td></tr><tr><td><code>video_subtitle_off</code></td><td><code>av.subtitle.off</code></td></tr><tr><td><code>video_subtitle_on</code></td><td><code>av.subtitle.on</code></td></tr><tr><td><code>video_volume</code></td><td><code>av.volume</code></td></tr><tr><td><code>view_cart</code></td><td><code>cart.display</code></td></tr><tr><td><code>view_item</code></td><td><p><code>product.display</code> <strong>[3]</strong></p><p><code>product.page_display</code> <strong>[3]</strong></p></td></tr><tr><td><code>view_item_list</code></td><td><code>page.view_item_list</code> <strong>[*]</strong></td></tr><tr><td><code>[Any Other Event]</code></td><td><code>[Custom Event]</code> <strong>[*]</strong></td></tr></tbody></table>

{% 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 ![](https://3282103337-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mk6XpTQ2LaRLcr2tA-d%2Fuploads%2Fgit-blob-5aed90690b9e24f27ec864bad486d53d8dda30e9%2F1.png?alt=media) ➜ `PARAMÈTRES` ➜ `Gestion des données` ➜ `Modèle de données` ➜`Événements`.\
**1.** Si <mark style="color:blue;">`page_type`</mark> est égal à <mark style="color:blue;">`product`</mark> alors <mark style="color:blue;">`product.page_display`</mark> est envoyé, sinon, <mark style="color:blue;">`page.display`</mark> .\
**2.** Un <mark style="color:blue;">`product.purchased`</mark> sera envoyé pour chaque produit acheté.\
**3.** En cochant <mark style="color:blue;">`Mappage d'événement personnalisé : "view_item" associé à Piano "product.page_display"`</mark> (Voir [Configuration de la destination](#destination-setup)) associe votre <mark style="color:blue;">`view_item`</mark> à Piano <mark style="color:blue;">`product.page_display`</mark> , sinon votre événement sera associé à Piano <mark style="color:blue;">`product.display`</mark> .
{% endhint %}

## Mappages des champs

<table data-header-hidden="false" data-header-sticky><thead><tr><th>Propriétés Commanders Act</th><th>Propriétés Piano Analytics</th></tr></thead><tbody><tr><td><code>event_timestamp</code></td><td><code>device_timestamp_utc</code> <strong>[1]</strong></td></tr><tr><td><code>context.page.referrer</code></td><td><code>previous_url</code></td></tr><tr><td><code>page_name</code></td><td><code>page</code></td></tr><tr><td><code>value</code></td><td><p><code>generate_lead_value</code></p><p><code>cart_turnovertaxincluded</code></p></td></tr><tr><td><code>currency</code></td><td><p><code>generate_lead_currency</code></p><p><code>cart_currency</code></p></td></tr><tr><td><code>id</code></td><td><p><code>transaction_id</code></p><p><code>generate_lead_id</code></p></td></tr><tr><td><code>item_list_name</code></td><td><code>view_item_list_name</code></td></tr><tr><td><code>method</code></td><td><p><code>login_method</code></p><p><code>sign_up_method</code></p></td></tr><tr><td><code>content_type</code></td><td><code>content_type</code></td></tr><tr><td><code>item_id</code></td><td><code>item_id</code></td></tr><tr><td><code>search_term</code></td><td><code>ise_keyword</code></td></tr><tr><td><code>items.X.id</code></td><td><code>product_id</code> <strong>[2]</strong></td></tr><tr><td><code>items.X.product.name</code></td><td><code>product</code> <strong>[2]</strong></td></tr><tr><td><code>items.X.variant</code></td><td><code>product_variant</code> <strong>[2]</strong></td></tr><tr><td><code>items.X.product.brand</code></td><td><code>product_brand</code> <strong>[2]</strong></td></tr><tr><td><code>(items.X.discount > 0)</code></td><td><code>product_discount</code> <strong>[2][3]</strong></td></tr><tr><td><code>items.X.product.price</code></td><td><code>product_pricetaxincluded</code> <strong>[2]</strong></td></tr><tr><td><code>items.X.product.currency</code></td><td><code>product_currency</code> <strong>[2]</strong></td></tr><tr><td><code>items.X.product.category_1</code></td><td><code>product_category1</code> <strong>[2]</strong></td></tr><tr><td><code>items.X.product.category_2</code></td><td><code>product_category2</code> <strong>[2]</strong></td></tr><tr><td><code>items.X.product.category_3</code></td><td><code>product_category3</code> <strong>[2]</strong></td></tr><tr><td><code>items.X.product.category_4</code></td><td><code>product_category4</code> <strong>[2]</strong></td></tr><tr><td><code>items.X.quantity</code></td><td><p><code>product_quantity</code> <strong>[2]</strong></p><p><code>cart_quantity</code> <strong>[4]</strong></p></td></tr><tr><td><code>items.X.coupon</code></td><td><code>product_promocode</code> <strong>[2]</strong></td></tr><tr><td><code>coupon</code></td><td><code>transaction_promocode</code></td></tr><tr><td><code>payment_method</code></td><td><code>payment_mode</code></td></tr><tr><td><code>shipping_amount</code></td><td><code>shipping_costtaxincluded</code></td></tr><tr><td><code>shipping_tier</code></td><td><code>shipping_delivery</code></td></tr><tr><td><code>cart_id</code></td><td><code>cart_id</code></td></tr><tr><td><code>revenue</code></td><td><code>cart_turnovertaxfree</code></td></tr><tr><td><code>items.length</code></td><td><code>cart_nbdistinctproduct</code></td></tr><tr><td><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></td><td><code>user_id</code> <strong>[5]</strong></td></tr><tr><td><code>context.device.manufacturer</code></td><td><code>device_manufacturer</code></td></tr><tr><td><code>context.device.model</code></td><td><code>device_model</code></td></tr><tr><td><code>context.device.screen.height</code></td><td><code>device_screen_height</code></td></tr><tr><td><code>context.device.screen.width</code></td><td><code>device_screen_width</code></td></tr><tr><td><code>content_asset_id</code></td><td><code>av_content_id</code> <strong>[6]</strong></td></tr><tr><td><code>page.url</code><br><code>page.location.href</code></td><td><code>src_medium</code> <strong>[7]</strong></td></tr><tr><td><code>page.url</code><br><code>page.location.href</code></td><td><code>src_campaign</code> <strong>[8]</strong></td></tr><tr><td><code>page.url</code><br><code>page.location.href</code></td><td><code>src_variant</code> <strong>[9]</strong></td></tr><tr><td><code>page.url</code><br><code>page.location.href</code></td><td><code>src_format</code> <strong>[10]</strong></td></tr><tr><td><code>page.url</code><br><code>page.location.href</code></td><td><code>src_[property]</code> <strong>[11]</strong></td></tr><tr><td><code>video_session_id</code></td><td><code>av_session_id</code></td></tr><tr><td><code>cursor_position</code></td><td><code>av_position</code></td></tr><tr><td><code>prev_cursor_position</code></td><td><code>av_previous_position</code></td></tr><tr><td><code>time_prev_event</code></td><td><code>av_duration</code></td></tr><tr><td><code>prev_event_name</code></td><td><code>av_previous_event</code></td></tr><tr><td><code>video_title</code></td><td><code>av_content</code></td></tr><tr><td><code>video_category</code></td><td><code>av_content_type</code></td></tr><tr><td><code>total_length * 1000</code></td><td><code>av_content_duration</code></td></tr><tr><td><code>content_linked</code></td><td><code>av_content_linked</code></td></tr><tr><td><code>airdate</code></td><td><code>av_publication_date</code></td></tr><tr><td><code>keywords</code></td><td><code>av_content_genre</code></td></tr><tr><td><code>program</code></td><td><code>av_show</code></td></tr><tr><td><code>season</code></td><td><code>av_show_season</code></td></tr><tr><td><code>episode</code></td><td><code>av_episode_id</code></td></tr><tr><td><code>episode_label</code></td><td><code>av_episode</code></td></tr><tr><td><code>channel</code></td><td><code>av_channel</code></td></tr><tr><td><code>publisher</code></td><td><code>av_author</code></td></tr><tr><td><code>content_version</code></td><td><code>av_content_version</code></td></tr><tr><td><code>content_duration_range</code></td><td><code>av_content_duration_range</code></td></tr><tr><td><code>(livestream)</code></td><td><code>av_broadcasting_type</code> <strong>[12]</strong></td></tr><tr><td><code>broadcaster_name</code></td><td><code>av_broadcaster</code></td></tr><tr><td><code>ad_type</code></td><td><code>av_ad_type</code></td></tr><tr><td><code>video_player</code></td><td><code>av_player</code></td></tr><tr><td><code>video_player_version</code></td><td><code>av_player_version</code></td></tr><tr><td><code>auto_play</code></td><td><code>av_auto_mode</code></td></tr><tr><td><code>video_language</code></td><td><code>av_language</code></td></tr><tr><td><code>video_subtitles_language</code></td><td><code>av_subtitles</code></td></tr><tr><td><code>video_launch_reason</code></td><td><code>av_launch_reason</code></td></tr><tr><td><code>interruption_method</code></td><td><code>av_player_error</code></td></tr><tr><td><code>seek_position</code></td><td><code>av_seek_position</code></td></tr><tr><td><code>bitrate</code></td><td><code>av_bitrate</code></td></tr><tr><td><code>framerate</code></td><td><code>av_framerate</code></td></tr><tr><td><code>sound</code></td><td><code>av_sound</code></td></tr><tr><td><code>full_screen</code></td><td><code>av_fullscreen</code></td></tr><tr><td><code>ad_enabled</code></td><td><code>av_ad_enabled</code></td></tr><tr><td><code>image_quality</code></td><td><code>av_image_quality</code></td></tr><tr><td><p><code>content_pod_id</code></p><p><code>ad_pod_id</code></p></td><td><code>av_pod_id</code> <strong>[6]</strong></td></tr><tr><td><code>video_description</code></td><td><code>av_description</code></td></tr><tr><td><code>full_episode</code></td><td><code>av_full_episode</code></td></tr></tbody></table>

{% hint style="info" %}
**1.** L’horodatage lié au moment où l’événement a eu lieu. Les horodatages à 10 ou 13 chiffres sont tous deux pris en charge : dans ce dernier cas, l’horodatage est converti au format décimal (par 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:blue;">`add_to_cart`</mark> , <mark style="color:blue;">`page_view (product.page_display)`</mark> , <mark style="color:blue;">`view_item`</mark> , <mark style="color:blue;">`purchase (product.purchased)`</mark> , <mark style="color:blue;">`remove_from_cart`</mark> , <mark style="color:blue;">`add_to_wishlist`</mark> , et <mark style="color:blue;">`select_item`</mark> .\
**3.** Valeur booléenne : <mark style="color:blue;">`true`</mark> ou <mark style="color:blue;">`false`</mark> .\
**4.** Additionner tous les <mark style="color:blue;">`items.X.quantity`</mark> .\
**5.** Selon la sélection dans la liste déroulante (voir la <mark style="color:blue;">`Identifiant utilisateur`</mark> dans le[<mark style="color:blue;">`Configuration`</mark>](#configuration)section), une propriété Commanders Act spécifique est utilisée.\
**6.** Champ converti en chaîne de caractères.\
**7.** Analysé à partir du <mark style="color:blue;">`utm_medium`</mark> ou <mark style="color:blue;">`at_medium`</mark> paramètre dans l’url fournie. Le premier paramètre est prioritaire sur le second.\
**8.** Analysé à partir du <mark style="color:blue;">`utm_campaign`</mark> ou <mark style="color:blue;">`at_campaign`</mark> paramètre dans l’url fournie. Le premier paramètre est prioritaire sur le second.\
**9.** Analysé à partir du <mark style="color:blue;">`utm_content`</mark> ou <mark style="color:blue;">`at_variant`</mark> paramètre dans l’url fournie. Le premier paramètre est prioritaire sur le second.\
**10.** Analysé à partir du <mark style="color:blue;">`utm_creative_format`</mark> ou <mark style="color:blue;">`at_creative_format`</mark> paramètre dans l’url fournie. Le premier paramètre est prioritaire sur le second.\
**11.** Analysé à partir du <mark style="color:blue;">`at_[property]`</mark> paramètre dans l’url fournie.\
**12.** 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 d’événements [*page\_view*](https://doc.commandersact.com/developers/tracking/events-reference/common-events#page_view) et *click.action* 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 transmis tel quel.\
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.