Présentation de l’extension de suivi vidéo YouTube

REMARQUE

Adobe Experience Platform Launch devient une suite de technologies destinées à la collecte de données dans Experience Platform. Plusieurs modifications terminologiques ont par conséquent été apportées à la documentation du produit. Reportez-vous au document suivant pour consulter une référence consolidée des modifications terminologiques.

Conditions préalables

Chaque propriété de balise dans Adobe Experience Platform requiert que les extensions suivantes soient installées et configurées à partir de l’écran Extensions :

  • Adobe Analytics
  • Service d’identification des visiteurs Experience Cloud
  • Extension Core

Utilisez l’extrait de code "Incorporer un lecteur à l’aide d’une balise <iframe>" de la documentation destinée aux développeurs Google dans le code HTML de chaque page Web sur laquelle un lecteur vidéo doit être rendu.

Cette extension, version 2.0.1, prend en charge l’incorporation d’une ou de plusieurs vidéos YouTube sur une seule page web en insérant un attribut id avec une valeur unique dans la balise de script iframe, et en ajoutant enablejsapi=1 et rel=0 à la fin de la valeur de l’attribut src, le cas échéant. Par exemple :

<iframe id="player1" width="560" height="315" src="https://www.youtube.com/embed/xpatB77BzYE?enablejsapi=1" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>

Cette extension est également conçue pour rechercher de manière dynamique une valeur d’attribut d’identifiant unique, telle que player1, que les paramètres de chaîne de requête enablejsapi et rel existent ou que leurs valeurs attendues soient correctes. Par conséquent, la balise de script YouTube peut être ajoutée à une page web avec ou sans l’attribut id et indépendamment de l’inclusion ou non des paramètres de la chaîne de requête enablejsapi et rel.

REMARQUE

Sur les pages comportant plusieurs vidéos, chaque vidéo utilise le même jeu de configuration défini dans la règle de balise qui s’exécute sur cette page. Par exemple, si vous créez une règle avec un événement qui se déclenche lorsque la vidéo atteint 50 %, chaque vidéo de la page déclenche la règle au point de repère de 50 %.

L’extension repose sur la logique suivante pour réécrire les iFrames :

document.onreadystatechange = function () {
 if (document.readyState === 'complete') {

Par conséquent, il y a un léger scintillement après le chargement de la page. Ce comportement est attendu.

Éléments de données

L’extension contient six éléments de données. Aucun ne nécessite d’être configuré.

  • Position du curseur de lecture : enregistre l’emplacement, en secondes, de la position du curseur de lecture sur la chronologie de la vidéo, lorsqu’elle est appelée dans une règle de balise.
  • ID de la vidéo : indique l’ID YouTube associé à la vidéo.
  • Nom de la vidéo : indique le nom descriptif ou convivial de la vidéo.
  • URL de la vidéo : renvoie l’URL YouTube.com pour la vidéo actuellement chargée/en cours de lecture.
  • Durée de la vidéo : enregistre la durée totale, en secondes, de la vidéo.
  • Version de l’extension : cet élément de données enregistre la version de l’extension de suivi YouTube, comme « Video Tracking_YouTube_2.0.0 », par exemple.

Événements

L’extension comprend huit événements et seul le suivi des points de repère personnalisés requiert une configuration.

  • Vidéo prête : se déclenche lorsque la vidéo est guidée et prête à être lue.
  • Début vidéo : déclenche le premier démarrage de la vidéo et lorsque player.getCurrentTime() === 0
  • Relecture vidéo : se déclenche lorsque la vidéo est guidée et relue après le démarrage initial. Ce déclencheur se déclenche à chaque lecture.
  • Vidéo mise en pause : se déclenche lorsque la vidéo est mise en pause.
  • Reprise de la vidéo : se déclenche lorsque la vidéo reprend et lorsque player.getCurrentTime() !== 0
  • Suivi des points de repère personnalisés : se déclenche lorsque la vidéo atteint le pourcentage de vidéo indiqué. Par exemple, si une vidéo dure 60 secondes et que le repère spécifié est de 50 %, l’événement se déclenche lorsque la position du curseur de lecture est égale à 30 secondes. Le suivi des points de repère s’applique à la lecture initiale et à la relecture. Notez que si l’utilisateur effectue une recherche sur un point de repère, l’événement ne se déclenche pas. Les événements de point de repère ne se déclenchent que lorsque le curseur de lecture traverse l’emplacement du point de repère calculé sur la chronologie et que le lecteur vidéo est en cours de lecture.
  • Mémoire tampon de la vidéo : se déclenche lorsque le lecteur télécharge une certaine quantité de données avant de commencer la lecture de la vidéo.
  • Fin de la vidéo : se déclenche lorsqu’une vidéo est entièrement terminée.

Utilisation

Une règle de balise peut être définie pour chaque événement vidéo (les sept événements répertoriés ci-dessus). Créez une règle de balise spécifique pour chaque événement dont vous souhaitez effectuer le suivi. Si vous ne souhaitez pas suivre un événement, il vous suffit de l’omettre pour créer une règle pour celui-ci.

Les règles comportent trois actions :

  • Définir des variables : définissez les variables Adobe Analytics (les faire correspondre à tous les éléments de données inclus ou à certains d’entre eux).
  • Envoyer la balise : envoyez la balise Adobe Analytics en tant qu’appel de suivi des liens personnalisé et indiquez une valeur « Nom du lien ».
  • Effacer les variables : effacez les variables Adobe Analytics.

Exemple de règle de balise pour "Vidéo lancée"

Les objets d’extension vidéo suivants doivent être inclus.

  • Événements : "Vidéo lancée" (cet événement déclenche la règle lorsque le visiteur lance une vidéo YouTube.)

  • Condition : aucune

  • Actions : Utilisez l’action Extension Analytics pour "Définir des variables", pour mapper :

    • L’événement pour Début vidéo,
    • Une valeur prop/eVar pour l’élément de données Durée de la vidéo
    • Une valeur prop/eVar pour l’élément de données ID de la vidéo
    • Une valeur prop/eVar pour l’élément de données Nom de la vidéo
    • Une valeur prop/eVar pour l’élément de données URL de la vidéo

    Insérez ensuite l’action "Envoyer la balise" (s.tl) avec le nom de lien "Début vidéo", suivie d’une action "Effacer les variables".

CONSEIL

Pour les implémentations dans lesquelles plusieurs eVars ou props pour chaque élément vidéo ne peuvent pas être utilisés, les valeurs des éléments de données peuvent être concaténées dans Platform, analysées dans les rapports de classification à l’aide de l’outil Créateur de règles de classification, comme expliqué dans la section https://experienceleague.adobe.com/docs/analytics/components/classifications/classifications-rulebuilder/classification-rule-builder.html?lang=fr, puis appliquées en tant que segment dans Analysis Workspace.

Pour concaténer des valeurs d’informations sur la vidéo, créez un nouvel élément de données appelé « Métadonnées vidéo », puis programmez-le à extraire tous les éléments de données vidéo (répertoriés ci-dessus) et à les assembler. Par exemple :

var r = ””;

r.push('YouTube'); //Player Name
r.push(_satellite.getVar('Video ID'));
r.push(_satellite.getVar('Video Name'));
r.push(_satellite.getVar('Video Duration'));
r.push(_satellite.getVar('Extension Version'));

return r.join('|');

Sur cette page