Show Menu
TEMAS×

Video Analytics

A continuación encontrará más información sobre la medición de vídeo en Android mediante la solución de medición de vídeo.
Durante la reproducción de vídeo, se envían llamadas frecuentes de monitoreo del funcionamiento a este servicio para medir el tiempo de reproducción. Estas llamadas de monitoreo del funcionamiento se envían cada diez segundos, lo que crea métricas de participación de vídeo granulares e informes de visitas de vídeo más precisos. Para obtener más información acerca de la solución de medición de vídeo de Adobe, consulte Medición de audio y vídeo en Adobe Analytics .
El proceso general de medición de vídeos es muy similar en todas las plataformas. Este contenido ofrece una visión general de las tareas del desarrollador, con ejemplos de código. La siguiente tabla indica los datos multimedia que se envían a Analytics. Las reglas de procesamiento se utilizan para asignar los datos de contexto a una variable de Analytics.

Asignación de eventos del reproductor a las variables de Analytics

  • a.media.name
    • Tipo de variable: eVar
      • Caducidad predeterminada: visita
      • Insight personalizada (s.prop, se utiliza para rutas de vídeo)
    • ( Obligatorio ) Cuando un visitante visualiza el vídeo de alguna forma, la variable de datos de contenido recopila el nombre del vídeo, según lo especificado en la implementación. Puede añadir clasificaciones para esta variable.
    • ( Opcional ) La variable Insight personalizada proporciona información sobre la ruta del vídeo.
  • a.media.name
    • Tipo de variable: Custom Insight (s.prop)
    • ( Opcional ) Proporciona información sobre la ruta del vídeo.
      ExpCare debe habilitar las rutas para esta variable.
    • Tipo de evento: Insight personalizada (s.prop)
  • a.media.segment
    • Tipo de variable: eVar
    • Caducidad predeterminada: vista de página
    • ( Obligatorio ) Recopila datos de segmento del vídeo, incluido el nombre del segmento y el orden en el que aparece el segmento en el vídeo.
      Esta variable se rellena habilitando la variable segmentByMilestones cuando se realiza un seguimiento automático de eventos de reproductor, o bien estableciendo un nombre de segmento personalizado cuando se realiza un seguimiento manual de eventos de reproductor. Por ejemplo, cuando un visitante ve el primer segmento de un vídeo, SiteCatalyst podría recopilar lo siguiente en la eVar Segments: 1:M:0-25 .
      El método personalizado de recopilación de datos de vídeo obtiene datos en los siguientes puntos:
      • inicio del vídeo (reproducción)
      • comienzo del segmento
      • fin del vídeo (parada) Analytics cuenta la primera vista de segmento en el inicio del segmento, cuando el visitante comienza a verlo. El segmento siguiente se visualiza cuando empieza el segmento.
  • a.contentType
    • Tipo de variable: eVar
    • Caducidad predeterminada: vista de página
    • Recopila datos sobre el tipo de contenido que un visitante ve.
      Se asigna un tipo de contenido video a las visitas enviadas por la medición de vídeo. Desde la perspectiva de medición de vídeo, Tipo de contenido permite identificar visitantes de vídeo y calcular tasas de conversión de vídeo.
  • a.media.timePlayed
    • Tipo de variable: Event
    • Tipo: contador
    • Cuenta el tiempo, en segundos, transcurrido viendo un vídeo desde el último proceso de recopilación de datos (solicitud de imagen).
  • a.media.view
    • Tipo de variable: Event
    • Tipo: contador
    • Indica que un visitante ha visto alguna parte de un vídeo.
      Sin embargo, no proporciona ninguna información sobre qué parte del vídeo ha visualizado el visitante, ni durante cuánto tiempo.
  • a.media.segmentView
    • Tipo de variable: Event
    • Tipo: contador
    • Indica que un visitante ha visto alguna parte de un segmento 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.
  • a .media.complete
    • Tipo de variable: Event
    • Tipo: 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 un vídeo pueden quedar sin ver y, pese a ello, considerarse como una vista completa. Para vídeo en directo y otras transmisiones sin un fin definido, puede especificar un punto personalizado para medir las visualizaciones completas (por ejemplo, después de un tiempo de visualización especificado).

Configuración de medios

Configure un objeto MediaSettings con los ajustes que quiera usar para realizar seguimiento de vídeo:
MediaSettings mySettings = Media.settingsWith("name", 10, "playerName", "playerId");

Seguimiento de eventos del reproductor

Para medir la reproducción de vídeo, es preciso realizar llamadas a los métodos mediaPlay , mediaStop , y mediaClose en los momentos apropiados. Por ejemplo, cuando el reproductor se pone en pausa, llame a mediaStop . mediaPlay se utiliza cuando la reproducción comienza o se reanuda.

Clases

Clase: 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;

Clase: 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;

Referencia de clases y métodos de medición de medios

Estos son los métodos de la clase de medición de medios:
  • settingsWith
    Devuelve un objeto MediaSettings con parámetros especificados.
    • Esta es la sintaxis para este método:
      public static MediaSettings adSettingsWith(String name, double length, String playerName, String parentName, String parentPod, double parentPodPosition, String CPM);
      
      
    • Este es un ejemplo de código para este método:
      MediaSettingsmySettings = Media.settingsWith("name", 10, "playerName", "playerId");
      
      
  • adSettingsWith
    Devuelve un objeto MediaSettings que se utiliza en el seguimiento de un vídeo de anuncio.
    • Esta es la sintaxis para este método:
      public static MediaSettings adSettingsWith(String name, double length, String playerName, String parentName, String parentPod, double parentPodPosition, String CPM);
      
      
  • open
    Abre un objeto MediaSettings para el seguimiento.
    • Esta es la sintaxis para este método:
      public static void open(MediaSettings settings, MediaCallback callback); 
      
      
    • Este es un ejemplo de código para este método:
      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
      Cierra el elemento de medios llamado nombre .
      • Esta es la sintaxis para este método:
      public static void close(String name);
      
      
    • Este es un ejemplo de código para este método:
      Media.close("name"); 
      
      
  • play
    • Reproduce el elemento de medios llamado nombre con un desplazamiento determinado en segundos.
    • Esta es la sintaxis para este método:
      publicstatic void play(String name, double offset); 
      
      
  • completo
    Marca de forma manual como completado el elemento de medios en el desplazamiento offset indicado en segundos.
    • Esta es la sintaxis para este método:
      public static void complete(String name, double offset); 
      
      
    • Este es un ejemplo de código para este método:
      Media.complete("name", 0); 
      
      
  • stop
    Notifica al módulo de medios que el vídeo se ha detenido o pausado en el offset indicado.
    • Esta es la sintaxis para este método:
      public static void stop(String name, double offset); 
      
      
    • Este es un ejemplo de código para este método:
      Media.stop("name", 0);
      
      
  • click
    Notifica al módulo de medios que se ha hecho clic en el elemento de medios.
    • Esta es la sintaxis para este método:
      public static void click(String name double offset); 
      
      
    • Este es un ejemplo de código para este método:
      Media.click("name", 0);
      
      
  • track
    Envía una llamada de acción de seguimiento (sin visualización de página) al estado de medios actual.
    • Esta es la sintaxis para este método:
      publicstatic void track(String name, Map<String, Object> data); 
      
      
    • Este es un ejemplo de código para este método:
      Media.track("name", null);