Integrações

Como conectar o Google Analytics (GA4)

Cadastre o ID de medição do GA4 e o player passa a enviar início, progresso, fim do vídeo e clique no checkout.

4 min de leitura

Assim como o Meta Pixel, o Google Analytics no VSL Max é configurado na conta e vale para todos os vídeos, inclusive os já publicados. O player envia os eventos de dentro da sua página de vendas, no navegador de quem assiste.

Antes de começar

  • Você precisa do ID de medição do GA4. Ele fica no Google Analytics em Administrador › Fluxos de dados e começa com G-. O antigo ID UA- não funciona.
  • O vídeo precisa estar na página pelo embed por script. No iframe o player não envia eventos.
  • Só administradores conseguem adicionar, pausar ou remover IDs.

Passo a passo

  1. Abra Configurações › Integrações.
  2. No cartão Google Analytics, clique em Conectar.
  3. Em Adicionar ID de medição, cole o ID (por exemplo G-ABC123XYZ). O nome é opcional.
  4. Clique em Adicionar.

Os vídeos publicados passam a enviar para esse ID sem trocar o código de embed.

Eventos que o player envia

  • video_start: quando a pessoa começa a assistir de verdade, fora da prévia muda do autoplay.
  • video_progress: aos 10, 25, 50, 75 e 90% do tempo real assistido, com o parâmetro video_percent.
  • video_complete: quando o vídeo termina.
  • begin_checkout: quando a pessoa clica num link que leva ao checkout da conversão vinculada ao vídeo.

Todos os eventos levam video_id, video_title, video_duration, video_current_time e video_provider com o valor vslmax. Cada marco sai uma vez por carregamento.

O player não envia page_view. Se a sua página já tem o gtag, ele usa o que está lá e não repete a configuração do mesmo ID. Se não tem, o script do Google só é carregado no primeiro evento, depois do primeiro play.

Para usar os parâmetros nos relatórios (por exemplo, quebrar por video_title), registre-os como dimensões personalizadas no GA4.

Como conferir no GA4

  1. Abra a sua página de vendas e dê play no vídeo.
  2. No GA4, abra o relatório Tempo real ou o DebugView.
  3. O video_start aparece logo depois do play. Os video_progress chegam conforme o vídeo avança.

Limites e cuidados

  • Até 3 IDs de medição por conta, sem repetir o mesmo ID.
  • Os números do GA4 não vão bater exatamente com o Analytics do VSL Max: bloqueadores, consentimento de cookies e regras de sessão do Google mudam a contagem. Para o desempenho do vídeo, a referência é o Analytics do dashboard. Veja Métricas de resultados.

Mais nesta seção