DocumentationAnalyticsGuide de Media Analytics

Migration de Milestone vers Media Analytics migrating-from-milestone-to-media-analytics

Last update: Tue Jan 03 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Créé pour :

  • User
  • Admin
  • Developer

Aperçu overview

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 migration-guide

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.
recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb