Show Menu
SUJETS×

Suivi vidéo par repères personnalisés : Documentation sur l’extension BrightCove

Prérequis

Pour chaque propriété 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 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 Launch n’ait pu être complètement chargée, envisagez de charger la bibliothèque de 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 Launch, cet élément de données enregistre l’emplacement, en secondes, de la position du curseur de lecture sur la 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 Launch pour chaque événement vidéo (les sept événements répertoriés ci-dessus). Créez une règle 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 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 »
Si vous ne souhaitez pas configurer plusieurs eVars ou props pour chaque élément vidéo, les valeurs des éléments de données peuvent être concaténées dans Launch, puis analysées sous forme de rapports de classification à l’aide de l’outil Créateur de règles de classification, https://docs.adobe.com/content/help/fr-FR/analytics/components/classifications/classifications-rulebuilder/classification-rule-builder.html , et enfin appliquées en tant que segment dans Analysis Workspace.
Pour ce faire, créez un nouvel élément de données appelé par exemple « Métadonnées vidéo » et programmez-le pour extraire tous les éléments de données vidéo (répertoriés ci-dessus) et les concaténer.
var r = [];

r.push( \_satellite.getVar( &#39;Video ID&#39; ) );

r.push( \_satellite.getVar( &#39;Video Name&#39; ) );

r.push( \_satellite.getVar( &#39;Video Duraction&#39; ) );


return r.join(&#39;|&#39;);