Passar para o conteúdo principal

Como configurar o Pixel da Meta e o Google Analytics pelo GTM

Este guia mostra como configurar o rastreamento da sua loja Unbox começando do zero.

Na Unbox, o rastreamento é centralizado no Google Tag Manager (GTM). Você configura suas contas do GA4 e da Meta dentro do seu próprio container do GTM.


​

Importante: a Unbox não precisa receber os dados nem as credenciais das suas contas do GA4 ou do Pixel. Essas ferramentas são configuradas diretamente no seu Google Tag Manager.

Para que nossa equipe possa ajudar na configuração e validação das tags, conceda acesso ao seu GTM para manu.unboxonline@gmail.com.

Ao final da configuração, você terá:

  • um container próprio no Google Tag Manager;

  • uma propriedade do Google Analytics 4;

  • um Pixel da Meta;

  • o template de rastreamento da Unbox instalado no GTM;

  • os eventos de e-commerce configurados para Google Analytics e Meta.

Importante: você não precisa criar manualmente as tags do GA4 ou do Pixel. O arquivo de configuração da Unbox já contém essas tags.


Você precisará ter acesso a:

  • uma conta Google;

  • o Google Tag Manager;

  • o Google Analytics;

  • uma conta Meta Business;

  • o Gerenciador de Eventos da Meta;

  • o painel administrativo da sua loja Unbox.

Também tenha em mãos o arquivo:

GTM-UNBOX-Set26-v7.json
​

Se o arquivo que você recebeu tiver outro nome ou outra versão, confirme com a equipe da Unbox antes de fazer a instalação.


1. Criar sua conta no Google Tag Manager

Se você ainda não possui um Google Tag Manager:

  1. Entre com a conta Google que será utilizada para administrar o rastreamento da loja.

  2. Clique em Criar conta.

  3. Informe o nome da empresa ou da loja.

  4. Selecione o país.

  5. Crie um container para a sua loja.

  6. Em Plataforma de destino, selecione Web.

  7. Aceite os termos de serviço.

Depois de criar o container, você terá um ID parecido com:

GTM-XXXXXXX

Esse é o ID que será cadastrado na sua loja.

Importante: guarde esse ID. Você vai utilizá-lo na etapa 4.

2. Criar sua propriedade do Google Analytics 4

Se você ainda não possui uma propriedade do Google Analytics para a loja:

  1. Entre com a conta Google responsável pela mensuração da loja.

  2. Clique em Administrador.

  3. Selecione Criar propriedade.

  4. Informe o nome da loja.

  5. Configure o fuso horário e a moeda utilizados pela operação.

  6. Crie um fluxo de dados.

  7. Escolha Web.

  8. Informe o endereço da sua loja.

  9. Conclua a criação do fluxo.

Depois disso, o Google Analytics fornecerá um ID de medição, parecido com:

G-XXXXXXXXXX

Copie esse ID.

Você vai utilizá-lo posteriormente na variável GA4-ID do Google Tag Manager.

3. Criar o Pixel da Meta

Agora vamos criar o Pixel que será utilizado para medir as interações da loja na Meta.

  1. Acesse o Gerenciador de Eventos da Meta.

  2. Clique em Conectar fonte de dados.

  3. Escolha Web.

  4. Selecione Meta Pixel.

  5. Clique em Conectar.

  6. Informe um nome para o Pixel.

  7. Finalize a criação.

Depois de criar o Pixel, copie o ID do Pixel.

Ele será utilizado posteriormente na variável:

FB-Pixel-ID

Importante: neste processo, você precisa apenas do ID do Pixel.

Não instale manualmente o código base do Pixel no site. O código já está incluído no template da Unbox.

4. Cadastrar o Google Tag Manager na Unbox

Agora vamos conectar o container que você acabou de criar à sua loja.

No painel administrativo da Unbox:

  1. Acesse Personalização.

  2. Entre em SEO.

  3. Acesse Analytics e integrações.

  4. Abra Google Services.

  5. Informe o ID do seu container do Google Tag Manager.

Exemplo:

GTM-XXXXXXX


6. Salve a configuração.

Atenção: nesse campo você deve informar o ID do GTM, e não o ID do GA4 ou do Pixel.

5. Importar o template da Unbox

Agora vamos instalar a estrutura de rastreamento dentro do seu container.

  1. Acesse o Google Tag Manager.

  2. Abra o container que você criou para a loja.

  3. Acesse Administração.

  4. Clique em Importar container.

  5. Selecione o arquivo GTM-UNBOX-Set26-v6.json.

  6. Escolha o workspace que será utilizado.

  7. Em Opções de importação, selecione Mesclar.

  8. Se aparecer a opção para renomear itens conflitantes, mantenha essa opção selecionada.

  9. Confirme a importação.

Importante: não utilize Substituir, pois essa opção pode apagar configurações existentes no container.

6. Configurar o ID do Google Analytics

Depois de importar o arquivo:

  1. Acesse Variáveis no Google Tag Manager.

  2. Localize a variável GA4-ID.

  3. Abra a variável.

  4. Substitua o valor de exemplo pelo ID de medição que você copiou no Google Analytics.

Exemplo:

G-XXXXXXXXXX


5. Salve.

7. Configurar o ID do Pixel da Meta

Agora:

  1. Ainda em Variáveis, localize FB-Pixel-ID.

  2. Abra a variável.

  3. Substitua o valor de exemplo pelo ID do Pixel criado no Gerenciador de Eventos da Meta.

  4. Salve.

8. Não crie as tags do GA4 e do Pixel manualmente

Essa é uma mudança importante em relação à configuração antiga.

Você não precisa criar:

  • Google tag;

  • tags individuais do GA4;

  • código base do Pixel;

  • PageView da Meta;

  • tags individuais para cada evento de e-commerce.

