Video Custom Cue Tracker : documentation de l’extension YouTube

Conditions préalables

Chaque propriété Adobe Experience Platform Launch 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

Par https://developers.google.com/youtube/player_parameters, utilisez le fragment de code « Incorporer un lecteur à l’aide d’une balise » dans le code HTML de chaque page web sur laquelle un lecteur vidéo doit être rendu.

Cette extension version 1.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 iframe et en ajoutant ?enablejsapi=1 à la fin de la valeur de l’attribut src. 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>

Dans la mesure où l’extension ajoute dynamiquement le paramètre de champ id et de chaîne de requête enablejsapi=1 à l’iFrame, n’ajoutez pas ces paramètres manuellement à l’iFrame.

Sur les pages comportant plusieurs vidéos, notez que chaque vidéo utilise le même jeu de configuration défini par la règle Platform Launch 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 aura un léger scintillement après le chargement de la page. Ce comportement est attendu.

Éléments de données

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

  • Position du curseur de lecture : lorsqu’il est appelé dans une règle de Launch, cet élément de données enregistre l’emplacement, en secondes, de la position du curseur sur la chronologie de la vidéo.
  • 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.

É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. Veuillez noter que si l’utilisateur effectue une recherche sur un point de repère, l’événement ne se déclenche pas. Les événements du 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

Il existe une règle Platform Launch pour chaque événement vidéo (répertoriés ci-dessus). Par conséquent, vous devez créer une règle spécifique pour chaque événement que vous souhaitez suivre. En d’autres termes, si vous ne souhaitez pas suivre l’événement Vidéo mise en pause, il suffit de ne pas créer de règle associée.

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 Platform Launch pour « Début vidéo »

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

Événements :

« Début vidéo » (cet événement déclenche la règle lorsque le visiteur lance une vidéo YouTube).

Condition : aucune

Actions : utilisez l’extension Analytics pour :

Action « Définir des variables », pour faire correspondre :

  • 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 Launch, analysées dans les rapports de classification à l’aide de l’outil Créateur de règles de classification, comme expliqué dans https://docs.adobe.com/content/help/fr-FR/analytics/components/classifications/classifications-rulebuilder/classification-rule-builder.html, 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'));

return r.join('|');

Sur cette page