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:
Acesse o Google Tag Manager.
Entre com a conta Google que será utilizada para administrar o rastreamento da loja.
Clique em Criar conta.
Informe o nome da empresa ou da loja.
Selecione o país.
Crie um container para a sua loja.
Em Plataforma de destino, selecione Web.
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:
Acesse o Google Analytics.
Entre com a conta Google responsável pela mensuração da loja.
Clique em Administrador.
Selecione Criar propriedade.
Informe o nome da loja.
Configure o fuso horário e a moeda utilizados pela operação.
Crie um fluxo de dados.
Escolha Web.
Informe o endereço da sua loja.
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.
Acesse o Gerenciador de Eventos da Meta.
Clique em Conectar fonte de dados.
Escolha Web.
Selecione Meta Pixel.
Clique em Conectar.
Informe um nome para o Pixel.
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:
Acesse Personalização.
Entre em SEO.
Acesse Analytics e integrações.
Abra Google Services.
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.
Acesse o Google Tag Manager.
Abra o container que você criou para a loja.
Acesse Administração.
Clique em Importar container.
Selecione o arquivo
GTM-UNBOX-Set26-v6.json.Escolha o workspace que será utilizado.
Em Opções de importação, selecione Mesclar.
Se aparecer a opção para renomear itens conflitantes, mantenha essa opção selecionada.
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:
Acesse Variáveis no Google Tag Manager.
Localize a variável
GA4-ID.Abra a variável.
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:
Ainda em Variáveis, localize
FB-Pixel-ID.Abra a variável.
Substitua o valor de exemplo pelo ID do Pixel criado no Gerenciador de Eventos da Meta.
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:
Clique em Visualizar.
Informe o endereço da sua loja.
Conecte o modo de visualização à loja.
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 |
| GA4 - View Item, FB - ViewContent |
|
Carrinho |
| GA4 - Add To Cart, FB - AddToCart |
|
Início do checkout |
| GA4 - Begin Checkout, FB - InitiateCheckout |
|
Cada etapa do checkout | Exibição de página ou Alteração no histórico | GA4 - Checkout Step |
|
Frete e pagamento |
| GA4 - Add Shipping Info, GA4 - Add Payment Info | iguais |
Pedido concluído |
| GA4 - Purchase, FB - 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:
Acesse o Google Analytics.
Abra Relatórios → Tempo real.
Navegue pela loja ou faça uma compra de teste.
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:
Volte ao Google Tag Manager.
Clique em Enviar.
Informe um nome para a versão.
Descreva, por exemplo:
Configuração inicial do rastreamento UnboxClique 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:
Acesse o Google Analytics.
Entre em Administrador.
Acesse Definições personalizadas.
Crie uma dimensão personalizada.
Informe
checkout_stepcomo parâmetro.Utilize escopo Evento.
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-IDpreenchido.FB-Pixel-IDpreenchido.Nenhuma tag manual duplicando o GA4 ou o Pixel.
view_itemtestado.add_to_carttestado.begin_checkouttestado.purchasetestado.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.
Na importação, selecione Mesclar e depois Substituir tags, acionadores e variáveis conflitantes.
Preencha de novo a GA4-ID e preencha a FB-Pixel-ID. A substituição volta a
GA4-IDparaSUBSTITUIR.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_checkouteGA4 - DL - begin_checkout -- DOM.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.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.
Teste em Visualizar e confirme que cada evento dispara uma única vez.
