Información general de Milestone milestone-overview

Métrica de vídeo

Tipo de variable

Descripción

Contenido

Caducidad predeterminada de la eVar: Visita

(Requerido) Recopila el nombre del vídeo tal como se especifica en la implementación.

Tipo de contenido

Caducidad predeterminada de la eVar: Vista de página

Recopila datos sobre el tipo de contenido que un visitante ve. Las visitas enviadas por la medición de vídeo tienen asignado un tipo de contenido de video.
Esta variable no necesita estar reservada exclusivamente para el seguimiento de vídeo. El hecho de disponer de otros tipos de contenido de informe de contenido mediante el uso de esta misma variable le permite analizar la distribución de los visitantes entre los distintos tipos de contenido. Por ejemplo, podría etiquetar otros tipos de contenido con valores como article o product page usando esta variable.
Desde una perspectiva de medición de vídeo, Tipo de contenido permite identificar visitantes de vídeo y, por consiguiente, calcular las tasas de conversión de vídeo.

Tiempo invertido en contenido

Tipo de
evento: Contador

Cuenta el tiempo, en segundos, transcurrido en ver un vídeo desde el último proceso de recopilación de datos (solicitud de imagen).

Inicios de vídeo

Tipo de
evento: Contador

Indica que un visitante ha visto alguna parte de un de vídeo. Sin embargo, no proporciona ninguna información sobre qué parte del vídeo ha visualizado el visitante, ni durante cuánto tiempo.

Vídeos completados

Tipo de
evento: Contador

Indica que un usuario ha visto un vídeo completo. De forma predeterminada, el evento completo se mide 1 segundo antes del final del vídeo.
Durante la implementación, puede especificar cuántos segundos desde el final de vídeo quisiera considerar como una vista completa. Para vídeo en directo y otros flujos que no tienen un final definido, puede especificar un punto personalizado para medir las finalizaciones. Por ejemplo, después de un tiempo de visualización específico.

Variable

Descripción

Sintaxis:

s.Media.trackUsingContextData = true;
Esta opción habilita el rastreo de vídeo integrado. Cuando se establece en true, el módulo multimedia genera datos de contexto para el seguimiento de contenidos, en lugar del pev3 heredado.
Utilice Media.contextDataMapping para asignar los datos de contexto a las eVars y los eventos seleccionados.
Valor predeterminado: false

Sintaxis:

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"
     }
};

Un objeto que define la asignación de variables a eVars y eventos que desea usar para la medición de vídeo. El objeto debe asignar los siguientes campos:

a.media.name: (obligatorio) rellena variables con el nombre del vídeo. Proporcione la eVar que seleccionó para almacenar el nombre del vídeo y la variable de vídeo de Custom Insight (s.prop) que desee usar para configurar las rutas de vídeo. Disponga los valores en una lista separados por comas.

a.media.segment: (opcional) la eVar que desea que almacene el nombre del segmento de contenidos. a.contentType: (opcional) la eVar que desea que almacene el valor del vídeo, que contiene el seguimiento de visitas y visitantes habilitado para generar informes sobre ellos. La variable que seleccione probablemente ya se esté usando para almacenar datos, como diapositivas de artículos o páginas de productos.

a.media.view: (obligatorio) el evento que desea que cuente las visualizaciones de contenidos.

a.media.segmentView: (opcional) el evento que desea que cuente las vistas de segmentos.

a.media.complete: (opcional) el evento que desea que cuente las vistas completas.

a.media.timePlayed: (opcional; muy recomendable) el evento numérico que desea que almacene el número de segundos de vídeo reproducidos.

a.media.milestones: (opcional) un objeto que asigna hitos s.Media.trackMilestones a eventos de contador. Media.segmentByMilestones debe establecerse como true si define hitos.

Seguimiento de anuncios Las siguientes variables de datos de contexto están disponibles para realizar el seguimiento de anuncios:
a.media.ad.name: (obligatorio) rellena variables con el nombre del anuncio. Proporcione la eVar que seleccionó para almacenar el nombre del anuncio y la variable de vídeo de Custom Insight (s.prop) que desee usar para configurar las rutas. Disponga los valores en una lista separados por comas.

a.media.ad.pod: la posición en el contenido principal en la que se reprodujo el anuncio.

a.media.ad.podPosition: la posición dentro de la secuencia en la que se reprodujo el anuncio.

a.media.ad.CPM: el CPM o CPM cifrado (con el prefijo “~”) que se aplica a esta reproducción.

