Informations sur la mesure des vidéos sur Android à l’aide de la solution de mesure vidéo.
Au cours de la lecture vidéo, de fréquents appels de « pulsation » sont envoyés à ce service afin de mesurer la durée de lecture. Ces appels de pulsation sont envoyés toutes les dix secondes, ce qui se traduit par des mesures d’engagement vidéo granulaires et par des rapports d’abandons vidéo plus précis. Pour plus d’informations sur la solution de mesure vidéo d’Adobe, voir Mesures audio et vidéo dans Adobe Analytics.
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.
a.media.name
a.media.name
Type de variable : Insight personnalisé (s.prop)
(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)
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 :
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
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.
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");
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.
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;
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.
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);