Visão geral da extensão de rastreamento de vídeo do YouTube

OBSERVAÇÃO

A Adobe Experience Platform Launch está sendo reformulada como um conjunto de tecnologias de coleta de dados no Experience Platform. Essas alterações serão implementadas em toda a documentação do produto nas próximas semanas. Consulte o seguinte document para obter uma referência consolidada das alterações de terminologia.

Pré-requisitos

Cada propriedade do Adobe Experience Platform Launch exige que as seguintes extensões sejam instaladas e configuradas na tela Extensões:

  • Adobe Analytics
  • Serviço do Experience Cloud Visitor ID
  • Extensão principal

Para https://developers.google.com/youtube/player_parameters, use o trecho de código "Incorporar um player usando uma tag" no HTML de cada página da Web em que um player de vídeo deve ser renderizado.

Esta extensão, versão 2.0.0, aceita a incorporação de um ou mais vídeos do YouTube em uma única página da Web inserindo um atributo id com um valor único na tag de script iframe e anexando enablejsapi=1 and rel=0 ao final do valor de atributo src, se ainda não estiver incluído, como:

<iframe id="player1" width="560" height="315" src="https://www.youtube.com/embed/xpatB77BzYE?enablejsapi=1" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>

Observe que essa extensão também foi projetada para verificar dinamicamente se há um valor de atributo de identificador exclusivo, como player1, se os parâmetros da sequência de consulta enablejsapi e rel existem e se os valores esperados estão corretos. Como resultado, a tag do script do YouTube pode ser adicionada a uma página da Web com ou sem o atributo id e se os parâmetros da sequência de consulta enablejsapi e rel estão ou não incluídos.

Em páginas com mais de um vídeo, observe que cada vídeo usa o mesmo conjunto de configurações na regra do Launch executado nessa página. Por exemplo, se você criar uma regra com um evento que é acionado no vídeo 50% concluído, cada vídeo na página acionará a regra no ponto de sinalização de 50%.

A extensão depende da seguinte lógica para reescrever os iFrames:

document.onreadystatechange = function () {
 if (document.readyState === 'complete') {

Portanto, haverá uma pequena oscilação depois que a página for carregada. Esse comportamento é esperado.

Elementos de dados

Há seis elementos de dados disponíveis na extensão, e nenhum deles precisa ser configurado.

  • Posição do indicador de reprodução: registra o local, em segundos, da posição do indicador de reprodução na linha do tempo do vídeo quando ele é chamado em uma regra do Launch.
  • ID do vídeo: especifica a ID do YouTube associada ao vídeo.
  • Nome do vídeo: especifica o nome descritivo ou amigável do vídeo.
  • URL do vídeo: retorna o URL do YouTube.com para o vídeo atualmente carregado/reproduzido.
  • Duração do vídeo: registra a duração total, em segundos, do conteúdo de vídeo.
  • Versão da extensão: esse elemento de dados registra a versão da Extensão de rastreamento do YouTube, como "Video Tracking_YouTube_2.0.0", por exemplo.

Eventos

Há oito eventos disponíveis na extensão. Somente o Rastreamento de ponto de sinalização personalizado precisa ser configurado.

  • Vídeo pronto: acionado quando o vídeo está sinalizado e pronto para ser reproduzido.
  • Início do vídeo: acionado quando o vídeo é iniciado pela primeira vez e quando player.getCurrentTime() === 0
  • Repetição de vídeo: acionado quando o vídeo é sinalizado e reproduzido novamente após o início. Esse acionador será ativado a cada repetição.
  • Pausa do vídeo: acionado quando o vídeo é pausado.
  • Retomada do vídeo: acionado quando o vídeo é retomado e quando player.getCurrentTime() !== 0
  • Rastreamento de sinalização personalizado: acionado quando o vídeo atinge a porcentagem limite de vídeo especificada…
    Por exemplo, se um vídeo tiver 60 segundos e o ponto de sinalização especificado for 50%, o evento será acionado quando a posição do indicador de reprodução for igual a 30 segundos. O rastreamento do ponto de sinalização se aplica à reprodução inicial e à repetição. Observe que se o usuário buscar um ponto de sinalização, o evento não será acionado. Os eventos de ponto de sinalização só são acionados quando o indicador de reprodução cruza o local do ponto de sinalização calculado na linha do tempo e o player de vídeo está reproduzindo.
  • Buffer de vídeo: acionado quando o player baixa determinada quantidade de dados antes de começar a reproduzir o vídeo.
  • Vídeo encerrado: acionado quando um vídeo é totalmente concluído.

Uso

Há uma regra do Platform Launch para cada evento de vídeo (listada acima). Dessa forma, o usuário dessa extensão precisa criar uma regra do Platform Launch específica para cada evento que deseja rastrear. Em outras palavras, se você não quiser rastrear a pausa de vídeo, não criará uma regra para ela.

As regras têm três ações:

  • Definir variáveis: defina as variáveis do Adobe Analytics (mapeie para todos os elementos de dados incluídos ou alguns deles).
  • Enviar beacon: envie o beacon do Adobe Analytics como uma chamada de rastreamento de link personalizado e forneça um valor "Nome do link".
  • Limpar variáveis: limpe as variáveis do Adobe Analytics.

Exemplo de regra do Platform Launch para "Início do vídeo"

Os seguintes objetos de Extensão de vídeo devem ser incluídos.

Eventos:

"Início do vídeo" (esse evento faz com que a regra seja acionada quando o visitante começa a reproduzir um vídeo do YouTube.)

Condição: nenhuma

Ações: use a extensão do Analytics para:

Ação "Definir variáveis", para mapear:

  • O evento para Início do vídeo,
  • Uma prop/eVar para o elemento de dados Duração do vídeo
  • Uma prop/eVar para o elemento de dados ID do vídeo
  • Uma prop/eVar para o elemento de dados Nome do vídeo
  • Uma prop/eVar para o elemento de dados URL do vídeo

Em seguida, inclua a ação "Enviar beacon" (s.tl) com o nome do link "início do vídeo", seguida por uma ação "Limpar variáveis".

DICA

Para implementações em que várias eVars ou props para cada elemento de vídeo não podem ser usadas, os valores do elemento de dados podem ser concatenados no Platform launch, analisados nos relatórios de classificação usando a ferramenta Construtor de regras de classificação, conforme explicado em https://experienceleague.adobe.com/docs/analytics/components/classifications/classifications-rulebuilder/classification-rule-builder.html?lang=pt-BR?lang=pt-BR, e, em seguida, aplicados como um segmento no Analysis Workspace.

Para concatenar valores de informações de vídeo, crie um novo elemento de dados chamado "Metadados de vídeo" e programe-o para obter todos os elementos de dados de vídeo (listados acima) e reuni-los. Por exemplo:

var r = ””;

r.push('YouTube'); //Player Name
r.push(_satellite.getVar('Video ID'));
r.push(_satellite.getVar('Video Name'));
r.push(_satellite.getVar('Video Duration'));
r.push(_satellite.getVar('Extension Version'));

return r.join('|');

Nesta página