Il existe différentes méthodes pour assurer le suivi des événements vidéo, dont deux sont des options héritées de versions précédentes d’Adobe Analytics. Ces options existantes sont : Jalons hérités et Secondes héritées.
Avant de poursuivre, assurez-vous qu’une vidéo lisible est chargée dans AEM.
Pour vous assurer que vos vidéos sont lisibles dans la page, consultez ce didacticiel pour plus d’informations sur le transcodage de fichiers vidéo dans AEM.
Appliquez la procédure ci-dessous pour configurer une structure pour le suivi des vidéos à l’aide de chaque méthode.
Pour les nouvelles mises en œuvre, il est recommandé de ne pas utiliser les options héritées pour le suivi vidéo. Utilisez plutôt la méthode Jalons.
Configurez une page web en faisant glisser un composant vidéo à partir du sidekick et en ajoutant une vidéo comme ressource lisible pour le composant.
Créez une configuration et une structure Adobe Analytics.
Sur la page de structure, sélectionnez un RSID et définissez l’utilisation sur tous. (http://localhost:4502/cf#/etc/cloudservices/sitecatalyst/videoconf/videofw.html)
Dans la catégorie Général du sidekick, faites glisser le composant vidéo dans la structure.
Sélectionnez une méthode de suivi :
Lorsque vous sélectionnez une méthode de suivi, la liste de variables CQ change en conséquence. Pour plus d’informations sur la configuration du composant et la mise en correspondance des variables CQ avec les propriétés Adobe Analytics, reportez-vous aux sections suivantes.
La méthode Jalons suit la plupart des informations sur la vidéo. Elle est hautement personnalisable et facile à configurer.
Pour utiliser la méthode Jalons, spécifiez les décalages de suivi temporels afin de définir les jalons. Lorsqu’une lecture vidéo franchit un jalon, la page appelle Adobe Analytics pour effectuer le suivi du événement. Pour chaque jalon que vous définissez, le composant crée une variable CQ que vous pouvez mapper à une propriété Adobe Analytics. Le format du nom de ces variables CQ est le suivant :
eventdata.events.milestoneXX
Le suffixe XX correspond au décalage de suivi, qui définit le jalon. Par exemple, la spécification de décalages de suivi de 4, 8, 16, 20 et 28 secondes génère les variables CQ suivantes :
eventdata.events.milestone4
eventdata.events.milestone8
eventdata.events.milestone16
eventdata.events.milestone20
eventdata.events.milestone28
Le tableau ci-dessous décrit les variables CQ par défaut fournies pour la méthode Jalons :
Variables CQ | Propriétés Adobe Analytics |
---|---|
eventdata.videoName | Les variables mappées à cet élément contiendront le nom convivial (Titre) de la vidéo si défini dans le DAM ; si cette option n’est pas définie, le nom de fichier de la vidéo sera envoyé à la place. Envoyée une seule fois, au début de la lecture d’une vidéo. |
eventdata.videoFileName | Les variables associées contiennent le nom du fichier. Uniquement envoyé avec eventdata.événements.a.media.vue |
eventdata.videoFilePath | Les variables mises en correspondance contiennent le chemin d’accès du fichier sur le serveur. Uniquement envoyé avec eventdata.événements.a.media.vue |
eventdata.events.a.media.segmentView | Envoyé chaque fois qu’un jalon de segment est dépassé |
eventdata.events.a.media.timePlayed | Envoyé chaque fois qu’un jalon est déclenché, le nombre de secondes passé par l’utilisateur à regarder le segment donné est également envoyé avec ce événement. e.g. eventX=21 |
eventdata.events.a.media.view | Envoyé lors de l’initialisation de la vue vidéo |
eventdata.events.a.media.complete | Envoyé lorsque la lecture de la vidéo est terminée |
eventdata.events.milestoneX | Envoyé lorsque le jalon donné est franchi, X correspond à la seconde où le jalon est déclenché à |
eventdata.a.contentType | Envoyé à chaque jalon ; apparaît sous la forme pev3 dans l’appel Adobe Analytics, généralement envoyé sous la forme "video" |
eventdata.a.media.name | Correspond exactement à eventdata.videoName |
eventdata.a.media.segment | Contient des informations sur le segment qui a été affiché, par exemple 2:O:4-8 |
Vous pouvez définir le nom convivial d d’une vidéo en ouvrant la vidéo pour modification dans la gestion des actifs numériques et en définissant le champ de métadonnées Titre sur le nom de votre choix.
Après avoir sélectionné les jalons comme méthode de suivi, dans la boîte de dialogue des décalages de suivi, saisissez une liste de décalages de suivi, exprimés en secondes, séparés par des virgules. Par exemple, la valeur ci-dessous définit des jalons 4, 8, 16, 20 et 28 secondes après le début de la vidéo :
4,8,16,20,24
Les valeurs de décalage doivent être des entiers supérieurs à 0. La valeur par défaut est 10,25,50,75
.
Pour mapper les variables CQ aux propriétés Adobe Analytics, faites glisser les propriétés Adobe Analytics depuis ContentFinder en regard de la variable CQ sur le composant.
Pour plus d’informations sur l’optimisation des mappages, voir le guide Mesure vidéo dans Adobe Analytics.
Ajoutez le cadre sur la page.
Pour tester la configuration en mode de Prévisualisation, lisez la vidéo pour obtenir les appels Adobe Analytics à déclencher.
Les exemples de données de suivi Adobe Analytics qui suivent s’appliquent au suivi par jalon à l’aide de décalages de suivi de 4,8,16,20 et 24, et les mappages suivants pour les variables CQ :
Variable CQ | Propriété Adobe Analytics |
---|---|
eventdata.videoName | prop2 |
eventdata.videoFileName | prop3 |
eventdata.videoFilePath | prop4 |
eventdata.events.a.media.segmentView | event1 |
eventdata.events.a.media.timePlayed | event2 |
eventdata.events.a.media.view | event3 |
eventdata.events.a.media.complete | événement4 |
eventdata.events.milestone4 | event10 |
eventdata.events.milestone8 | event11 |
eventdata.events.milestone16 | event12 |
eventdata.events.milestone20 | event13 |
eventdata.events.milestone24 | event14 |
eventdata.a.contentType | eVar3 |
eventdata.a.media.name | eVar1, prop1 |
eventdata.a.media.segment | eVar2 |
Dans cet exemple, le composant Vidéo s’affiche comme suit dans la page de la structure :
Pour voir les appels envoyés à Adobe Analytics, utilisez un outil approprié, tel que DigitalPulse Debugger ou Fiddler.
Les appels à Adobe Analytics à l’aide de l’exemple fourni doivent ressembler à celui-ci lors de l’affichage avec le débogueur DigitalPulse :
Il s’agit du premierappel envoyé à Adobe Analytics contenant les valeurs suivantes :
Troisième appelvers Adobe Analytics :
a.media.name;
La méthode Jalons non hérités est similaire à la méthode Jalons, excepté que les jalons sont définis à l’aide de pourcentages de la durée du suivi. Les points communs sont les suivants :
Le format du nom de ces variables CQ est le suivant :
Le suffixe XX correspond au pourcentage de la durée du suivi, qui définit le jalon. Par exemple, la spécification des pourcentages de 10, 25, 50 et 75 secondes génère les variables CQ suivantes :
eventdata.events.milestone10
eventdata.events.milestone25
eventdata.events.milestone50
eventdata.events.milestone75
eventdata.events.milestoneXX
Après avoir sélectionné la méthode de suivi Jalons non hérités, dans la zone Décalage de suivi, saisissez une liste de pourcentages de durée du suivi séparés par des virgules. Par exemple, la valeur par défaut ci-dessous définit des jalons à 10 %, 25 %, 50 % et 75 % de la durée du suivi :
10,25,50,75
Les valeurs de décalage doivent être des entiers supérieurs à 0.
Pour mapper les variables CQ aux propriétés Adobe Analytics, faites glisser les propriétés Adobe Analytics depuis ContentFinder en regard de la variable CQ sur le composant.
Pour plus d’informations sur l’optimisation des mappages, voir le guide Mesure vidéo dans Adobe Analytics.
Ajoutez le cadre sur la page.
Pour tester la configuration en mode de Prévisualisation, lisez la vidéo pour obtenir les appels Adobe Analytics à déclencher.
Cette méthode est similaire à la méthode Jalons, excepté que les jalons spécifiés dans le champ Décalage de suivi sont des pourcentages et non des points définis dans la vidéo.
Le champ Décalage de suivi accepte uniquement des nombres entiers compris entre 1 et 100, séparés par des virgules.
Définissez le décalage de suivi.
En outre, les informations envoyées à Adobe Analytics sont moins personnalisables ; seules 3 variables sont disponibles pour le mappage :
eventdata.videoName |
Les variables mappées à cet élément contiendront le nom convivial (Titre) de la vidéo si défini dans le DAM ; si le titre n’est pas défini, le nom de fichier de la vidéo est envoyé à la place. Envoyée une seule fois, au début de la lecture d’une vidéo. |
eventdata.videoFileName | Les variables associées contiennent le nom du fichier. Envoyée une seule fois, au début de la lecture d’une vidéo. |
eventdata.videoFilePath | La variable associée contient le chemin d’accès du fichier sur le serveur. Envoyée une seule fois, au début de la lecture d’une vidéo. |
Vous pouvez définir un nom convivial de la vidéo en ouvrant la vidéo pour modification dans le module DAM, et en définissant le champ Title metadata comme nom de votre choix. Vous devez également enregistrer les modifications apportées une fois l’opération terminée.
Mappez ces variables aux variables props 1 à 3.
Le reste des informations pertinentes dans l’appel sera envoyé sous forme concaténée dans une variable nommée pev3.
Les exemples d’ appels vers Adobe Analytics utilisant l’exemple fourni doivent ressembler à celui-ci lors de l’affichage avec le débogueur DigitalPulse :
La variable pev3envoyée dans l’appel contient les informations suivantes :
Lors de l’utilisation de la méthode legacy seconds, les appels Adobe Analytics sont déclenchés toutes les N-e secondes, où N est spécifié dans le champ de décalage de suivi.
Définissez le décalage de la piste sur n’importe quel nombre de secondes,
Le champ Décalage de suivi accepte uniquement des entiers supérieurs à 0.
Les informations envoyées à Adobe Analytics sont moins personnalisables. Seules 3 variables sont disponibles pour le mappage :
eventdata.videoName |
Les variables mappées à cet élément contiendront le nom convivial (Titre) de la vidéo si défini dans le DAM ; si le titre n’est pas défini, le nom de fichier de la vidéo est envoyé à la place. Envoyée une seule fois, au début de la lecture d’une vidéo. |
eventdata.videoFileName | La variable associée contient le nom du fichier. Envoyée une seule fois, au début de la lecture d’une vidéo. |
eventdata.videoFilePath | La variable associée contient le chemin d’accès du fichier sur le serveur. Envoyée une seule fois, au début de la lecture d’une vidéo. |
Vous pouvez définir le nom convivial d d’une vidéo en ouvrant la vidéo pour modification dans la gestion des actifs numériques et en définissant le champ de métadonnées Titre sur le nom de votre choix. Vous devez également enregistrer les modifications apportées une fois l’opération terminée.
Mappez ces variables à prop1, prop2 et prop3.
Le reste des informations pertinentes dans l’appel sera envoyé sous forme concaténée dans une variable nommée pev3.
Les appels à Adobe Analytics à l’aide de l’exemple fourni doivent ressembler à celui-ci lors de l’affichage avec le débogueur DigitalPulse :
L’appel est similaire à l’appel Jalons hérités ci-dessus. Consultez les informations sur pev3 fournies ici.
Références utilisées dans ce didacticiel :