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

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.

A extensão versão 1.0.1 é compatível com 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 iframe e anexando ?enablejsapi=1 ao final do valor do atributo src. Por exemplo:

<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>

Como a extensão adiciona dinamicamente o campo id e o parâmetro de sequência de consulta enablejsapi=1 ao iFrame, não os adicione manualmente ao iFrame.

Em páginas com mais de um vídeo, observe que cada vídeo usa o mesmo conjunto de configurações na regra do Platform 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á cinco 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.

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). É necessário criar uma regra específica para cada evento que você 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 não é possível usar várias eVars ou props para cada elemento de vídeo, os valores do elemento de dados podem ser concatenados no Platform Launch, analisados em relatórios de classificação usando a ferramenta Construtor de regras de classificação, conforme explicado em https://docs.adobe.com/content/help/pt-BR/analytics/components/classifications/classifications-rulebuilder/classification-rule-builder.html, e 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'));

return r.join('|');

Nesta página

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now