Show Menu
TÓPICOS×

Análise de vídeo

Informações para ajudá-lo com a Análise de vídeo.
Video measurement is described in detail in the Measuring audio and video in Adobe Analytics guide. O processo geral para medição de vídeo é muito parecido em todas as plataformas AppMeasurement. Esta seção de início rápido fornece uma visão geral básica das tarefas do desenvolvedor junto com exemplos de código.
A tabela a seguir lista os dados de mídia que são enviados para o Analytics. Use as regras de processamento para mapear os dados de contexto para uma variável do Analytics.
  • a.media.name
    (Obrigatório) Coleta o nome do vídeo, conforme especificado na implementação, quando um visitante visualiza o vídeo de alguma forma. É possível adicionar classificações para esta variável.
    ( Opcional ) A variável Insight personalizado fornece informações sobre o caminho do vídeo.
    • Tipo de variável: eVar
    • Expiração padrão: visita
    • Insight personalizado (s.prop, usado para caminhos de vídeo)
  • a.media.name
    (opcional) Fornece informações sobre o caminho de vídeo. Os caminhos devem ser habilitados para esta variável pelo ClientCare.
    Tipo de evento: Insight personalizado (s.prop)
    • Tipo de variável: Insight personalizado (s.prop)
  • a.media.segment
    (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 monitoramento de eventos de player de modo automático, ou ao configurar um nome de segmento personalizado durante o monitoramento manual dos eventos do player. For example, when a visitor views the first segment in a video, SiteCatalyst might collect the following in the 1:M:0-25 segment eVar.
    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.
    • Tipo de variável: eVar
    • Expiração padrão: visualização de página
  • a.contentType
    Coleta dados sobre o tipo de conteúdo exibido por um visitante. Ocorrências enviadas por meio da avaliação de vídeo recebem um tipo de conteúdo chamado “vídeo”. Essa variável não precisa estar reservada exclusivamente para o rastreamento de vídeo. Quando outros conteúdos relatam o tipo por meio da mesma variável, é possível analisar a distribuição de visitantes em tipos diferentes de conteúdo. Por exemplo, é possível marcar outros tipos de conteúdo por meio de valores como “artigo” ou “página do produto” com essa variável. Da perspectiva de avaliação de vídeo, o tipo de conteúdo permite identificar visitantes de vídeo e calcular as taxas de conversão de vídeo.
    • Tipo de variável: eVar
    • Expiração padrão: visualização de página
  • a.media.timePlayed
    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).
    • Tipo de variável: Evento
    • Tipo: contador
  • a.media.view
    Indica que um visitante visualizou uma parte de um vídeo. No entanto, não fornece informações algumas sobre quanto ou a que parte de um vídeo o visitante assistiu.
    • Variável: Evento
    • Tipo: contador
  • a.media.segmentView
    Indica que um visitante visualizou uma parte de um segmento de vídeo. No entanto, não fornece informações algumas sobre quanto ou a que parte de um vídeo o visitante assistiu.
    • Tipo de variável: Evento
    • Tipo: contador
  • a .media.complete
    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 o vídeo ao vivo e outros fluxos sem um fim definido, é possível especificar um ponto personalizado para avaliar conclusões. Por exemplo, após um tempo de exibição específico.
    • Tipo de variável: Evento
    • Tipo: contador

Configure media settings

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

Track player events

To measure video playback, The Play , Stop , and Close methods need to be called at the appropriate times. Por exemplo, quando o reprodutor está pausado, Stop . Play é chamado quando a reprodução começa ou é retomada.

Classes

Classe: MediaSettings

property Platform::String ^name; 
property Platform::String ^playerName; 
property Platform::String ^playerID; 
property double length; 
property Platform::String ^channel; 
property Platform::String ^milestones; 
property Platform::String ^offsetMilestones; 
property bool segmentByMilestones; 
property bool segmentByOffsetMilestones; 
property int trackSeconds; 
property int completeCloseOffsetThreshold; 
 
// MediaAnalytics Ad settings 
property Platform::String ^parentName; 
property Platform::String ^parentPod; 
property Platform::String ^CPM; 
property double parentPodPosition; 
property bool isMediaAd;

Media measurement class and method reference

  • SettingsWith (winJS: settingsWith)
    Retorna um objeto MediaSetting com parâmetros especificados.
    • Esta é a sintaxe para este método:
      static MediaSettings ^SettingsWith(Platform::String ^name, double length, Platform::String ^playerName, Platform::String ^playerID); 
      
      
    • Esta é a amostra de código para este método:
      var mySettings = ADB.Media.settingsWith("name", 10, "playerName", "playerId"); 
      
      
  • AdSettingsWith (winJS: adSettingsWith
    Retorna um objeto MediaSettings para utilizar no monitoramento de um vídeo de anúncio.
    • Esta é a sintaxe para este método:
      static MediaSettings ^AdSettingsWith(Platform::String ^name, double length, Platform::String ^playerName, Platform::String ^parentName, Platform::String ^parentPod, double parentPosition, Platform::String ^CPM); 
      
      
    • Esta é a amostra de código para este método:
      var myAdSettings = ADB.Media.adSettingsWith("name", 10, "playerName", "parentName", "parentPod", 5, "myCPM"); 
      
      
  • Open (winJS: open)
    Rastreia uma abertura de mídia com o uso das configurações definidas em settings .
    • Esta é a sintaxe para este método:
      static void Open(MediaSettings ^settings);
      
      
    • Esta é a amostra de código para este método:
      ADB.Media.open(mySettings); 
      
      
  • Close (winJS: close)
    Rastreia um fechamento de mídia para o item de mídia chamado name .
    • Esta é a sintaxe para este método:
      static void Close(Platform::String ^name);
      
      
    • Esta é a amostra de código para este método:
      ADB.Media.close("mediaName");
      
      
  • Reproduzir (winJS: play)
    Rastreia uma reprodução de mídia para o item de mídia chamado name no offset dado (em segundos).
    • Esta é a sintaxe para este método:
      static void Play(Platform::String ^name, double offset);
      
      
    • Esta é a amostra de código para este método:
      ADB.Media.play("mediaName", 0);
      
      
  • Concluído (winJS: 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:
      static void Complete(Platform::String ^name, double offset);
      
      
    • Esta é a amostra de código para este método:
      ADB.Media.complete("mediaName", 8); 
      
      
  • Stop (winJS: parar)
    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:
      static void Stop(Platform::String ^name, double offset);
      
      
    • Esta é a amostra de código para este método:
      ADB.Media.stop("mediaName", 4);
      
      
  • Clique em (winJS: clique)
    Notifica ao módulo de mídia que o item de mídia foi clicado.
    • Esta é a sintaxe para este método:
      static void Click(Platform::String ^name, double offset);
      
      
    • Esta é a amostra de código para este método:
      ADB.Media.click("mediaName", 3);
      
      
  • Track (winJS: 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:
      static void Track(Platform::String ^name, Windows::Foundation::Collections::IMap<Platform::String^, Platform::Object^> ^contextData);
      
      
    • Esta é a amostra de código para este método:
      ADB.Media.track("mediaName", null);