Migración de Milestone a Media Analytics

Información general

Los conceptos principales de la medición de vídeo son los mismos para Milestone y Media Analytics, que lleva eventos de reproductor de vídeo y los asigna a métodos de análisis, al tiempo que toma metadatos y valores del reproductor y los asigna a variables de análisis. La solución de Media Analytics se desarrolló a partir de Milestone, por lo que muchos de los métodos y métricas son los mismos; sin embargo, el enfoque de configuración y el código han cambiado significativamente. Debería ser posible actualizar el código de evento del reproductor para que indique los nuevos métodos de Media Analytics. Consulte Información general de SDK e Información general del seguimiento para obtener más información sobre la implementación de Media Analytics.

En las tablas siguientes se proporcionan las correspondencias entre la solución Milestone y la solución Media Analytics.

Guía de migración

Referencia de variable

Métrica de Milestone	Tipo de variable	Métrica de Media Analytics
Contenido	Caducidad predeterminada de la eVar: Visita	Contenido
Tipo de contenido	Caducidad predeterminada de la eVar: Vista de página	Tipo de contenido
Tiempo invertido en contenido	Tipo de evento: Contador	Tiempo invertido en contenido
Inicios de vídeo	Tipo de evento: Contador	Inicios de vídeo
Vídeos completados	Tipo de evento: Contador	Contenido finalizado

Variables de módulo multimedia

Milestone	Sintaxis de Milestone	Media Analytics	Sintaxis de Media Analytics
Media.trackUsingContextData	`s.Media.trackUsingContextData` `= true;`	N/D	Todos los datos de Media Analytics solo se envían mediante datos de contexto.
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"` `}` `};`	N/D	Los datos de contexto de Media Analytics se rellenan automáticamente en las variables reservadas. Ya no es necesario asignar eVars, props y eventos en el código de implementación. Los clientes pueden asignar datos de contexto a variables mediante el uso de reglas de procesamiento.
Media.trackVars	`s.Media.trackVars =` `"events,` `prop2,` `eVar1,` `eVar2,` `eVar3";`	N/D	Ya no es necesario puesto que se realiza mediante variables reservadas y reglas de procesamiento.
Media.trackEvents	`s.Media.trackEvents =` `"event1,` `event2,` `event3,` `event4,` `event5,` `event6,` `event7"`	N/D	Ya no es necesario puesto que se realiza mediante variables reservadas y reglas de procesamiento.

Variables opcionales

Milestone	Sintaxis de Milestone	Media Analytics	Sintaxis de Media Analytics
Media.autoTrack	`s.Media.autoTrack` `= true;`	N/D	Ya no proporcionamos asignaciones de reproductor precompiladas.
Media.autoTrackNetStreams	`s.Media.` `autoTrackNetStreams` `= true`	N/D	Ya no proporcionamos asignaciones de reproductor precompiladas.
Media.completeByCloseOffset	`s.Media.` `completeByCloseOffset` `= true`	N/D	La finalización del contenido solo admite un marcador de progreso del 100%.
Media.completeCloseOffsetThreshold	`s.Media.` `completeCloseOffsetThreshold` `= 1`	N/D	La finalización del contenido solo admite un marcador de progreso del 100%.
Media.playerName	`s.Media.playerName` `= "Custom Player Name"`	Clave de SDK: playerName; Clave de API: media.playerName	`MediaHeartbeatConfig.` `playerName`
Media.trackSeconds	`s.Media.` `trackSeconds` `= 15`	N/D	Media Analytics tiene establecido 10 segundos para el contenido y 1 segundo para los anuncios. No hay más opciones disponibles.
Media.trackMilestones	`s.Media.` `trackMilestones` `= "25,50,75";`	N/D	Media Analytics siempre realiza un seguimiento de los marcadores de progreso en el 10 %, 25 %, 50 %, 75 % y 95 %.
Media.trackOffsetMilestones	`s.Media.` `trackOffsetMilestones` `= "20,40,60";`	N/D	Media Analytics siempre realiza un seguimiento de los marcadores de progreso en el 10 %, 25 %, 50 %, 75 % y 95 %.
Media.segmentByMilestones	`s.Media.segmentByMilestones` `= true;`	N/D	El seguimiento automático ya no está disponible.
Media.segmentByOffsetMilestones	`s.Media.` `segmentByOffsetMilestones` `= true;`	N/D	El seguimiento automático ya no está disponible.

