Visão geral da extensão de rastreamento de vídeo do YouTube
Pré-requisitos
Cada propriedade de tag da Adobe Experience Platform 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
Use o trecho de código "Incorpore um player usando uma tag <iframe>" dos documentos de desenvolvedor do Google 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.1, 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 e rel=0 ao final do valor de atributo src, se ainda não estiver incluído. 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>
Essa extensão também foi projetada para verificar dinamicamente se há um valor de atributo de identificador exclusivo, como player1, independendemente de os parâmetros de string de consulta enablejsapi e rel existirem e de os respectivos valores esperados estarem 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 string de consulta enablejsapi e rel estão ou não incluídos.
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 de tag.
- 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 em 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
Uma regra de tag pode ser definida para cada evento de vídeo (os sete eventos listados acima). Crie uma regra específica de tag para cada evento que desejar rastrear. Caso não queira rastrear um evento, bastará omitir a criação de uma regra para ele.
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 de "Nome do Link".
- Limpar variáveis: limpe as variáveis do Adobe Analytics.
Exemplo de regra de tag para "Início do vídeo"
Os objetos de extensão de vídeo a seguir 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 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", seguido da ação "Limpar variáveis".
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('|');
Para obter mais informações sobre como criar e aproveitar elementos de dados com eficiência na Platform, leia a documentação dos elementos de dados.