Show Menu
TÓPICOS×

Análise de vídeo

Estas são algumas informações sobre a avaliação de vídeo no Android vindas da solução de avaliação de vídeo.
Durante a reprodução do vídeo, chamadas "heartbeat" frequentes são enviadas a esse serviço para medir o tempo reproduzido. Essas chamadas de heartbeat são enviadas a cada 10 segundos, o que resulta em métricas granulares de envolvimento com o vídeo e relatórios de repercussão de vídeo mais precisos. Para obter mais informações sobre a solução de medição de vídeos da Adobe, consulte Medição de áudio e vídeo no Adobe Analytics .
O processo geral para medição de vídeo é parecido em todas as plataformas. Este conteúdo oferece uma visão geral das tarefas do desenvolvedor com amostras de código. A tabela a seguir lista os dados de mídia que são enviados para o Analytics. As regras de processamento são usadas para mapear os dados de contexto para uma variável do Analytics.

Mapear eventos do player para variáveis do Analytics

  • a.media.name
    • Tipo de variável: eVar
      • Expiração padrão: visita
      • Insight personalizado (s.prop, usado para caminhos de vídeo)
    • ( Obrigatório ) Quando um visitante visualiza o vídeo de alguma forma, essa variável de dados de contexto coleta o nome do vídeo, como especificado na implementação. É possível adicionar classificações para essa variável.
    • ( Opcional ) A variável Insight personalizado fornece informações sobre o caminho do vídeo.
  • a.media.name
    • Tipo de variável: Insight personalizado (s.prop)
    • ( Opcional ) Fornece informações sobre o caminho do vídeo.
      O caminho deve ser habilitado para esta variável pelo ExpCare.
    • Tipo de evento: Insight personalizado (s.prop)
  • a.media.segment
    • Tipo de variável: eVar
    • Expiração padrão: visualização de página
    • ( Obrigatório ) Coleta dados de segmento do vídeo, incluindo o nome do segmento e a ordem na qual ele ocorre no vídeo.
      Essa variável é preenchida com a habilitação da variável segmentByMilestones durante o rastreamento automático de eventos de player, ou ao configurar um nome de segmento personalizado durante o rastreamento manual dos eventos do player. Por exemplo, quando um visitante exibe o primeiro segmento em um vídeo, o SiteCatalyst pode coletar as seguintes informações no eVar Segmentos: 1:M:0-25 .
      O método de coleção de dados de vídeo coleta os dados dos pontos as seguir:
      • início do vídeo (play)
      • início do segmento
      • término do vídeo (stop) O Analytics conta a primeira exibição de segmento no início, quando o visitante começa a assistir. As exibições de segmento subsequente ocorrem quando o segmento começa.
  • a.contentType
    • Tipo de variável: eVar
    • Expiração padrão: visualização de página
    • Coleta dados sobre o tipo de conteúdo que é visualizado por um visitante.
      Ocorrências enviadas por meio da medição de vídeo recebem um tipo de conteúdo de video . Da perspectiva de avaliação do vídeo, o Tipo de conteúdo permite que você identifique visitantes de vídeo e, portanto, calcule as taxas de conversão do vídeo.
  • a.media.timePlayed
    • Tipo de variável: evento
    • Tipo: contador
    • Contabiliza o tempo, em segundos, que é gasto com a exibição de um vídeo desde o último processo de coleta de dados (solicitação da imagem).
  • a.media.view
    • Tipo de variável: evento
    • Tipo: contador
    • Indica que um visitante visualizou uma parte de um vídeo.
      No entanto, não fornece informações sobre quanto ou a qual parte de um segmento de vídeo o visitante assistiu.
  • a.media.segmentView
    • Tipo de variável: evento
    • Tipo: contador
    • Indica que um visitante visualizou uma parte de um segmento de vídeo.
      No entanto, não fornece informações sobre quanto ou a qual parte de um segmento de vídeo o visitante assistiu.
  • a .media.complete
    • Tipo de variável: evento
    • Tipo: contador
    • Indica se o usuário exibiu um vídeo completo.
      Por padrão, o evento completo é avaliado um segundo antes do fim do vídeo. Durante a implementação, é possível especificar quantos segundos a partir do fim do vídeo são necessários para considerar a visualização como concluída. Para vídeo em tempo real e outros fluxos que não possuem um término determinado, é possível especificar um ponto personalizado para medidas completas (por exemplo, depois de um determinado tempo após assistido).

Definir as configurações de mídia

Defina um objeto MediaSettings com as configurações que deseja usar para monitorar o vídeo:
MediaSettings mySettings = Media.settingsWith("name", 10, "playerName", "playerId");

Rastrear eventos de vídeo

Para medir a reprodução de vídeo, os métodos mediaPlay , mediaStop e mediaClose devem ser chamados nos momentos apropriados. Por exemplo, quando o reprodutor é pausado, chame mediaStop . mediaPlay é chamado quando a reprodução começa ou é retomada.

Classes

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

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

Classe de medição de mídia e referência de método

Estes são os métodos na classe de medição de mídia:
  • settingsWith
    Retorna um objeto MediaSettings com parâmetros especificados.
    • Esta é a sintaxe para este método:
      public static MediaSettings adSettingsWith(String name, double length, String playerName, String parentName, String parentPod, double parentPodPosition, String CPM);
      
      
    • Esta é a amostra de código para este método:
      MediaSettingsmySettings = Media.settingsWith("name", 10, "playerName", "playerId");
      
      
  • adSettingsWith
    Retorna um objeto MediaSettings para utilizar no monitoramento de um vídeo de anúncio.
    • Esta é a sintaxe para este método:
      public static MediaSettings adSettingsWith(String name, double length, String playerName, String parentName, String parentPod, double parentPodPosition, String CPM);
      
      
  • open
    Abre um objeto MediaSettings para monitoramento.
    • Esta é a sintaxe para este método:
      public static void open(MediaSettings settings, MediaCallback callback); 
      
      
    • Esta é a amostra 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
      Fecha o item de mídia com nome .
      • Esta é a sintaxe para este método:
      public static void close(String name);
      
      
    • Esta é a amostra de código para este método:
      Media.close("name"); 
      
      
  • play
    • Reproduz o item de mídia com o nome name no offset em questão em segundos.
    • Esta é a sintaxe para este método:
      publicstatic void play(String name, double offset); 
      
      
  • concluído
    Marca manualmente o item de mídia como concluído no offset em questão em segundos.
    • Esta é a sintaxe para este método:
      public static void complete(String name, double offset); 
      
      
    • Esta é a amostra de código para este método:
      Media.complete("name", 0); 
      
      
  • stop
    Notifica ao módulo de mídia que o vídeo foi interrompido ou pausado no offset em questão.
    • Esta é a sintaxe para este método:
      public static void stop(String name, double offset); 
      
      
    • Esta é a amostra de código para este método:
      Media.stop("name", 0);
      
      
  • click
    Notifica ao módulo de mídia que o item de mídia foi clicado.
    • Esta é a sintaxe para este método:
      public static void click(String name double offset); 
      
      
    • Esta é a amostra de código para este método:
      Media.click("name", 0);
      
      
  • track
    Envia uma chamada de ação de rastreamento (sem exibição de página) para o estado de mídia atual.
    • Esta é a sintaxe para este método:
      publicstatic void track(String name, Map<String, Object> data); 
      
      
    • Esta é a amostra de código para este método:
      Media.track("name", null);