Pular para o conteúdo principal

Integração de rastreamento manual com o Google Tag Manager

Última atualização em 02 de set. de 20266 min de leitura
important

Estas instruções aplicam-se a contas que configuraram o seu rastreamento antes de 11.02.2025. Se a tua conta já tem uma configuração de rastreamento, tudo permanece como está - não são necessárias alterações.

Se ainda assim quiseres usar o novo switch Tracking setup? Descobre como aqui: Migração para o Tracking Setup Wizard

Em resumo​

No Tracking Setup Wizard, tens a opção de realizar a configuração manualmente através do Google Tag Manager (GTM). Isto requer que sejam feitos ajustes no GTM para que os dados do experimento sejam enviados para o GA4.

Este guia mostra-te passo a passo como configurar corretamente o Google Tag Manager.

important

Importante para Shopify: Se o Google Tag Manager for integrado através de um Shopify Custom Pixel, deve ser seguida a seguinte integração de tracking: Shopify Custom Pixel Integration via Google Tag Manager

Configuração do Tracking Setup Wizard​

Se selecionares a integração manual do Analytics através do Google Tag Manager (GTM) no Tracking Setup Wizard, são necessários ajustes adicionais no GTM. Sem estes ajustes, nenhum evento de tracking será enviado para o Google Analytics.

Tracking Setup com todos os três passos do wizard marcados, Google Tag Manager em „Yes“ e envio de dados definido como „Manually“.

Passo 1: Configuração no Google Tag Manager​

1. Criação de uma nova variável de data layer (VA Short)​

Esta variável é usada para fornecer a uma tag a informação do teste A/B.

  1. Cria uma nova variável: "Variables" > "New"
  2. Tipo de variável -> "Data Layer Variable"
  3. Data Layer Variable Name -> varify_abTestShort (ortografia obrigatória)
  4. Dá um nome à variável -> VA Short
Variável do Google Tag Manager „VA Short“ do tipo Data Layer Variable, a ler varify_abTestShort.

2. cria um novo trigger (Varify.io - Event)​

O trigger é o evento decisivo que despoleta o envio de dados para o sistema de Analytics.

  1. Nome do trigger: ex.: "Varify.io - event"
  2. Tipo de trigger: "User-defined event"
  3. Nome do evento: varify (ortografia obrigatória)
Trigger do Google Tag Manager „Varify.io – event“: evento personalizado com o nome de evento varify, disparado em todos os eventos personalizados.

3. criação de uma nova tag GTM (Varify.io - GA4 Tracking Linker)​

Tags são trechos de código que enviam os valores armazenados nas variáveis para a tua ferramenta de análise, como o Google Analytics. Agora cria uma tag para enviar os valores da variável criada para o Google Analytics.

  1. Nome da tag: "Varify.io - GA4 Tracking Linker"
  2. Tag de configuração: [usa a tua tag GA4 existente].
  3. Nome do evento: ex.: "Abtesting"
  4. Nome do parâmetro: varify_abTestShort (ortografia obrigatória)
  5. Valores: {{VA Short}} (a variável criada no passo 1)
  6. Trigger: "Varify.io - event" (o trigger criado no passo 2)
Tag de evento GA4 „Varify.io – GA4 Tracking Linker“ com o nome do evento Abtesting, o parâmetro varify_abTestShort definido como {{VA Short}} e o evento Varify como trigger.

4. publicar o contêiner do GTM​

Para garantir que os teus ajustes no Google Tag Manager também funcionem no teu site, é importante publicar as alterações.

Para isso, vai a "Overview" no Tag Manager, à esquerda. Aqui podes ver uma visão geral de todos os elementos que acabaste de criar.

Para publicar, clica no botão azul "Publish" no canto superior direito e confirma. A tag agora está ativa e envia os dados para o teu Google Analytics.

Workspace do Google Tag Manager com o botão «Submit» destacado.

Passo 2: Transmitindo os dados para o GA4​

Enviando dados com consentimento do usuário​

Você pode enviar os dados do experimento para o GA4 com ou sem o consentimento do usuário. Se o Google Analytics 4 já envia dados apenas via User Consent, você também deve enviar os dados do Varify apenas via User Consent. Você pode descobrir como isso funciona aqui: Enviando dados com consentimento do usuário

Enviando dados sem consentimento do usuário​

As etapas a seguir descrevem como enviar os dados para o GA4 sem o consentimento do usuário.

1ª configuração: Start Tracking on Activation Event​

Em «Advanced Setup», você encontrará a configuração «Start Tracking on Activation Event», que está ativada por padrão.

  • «Enabled (default)»: os eventos de tracking do Varify só são enviados ao data layer após a execução do «Activate Tracking Script». Isso garante que os eventos sejam enviados somente depois que a configuração do GA4 estiver completa e evita sessões «Not Set». «Importante»: o «Activate Tracking Script» deve ser armazenado como uma tag HTML personalizada no GTM. Sem esse script, nenhum evento será enviado ao GA4. Para isso, siga as etapas 2–4 das instruções do GTM.
  • «Disabled»: os eventos são gravados no data layer imediatamente quando a variante é carregada. Isso pode fazer com que nem todos os usuários sejam registrados corretamente no GA4 caso a configuração do GA4 ainda não tenha sido totalmente carregada.

Além disso, quando «Start Tracking on Activation Event» está ativado, a opção «Keep users in variation» é exibida. Se ativada, os usuários sem um «Tracking Activation Script» executado são armazenados no «Session Storage», o que significa que eles veem a mesma variação durante a sessão. Após a execução do script, a informação é transferida do «Session Storage» para o «Local Storage» e o usuário é atribuído permanentemente a uma variante. Essa opção deve ser usada especialmente se, por exemplo, for possível navegar pelo site sem precisar interagir com o banner de cookies, já que os usuários permanecem permanentemente atribuídos à variante inicialmente designada durante a sessão, mesmo sem consentir com o banner de cookies.

Advanced Setup com „Start Tracking on Activation Event“ e „Keep users in variation“ ativados.

2. criar uma nova tag HTML personalizada no GTM​

  1. Vá até Tags no Google Tag Manager e clique em New. Agora crie aqui uma nova tag HTML personalizada.
  2. Nomeie a tag: "Varify Activate Tracking"
  3. Cole o seguinte código no campo HTML:
  4. Salve a tag. Confirme que a tag deve ser salva sem um trigger.
<script>
if (window.varify && typeof window.varify.setTracking === 'function') {
window.varify.setTracking(true);
} else {
window.addEventListener('varify:loaded', function () {
window.varify.setTracking(true);
});
}
</script>
important

Desde 29.10.2025, utilizamos um Activate Tracking Script atualizado.
No entanto, todos os scripts implementados anteriormente permanecem válidos e continuam a funcionar sem qualquer ajuste.

Tag HTML personalizada „Varify Activate Tracking“ chamando window.varify.setTracking(true), com um fallback no evento varify:loaded.

3. personalizar a tag de configuração do Google Tag​

  1. Agora vá até a sua tag de configuração do GA4 e abra-a. Nota: A forma mais fácil de encontrá-la é navegar até suas tags e pesquisar por "Google Tag" com Ctrl+F
Lista de tags no Google Tag Manager; a pesquisa marca „Google Tag“ como o tipo da tag de Config do GA4.
  1. Clique na área de Tag Configuration e selecione Advanced Settings e Tag Sequencing.
    1. agora clique em "Fire a tag after GA4 Config (The GA4 config tag) fires"
  2. Selecione a tag Varify Active Tracking que você acabou de criar.
  3. Clique na marca de seleção abaixo de "Don't fire Varify Activate Tracking if GA4 Config fails or is paused"
  4. Salve a personalização da tag
Tag de configuração do GA4, Configurações avançadas: o sequenciamento de tags dispara "Varify Activate Tracking" após o tag de configuração, e não dispara se o tag de configuração falhar.

4. publicar o contêiner do GTM​

Para garantir que os teus ajustes no Google Tag Manager também funcionem no teu site, é importante publicar as alterações.

Para fazer isso, vai a "Overview" no Tag Manager, à esquerda. Aqui podes ver uma visão geral de todos os elementos que acabaste de criar.

Para publicar, clica no botão azul "Publish" no canto superior direito e confirma. O tag está agora ativo e envia os dados para o teu Google Analytics.

Workspace do Google Tag Manager com o botão «Submit» destacado.

Etapa 3: Configurar uma dimensão personalizada no GA4​

important

AVISO IMPORTANTE: A dimensão personalizada só precisa de ser criada manualmente se a tua conta Varify não for conectada ao Google Analytics 4 através do Google Authenticator.

Etapa 3 do assistente com «Only in GA4» selecionado.

Por fim, é necessário criar uma dimensão personalizada no Google Analytics. Procede da seguinte forma:

  1. Abre as tuas definições do GA4 e seleciona a opção de menu «Custom Definitions»
Área de administração do GA4 com «Custom definitions» selecionado em Data display.
  1. Cria uma nova dimensão personalizada («Create custom dimension»)
  2. Escolhe um nome para a dimensão: Varify AB Test (ortografia obrigatória)
  3. Seleciona o parâmetro de evento: varify_abTestShort (certifica-te de que introduzes o parâmetro de evento na notação correta).
Dimensão personalizada «Varify AB Test» no GA4, com âmbito de evento, a ler o parâmetro varify_abTestShort.
important

Aviso Importante: Só poderás selecionar o parâmetro de evento "varify_abTestShort" na definição definida pelo utilizador assim que o GA4 tiver recebido os primeiros dados de teste. Depois disso, pode demorar até 24 horas até encontrares o valor na lista pendente. Ainda podes inserir o parâmetro manualmente, mas certifica-te de que usas a grafia correta.

Exibir os dados do teste A/B no Varify.io​

Com a Ligação Google Analytics 4 do Varify.io, podes exibir facilmente os teus resultados diretamente no teu painel do Varify.io. Podes descobrir como fazer isto aqui: Para a avaliação de resultados no Varify.io

Visualizar os dados do teste A/B no GA4​

Podes analisar os dados das variações do teu teste A/B no GA4 com a Análise Exploratória de Dados. Podes encontrar mais informações aqui: Para avaliar os resultados no GA4