Integração da GoAB com GA4

Introdução

Este manual vai te guiar, passo a passo, para integrar a GoAB (ferramenta de experimentação) com o Google Analytics 4 (GA4) utilizando o Google Tag Manager (GTM). Com essa integração, você poderá capturar e analisar os dados dos seus experimentos diretamente no GA4, facilitando a tomada de decisões baseadas em dados.

Para realizar as etapas abaixo é necessário ter o Google Tag Manager. Caso não tenha, veja como instalar aqui.

O evento GOAB no dataLayer

Com o script da GoAB instalado, não é preciso escrever nenhum código para enviar a variante ao GTM. Toda vez que um visitante entra em um experimento e recebe uma variante, a GoAB publica automaticamente este evento na camada de dados (dataLayer) da página, antes de aplicar a variante:

{ event: "GOAB", GOAB: "GOAB:exp-<id do experimento>:<id da variante>" }

• event — sempre GOAB. É ele que aciona o trigger do GTM.
• GOAB — identifica o experimento e a variante que o visitante recebeu. Exemplo: GOAB:exp-123:2 é o experimento 123, variante 2.

O evento é enviado uma vez por visitante em experimento, a cada carregamento da página em que o experimento é avaliado. Visitantes fora do experimento não disparam o evento.

Atenção: se o seu time já criava esse dataLayer.push manualmente no código das variantes, remova-o ao adotar esta integração — caso contrário o evento chegará duplicado no GA4.

1. Configurando a Variável de Camada de Dados no GTM

Passo 1: Acessando o Google Tag Manager

1. Acesse sua conta no Google Tag Manager.
2. Selecione o contêiner do site onde deseja configurar a integração.
3. No menu lateral esquerdo, clique em "Variáveis".
4. Clique em "Nova" para criar uma nova variável.

Passo 2: Selecionando o tipo da variável

1. Na gaveta que foi aberta, dê um nome para a variável.
2. Em seguida clique em configurar variável.
3. Escolha o tipo da variável clicando em "Variável da camada de dados".

Passo 3: Configuração da variável

1. Dê um nome para o campo nome da variável da camada de dados: GOAB. Ele deve ser exatamente igual à chave GOAB do evento acima; assim a variável passa a valer, por exemplo, GOAB:exp-123:2.
2. Em seguida clique em salvar.

2. Criando a Tag de Evento do GA4 para GoAB

Passo 1: Acessando a Seção de Tags

1. No painel principal do GTM, clique em "Tags" no menu lateral esquerdo.
2. Clique em "Nova" para criar uma nova tag.
3. Nomeie a tag como "GoAB GA4 Push", dependendo da configuração que deseja realizar.
4. Clique em "Configurações da Tag".
5. Escolha o tipo de tag, clicando em "Google Analytics".
6. Em seguida, selecione "Google Analytics: evento do GA4".

Passo 2: Configurando a Tag de Evento GA4

1. Insira o ID da métrica correspondente ao seu GA4.
2. Defina um Nome do Evento como "GOAB" e clique em adicionar parâmetros.
3. Adicione um parâmetro chamado "goab_uuid" e/ou configure o valor como {{GOAB}}. Esses parâmetros permitem rastrear as variações e impressões do experimento GoAB no GA4, proporcionando insights detalhados sobre o comportamento do usuário.

Passo 3: Definindo o Acionamento (Trigger)

1. Clique em "Acionamento".
2. Selecione o trigger chamado "Evento GoAB". Se ele ainda não existir, crie um novo: clique em "+", nomeie como "Evento GoAB", escolha o tipo Evento personalizado, digite GOAB em "Nome do evento" (sem regex) e mantenha "Todos os eventos personalizados".
3. Clique em salvar. O acionador garante que a tag seja disparada no momento certo, como quando um usuário interage com uma variação do experimento GoAB.

3. Finalizando a Configuração

Passo 1: Salvando a Tag

1. Após configurar a tag e o acionamento, clique em "Salvar" no canto superior direito.
2. Volte ao painel principal do GTM e clique em "Enviar" para publicar as alterações feitas.

4. Conferindo se está funcionando

1. Abra o seu site em uma página que tenha um experimento ativo.
2. Abra o console do navegador e execute dataLayer.filter(e => e.event === 'GOAB'). Deve aparecer um item como { event: "GOAB", GOAB: "GOAB:exp-123:2" }.
3. No GTM, use o modo Visualizar: o evento "GOAB" deve aparecer na lista à esquerda, com a tag "GoAB GA4 Push" disparada.
4. No GA4, o evento GOAB chega em Relatórios em tempo real com o parâmetro goab_uuid.

Importante: o evento GOAB só é enviado quando o visitante acessa o site normalmente. O modo de pré-visualização (preview) aplica a variante para você revisar o visual, mas não envia o evento ao dataLayer — para testar a integração com o GA4, acesse o site sem o preview.