a.media.ad.view: funciona igual que a.media.view

a.media.ad.clicked: Cuenta el número de clics para el anuncio (llamadas a Media.click)

a.media.ad.timePlayed: funciona igual que a.media.timePlayed

a.media.ad.complete: Funciona igual que a.media.ad.segment de a.media.complete: Funciona igual que a.media.segment

a.media.ad.segmentView: funciona igual que a.media.segmentView

a.media.ad.milestones: funciona igual que a.media.milestones

a.media.ad.offsetMilestones: funciona igual que a.media.offsetMilestones

Sintaxis:

s.Media.trackVars =
   "events, prop2, eVar1, eVar2, eVar3";

Una lista separada por comas de todas las variables que se establecen en su código de seguimiento de vídeo.

Sintaxis:

s.Media.trackEvents =
   "event1, event2, event3, event4, event5, event6, event7"

Una lista separada por comas de todos los eventos que se establecen en su código de seguimiento de vídeo.

Variable

Descripción

Sintaxis:

s.Media.autoTrack = true

Habilita el seguimiento automático para reproductores compatibles. Estos son los reproductores compatibles:

• Open Source Media Framework (OSMF)
• FLVPlayback (reproductores de vídeo creados por el asistente de importación de vídeo en Flash Professional)
• Silverlight
• MediaDisplay
• MediaPlayback
• Brightcove versiones de API 2 y 3 (consulte Brightcove)
• Windows Media Player, Quicktime o Real Player con JavaScript

Si no utiliza ninguno de esos reproductores, puede usar Media.open Media.play Media.stop Media.close para rastrear eventos de reproductor.

Sintaxis:

s.Media.autoTrackNetStreams = true

Flash 10.3 ha introducido nuevas funciones en el componente NetStream que permiten rastrear mejor los vídeos. Si utiliza un reproductor Flash NetStream personalizado, puede habilitar esta variable para activar una funcionalidad similar a autoTrack. Este método requiere que los vídeos se vean en Flash 10.3 o posterior.

Sintaxis:



s.Media.completeByCloseOffset = true

Esta configuración le permite contar una vista completa de vídeo unos segundos antes del verdadero final del vídeo.

El evento se envía en función del número de segundos especificado en completeCloseOffsetThreshold. Esto permite medir las finalizaciones en reproductores de vídeo que nunca informan sobre el desplazamiento cuando este es igual a la duración del vídeo.

De forma predeterminada, este valor se define como true y el umbral se establece como 1 segundo. Con estos valores predeterminados, el evento de finalización se envía 1 segundo antes del final del vídeo.

Sintaxis:

s.Media.completeCloseOffsetThreshold = 1

Este umbral le permite contar una vista completa de vídeo unos segundos antes del verdadero final del vídeo. Media.completeByCloseOffset debe estar definido como true para usar este umbral.

El valor entero que proporciona determina a qué distancia en segundos puede estar el desplazamiento con respecto a la duración completa del vídeo y seguir contando como una finalización. Esto permite medir las finalizaciones en reproductores de vídeo que nunca informan sobre el desplazamiento cuando este es igual a la duración del vídeo.

El umbral predeterminado es 1 segundo.

Sintaxis:

s.Media.playerName = "Custom Player Name"

Especifica un nombre del reproductor de vídeo personalizado.

Sintaxis:

s.Media.trackSeconds = 15

Define el intervalo, en segundos, para enviar datos de seguimiento de vídeo a los servidores de recopilación de datos de Adobe mientras se reproduce el vídeo. El valor debe definirse en incrementos de 5 segundos.

Al habilitar Media.trackSeconds, se activan solo los eventos definidos en Media.contextDataMapping. Para enviar variables adicionales al margen de las especificadas para la medición de vídeo, debe usar Media.Monitor.

Realiza el seguimiento de hitos como un porcentaje de la duración del vídeo.

Sintaxis:

s.Media.trackMilestones = "25, 50, 75";

Define el intervalo, como un porcentaje de la duración del vídeo, para enviar datos de seguimiento de vídeo a los servidores de recopilación de datos de Adobe. Indique los hitos en una lista de números enteros separados por comas. Por ejemplo: 10 = 10 %, 23 = 23 %.

Puesto que estos hitos son puntos fijos del vídeo, si un visitante pasa el hito de 10 %, luego rebobina y vuelve a pasar ese hito, el módulo multimedia envía los datos de seguimiento varias veces. De igual modo, si un visitante avanza un hito rápidamente, el módulo multimedia no envía los datos de rastreo para ese hito.

Al habilitar Media.trackMilestones, se activan solo los eventos definidos en Media.contextDataMapping. Para enviar variables adicionales al margen de las especificadas para la medición de vídeo, debe usar Media.Monitor.

Realiza el seguimiento de hitos como segundos transcurridos desde el principio del vídeo.

Sintaxis:

s.Media.trackOffsetMilestones = "20, 40, 60";

Define el intervalo, como segundos transcurridos desde el principio del vídeo, para enviar datos de seguimiento de vídeo a los servidores de recopilación de datos de Adobe. Indique los hitos en una lista de números enteros separados por comas. Por ejemplo: 20 = 20 segundos, 40 = 40 segundos).

Puesto que estos hitos son puntos fijos del vídeo, si un visitante pasa el hito de 20 segundos, luego rebobina y vuelve a pasar ese hito, el módulo multimedia envía los datos de seguimiento varias veces. De igual modo, si un visitante avanza un hito rápidamente, el módulo multimedia no envía los datos de rastreo para ese hito.

Al habilitar Media.trackOffsetMilestones, se activan solo los eventos definidos en Media.contextDataMapping. Para enviar variables adicionales al margen de las especificadas para la medición de vídeo, debe usar Media.Monitor.

Sintaxis:

s.Media.segmentByMilestones = true;

Genera automáticamente el nombre del segmento, el número del segmento y los datos de duración del segmento, en función de la longitud de los contenidos y los hitos especificados en Media.trackMilestones

Segmentación por hitos (Milestone) es la única manera de definir segmentos al utilizar autoTrack.

Valor predeterminado: false

Sintaxis:

s.Media.segmentByOffsetMilestones = true;

Genera automáticamente el nombre del segmento, el número del segmento y los datos de duración del segmento, en función de la longitud de los contenidos y los hitos especificados en Media.trackOffsetMilestones

Segmentación por hitos (Milestone) es la única manera de definir segmentos al utilizar autoTrack.

Valor predeterminado: false

Variable

Descripción

Sintaxis:

s.Media.adTrackSeconds = 15;

Define el intervalo, en segundos, para enviar datos de seguimiento de anuncios de vídeo a los servidores de recopilación de datos de Adobe mientras se reproduce el vídeo. El valor debe definirse en incrementos de 5 segundos.

Al habilitar Media.adTrackSeconds, se activan solo los eventos definidos en Media.contextDataMapping. Para enviar variables adicionales al margen de las especificadas para la medición de vídeo, debe usar Media.monitor.

Realiza el seguimiento de hitos de anuncio como un porcentaje de la duración del anuncio.

Sintaxis:

s.Media.adTrackMilestones = "25, 50, 75";

Define el intervalo, como un porcentaje de la duración del anuncio, para enviar datos de seguimiento de anuncio a los servidores de recopilación de datos de Adobe. Indique los hitos en una lista de números enteros separados por comas. Por ejemplo: 10 = 10 %, 23 = 23 %).

Puesto que estos hitos son puntos fijos del anuncio, si un visitante pasa el hito de 10 %, luego rebobina y vuelve a pasar ese hito, el módulo multimedia envía los datos de seguimiento varias veces. De igual modo, si un visitante avanza un hito rápidamente, el módulo multimedia no envía los datos de rastreo para ese hito.

Al habilitar Media.adTrackMilestones, se activan solo los eventos definidos en Media.contextDataMapping. Para enviar variables adicionales al margen de las especificadas para la medición de vídeo, debe usar Media.monitor.

Realiza el seguimiento de hitos como segundos transcurridos desde el principio del anuncio.

Sintaxis:

s.Media.adTrackOffsetMilestones = "20, 40, 60";

Define el intervalo, como segundos transcurridos desde el principio del anuncio, para enviar datos de seguimiento de anuncio a los servidores de recopilación de datos de Adobe. Indique los hitos en una lista de números enteros separados por comas. Por ejemplo: 20 = 20 segundos, 40 = 40 segundos).

Puesto que estos hitos son puntos fijos del anuncio, si un visitante pasa el hito de 20 segundos, luego rebobina y vuelve a pasar ese hito, el módulo multimedia envía los datos de seguimiento varias veces. De igual modo, si un visitante avanza un hito rápidamente, el módulo multimedia no envía los datos de rastreo para ese hito.

Al habilitar Media.adTrackOffsetMilestones, se activan solo los eventos definidos en Media.contextDataMapping. Para enviar variables adicionales al margen de las especificadas para la medición de vídeo, debe usar Media.monitor.

