DocumentaçãoAEM 6.5Guia do usuário

Configuração do rastreamento de vídeo para o Adobe Analytics configuring-video-tracking-for-adobe-analytics

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Tópicos:

Criado para:

  • undefined

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

NOTE
Antes de continuar, verifique se você tem um vídeo reproduzível carregado com 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 o rastreamento de vídeo usando cada método.

NOTE
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 common-steps

  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. Criar uma configuração e estrutura do 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 uma RSID e defina o uso para todos. (https://localhost:4502/cf#/etc/cloudservices/sitecatalyst/videoconf/videofw.html)

  4. Na categoria geral de componentes no Sidekick, arraste o componente de Vídeo para a estrutura.

  5. Selecione um método de rastreamento:

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

Etapas milestones

O método de etapas 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 deslocamentos de rastreamento com base no tempo para definir os marcos. Quando uma reprodução de vídeo passa um marco, a página chama o Adobe Analytics para rastrear o evento. Para cada marco definido, o componente cria uma variável do CQ que você pode mapear para uma propriedade do Adobe Analytics. O nome dessas variáveis CQ usa o seguinte formato:

eventdata.events.milestoneXX

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

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

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

Variáveis CQ
Propriedades do Adobe Analytics
eventdata.videoName
As variáveis mapeadas para este conterão o nome amigável do usuário (Título) do vídeo se definido no DAM; se não estiver definido, o nome de arquivo do vídeo será enviado. Enviado somente uma vez, no início da reprodução de um vídeo.
eventdata.videoFileName
As variáveis mapeadas para esse local conterão o nome do arquivo. Enviado somente junto com eventdata.events.a.media.view
eventdata.videoFilePath
As variáveis mapeadas para esse local conterão o caminho do arquivo no servidor. Enviado somente junto com eventdata.events.a.media.view
eventdata.events.a.media.segmentView
Enviado sempre que uma etapa do segmento é aprovada
eventdata.events.a.media.timePlayed
Enviado sempre que um marco é acionado, o número de segundos que o usuário gastou assistindo ao segmento específico também é enviado junto com esse evento. por exemplo, eventX=21
eventdata.events.a.media.view
Enviado ao inicializar visualização de vídeo
eventdata.events.a.media.complete
Enviado quando a reprodução do vídeo terminar
eventdata.events.milestoneX
Enviado quando o marco fornecido é passado, X representa o segundo em que o marco é acionado em
eventdata.a.contentType
Enviado em cada marco; exibido como pev3 na chamada do Adobe Analytics, geralmente enviado como "vídeo"
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
NOTE
Você pode definir o nome amigável de um vídeo, abrindo o vídeo para edição no DAM e definindo o campo de metadados Título com o nome desejado.

  1. Depois de selecionar Etapas como método de rastreamento, na caixa Rastrear deslocamento, insira 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 início do vídeo:

    code language-xml 
    4,8,16,20,24

    Os valores de deslocamento devem ser números inteiros maiores que 0. O valor padrão é 10,25,50,75.

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

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

  3. Adicionar a estrutura à página.

  4. Para testar a configuração no modo de Visualização, reproduza o vídeo para obter chamadas do Adobe Analytics para acionar.

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

Variável CQ
propriedade do Adobe Analytics
eventdata.videoName
prop2
eventdata.videoFileName
prop3
eventdata.videoFilePath
prop4
eventdata.events.a.media.segmentView
event1
eventdata.events.a.media.timePlayed
event2
eventdata.events.a.media.view
event3
eventdata.events.a.media.complete
event4
eventdata.events.milestone4
event10
eventdata.events.milestone8
event11
eventdata.events.milestone16
event12
eventdata.events.milestone20
event13
eventdata.events.milestone24
event14
eventdata.a.contentType
EVAR 3
eventdata.a.media.name
eVar 1, prop1
eventdata.a.media.segment
EVAR 2

Neste exemplo, o componente de Vídeo aparece da seguinte maneira na página da estrutura:

vídeo1

NOTE
Para ver as chamadas feitas ao Adobe Analytics, use uma ferramenta apropriada, como DigitalPulse Debugger ou Fiddler.

As chamadas para o Adobe Analytics usando o exemplo fornecido devem ter esta aparência quando visualizadas com o DigitalPulse Debugger:

chlimage_1-128

Esta é a primeira chamada ​feita para o Adobe Analytics contendo os seguintes valores:

  • prop1 e eVar 1 para eventdata.a.media.name,
  • props2-4, juntamente com eVar 2 e eVar 3 contendo contentType (vídeo) e segmento (11-4)
  • event3 que foi mapeado para eventdata.events.a.media.view.

chlimage_1-129

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

  • prop1 e eVar 1 contêm a.media.name;
  • event1 porque um segmento foi visualizado
  • evento2 enviado com tempo reproduzido = 4
  • event11 enviado porque eventdata.events.milestone8 foi atingido
  • prop2 a 4 não são enviados (já que eventdata.events.a.media.view não foi acionado)

Etapas não herdadas non-legacy-milestones

O método de Etapas não herdadas é semelhante ao método de Etapas, exceto que as etapas são definidas usando porcentagens da duração da trilha. As semelhanças são as seguintes:

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

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

O sufixo XX é a porcentagem de duração da trilha que define o marco. Por exemplo, especificar porcentagens de 10, 25, 50 e 75 gera as seguintes variáveis 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 Rastrear deslocamento, insira uma lista separada por vírgulas de porcentagens de duração da faixa. Por exemplo, o valor padrão a seguir define marcos em 10, 25, 50 e 75% da duração da trilha:

    code language-xml 
    10,25,50,75

    Os valores de deslocamento devem ser números inteiros maiores que 0.

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

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

  3. Adicionar a estrutura à página.

  4. Para testar a configuração no modo de Visualização, reproduza o vídeo para obter chamadas do Adobe Analytics para acionar.

Etapas herdadas legacy-milestones

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

NOTE
O campo Tracking offset aceita apenas uma lista separada por vírgulas contendo números inteiros entre 1 e 100.

  1. Defina a opção Rastrear deslocamento.

    • por exemplo,10,50,75,100

    Além disso, as informações enviadas para o Adobe Analytics são menos personalizáveis. Há apenas três variáveis disponíveis para mapeamento:

eventdata.videoName
As variáveis mapeadas para este contêm o nome amigável do usuário (Título) do vídeo, se definido no DAM. Se o Título não for definido, o nome do arquivo do vídeo será enviado. Enviado apenas uma vez, no início da reprodução de um vídeo.
eventdata.videoFileName
As variáveis mapeadas para esse local conterão o nome do arquivo. Enviado somente uma vez, no início da reprodução de um vídeo.
eventdata.videoFilePath
A variável mapeada para este conterá o caminho do arquivo no servidor. Enviado somente uma vez, no início da reprodução de um vídeo.
NOTE
Você pode definir o nome amigável de um vídeo, abrindo o vídeo para edição no DAM e definindo o campo de metadados Título com o nome desejado. Também é necessário Salvar as alterações feitas ao concluir.

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

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

    Chamadas de exemplo para o Adobe Analytics usando o exemplo fornecido devem ter esta aparência quando visualizadas com o DigitalPulse Debugger:

    marcos1

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

    • Nome - O nome do arquivo de vídeo (film.avi)

    • Comprimento - O comprimento do arquivo de vídeo, em segundos (100)

    • Nome do player - O player de vídeo usado para reproduzir o arquivo de vídeo (HTML5 vídeo)

    • Total de Segundos Reproduzidos - O número total de segundos em que o vídeo foi reproduzido (25)

    • Carimbo de data/hora de início - Carimbo de data/hora que identifica quando a reprodução de vídeo começou (1331035567)

    • Reproduzir Sessão - Os detalhes da sessão de reprodução. Esse campo indica como o usuário interagiu com o vídeo. Isso pode incluir dados como onde eles começaram a reproduzir o vídeo, se usaram o controle deslizante do vídeo para avançar o vídeo e onde pararam de reproduzir o vídeo (L10E24S58L58 - o vídeo foi interrompido em segundos. 25 da seção L10, então ignorado para s. 48)

Segundos herdados legacy-seconds

Ao usar o método ​ legacy seconds, as chamadas do Adobe Analytics são acionadas a cada N-ésimo segundo, em que N é especificado no campo Track offset.

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

    • por exemplo, 6
    note note
    NOTE
    O campo de deslocamento de Rastreamento aceita apenas números inteiros maiores que 0

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

eventdata.videoName
As variáveis mapeadas para este contêm o nome amigável do usuário (Título) do vídeo, se definido no DAM. Se o Título não for definido, o nome do arquivo do vídeo será enviado. Enviado apenas uma vez, no início da reprodução de um vídeo.
eventdata.videoFileName
A variável mapeada para este conterá o nome do arquivo. Enviado somente uma vez, no início da reprodução de um vídeo.
eventdata.videoFilePath
A variável mapeada para este conterá o caminho do arquivo no servidor. Enviado somente uma vez, no início da reprodução de um vídeo.
NOTE
Você pode definir o nome amigável de um vídeo, abrindo o vídeo para edição no DAM e definindo o campo de metadados Título com o nome desejado. Também é necessário Salvar as alterações feitas ao concluir.

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

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

    As chamadas para o Adobe Analytics usando o exemplo fornecido devem ter esta aparência quando visualizadas com o DigitalPulse Debugger:

    lsegundos

    A chamada é semelhante à chamada de Marcos herdados acima. Consulte as informações no pev3 fornecidas aqui.

Referências usadas neste tutorial:

[0] https://experienceleague.adobe.com/docs/media-analytics/using/media-overview.html?lang=pt-BR

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2