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.
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.
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.
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
Criar uma configuração e uma estrutura do Adobe Analytics.
Na página da estrutura, selecione um RSID e defina o uso para todos. (http://localhost:4502/cf#/etc/cloudservices/sitecatalyst/videoconf/videofw.html)
Na categoria de componente Geral do Sidekick, arraste o componente Vídeo até a estrutura.
Selecione um método de rastreamento:
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.
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, 2:O:4-8 |
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.
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:
4,8,16,20,24
Os valores de deslocamento devem ser inteiros com mais de 0. O valor padrão é 10,25,50,75
.
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.
Adicionar a estrutura à página.
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:
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:
Este é o primeira chamadafeito no Adobe Analytics contendo os seguintes valores:
Este é o terceira chamadafeito no Adobe Analytics:
a.media.name;
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:
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
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:
10,25,50,75
Os valores de deslocamento devem ser inteiros com mais de 0.
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.
Adicionar a estrutura à página.
Para testar a configuração em Modo de visualização, reproduza o vídeo para acionar chamadas do Adobe Analytics.
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.
O campo Tracking offset aceita apenas uma lista separada por vírgulas contendo números inteiros entre 1 e 100.
Defina o deslocamento da Faixa.
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. |
É 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.
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:
O pev3enviada na chamada contém as seguintes informações:
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.
Defina o deslocamento da Faixa para qualquer número de segundos,
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. |
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.
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:
A chamada é semelhante à chamada de marcos herdados acima. Consulte as informações sobre pev3 desde que.
Referências usadas neste tutorial: