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: Wed Mar 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

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 uma vídeo reproduzível enviado por 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 usar as opções herdadas para o rastreamento de vídeo. Use o Etapas em vez disso.

Etapas comuns common-steps

  1. Configurar uma página da Web arrastando um componente de vídeo no sidekick e adicionar um reproduzível vídeo como um ativo para o componente

  2. Criar uma configuração e estrutura do Adobe Analytics.

    • Os exemplos nas seções seguintes usam o nome my-sc-configuration para a configuração e videofw para o quadro.

  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 esse conterão a variável fácil de usar nome (Título) do vídeo, se definido no DAM; se não estiver definido, o do vídeo nome do arquivo 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 o vídeo terminar de ser reproduzido
eventdata.events.milestoneX
Enviado quando o marco fornecido é passado, X representa o segundo em que o marco é acionado
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
É possível definir as configurações de fácil de usar abrindo o vídeo para edição no DAM e definindo o parâmetro Título para 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 Medição de vídeo no Adobe Analytics guia.

  3. Adicionar a estrutura para a página.

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

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:

video1

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

Este é o primeira chamada ​feito no 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

Este é o terceira chamada ​feito no Adobe Analytics:

  • prop1 e eVar 1 contêm a.media.name;
  • event1 porque um segmento foi visualizado
  • event2 enviado com o tempo reproduzido = 4
  • event11 enviado porque eventdata.events.milestone8 foi atingido
  • prop2 para 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.
  • A variável conjunto estático de variáveis CQ que são definidos para mapeamento com propriedades do 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 Medição de vídeo no Adobe Analytics guia.

  3. Adicionar a estrutura para a página.

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

Etapas herdadas legacy-milestones

Este método é semelhante ao método de Marcos com a diferença de que os marcos especificados na variável Deslocamento de rastreamento são porcentagens em vez de pontos definidos 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 esse conterão a variável fácil de usar nome (Título) do vídeo se definido no DAM; se o Título não estiver definido, o nome do vídeo nome do arquivo 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 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
É possível definir as configurações de fácil de usar abrindo o vídeo para edição no DAM e definindo o parâmetro Título para o nome desejado. Também é necessário Salvar as alterações feitas ao concluir.

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

    A variável resto das informações relevantes na chamada será enviada concatenada em um variável nomeada pev3.

    Exemplos de chamadas Para o Adobe Analytics usar o exemplo fornecido, deve ter esta aparência quando visualizado 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)

    • Length - A duração do arquivo de vídeo, em segundos (100)

    • Nome do player - O reprodutor 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 inicial - Carimbo de data e hora que identifica quando a reprodução do 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 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 - video was stopped at sec (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 esse conterão a variável fácil de usar nome (Título) do vídeo se definido no DAM; se o Título não estiver definido, o nome do vídeo nome do arquivo será enviado. Enviado somente 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
É possível definir as configurações de fácil de usar abrindo o vídeo para edição no DAM e definindo o parâmetro Título para o nome desejado. Também é necessário Salvar as alterações feitas ao concluir.

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

    A variável resto das informações relevantes na chamada será enviado concatinado em um variável nomeada pev3.

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

    lseconds

    A chamada é semelhante à chamada de Marcos herdados acima. Consulte as informações em pev3 fornecido lá.

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