Rastreador de sinalização de vídeo personalizado: documentação da extensão 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 exclusivo 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