Configuração do rastreamento de vídeo para Adobe Analytics

Há vários métodos disponíveis para rastrear eventos de vídeo, sendo 2 opções herdadas para versões mais antigas do Adobe Analytics. Essas opções herdadas são: Marcos herdados e segundos herdados.

OBSERVAÇÃO

Antes de continuar, certifique-se de ter um vídeo reproduzível carregado no AEM.

Para garantir que seus vídeos sejam reproduzidos na página, consulte este tutorial para obter informações sobre como transcodificar arquivos de vídeo no AEM.

Use o procedimento a seguir para configurar uma estrutura para rastreamento de vídeo usando cada método.

OBSERVAÇÃO

Para novas implementações, é recomendável que você não use as opções herdadas para o rastreamento de vídeo. Em vez disso, use o método Marcos.

Etapas comuns

  1. Configure uma página da Web arrastando um componente de vídeo do sidekick e adicionando um vídeo reproduzível como um ativo para o componente

  2. Crie uma configuração e uma estrutura Adobe Analytics.

    • Os exemplos nas seções a seguir usam o nome my-sc-configuration para a configuração e videofw para a estrutura.
  3. Na página da estrutura, selecione um RSID e defina o uso como todos. (http://localhost:4502/cf#/etc/cloudservices/sitecatalyst/videoconf/videofw.html)

  4. A partir da categoria de componente Geral no Sidekick, arraste o componente Vídeo até a estrutura.

  5. Selecione um método de rastreamento:

  6. Quando você seleciona um método de rastreamento, a lista das variáveis do CQ muda de acordo. Use as seções a seguir para obter informações sobre como configurar ainda mais o componente e mapear as variáveis do CQ com as propriedades do Adobe Analytics.

Marcos

O método Marcos rastreia a maioria das informações sobre o vídeo, é altamente personalizável e fácil de configurar.

Para usar o método Marcos, especifique os deslocamentos de rastreamento baseados em tempo para definir os marcos. Quando uma reprodução de vídeo ultrapassar um marco, a página chamará a Adobe Analytics para rastrear o evento. Para cada marco definido, o componente cria uma variável CQ que pode ser mapeada para uma propriedade do Adobe Analytics. O nome dessas variáveis CQ usa o seguinte formato:

eventdata.events.milestoneXX

O sufixo XX é o deslocamento de rastreamento que define o marco. Por exemplo, a especificação de deslocamentos de rastreamento de 4, 8, 16, 20 e 28 segundos gera as seguintes variáveis de CQ:

  • eventdata.events.milestone4
  • eventdata.events.milestone8
  • eventdata.events.milestone16
  • eventdata.events.milestone20
  • eventdata.events.milestone28

A tabela a seguir descreve as variáveis CQ padrão fornecidas para o método Marcos:

Variáveis CQ Propriedades do Adobe Analytics
eventdata.videoName As variáveis mapeadas para isso conterão o nome amigável ao usuário (Title) do vídeo, se definido no DAM; se isso não for definido, o nome de arquivo do vídeo será enviado em vez disso. Enviado apenas uma vez, no início da reprodução de um vídeo.
eventdata.videoFileName As variáveis mapeadas para isso conterão o nome do arquivo. Enviados somente com eventdata.eventos.a.media.visualização
eventdata.videoFilePath As variáveis mapeadas para isso conterão o caminho do arquivo no servidor. Enviados somente com eventdata.eventos.a.media.visualização
eventdata.events.a.media.segmentView Enviado sempre que um marco de segmento é aprovado
eventdata.events.a.media.timePlayed Sempre que um marco é acionado, o número de segundos que o usuário gastou assistindo ao segmento especificado também é enviado juntamente com esse evento. por exemplo, eventX=21
eventdata.events.a.media.view Enviado ao inicializar a visualização de vídeo
eventdata.events.a.media.complete Enviado quando o vídeo terminar de reproduzir
eventdata.events.milestoneX Enviado quando o marco especificado é passado, X representa o segundo em que o marco é acionado em
eventdata.a.contentType Enviados em cada marco; aparece como pev3 na chamada do Adobe Analytics, normalmente enviada como "video"
eventdata.a.media.name Corresponde exatamente a eventdata.videoName
eventdata.a.media.segment Contém informações sobre o segmento que foi visualizado, por exemplo, 2:O:4-8
OBSERVAÇÃO

Você pode definir um nome de usuário do vídeo ao abrir o vídeo para edição no DAM e configurar o campo de metadados Title para o nome desejado.

  1. Depois de selecionar Marcos como o método de rastreamento, na caixa Deslocamento da faixa, digite uma lista separada por vírgulas de deslocamentos de rastreamento em segundos. Por exemplo, o valor a seguir define marcos em 4, 8, 16, 20 e 28 segundos após o start do vídeo:

    4,8,16,20,24
    

    Os valores de deslocamento devem ser inteiros com mais de 0. O valor padrão é 10,25,50,75.

  2. Para mapear as variáveis do CQ para as propriedades do Adobe Analytics, arraste as propriedades do Adobe Analytics do ContentFinder ao lado da variável do CQ no componente.

    Para obter informações sobre como otimizar os mapeamentos, consulte o guia Medição de vídeo no Adobe Analytics.

  3. Adicione a estrutura à página.

  4. Para testar a configuração no modo de Pré-visualização, reproduza o vídeo para acionar chamadas do Adobe Analytics.

Os exemplos de dados de rastreamento do Adobe Analytics a seguir se aplicam ao rastreamento de marcos usando deslocamentos de rastreamento de 4,8,16,20 e 24, e os seguintes mapeamentos para as variáveis do CQ:

Variável CQ Propriedade Adobe Analytics
eventdata.videoName prop2
eventdata.videoFileName prop3
eventdata.videoFilePath prop4
eventdata.events.a.media.segmentView evento1
eventdata.events.a.media.timePlayed evento2
eventdata.events.a.media.view evento3
eventdata.events.a.media.complete evento4
eventdata.events.milestone4 evento10
eventdata.events.milestone8 evento11
eventdata.events.milestone16 evento12
eventdata.events.milestone20 evento13
eventdata.events.milestone24 evento14
eventdata.a.contentType eVar 3
eventdata.a.media.name eVar 1, prop1
eventdata.a.media.segment eVar2

Neste exemplo, o componente Vídeo é exibido da seguinte forma na página de estrutura:

video1

OBSERVAÇÃO

Para ver as chamadas feitas para a Adobe Analytics, use uma ferramenta apropriada, como o Depurador DigitalPulse ou o Fiddler.

As chamadas para a Adobe Analytics usando o exemplo fornecido devem ser semelhantes quando visualizadas com o DigitalPulse Debugger:

chlimage_1-156

Este é o primeiro​chamado feito para a Adobe Analytics que contém os seguintes valores:

  • prop1 e eVar1 para eventdata.a.media.name,
  • props2-4, juntamente com o eVar 2 e o eVar 3 contendo contentType (vídeo) e segmento (1:O:1-4)
  • evento3 que foi mapeado para eventdata.eventos.a.media.visualização.

chlimage_1-157

Esta é a terceira​chamada feita para a Adobe Analytics:

  • prop1 e eVar 1 contêma.media.name;
  • evento 1 porque um segmento foi visualizado
  • evento2 enviado com tempo reproduzido = 4
  • evento11 enviado porque eventdata.eventos.milestone8 foi atingido
  • prop2 para 4 não são enviados (já que eventdata.eventos.a.media.visualização não foi acionado)

Marcos não herdados

O método Marcos não herdados é semelhante ao método Marcos, exceto que os marcos são definidos usando porcentagens da duração da faixa. Os pontos comuns são os seguintes:

  • Quando uma reprodução de vídeo ultrapassar um marco, a página chamará a Adobe Analytics para rastrear o evento.
  • O conjunto estático de variáveis CQ definido para mapeamento com propriedades do Adobe Analytics.
  • Para cada marco definido, o componente cria uma variável CQ que pode ser mapeada para uma propriedade do Adobe Analytics.

O nome dessas variáveis CQ usa o seguinte formato:

O sufixo XX é a porcentagem da duração da faixa que define o marco. Por exemplo, especificar porcentagens de 10, 25, 50 e 75 gera as seguintes variáveis de CQ:

  • eventdata.events.milestone10
  • eventdata.events.milestone25
  • eventdata.events.milestone50
  • eventdata.events.milestone75
eventdata.events.milestoneXX
  1. Depois de selecionar Etapas não herdadas como método de rastreamento, na caixa Deslocamento da faixa, digite uma lista separada por vírgulas com porcentagens da duração da faixa. Por exemplo, o seguinte valor padrão define marcos em 10, 25, 50 e 75 por cento do comprimento da faixa:

    10,25,50,75
    

    Os valores de deslocamento devem ser inteiros com mais de 0.

  2. Para mapear as variáveis do CQ para as propriedades do Adobe Analytics, arraste as propriedades do Adobe Analytics do ContentFinder ao lado da variável do CQ no componente.

    Para obter informações sobre como otimizar os mapeamentos, consulte o guia Medição de vídeo no Adobe Analytics.

  3. Adicione a estrutura à página.

  4. Para testar a configuração no modo de Pré-visualização, reproduza o vídeo para acionar chamadas do Adobe Analytics.

Marcos herdados

Esse método é semelhante ao método Marcos com a diferença de que os marcos especificados no campo Deslocamento de rastreamento são percentuais em vez de pontos definidos no vídeo.

OBSERVAÇÃO

O campo de deslocamento de rastreamento aceita apenas uma lista separada por vírgulas contendo números inteiros entre 1 e 100.

  1. Defina o deslocamento da faixa.

    • e.g.10,50,75,100

    Além disso, as informações enviadas à Adobe Analytics são menos personalizáveis; há apenas 3 variáveis disponíveis para mapeamento:

eventdata.videoName
As variáveis mapeadas para isso conterão o nome amigável ao usuário (Title) do vídeo, se definido no DAM; se o Título não estiver definido, o nome de arquivo do vídeo será enviado em vez disso. Enviado apenas uma vez, no início da reprodução de um vídeo.
eventdata.videoFileName As variáveis mapeadas para isso conterão o nome do arquivo. Enviado apenas uma vez, no início da reprodução de um vídeo.
eventdata.videoFilePath A variável mapeada para isso conterá o caminho do arquivo no servidor. Enviado apenas uma vez, no início da reprodução de um vídeo.
OBSERVAÇÃO

Você pode definir um nome de usuário fácil de usar de um vídeo ao abrir o vídeo para edição no DAM e configurar o campo de metadados Título para o nome desejado. Também é necessário Salvar as alterações feitas ao terminar.

  1. Mapear essas variáveis para props 1 a 3

    O restante das informações relevantes na chamada será enviado concatenado para a variável one chamada pev3.

    As chamadas de amostra para Adobe Analytics usando o exemplo fornecido devem ser semelhantes quando visualizadas com o Depurador DigitalPulse:

    marcos1

    A variável pev3​enviada na chamada contém as seguintes informações:

    • Nome - O nome do arquivo de vídeo (movie.avi)
    • Duração - A duração do arquivo de vídeo, em segundos (100)
    • Nome do player - o player de vídeo usado para reproduzir o arquivo de vídeo (vídeo ** HTML5)
    • Total de segundos reproduzidos - o número total de segundos em que o vídeo foi reproduzido (25)
    • Carimbo de data e hora do start - Carimbo de data e hora que identifica quando a reprodução do vídeo começou (1331035567)
    • Sessão Play - Os detalhes da sessão Play. Este campo indica como o usuário interagiu com o vídeo. Isso pode incluir dados como o local em que começaram a reproduzir o vídeo, se eles usaram o controle deslizante do vídeo para avançar com o vídeo e onde pararam de reproduzir o vídeo (L10E24S58L58 - o vídeo foi interrompido em segundos. 25 da seção L10, depois pulado para s. 48)

Segundos herdados

Ao usar o método de segundos herdados, as chamadas da Adobe Analytics são acionadas a cada N-ésimo segundo, onde N é especificado no campo de deslocamento Track.

  1. Defina o deslocamento da faixa para qualquer número de segundos,

    • por exemplo, 6
    OBSERVAÇÃO

    O campo de deslocamento de rastreamento aceita apenas números inteiros que sejam superiores a 0

    As informações enviadas à Adobe Analytics são menos personalizáveis. Há apenas 3 variáveis disponíveis para mapeamento:

eventdata.videoName
As variáveis mapeadas para isso conterão o nome amigável ao usuário (Title) do vídeo, se definido no DAM; se o Título não estiver definido, o nome de arquivo do vídeo será enviado em vez disso. Enviado apenas uma vez, no início da reprodução de um vídeo.
eventdata.videoFileName A variável mapeada para isso conterá o nome do arquivo. Enviado apenas uma vez, no início da reprodução de um vídeo.
eventdata.videoFilePath A variável mapeada para isso conterá o caminho do arquivo no servidor. Enviado apenas uma vez, no início da reprodução de um vídeo.
OBSERVAÇÃO

Você pode definir um nome de usuário do vídeo ao abrir o vídeo para edição no DAM e configurar o campo de metadados Title para o nome desejado. Também é necessário Salvar as alterações feitas ao terminar.

  1. Mapeie essas variáveis para prop1, prop2 e prop3

    O restante das informações relevantes na chamada será enviado concatenado para a variável one chamada pev3.

    As chamadas para a Adobe Analytics usando o exemplo fornecido devem ser semelhantes quando visualizadas com o DigitalPulse Debugger:

    segundos

    A chamada é semelhante à chamada Legacy Milestones acima. Consulte as informações sobre pev3 aqui fornecidas.

Referências usadas neste tutorial:

[0] https://docs.adobe.com/content/help/pt-BR/media-analytics/using/sdk-implement/setup/setup-overview.html

Nesta página

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now