Sintaxis:

s.Media.adSegmentByMilestones = true;

Genera automáticamente el nombre del segmento, el número del segmento y los datos de duración del segmento, en función de la longitud de los contenidos y los hitos especificados en Media.adTrackMilestones

Segmentación por hitos (Milestone) es la única manera de definir segmentos al utilizar autoTrack.

Valor predeterminado: false

Sintaxis:

s.Media.adSegmentByOffsetMilestones = true;

Genera automáticamente el nombre del segmento, el número del segmento y los datos de duración del segmento, en función de la longitud de los contenidos y los hitos especificados en Media.adTrackOffsetMilestones

Segmentación por hitos (Milestone) es la única manera de definir segmentos al utilizar autoTrack.

Valor predeterminado: false

Método

Descripción

Sintaxis:

s.Media.open(mediaName, mediaLength, mediaPlayerName)

Prepara el módulo multimedia para recopilar datos de seguimiento de vídeo. Este método emplea los parámetros siguientes:

• mediaName: (requerido) nombre del vídeo tal como desea que aparezca en informes de vídeo.
• mediaLength: (requerido) duración del vídeo en segundos.
• mediaPlayerName: (requerido) nombre del reproductor de contenidos que se utilizó para ver el vídeo, tal como desea que aparezca en informes de vídeo.

Sintaxis:

s.Media.openAd(name, length, playerName, parentName,
   parentPod, parentPodPosition, CPM)

Prepara el módulo multimedia para recopilar datos de seguimiento de anuncios. Este método emplea los parámetros siguientes:

• name: (requerido) nombre o ID del anuncio.
• length: (requerido) duración del anuncio.
• playerName: (requerido) nombre del reproductor de contenidos que se utilizó para ver el anuncio.
• parentName: nombre o ID del contenido primario donde está incrustado el anuncio.
• parentPod: posición en el contenido primario en que se reprodujo el anuncio.
• parentPodPosition: posición dentro del pod donde se reproduce el anuncio.
• CPM: CPM o CPM cifrado (con el prefijo “~”) que se aplica a esta reproducción.

Sintaxis:

s.Media.click(name, offset)

Rastrea cuando se hace clic en un anuncio de un vídeo. Este método emplea los parámetros siguientes:

• Nombre: Nombre del anuncio. Debe coincidir con el nombre que se usa en Media.openAd.
• Desplazamiento: Desplazamiento en la publicidad cuando se produjo el clic.

Sintaxis:

s.Media.close(mediaName)

Finaliza la recopilación de datos de vídeo y envía información a servidores de recopilación de datos de Adobe. Llame a este método al final del vídeo. Este método toma el parámetro siguiente:

mediaName: nombre del vídeo. Debe coincidir con el nombre que se usa en Media.open.

Sintaxis:

s.Media.complete(name, offset)

Este método rastrea manualmente un evento completo. Este método se utiliza cuando necesita desencadenar eventos con lógica especial que no se pueden administrar con Media.completeByCloseOffset.

Por ejemplo, si está midiendo un flujo en vivo que no tiene fin definido, puede que desencadene una finalización después de que un usuario vea un flujo en vivo durante X segundos. Puede medir una finalización mediante un cálculo de porcentaje basado en la longitud y el tipo de contenido. Este método emplea los parámetros siguientes:

• mediaName: nombre del vídeo. Debe coincidir con el nombre que se usa en Media.open.
• mediaOffset: El número de segundos en el vídeo cuando se debe enviar el evento completo. Indique el desplazamiento teniendo en cuenta que el vídeo comienza en el segundo cero.
  
  Si el reproductor multimedia rastrea con milisegundos, asegúrese de que el valor se convierta a segundos antes de llamar a Media.complete.

Si planea invocar Completar manualmente, establezca

s.Media.completeByCloseOffset = false.

Sintaxis:

s.Media.play(name, offset, segmentNum, segment, segmentLength)

Llame a este método en cualquier momento en que se comience a reproducir un vídeo. Al utilizar medición de vídeo manual, puede proporcionar los datos de segmentos actuales al enviar datos de medición de vídeo.

Si el reproductor cambia de un segmento a otro por cualquier razón, debe invocar Media.stop Media.play.

Este método emplea los parámetros siguientes:

mediaName: nombre del vídeo. Debe coincidir con el nombre que se usa en Media.open.

