Show Menu
SUJETS×

Chemin

Informations relatives aux analyses de vidéos.
Video measurement is described in detail in the Measuring video and audio in Adobe Analytics guide. Le processus général de mesure vidéo se ressemble dans toutes les plates-formes AppMeasurement. Cette section de démarrage rapide donne une vue d’ensemble des tâches du développeur et fournit des exemples de code.
Le tableau suivant répertorie les données multimédias envoyées à Analytics. Use processing rules to map the context data to an Analytics variable.
  • a.media.name
    ( Required ) Collects the name of the video, as specified in the implementation, when a visitor views the video in some way.You can add classifications for this variable.
    ( Facultatif ) La variable Insight personnalisé fournit des informations sur le cheminement vidéo.
    • Variable type: eVar
    • Délai d’expiration par défaut : Visite
    • Insight personnalisé (s.prop, utilisé pour le cheminement vidéo)
  • a.media.name
    ( Facultatif) Fournit des informations de cheminement vidéo. Le cheminement doit être activé par le service à la clientèle pour cette variable.
    • Type d’événement : Insight personnalisé (s.prop).
    • Type de variable : Custom Insight (s.prop)
  • a.media.segment
    ( Obligatoire ) Collecte des données de segments de vidéos, notamment le nom du segment et l’ordre d’apparition du segment dans la vidéo.
    Cette variable est renseignée en activant la variable segmentByMilestones lors du suivi automatique des événements du lecteur ou en configurant un nom de segment personnalisé lors du suivi manuel des événements du lecteur. For example, when a visitor views the first segment in a video, SiteCatalyst might collect the following in the 1:M:0-25 segments eVar.
    La méthode par défaut de collecte de données est réalisée aux points suivants : le démarrage de la vidéo (play), le début du segment et la fin de la vidéo (stop). Analytics compte l’affichage du premier segment au début du segment, lorsque le visiteur commence la lecture. Les affichages de segments suivants commencent au démarrage du segment.
    • Variable type: eVar
    • Délai d’expiration par défaut : page vue
  • a.contentType
    Collecte les données sur le type de contenu affiché par un visiteur. Les envois d’accès par mesure vidéo se voient attribuer un type de contenu « vidéo ». Cette variable ne doit pas être exclusivement réservée au suivi vidéo. Les autres types de contenu des rapports de contenu utilisant la même variable permettent d’analyser la distribution des visiteurs par rapport aux différents types de contenu. Par exemple, vous pouvez baliser les types de contenu en utilisant des valeurs telles que « article » ou « page de produits » à l’aide de cette variable.
    Du point de vue des mesures vidéo, le type de contenu permet d’identifier les visiteurs de vidéos et donc de calculer les taux de conversion vidéo.
    • Variable type: eVar
    • Délai d’expiration par défaut : page vue
  • a.media.timePlayed
    Compte le temps de lecture vidéo passé, en secondes, depuis le dernier processus de collecte de données (requêtes d’images).
    • Variable type: Event
    • Type : compteur
  • a.media.view
    Indique qu’un visiteur a visionné une partie d’une vidéo. Cependant, cette mesure ne fournit aucune information quant au pourcentage de la vidéo que le visiteur a regardé (ni la partie visionnée).
    • Variable type: Event
    • Type : compteur
  • a.media.segmentView
    Indique qu’un visiteur a visionné une partie d’un segment de vidéo. Cependant, cette mesure ne fournit aucune information quant au pourcentage de la vidéo que le visiteur a regardée (ni la partie visionnée).
    • Type de variable : Evénement
    • Type : compteur
  • a .media.complete
    Indique qu’un utilisateur a visionné une vidéo dans son intégralité. Par défaut, la fin de l’événement est mesurée 1 seconde avant la fin de la vidéo. Pendant la mise en œuvre, vous pouvez spécifier combien de secondes à partir de la fin de la vidéo vous souhaitez considérer comme une lecture intégrale. Pour les vidéos en direct et les autres flux qui n’ont pas de fin définie, vous pouvez spécifier un point personnalisé pour mesurer la fin. Par exemple, après un temps de lecture spécifique.
    • Variable type: Event
    • Type : compteur

Configure media settings

Configurez un objet MediaSettings avec les paramètres que vous voulez utiliser pour effectuer le suivi de la vidéo :
var mySettings = ADB.Media.settingsWith("name", 10, "playerName", "playerId");

Track player events

To measure video playback, The Play , Stop , and Close methods need to be called at the appropriate times. Par exemple, lorsque le lecteur est en pause : Stop . Play est appelé lorsque la lecture démarre ou reprend.

Classes

Classe : MediaSettings

property Platform::String ^name; 
property Platform::String ^playerName; 
property Platform::String ^playerID; 
property double length; 
property Platform::String ^channel; 
property Platform::String ^milestones; 
property Platform::String ^offsetMilestones; 
property bool segmentByMilestones; 
property bool segmentByOffsetMilestones; 
property int trackSeconds; 
property int completeCloseOffsetThreshold; 
 
// MediaAnalytics Ad settings 
property Platform::String ^parentName; 
property Platform::String ^parentPod; 
property Platform::String ^CPM; 
property double parentPodPosition; 
property bool isMediaAd;

Media measurement class and method reference

  • SettingsWith (winJS : settingsWith)
    Renvoie un objet  MediaSettings avec les paramètres spécifiés.
    • Voici la syntaxe de cette méthode :
      static MediaSettings ^SettingsWith(Platform::String ^name,  double length, Platform::String ^playerName, Platform::String  ^playerID); 
      
      
    • Voici l’exemple de code pour cette méthode :
      var  mySettings  =  ADB.Media.settingsWith("name", 10,  "playerName", "playerId"); 
      
      
  • AdSettingsWith (winJS : adSettingsWith)
    Renvoie un objet  MediaSettings à utiliser pour le suivi d’une vidéo publicitaire.
    • Voici la syntaxe de cette méthode :
      static MediaSettings ^AdSettingsWith(Platform::String ^name,  double length, Platform::String ^playerName, Platform::String  ^parentName, Platform::String ^parentPod, double parentPosition,  Platform::String ^CPM);
      
      
    • Voici l’exemple de code pour cette méthode :
      var  myAdSettings = ADB.Media.adSettingsWith("name", 10,  "playerName", "parentName", "parentPod", 5, "myCPM");
      
      
  • Open (winJS : open)
    Effectue le suivi d’un média open en utilisant les paramètres définis dans settings .
    • Voici la syntaxe de cette méthode :
      static void Open(MediaSettings ^settings);
      
      
    • Voici l’exemple de code pour cette méthode :
      ADB.Media.open(mySettings);
      
      
  • Close (winJS : close)
    Effectue le suivi de fermeture d’un média pour l’élément média nommé name .
    • Voici la syntaxe de cette méthode :
      static  void  Close(Platform::String  ^name);
      
      
    • Voici l’exemple de code pour cette méthode :
      ADB.Media.close("mediaName"); 
      
      
  • Play (winJS : play)
    Effectue le suivi de lecture d’un média pour l’élément média nommé name à un décalage offset donné (en secondes).
    • Voici la syntaxe de cette méthode :
      static  void  Play(Platform::String ^name, double offset);
      
      
    • Voici l’exemple de code pour cette méthode :
      ADB.Media.play("mediaName",  0);
      
      
  • Complete (winJS: complete)
    Marque manuellement l’élément multimédia comme terminé au décalage offset donné (en secondes).
    • Voici la syntaxe de cette méthode :
      static  void  Complete(Platform::String ^name, double offset);
      
      
    • Voici l’exemple de code pour cette méthode :
      ADB.Media.complete("mediaName", 8);
      
      
  • Stop (winJS: stop)
    Avertit le module multimédia que la vidéo a été interrompue ou suspendue au décalage offset donné.
    • Voici la syntaxe de cette méthode :
      static void Stop(Platform::String ^name, double offset);
      
      
    • Voici l’exemple de code pour cette méthode :
      ADB.Media.stop("mediaName",  4);
      
      
  • Click (winJS: click)
    Avertit le module multimédia qu’un utilisateur a cliqué sur l’élément multimédia.
    • Voici la syntaxe de cette méthode :
      static void Click(Platform::String ^name, double  offset);
      
      
    • Voici l’exemple de code pour cette méthode :
      ADB.Media.click("mediaName",  3); 
      
      
  • Track (winJS : track)
    Envoie un appel d’action de suivi (aucune page vue) pour l’état multimédia en cours.
    • Voici la syntaxe de cette méthode :
      static void Track(Platform::String ^name, Windows::Foundation::Collections::IMap<Platform::String^,  Platform::Object> ^contextData); 
      
      
    • Voici l’exemple de code pour cette méthode :
      ADB.Media.track("mediaName",  null);