Tag AV Insights sans le SDK de Piano Analytics.

Dans les implémentations serveur-side, le support fourni par le SDK Piano Analytics n'est pas disponible. Le SDK permet généralement de :

• Ajouter des propriétés contextuelles aux événements, y compris le nom et la position de l'événement précédent (ex. : av_previous_position, av_previous_event).

• Envoyer des événements de type heartbeat pendant la lecture.

• Assurer le séquencement des événements au sein d'une même session AV.

Sans le SDK, ces mécanismes doivent être gérés manuellement, ce qui peut être complexe. Pour simplifier le suivi en serveur-side, Piano Analytics propose une version allégée d’AV Insight, spécialement conçue pour cet usage.

Qu'est-ce qu'AV Light ?

Afin d'assurer la compatibilité d’AV Insights avec les implémentations en serveur-side, AV Light réduit la quantité d’informations requises pour le suivi.

Attention : Lorsque les quatre propriétés généralement ajoutées par le SDK Piano sont absentes, le système de traitement les reconstruit automatiquement et gère la session AV. Cependant, ces quatre propriétés ne doivent pas être incluses dans le tag, faute de quoi l’événement ne sera pas reconnu comme AV Light et sera rejeté.

Les quatre propriétés gérées par le traitement :

• av_session_id – Identifiant unique regroupant les événements d'une même session de lecture.

• av_previous_event – Identifie l’événement AV Insight précédent.

• av_previous_position – Suit la position du curseur de l’événement précédent.

• av_duration – Spécifie la durée de l’événement précédent.

Étant donné que ces paramètres sont gérés par notre système de traitement, leur gestion suivra la logique prédéfinie par Piano Analytics.

→ Pour illustrer, un av_session_id est créé dans des conditions spécifiques lors de certains événements AV :

• av.play 

• av.buffer.start 

• av.buffer.heartbeat 

• av.start 

• av.rebuffer.start 

• av.rebuffer.heartbeat 

• av.heartbeat 

• av.pause 

• av.backward 

• av.forward 

• av.resume 

• av.seek.start 

L'ancien av_session_id est terminé et un nouvel av_session_id est généré lorsque la session précédente se termine par un événement av.stop ou lorsque l'un des paramètres suivants diffère de l'événement AV précédent :

• Day of the event 

• visitor_id 

• site_id 

• av_content_id 

Si vous avez besoin de plus de détails sur le traitement de ces paramètres, veuillez contacter notre centre support à support@piano.io.

Ce qui n’est pas pris en charge :

Nous recommandons d’implémenter manuellement les événements av.heartbeat en serveur-side. Cela garantit la continuité d'une session audio/vidéo et évite la sous-estimation des calculs de temps de lecture.

Recommandations d’implémentation pour les environnements serveur-side

✅ Suivi optimisé pour la simplicité

• AV Light Basique – Implémentation minimale sans gestion de propriétés complexes ni d'événements techniques. Adapté aux médias courts, tels que les clips.

• AV Light Avancé – Implémentation minimale avec des événements av.heartbeat déclenchés à chaque quartile de la vidéo. Recommandé pour les contenus longs, tels que les émissions ou les podcasts.

🔍 Suivi avancé avec contrôle total du client

• AV Serveur-side Complet – Implémentation plus avancée où les clients gèrent les paramètres de manière autonome, offrant ainsi une plus grande flexibilité.