Migration de Milestone vers Media Analytics

Aperçu

Les concepts de base de la mesure vidéo sont les mêmes pour Milestone et Media Analytics, qui prend les événements du lecteur vidéo et les mappe aux méthodes d’analyse, tout en récupérant les métadonnées et les valeurs du lecteur et en les associant aux variables d’analyse. La solution Media Analytics est basée sur Milestone, donc de nombreuses méthodes et mesures sont identiques. Toutefois, l’approche et le code de configuration ont beaucoup changé. Il devrait être possible de mettre à jour le code des événements du lecteur afin qu’il pointe vers les nouvelles méthodes Media Analytics. Voir Présentation du SDK et Présentation du suivi pour en savoir plus sur l’implémentation de Media Analytics.

Les tableaux suivants fournissent des correspondances entre la solution Milestone et la solution Media Analytics.

Guide de migration

Référence de variables

Mesure Milestone Type de variable Mesure Media Analytics
Contenu eVar
Délai d’expiration par défaut : Visite		 Contenu
Type de contenu eVar
Délai d’expiration par défaut : page vue		 Type de contenu
Temps passé sur le contenu Type
 d’événement : Compteur		 Temps passé sur le contenu
Démarrages de vidéo Type
 d’événement : Compteur		 Démarrages de vidéo
La vidéo se termine Type
 d’événement : Compteur		 Fin de contenu

Variables du module média

Milestone Syntaxe de Milestone Media Analytics Syntaxe Media Analytics
Media.trackUsingContextData s.Media.trackUsingContextData
= true;		 S.O. Toutes les données Media Analytics sont envoyées uniquement à l’aide de données contextuelles.
Media.contextDataMapping s.Media.contextDataMapping = {
"a.media.name":"eVar2,prop2",
"a.media.segment":"eVar3",
"a.contentType":"eVar1",
"a.media.timePlayed":"event3",
"a.media.view":"event1",
"a.media.segmentView":"event2",
"a.media.complete":"event7",
"a.media.milestones": {
25:"event4",
50:"event5",
75:"event6"
}
};		 S.O. Les données contextuelles Media Analytics sont automatiquement renseignées dans des variables réservées. Le mappage à des eVar, des props et des événements n’est plus nécessaire dans le code de mise en œuvre. Les clients peuvent associer des données contextuelles à des variables à l’aide de règles de traitement.
Media.trackVars s.Media.trackVars =
"events,
prop2,
eVar1,
eVar2,
eVar3";		 S.O. Plus nécessaire, car le mappage se fait via des variables réservées et des règles de traitement.
Media.trackEvents s.Media.trackEvents =
"event1,
event2,
event3,
event4,
event5,
event6,
event7"		 S.O. Plus nécessaire, car le mappage se fait via des variables réservées et des règles de traitement.

Variables facultatives

Milestone Syntaxe de Milestone Media Analytics Syntaxe Media Analytics
Media.autoTrack s.Media.autoTrack
= true;		 S.O. Nous ne fournissons plus de mappages de lecteur préconfigurés.
Media.autoTrackNetStreams s.Media.
autoTrackNetStreams
= true		 S.O. Nous ne fournissons plus de mappages de lecteur préconfigurés.
Media.completeByCloseOffset s.Media.
completeByCloseOffset
= true		 S.O. La fin du contenu ne prend en charge qu’un marqueur de progression de 100 %.
Media.completeCloseOffsetThreshold s.Media.
completeCloseOffsetThreshold
= 1		 S.O. La fin du contenu ne prend en charge qu’un marqueur de progression de 100 %.
Media.playerName s.Media.playerName
= "Custom Player Name"		 Clé SDK : playerName ;
Clé API : media.playerName		 MediaHeartbeatConfig.
playerName
Media.trackSeconds s.Media.
trackSeconds
= 15		 S.O. Media Analytics est défini sur 10 secondes pour le contenu et 1 seconde pour les publicités. Aucune autre option n’est disponible.
Media.trackMilestones s.Media.
trackMilestones
= "25,50,75";		 S.O. Media Analytics effectue toujours le suivi des marqueurs de progression à 10 %, 25 %, 50 %, 75 % et 95 %.
Media.trackOffsetMilestones s.Media.
trackOffsetMilestones
= "20,40,60";		 S.O. Media Analytics effectue toujours le suivi des marqueurs de progression à 10 %, 25 %, 50 %, 75 % et 95 %.
Media.segmentByMilestones s.Media.segmentByMilestones
= true;		 S.O. Le suivi automatique n’est plus disponible.
Media.segmentByOffsetMilestones s.Media.
segmentByOffsetMilestones
= true;		 S.O. Le suivi automatique n’est plus disponible.

Variables de suivi des publicités