Essas configurações já estão presentes no template importado.

Criar novamente essas tags pode fazer o mesmo evento ser enviado mais de uma vez.

9. Testar a configuração

Antes de publicar o container, faça um teste.

No Google Tag Manager:

  1. Clique em Visualizar.

  2. Informe o endereço da sua loja.

  3. Conecte o modo de visualização à loja.

  4. Navegue pela loja.

Faça pelo menos este percurso:

Página inicial → Produto → Carrinho → Checkout

Durante o teste, confira no Tag Assistant se cada momento da navegação gera o evento e as tags abaixo. Os nomes da coluna "Evento no Tag Assistant" são internos do template. No GA4, os eventos chegam com o nome da última coluna.

Momento

Evento no Tag Assistant

Tags que devem disparar

Nome no GA4

Página de produto

store_view_item

GA4 - View Item, FB - ViewContent

view_item

Carrinho

add_to_cart

GA4 - Add To Cart, FB - AddToCart

add_to_cart

Início do checkout

begin_checkout

GA4 - Begin Checkout, FB - InitiateCheckout

begin_checkout

Cada etapa do checkout

Exibição de página ou Alteração no histórico

GA4 - Checkout Step

checkout_step

Frete e pagamento

add_shipping_info, add_payment_info

GA4 - Add Shipping Info, GA4 - Add Payment Info

iguais

Pedido concluído

store_purchase

GA4 - Purchase, FB - Purchase

purchase

Atenção: se você procurar view_item ou purchase no Tag Assistant, não vai encontrar. Isso não é erro: procure por store_view_item e store_purchase.

10. Conferir o Google Analytics

Depois do teste no GTM:

  1. Acesse o Google Analytics.

  2. Abra Relatórios → Tempo real.

  3. Navegue pela loja ou faça uma compra de teste.

  4. Confira se os eventos estão chegando.

O evento de compra deve trazer informações como:

  • identificador do pedido;

  • valor;

  • frete;

  • cupom, quando aplicável;

  • forma de pagamento;

  • produtos.

11. Conferir o Pixel da Meta

No Gerenciador de Eventos da Meta, selecione o Pixel que você acabou de criar.

Faça uma navegação de teste na loja.

Verifique se os eventos aparecem.

Os principais eventos enviados pelo template são:

  • PageView;

  • ViewContent;

  • AddToCart;

  • InitiateCheckout;

  • Purchase.

O Pixel também possui eventID, que será importante caso você posteriormente configure a API de Conversões.

12. Publicar o container

Depois de confirmar que o teste está funcionando:

  1. Volte ao Google Tag Manager.

  2. Clique em Enviar.

  3. Informe um nome para a versão.

  4. Descreva, por exemplo:
    ​Configuração inicial do rastreamento Unbox

  5. Clique em Publicar.

A configuração estará ativa.

13. Configuração opcional: checkout_step

O template envia o parâmetro:

checkout_step

Ele permite analisar as etapas do checkout no Google Analytics.

Para disponibilizá-lo como dimensão personalizada:

  1. Acesse o Google Analytics.

  2. Entre em Administrador.

  3. Acesse Definições personalizadas.

  4. Crie uma dimensão personalizada.

  5. Informe checkout_step como parâmetro.

  6. Utilize escopo Evento.

  7. Salve.

Essa configuração é opcional.

14. Checklist final

Antes de considerar a instalação concluída, confira:

  • Conta do Google Tag Manager criada.

  • Container Web criado.

  • ID do GTM cadastrado na Unbox.

  • Propriedade GA4 criada.

  • ID de medição do GA4 copiado.

  • Pixel da Meta criado.

  • ID do Pixel copiado.

  • Arquivo da Unbox importado no GTM.

  • GA4-ID preenchido.

  • FB-Pixel-ID preenchido.

  • Nenhuma tag manual duplicando o GA4 ou o Pixel.

  • view_item testado.

  • add_to_cart testado.

  • begin_checkout testado.

  • purchase testado.

  • Eventos conferidos no GA4.

  • Eventos conferidos na Meta.

  • Container publicado.

Depois desses passos, sua estrutura básica de rastreamento estará configurada.

Para entender como os dados são gerados pela plataforma e transformados pelo template, consulte Como funciona o rastreamento da Unbox: container, dataLayer e eventos.


Já uso o arquivo antigo (Mar24-v4)

O arquivo novo tem itens com o mesmo nome dos antigos (por exemplo, GA4 - Config, GA4 - Purchase e a variável GA4-ID). Se você importar com renomear conflitantes, fica com as duas versões ativas: a loja passa a contar tudo em dobro, e a GA4-ID nova fica sem preencher.

  1. Na importação, selecione Mesclar e depois Substituir tags, acionadores e variáveis conflitantes.

  2. Preencha de novo a GA4-ID e preencha a FB-Pixel-ID. A substituição volta a GA4-ID para SUBSTITUIR.

  3. Exclua as tags que só existiam no arquivo antigo: FB - Pixel, FB - Page View, FB - View Content, FB - Add To Cart, FB - Begin Checkout, GA4 - DL - view_item, GA4 - DL - purchase, GA4 - DL - add_to_cart, GA4 - DL - begin_checkout e GA4 - DL - begin_checkout -- DOM.

  4. Exclua o acionador Click - AddToCart. Além de não ser mais necessário, ele registra no dataLayer o que o cliente digita no checkout.

  5. Exclua também tags do Universal Analytics e tags criadas à mão com o código do Pixel, PageView da Meta ou uma segunda tag do Google.

  6. Teste em Visualizar e confirme que cada evento dispara uma única vez.

BAIXAR ARQUIVO JSON

Respondeu à sua pergunta?