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

Prérequis

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

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

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. Le fragment de code HTML « Code incorporé sur la page (avancé) » se trouve dans la documentation Brightcove. Le lien suivant fournit des informations supplémentaires sur la manière de générer du code incorporé pour les lecteurs vidéo d’aperçu et de vidéos publiées.

Cette extension version 1.1.0 prend en charge l’incorporation de plusieurs vidéos BrightCove sur une seule page web. S’il existe plusieurs propriétés id dans les balises incorporées avancées, assurez-vous qu’elles possèdent chacune des valeurs uniques. Par exemple, player1, player2, etc.

Si la page web qui utilise cette extension interagit avec la vidéo avant que le script approprié ne soit complètement chargé, vous pouvez prendre deux mesures pour résoudre le problème. Vous pouvez tout d’abord charger la bibliothèque de balises de manière synchrone, puis placer l’élément <script type="text/javascript">\_satellite.pageBottom();\</script\> avant l’intégration de la vidéo dans la page.

Voir la documentation de l’API BrightCove pour plus d’informations sur les méthodes de composants et les événements utilisés dans cette extension.

Éléments de données

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

• Position de la tête de lecture : lorsque cet élément de données est appelé dans une règle de balise, il enregistre en secondes la position de la tête de lecture sur le 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.
• 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 vidéo : cet élément de données indique les scripts spécifiques associés à 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.

• Vidéo terminée : cet événement se déclenche lorsqu’une vidéo est entièrement terminée.
• Métadonnées de 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 vidéo : cet événement se déclenche lorsque la vidéo passe en mode Plein écran et le quitte.
• Vidéo lancée : cet événement se déclenche lorsque la vidéo est lancée pour la première fois.

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 effectuer le suivi dʼun événement, ne créez pas de règle pour celui-ci.

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 de balise 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

  1. 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('|');

Ressources Business.Adobe.com