Milestone Syntaxe de Milestone Media Analytics Syntaxe Media Analytics
Media.adTrackSeconds s.Media.
adTrackSeconds
= 15		 S.O. Media Analytics est défini sur 10 secondes pour le contenu et 1 seconde pour les publicités. Aucune autre option n’est disponible.
Media.adTrackMilestones s.Media.
adTrackMilestones
= "25,50,75";		 S.O. Les marqueurs de progression ne sont pas fournis par défaut pour les publicités. Utilisez des mesures calculées pour créer des marqueurs de progression des publicités.
Media.adTrackOffsetMilestones s.Media.
adTrackOffsetMilestones
= "20,40,60";		 S.O. Media Analytics est défini sur 1 seconde pour les publicités. Aucune autre option n’est disponible.
Media.adSegmentByMilestones s.Media.
adSegmentByMilestones
= true;		 S.O. Le suivi automatique n’est plus disponible.
Media.adSegmentByOffsetMilestones s.Media.
adSegmentByOffsetMilestones
= true;		 S.O. Le suivi automatique n’est plus disponible.

Méthodes du module média

Milestone Syntaxe de Milestone Media Analytics Syntaxe Media Analytics
Media.open s.Media.open(
mediaName,
mediaLength,
mediaPlayerName)		 trackSessionStart trackSessionStart(
mediaObject,
contextData)
mediaName mediaName : (obligatoire) nom de la vidéo tel que vous souhaitez le voir apparaître dans les rapports vidéo. nom createMediaObject(
name,
mediaId,
length,
streamType)
mediaLength mediaLength : (obligatoire) durée de la vidéo, en secondes. length createMediaObject(
name,
mediaId,
length,
streamType)
mediaPlayerName mediaPlayerName : (obligatoire) nom du lecteur vidéo utilisé pour visionner la vidéo, tel que vous souhaitez le voir apparaître dans les rapports vidéo. playerName MediaHeartbeatConfig.
playerName
Media.openAd s.Media.openAd(
name,
length,
playerName,
parentName,
parentPod,
parentPodPosition,
CPM)		 trackEvent mediaHeartbeat.trackEvent(
MediaHeartbeat.
Event.
AdBreakStart,
adBreakObject);
...
trackEvent(
MediaHeartbeat.
Event.
AdStart,
adObject,
adCustomMetadata);
nom name : (obligatoire) nom ou identifiant de la vidéo. nom createAdObject(
name,
adId,
position,
length)
length length : (obligatoire) durée de la publicité. length createAdObject(
name,
adId,
position,
length)
playerName playerName : (obligatoire) nom du lecteur vidéo utilisé pour visionner la publicité. playerName MediaHeartbeatConfig.
playerName
parentName parentName : nom ou identifiant du contenu principal dans lequel la publicité est incorporée. S.O. Hérité automatiquement.
parentPod parentPod : position de lecture de la publicité dans le contenu principal. position createAdBreakObject(
name,
position,
startTime)
parentPodPosition parentPodPosition : position de lecture de la publicité dans la capsule. position createAdObject(
name,
adId,
position,
length)
CPM CPM : CPM ou CPM chiffré (précédé du préfixe « ~ ») applicable à la lecture. S.O. Non disponible par défaut dans Media Analytics.
Media.click s.Media.click(name, offset) S.O. Utilisez un appel d’analyse de lien personnalisé pour effectuer le suivi des clics.
Media.close s.Media.close(mediaName) trackSessionEnd trackSessionEnd()
Media.complete s.Media.complete(name, offset) trackComplete trackComplete()
Media.play s.Media.play(
name,
offset,
segmentNum,
segment,
segmentLength)		 trackPlay trackPlay()
Media.stop s.Media.stop(mediaName, mediaOffset) trackPause
ou
trackEvent		 trackPause()
ou trackEvent(
MediaHeartbeat.
Event.
SeekStart)
ou
trackEvent(
MediaHeartbeat.
Event.
BufferStart);
Media.monitor s.Media.monitor(s, media) Utilisez des métadonnées personnalisées ou standard pour définir des variables supplémentaires. var customVideoMetadata =
{
isUserLoggedIn:
"false",
tvStation:
"Sample TV station",
programmer:
"Sample programmer"
};
...
var standardVideoMetadata
= {};
standardVideoMetadata
[MediaHeartbeat.
VideoMetadataKeys.
EPISODE] =
"Sample Episode";
standardVideoMetadata
[MediaHeartbeat.
VideoMetadataKeys.
SHOW] = "Sample Show";
...
mediaObject.setValue(
MediaHeartbeat.
MediaObjectKey.
StandardVideoMetadata,
standardVideoMetadata);
Media.track s.Media.track(mediaName) S.O. La fréquence des appels de suivi est définie automatiquement.

Sur cette page