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

Prérequis

Pour chaque propriété Adobe Experience Platform Launch, les extensions suivantes doivent être installées et configurées dans l’écran Extension :

• Adobe Analytics
• Service d’identification des visiteurs Experience Cloud
• Extensions Core installées

En suivant les instructions disponibles sur https://fr.studio.support.brightcove.com/publish/choosing-correct-embed-code.html, utilisez le fragment de code « Code incorporé sur la page (avancé) » dans le code HTML de chaque page web sur laquelle un lecteur vidéo doit apparaître. Voir également le lien suivant : https://fr.studio.support.brightcove.com/players/generating-player-embed-code.html

Bien que cette extension version 1.1.0 prenne en charge l’intégration de plusieurs vidéos BrightCove sur une seule page web, veillez à ce que la propriété id des balises incorporées avancées, si elles existent, ait des valeurs différentes, telles que : player1, player2, etc.

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 est terminée à 50 %, chaque vidéo de la page déclenche la règle au point de repère de 50 %.

Si la page web que vous prévoyez d’utiliser avec cette extension a la possibilité d’interagir avec la vidéo avant que la balise de Platform Launch n’ait pu être complètement chargée, envisagez de charger la bibliothèque de Platform Launch de manière synchrone et de placer la balise <script type="text/javascript">\_satellite.pageBottom();\</script\> avant l’intégration de la vidéo sur la page afin d’éviter tout potentiel problème. À titre de référence, voici le lien vers l’API BrightCove utilisée avec cette extension : https://docs.brightcove.com/brightcove-player/1.x/Player.html#vjsplayer.

Éléments de données

L’extension contient sept é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 Platform Launch, cet élément de données enregistre l’emplacement, en secondes, de la position du curseur sur le montage de la vidéo. (Really not sure about this one. On Adobe, video timeline is Montage vidéo).
• Identifiant du compte de la vidéo : cet élément de données enregistre l’identifiant du compte Brightcove qui a publié la vidéo.
• Durée de la vidéo : cet élément de données enregistre la durée totale, en secondes, du contenu vidéo. De plus, une mesure calculée peut être créée dans Analytics pour convertir cette valeur en minutes ou en heures.
• Prise en charge des publicités vidéo : cet élément de données indique si les publicités sont prises en charge dans la vidéo ou non.
• Identifiant de la vidéo : cet élément de données indique l’identifiant BrightCove associé à la vidéo.
• Nom de la vidéo : cet élément de données indique le nom descriptif ou convivial de la vidéo.
• Balises de la vidéo : cet élément de données indique les balises associées à la vidéo.

Événements

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

• Suivi personnalisé par points de repère : cet événement 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 la valeur indiquée est de 50 %, l’événement se déclenche à 30 secondes de vidéo. Veuillez noter que cet événement se déclenche à chaque fois que ce point de repère est atteint. Par exemple, si l’utilisateur atteint le repère des 50 %, retourne à un point antérieur de la vidéo, puis atteint à nouveau le repère, l’événement se déclenche à nouveau.
• Vidéo terminée : cet événement se déclenche lorsqu’une vidéo est entièrement terminée.
• Métadonnées vidéo chargées : cet événement est déclenché lorsque le lecteur a reçu les informations initiales de durée et de dimension.
• Vidéo mise en pause : cet événement se déclenche lorsque la vidéo est mise en pause.
• Vidéo reprise : cet événement se déclenche lorsque la vidéo reprend après avoir été mise en pause.
• Modification de l’affichage de la vidéo : cet événement se déclenche lorsque la vidéo passe en mode Plein écran et en sort.
• Vidéo lancée : cet événement se déclenche lorsque la vidéo est lancée pour la première fois.

Utilisation

Il y aura une règle Platform Launch pour chaque événement vidéo (les sept événements répertoriés ci-dessus). Créez une règle Platform Launch spécifique pour chaque événement dont vous souhaitez effectuer le suivi. En d’autres termes, si vous ne souhaitez pas suivre l’événement Vidéo mise en pause, ne créez pas de règle associée.

Les règles comportent trois actions :

1. Définir les variables Adobe Analytics. (Créer des éléments de données pour tous ou certains des éléments de données répertoriés ci-dessus.)
2. Envoyer la balise Adobe Analytics.
3. Effacer les variables Adobe Analytics.

Exemple de règle Platform Launch pour « Vidéo lancée »

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

Événements :

1. « Vidéo lancée » : cet événement déclenche la règle lorsque le visiteur lance une vidéo BrightCove.

Condition :

Aucun

Actions :

1. Dans une action Analytics « Définir des variables », définissez :

   • L’événement pour Vidéo lancée (exemple : event17)
   • Une valeur prop/eVar pour l’élément de données Nom de la vidéo (exemple : eVar10)
   • Une valeur prop/eVar pour l’élément de données Durée de la vidéo (exemple : eVar11)
   • Une valeur prop/eVar pour l’élément de données Emplacement actuel de la vidéo (exemple : eVar12)

2. L’action Analytics « Envoyer la balise » (s.tl)

3. L’action Analytics « Effacer les variables »

var r = [];

r.push( \_satellite.getVar( 'Video ID' ) );

r.push( \_satellite.getVar( 'Video Name' ) );

r.push( \_satellite.getVar( 'Video Duraction' ) );


return r.join('|');