Show Menu
SUJETS×

Chemin

Informations relatives aux analyses de vidéos.
Video measurement is described in detail in the Measuring audio and video 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
    (Requis) Collecte le nom de la vidéo, comme spécifié lors de la mise en œuvre, lorsqu’un visiteur visionne la vidéo de quelque manière que ce soit. Vous pouvez ajouter des classifications pour cette 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 sur le chemin de la vidéo. Le cheminement doit être activé par le service à la clientèle pour cette variable.
    Type d’événement : Insight personnalisé (s.prop)
    • Variable type: 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 segment eVar.
    La méthode par défaut de collecte des données sur les vidéos collecte les données aux points suivants :
    • début de la vidéo (lecture)
    • début du segment
    • fin de la vidéo (arrêt) 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.
    • Type de variable : 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 vous permet d’identifier les visiteurs de vidéos et de calculer les taux de conversion vidéo.
    • Type de variable : 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).
    • Type de variable : Evénement
    • 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 : Evénement
    • 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).
    • Variable type: Event
    • 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.
    • Type de variable : Evénement
    • 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  MediaSetting 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);