Variables de seguimiento de publicidades

Milestone	Sintaxis de Milestone	Media Analytics	Sintaxis de Media Analytics
Media.adTrackSeconds	`s.Media.` `adTrackSeconds` `= 15`	N/D	Media Analytics tiene establecido 10 segundos para el contenido y 1 segundo para los anuncios. No hay más opciones disponibles.
Media.adTrackMilestones	`s.Media.` `adTrackMilestones` `= "25,50,75";`	N/D	Los marcadores de progreso no se proporcionan de forma predeterminada para las publicidades. Utilice métricas calculadas para crear marcadores de progreso de anuncios.
Media.adTrackOffsetMilestones	`s.Media.` `adTrackOffsetMilestones` `= "20,40,60";`	N/D	Media Analytics se establece en 1 segundo para las publicidades. No hay más opciones disponibles.
Media.adSegmentByMilestones	`s.Media.` `adSegmentByMilestones` `= true;`	N/D	El seguimiento automático ya no está disponible.
Media.adSegmentByOffsetMilestones	`s.Media.` `adSegmentByOffsetMilestones` `= true;`	N/D	El seguimiento automático ya no está disponible.

Métodos de módulo multimedia

Milestone	Sintaxis de Milestone	Media Analytics	Sintaxis de Media Analytics
Media.open	`s.Media.open(` `mediaName,` `mediaLength,` `mediaPlayerName)`	trackSessionStart	`trackSessionStart(` `mediaObject,` `contextData)`
mediaName	`mediaName`: (requerido) nombre del vídeo tal como desea que aparezca en informes de vídeo.	name	`createMediaObject(` `name,` `mediaId,` `length,` `streamType)`
mediaLength	`mediaLength`: (requerido) duración del vídeo en segundos.	length	`createMediaObject(` `name,` `mediaId,` `length,` `streamType)`
mediaPlayerName	`mediaPlayerName`: (requerido) nombre del reproductor multimedia que se utilizó para ver el vídeo, tal como desea que aparezca en informes de vídeo.	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);`
name	`name`: (requerido) nombre o ID del anuncio.	name	`createAdObject(` `name,` `adId,` `position,` `length)`
length	`length`: (requerido) duración del anuncio.	length	`createAdObject(` `name,` `adId,` `position,` `length)`
playerName	`playerName`: (requerido) nombre del reproductor de contenidos que se utilizó para ver el anuncio.	playerName	`MediaHeartbeatConfig.` `playerName`
parentName	`parentName`: Nombre o ID del contenido primario donde está incrustado el anuncio.	N/D	Heredado automáticamente.
parentPod	`parentPod`: Posición en el contenido primario en que se reprodujo el anuncio.	position	`createAdBreakObject(` `name,` `position,` `startTime)`
parentPodPosition	`parentPodPosition`: Posición dentro del pod donde se reproduce el anuncio.	position	`createAdObject(` `name,` `adId,` `position,` `length)`
CPM	`CPM`: CPM o CPM cifrado (con el prefijo “~”) que se aplica a esta reproducción.	N/D	No disponible de forma predeterminada en Media Analytics.
Media.click	`s.Media.click(name, offset)`	N/D	Utilice una llamada de análisis de vínculo personalizado para hacer un seguimiento de los 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 o trackEvent	`trackPause()` O bien `trackEvent(` `MediaHeartbeat.` `Event.` `SeekStart)` O bien `trackEvent(` `MediaHeartbeat.` `Event.` `BufferStart);`
Media.monitor	`s.Media.monitor(s, media)`	Utilice metadatos personalizados o estándar para establecer variables adicionales.	`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)`	N/D	La frecuencia de llamada de seguimiento se configura automáticamente.