DocumentaçãoAEM 6.4Guia de administração

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

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Admin
CAUTION
AEM 6.4 chegou ao fim do suporte estendido e esta documentação não é mais atualizada. Para obter mais detalhes, consulte nossa períodos de assistência técnica. Encontre as versões compatíveis here.

Há vários métodos disponíveis para rastrear eventos de vídeo, 2 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 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 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 rastreamento de vídeo. Use o Marcos em vez disso.

Etapas comuns common-steps

  1. Configure uma página da Web arrastando um componente de vídeo do sidekick e adição de um player vídeo como um ativo para o componente

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

  4. Na categoria de componente Geral do 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 de variáveis CQ é alterada 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 propriedades do Adobe Analytics.

Marcos milestones

O método de 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 deslocamentos de rastreamento com base no tempo para definir os marcos. Quando a reprodução de um vídeo ultrapassa um marco, a página chama o 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, especificar 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 de Marcos:

Variáveis CQ
Propriedades do Adobe Analytics
eventdata.videoName
As variáveis mapeadas para isso conterão a variável fácil de usar name (Título) do vídeo, se definido no DAM; se isso não for definido, a variável nome do arquivo será enviada 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 somente com eventdata.events.a.media.view
eventdata.videoFilePath
As variáveis mapeadas para isso conterão o caminho do arquivo no servidor. Enviado somente com eventdata.events.a.media.view
eventdata.events.a.media.segmentView
Enviado sempre que um marco de segmento é passado
eventdata.events.a.media.timePlayed
Enviado sempre que um marco é acionado, o número de segundos que o usuário gastou assistindo a determinado segmento 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 é concluída
eventdata.events.milestoneX
Enviado quando o marco especificado é 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, normalmente 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, 24-8
NOTE
Você pode definir um nome amigável para o usuário de um vídeo ​ abrindo o vídeo para edição no DAM e definindo a variável Título campo de metadados para o nome desejado.

  1. Depois de selecionar Marcos 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 os 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 inteiros com mais de 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 otimização de mapeamentos, consulte o Avaliação de vídeo no Adobe Analytics guia.

  3. Adicionar a estrutura à página.

  4. Para testar a configuração em Modo de 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
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
eVar3
eventdata.a.media.name
eVar 1, prop1
eventdata.a.media.segment
eVar2

Para este exemplo, o componente Vídeo é exibido da seguinte maneira na página de estrutura:

video1

NOTE
Para ver as chamadas feitas para o Adobe Analytics, use uma ferramenta adequada, como o DigitalPulse Debugger ou Fiddler.

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

chlimage_1-156

Este é o primeira chamada ​feito no Adobe Analytics contendo os seguintes valores:

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

chlimage_1-157

Este é o terceira chamada ​feito no Adobe Analytics:

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

Marcos não herdados non-legacy-milestones

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

  • Quando a reprodução de um vídeo ultrapassa um marco, a página chama o Adobe Analytics para rastrear o evento.
  • O conjunto estático de variáveis CQ que são definidas 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 marcos não herdados como método de rastreamento, na caixa Rastrear deslocamento , insira uma lista separada por vírgulas de porcentagens da duração da faixa. Por exemplo, o valor padrão a seguir define os marcos em 10, 25, 50 e 75% da duração da faixa:

    code language-xml 
    10,25,50,75

    Os valores de deslocamento devem ser inteiros com mais de 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 otimização de mapeamentos, consulte o Avaliação de vídeo no Adobe Analytics guia.

  3. Adicionar a estrutura à página.

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

Marcos herdados legacy-milestones

Esse método é semelhante ao método 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 o deslocamento da Faixa.

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

    Além disso, as informações enviadas para a 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 a variável fácil de usar name (Título) do vídeo, se definido no DAM; se o Título não estiver definido, o nome do arquivo será enviada 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.
NOTE
É possível definir um nome amigável para o usuário de um vídeo ​ ao abrir o vídeo para edição no DAM e definir o campo de metadados Título ​ do 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

    O resto das informações pertinentes na chamada será enviada concatinada para one variável nomeada pev3.

    Exemplos de chamadas para o Adobe Analytics usando o exemplo fornecido deve ser semelhante a este quando exibido com o DigitalPulse Debugger:

    lmilestones1

    O pev3 ​enviada na chamada contém as seguintes informações:

    • Nome - O nome do arquivo de vídeo (filme.avi)
    • Length - A duração do arquivo de vídeo, em segundos (100)
    • Nome do reprodutor - O reprodutor de vídeo utilizado para reproduzir o ficheiro de vídeo (Vídeo HTML5)
    • Total de segundos reproduzidos - O número total de segundos de reprodução do vídeo (25.)
    • Iniciar carimbo de data e hora - Carimbo de data e hora que identifica quando a reprodução do vídeo foi iniciada (1331035567)
    • Reproduzir sessão - Os detalhes da sessão de reprodução. Este 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 eles usaram o controle deslizante do vídeo para avançar o vídeo e onde pararam de reproduzir o vídeo (L10E24S58L58 - vídeo parado em s. 25 da seção L10, em seguida, ignoradas. 48)

Segundos herdados legacy-seconds

Ao usar o método ​ herdado seconds, as chamadas do Adobe Analytics são acionadas a cada N-ésimo segundo, onde 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 Rastreamento de deslocamento aceita apenas números inteiros que sejam maiores que 0

    As informações enviadas para a 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 a variável fácil de usar name (Título) do vídeo, se definido no DAM; se o Título não estiver definido, o nome do arquivo será enviada 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.
NOTE
Você pode definir um nome amigável para o usuário de um vídeo ​ abrindo o vídeo para edição no DAM e definindo a variável Título campo de metadados 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

    O resto das informações pertinentes na chamada será enviada concatinada para one variável nomeada pev3.

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

    lseconds

    A chamada é semelhante à chamada de marcos herdados acima. Consulte as informações sobre pev3 desde que.

Referências usadas neste tutorial:

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

recommendation-more-help
5ce3024a-cbea-458b-8b2f-f9b8dda516e8