Fazer o rastreio do player do Youtube é possível graças a uma API que funciona com o iframe, ela nos permite manipular o player usando Javascript e o mais importante de tudo é que através de certas funções podemos coletar várias informações úteis do player, por exemplo, o seu estado de reprodução.
Requisitos:
Para trabalhar com a API do Youtube Iframe o primeiro é editar seus atributos para deixá-los dentro de um padrão exigido pela API, neste elemento vamos criar um id único caso o iframe não tenha e vamos adicionar o parâmetro “?enablejsapi=1” no final do atributo src:
Depois de termos a tag iframe cumprindo os requisitos para usar a API, inserimos o seguinte script no head:
As funções onYouTubeIframeAPIReady, onPlayerReady, onPlayerStateChange são chamadas automaticamente pela API, mas especificamente:
onPlayerStateChange: É disparado sempre que o estado do player for alterado, a propriedade data é alterada conforme esta função é executada, atribuindo determinados valores que representam o estado do player, no caso do código acima (data = 1) representa o player em reprodução.
onPlayerReady: É disparado sempre que um player terminar de carregar e estiver pronto para começar a receber chamadas de API.
onYouTubeIframeAPIReady: Será executada assim que o código API do player for baixado.
Exemplo:
Para exemplificar vamos usar este site, o objetivo é acionar a conversão após dar play num player específico, pois o site em questão possui vários:
Selecionamos o player para editar seu atributo src e criar um id único conforme explicado acima:
Após deixar o iframe dentro dos padrões exigidos pela API inserimos o script dentro do console para fazer o teste:
Após dar play no vídeo podemos ver que a conversão e a mensagem no console é disparada com sucesso!
Como uma alternativa mais simples à solução por gtag o GTM apresenta um método próprio para rastrear o player do Youtube, isto é possível graçãs ao trigger Youtube Video.
Requisitos:
Antes de trabalhar com este trigger, é importante ativar as variáveis incorporadas de vídeo:
Após ativá-las podemos trabalhar com mais flexibilidade com o trigger Youtube Video:
O trigger Youtube Video coleta dados dos players, por exemplo, se estão em reprodução, se estão pausados, a porcentagem de reprodução, etc.
Para trabalhar com este trigger sempre devemos ativar a opção “Add Javascript API support” ela adiciona o parâmetro “?enablejsapi=1” automaticamente no final de todos os atributos src dos iframes, nos poupando da parte de ter que editar eles manualmente como no método por Gtag.
Exemplo:
Para exemplificar vamos usar o mesmo site usado no tópico mostrando a solução por gtag, o objetivo é acionar uma conversão após dar play num player específico, pois o site em questão têm vários.
Antes de tudo ativamos as variáveis incorporadas de vídeo como mostrado acima pois o website possui vários players e para diferenciar um vídeo do outro vamos precisar da variável “Video Title”.
Após dar play vemos que a conversão é disparada com sucesso!
É possível rastrear este player graças ao SDK que trabalha com o iframe do Vimeo, nele encontramos diversas ferramentas para manipular o player e o mais importante, ele possui ferramentas que nos permitem ouvir eventos que são acionados de acordo com o comportamento do player.
Requisitos:
O primeiro a se fazer é inserir o seguinte script, ele nos permite acessar ao SDK do Vimeo player:
Depois inserimos este segundo script encarregado de acionar as conversões:
Após dar play vemos no console como as respectivas mensagens de cada vídeo são disparadas junto com sua respectiva conversão:
Funções Úteis:
Dependendo da situação precisaremos de diferentes acionadores para disparar a conversão do player, a seguir estão os principais:
Exemplo:
Vamos usar como exemplo este site, o objetivo é acionar uma conversão por GTM após iniciar a reprodução do player.
Neste exemplo, o código sofreu uma pequena mudança pois o seletor do iframe somente aparece após clicar neste botão:
HTML Personalizado:
Após dar play notamos que a conversão no preview foi disparada com sucesso!
Por último, mas não menos importante em situações muito raras podemos nos encontrar com o player clássico de vídeo gerado pela tag <video>, neste caso o código é ainda mais simples, pois podemos fazer o seu rastreio a través de eventos de vídeo como play ou pause: