Analyses de vidéos

Informations sur la mesure des vidéos sur Android à l’aide de la solution de mesure vidéo.

Le processus général de mesure vidéo se ressemble sur toutes les plateformes. Ce contenu présente un aperçu des tâches des développeurs avec des exemples de codes. Le tableau suivant répertorie les données multimédias envoyées à Analytics. Les règles de traitement permettent de mettre en correspondance les données contextuelles avec des variables Analytics.

Mise en correspondance des événements du lecteur avec les variables Analytics

• a.media.name

  • Type de variable : eVar
    • Délai d’expiration par défaut : Visite
    • Custom Insight (s.prop, utilisée pour le cheminement vidéo)
  • (Obligatoire) Lorsqu’un visiteur regarde la vidéo d’une manière ou d’une autre, cette variable de données contextuelles collecte le nom de la vidéo, comme indiqué dans l’implémentation. Vous pouvez ajouter des classifications pour cette variable.
  • (Facultatif) La variable Custom Insight fournit des informations de cheminement vidéo.

• a.media.name

  • Type de variable : Insight personnalisé (s.prop)

  • (Facultatif) Fournit des informations de cheminement vidéo.

    IMPORTANT

    Le cheminement doit être activé par le service à la clientèle pour cette variable.

  • Type d’événement : Insight personnalisé (s.prop)

• a.media.segment

  • Type de variable : eVar

  • Délai d’expiration par défaut : page vue

  • (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. Par exemple, lorsqu’un visiteur affiche le premier segment dans une vidéo, il est possible que SiteCatalyst collecte les données suivantes dans l’eVar Segments :1:M:0-25

    La méthode de collecte de données vidéo par défaut collecte les données aux points suivants :

    • lorsque la vidéo démarre (lecture) ;
    • lorsque le segment débute ;
    • lorsque la vidéo prend fin (arrêt).

    Analytics comptabilise la première vue du segment au début du segment, lorsque le visiteur commence à regarder. Les vues des segments suivants démarrent au début des segments.

• a.contentType

  • Type de variable : eVar

  • Délai d’expiration par défaut : page vue

  • Collecte les données sur le type de contenu affiché par un visiteur.

    Les envois d’accès par mesures vidéo se voient attribuer un type de contenu video. 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.

• a.media.timePlayed

  • Type de variable : Evénement
  • Type : compteur
  • Compte le temps de lecture vidéo passé, en secondes, depuis le dernier processus de collecte de données (demande d’image).

• a.media.view

  • Type de variable : Evénement

  • Type : compteur

  • Indique qu’un visiteur a visionné une partie d’une vidéo.

    Cependant, cette variable ne fournit aucune information quant au pourcentage, ni à la portion de la vidéo que le visiteur a visionnée.

• a.media.segmentView

  • Type de variable : Evénement

  • Type : compteur

  • Indique qu’un visiteur a visionné une partie d’un segment de vidéo.

    Cependant, cette variable ne fournit aucune information quant au pourcentage, ni à la portion de la vidéo que le visiteur a visionnée.

• a .media.complete

  • Type de variable : Evénement

  • Type : compteur

  • 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 les vidéos terminées, par exemple, après un moment spécifique de visionnage.

Configuration des paramètres multimédias

Configurez un objet MediaSettings avec les paramètres que vous voulez utiliser pour effectuer le suivi de la vidéo :

MediaSettings mySettings = Media.settingsWith("name", 10, "playerName", "playerId");

Suivi des événements du lecteur

Pour mesurer la lecture de vidéos, appelez les méthodes mediaPlay, mediaStop, et mediaClose aux moments opportuns. Par exemple, lorsque le lecteur est en pause, appelez mediaStop. mediaPlay est appelé lorsque la lecture démarre ou reprend.

Classes

Classe : MediaSettings

public String name; 
public String playerName; 
public String playerID; 
public double length; 
public String channel; 
public String milestones; 
public String offsetMilestones; 
public boolean segmentByMilestones; 
public boolean segmentByOffsetMilestones; 
public int trackSeconds = 0; 
public int completeCloseOffsetThreshold = 1; 
 
// MediaAnalytics Ad settings 
public String parentName; 
public String parentPod; 
public String CPM; 
public double parentPodPosition; 
public boolean isMediaAd;

Classe : MediaState

public Date openTime = new Date(); 
public String name; 
public String segment; 
public String playerName; 
public String mediaEvent; 
public int offsetMilestone; 
public int segmentNum; 
public int milestone; 
public double length; 
public double offset; 
public double percent; 
public double timePlayed; 
public double segmentLength; 
public boolean complete = false; 
public boolean clicked = false; 
public boolean ad; 
public boolean eventFirstTime;

Références pour les méthodes et classes de mesure d’éléments multimédias

Voici les méthodes de la classe Media Measurement :

• settingsWith

  Renvoie un objet MediaSettings avec les paramètres spécifiés.

  • Voici la syntaxe de cette méthode :

    public static MediaSettings adSettingsWith(String name, double length, String playerName, String parentName, String parentPod, double parentPodPosition, String CPM);
    

  • Voici l’exemple de code pour cette méthode :

    MediaSettingsmySettings = Media.settingsWith("name", 10, "playerName", "playerId");
    

• adSettingsWith

  Renvoie un objet MediaSettings à utiliser pour le suivi d’une vidéo publicitaire.

  • Voici la syntaxe de cette méthode :

    public static MediaSettings adSettingsWith(String name, double length, String playerName, String parentName, String parentPod, double parentPodPosition, String CPM);
    

• open

  Ouvre un objet MediaSettings pour le suivi.

  • Voici la syntaxe de cette méthode :

    public static void open(MediaSettings settings, MediaCallback callback); 
    

  • Voici l’exemple de code pour cette méthode :

    Media.open(mySettings, new Media.MediaCallback() { 
      @Override 
      public void call(Object item)
      {//  monitor  callback  if  you  want  to  be  notified  every  second  the  media  is  playing  }
      }); 
    

  • close

    Ferme l’élément multimédia nommé name.

    • Voici la syntaxe de cette méthode :

    public static void close(String name);
    

  • Voici l’exemple de code pour cette méthode :

    Media.close("name"); 
    

• play

  • Lit l’élément multimédia nommé name au décalage (offset) donné en secondes.

  • Voici la syntaxe de cette méthode :

    publicstatic void play(String name, double offset); 
    

• terminé

  Marque manuellement l’élément multimédia comme terminé au décalage (offset) donné en secondes.

  • Voici la syntaxe de cette méthode :

    public static void complete(String name, double offset); 
    

  • Voici l’exemple de code pour cette méthode :

    Media.complete("name", 0); 
    

• 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 :

    public static void stop(String name, double offset); 
    

  • Voici l’exemple de code pour cette méthode :

    Media.stop("name", 0);
    

• click

  Avertit le module multimédia qu’un utilisateur a cliqué sur l’élément multimédia.

  • Voici la syntaxe de cette méthode :

    public static void click(String name double offset); 
    

  • Voici l’exemple de code pour cette méthode :

    Media.click("name", 0);
    

• 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 :

    publicstatic void track(String name, Map<String, Object> data); 
    

  • Voici l’exemple de code pour cette méthode :

    Media.track("name", null);