mediaOffset: El número de segundos en el vídeo en el que comienza la reproducción. Indique el desplazamiento teniendo en cuenta que el vídeo comienza en el segundo cero. Si el reproductor multimedia rastrea con milisegundos, asegúrese de que el valor se convierta a segundos antes de llamar a Media.play.

segmentNum: (Opcional) número del segmento actual que los informes de marketing utilizan para ordenar la visualización de segmentos en informes. El parámetro segmentNum debe ser mayor que cero.

segment: (Opcional) nombre del segmento actual.

segmentLength: (Opcional)

La duración en segundos del segmento actual.

Por ejemplo:

s.Media.play("My Video", 1800, 2,"Second Quarter", 1800)

s.Media.play("My Video", 0, 1,"Preroll", 30)

Sintaxis:

s.Media.stop(mediaName, mediaOffset)

Rastrea un evento detención (detención, pausa, etc.) para el vídeo especificado. Este método emplea los parámetros siguientes:

• mediaName: nombre del vídeo. Debe coincidir con el nombre que se usa en Media.open.
• mediaOffset: El número de segundos en el vídeo que se produce el evento de detención o pausa. Indique el desplazamiento teniendo en cuenta que el vídeo comienza en el segundo cero.

Sintaxis:

s.Media.monitor(s, media)

Sintaxis de Silverlight:

s.Media.monitor =
   new AppMeasurement_Media_Monitor(myMediaMonitor);

El monitor multimedia de aplicaciones de Silverlight implementa el patrón de diseño de delegado Objective-C. El método de clase myMediaMonitor toma los parámetros s y media.

Utilice este método para enviar métricas de vídeos adicionales. Puede configurar variables adicionales (Props, eVars, Events) y enviarlas con Media.track en función del estado actual del vídeo mientras se reproduce.

Consulte Medir métricas adicionales con Media.monitor.

Este método emplea los parámetros siguientes:

s:: La instancia de AppMeasurement (o el objeto de JavaScript de s).

contenidos: Un objeto con miembros que indican el estado del vídeo. Estos miembros son:

• media.name: Nombre del vídeo. Debe coincidir con el nombre que se usa en Media.open;
• media.length: duración del vídeo en segundos que se proporciona en la llamada a Media.open;
• media.playerName: nombre del reproductor de contenidos que se proporciona en la llamada a Media.open;
• media.openTime: Ubjeto NSDate que contiene datos sobre cuándo se invocó a Media.open;
• media.offset: desplazamiento actual, en segundos, (punto real en el vídeo) del vídeo. El desplazamiento comienza en cero (el primer segundo del vídeo es el segundo 0);
• media.percent: porcentaje actual del vídeo que se reprodujo, en función de la duración del vídeo y del desplazamiento actual.;
• media.timePlayed: número total de segundos reproducidos hasta el momento;
• media.eventFirstTime: indica si esta fue la primera vez en invocar el evento multimedia para este vídeo;
• media.mediaEvent: cadena que contiene el nombre del evento que provocó la llamada al monitor.

media.mediaEvent eventos:

• OPEN: cuando la reproducción se observa por primera vez mediante Media.autoTrack o una llamada a Media.play;
• CLOSE: cuando la reproducción termina al completarse el vídeo mediante Media.autoTrack o una llamada a Media.close;
• PLAY: cuando la reproducción se reanuda después de estar pausada o se analiza mediante Media.autoTrack o una segunda llamada a Media.play;
• STOP: cuando una reproducción se detiene debido a una pausa del principio de análisis mediante Media.autoTrack o una llamada a Media.stop;
• MONITOR: cuando nuestra supervisión automática comprueba el estado del vídeo mientras se está reproduciendo (cada segundo);
• SECONDS: En el segundo intervalo definido por la variable de Media.trackSeconds;
• MILESTONE: en los hitos (Milestone) definidos por la variable Media.trackMilestones;

Sintaxis:

s.Media.track(mediaName)

Envía inmediatamente el estado de vídeo actual, junto con las Media.trackVars y los Media.trackEvents que ha definido. Este método se utiliza dentro de Media.monitor.

Consulte Medir métricas adicionales con Media.monitor.

Llame a Media.open y Media.play en el vídeo antes de llamar a este método. Este método emplea el parámetro siguiente:

• mediaName: nombre del vídeo. Debe coincidir con el nombre que se usa en Media.open.

Este método es la única manera de enviar variables adicionales mientras se reproduce el vídeo. Restaura los contadores de intervalo de segundos y de hito porcentual a cero para evitar múltiples visitas de seguimiento.