Análise de vídeo

Informações para ajudá-lo com o Video Analytics.

A avaliação de vídeo é descrita em detalhes no guia Medição de vídeo e áudio no Adobe Analytics . O processo geral para avaliar vídeos é muito semelhante em todas as plataformas AppMeasurement. Esta seção de start 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. Usar 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 o vídeo de alguma forma.Você pode adicionar classificações para essa variável.

    (Optional) The Custom Insight variable provides video pathing information.

    • Tipo de variável: eVar
    • Expiração padrão: visita
    • Custom Insight (s.prop, usado para definição de caminho de vídeo)
  • a.media.name

    (Opcional) Fornece informações sobre o caminho do vídeo. A definição de caminho deve ser ativada para essa variável pelo ClientCare.

    • Tipo de evento: Insight personalizado (s.prop).
    • Tipo de variável: Insight personalizado (s.prop)
  • a.media.segment

    (Required) Collects video segment data, including the segment name and the order in which the segment occurs in the video.

    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 segments eVar.

    O método padrão de coleta de dados de vídeo coleta dados nos seguintes pontos: start de vídeo (play), início do segmento e fim do vídeo (stop). O Analytics conta a primeira visualização de segmento no início do segmento, quando o visitante começa a assistir. As visualizações de segmento subsequentes ocorrem conforme 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 avaliação de vídeo recebem um tipo de conteúdo de "vídeo". Essa variável não precisa ser reservada exclusivamente para rastreamento de vídeo. Quando outros conteúdos relatam tipos usando essa mesma variável, você pode analisar a distribuição de visitantes entre os diferentes tipos 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 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.

    • 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 de vídeo. No entanto, não fornece informações sobre quanto ou qual parte de um vídeo o visitante visualizou.

    • Tipo de 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 sobre quanto ou qual parte de um vídeo o visitante visualizou.

    • 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 vídeos ao vivo e outras transmissões que não têm um fim definido, você pode especificar um ponto personalizado para medir as conclusões. Por exemplo, depois de um tempo de exibição específico.

    • Tipo de variável: Evento
    • Tipo: contador

Definir as configurações de mídia

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

Rastrear eventos de vídeo

Para avaliar a reprodução de vídeo, os métodos Play, Stop, e Close devem ser chamados em momentos apropriados. 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;

Referência de método e classe de medição de mídia

  • SettingsWith (winJS: settingsWith)

    Retorna um objeto MediaSettings 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 usando as 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: fechar)

    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 nomeado name no deslocamento especificado (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);
      

Nesta página