Este tutorial orienta agências parceiras a configurar corretamente lojas Nuvemshop, garantindo rastreamento confiável, campanhas eficientes e integrações estáveis com GA4, Google Ads, GTM e Google Shopping.
Princípios gerais
- Prefira as integrações nativas da Nuvemshop para GA4, Google Ads e Google Shopping (maior estabilidade, precisão e suporte oficial).
- Não duplique integrações (ex.: GA4 nativo + GA4 via GTM ao mesmo tempo).
- Evite códigos externos que repliquem eventos já enviados pela Nuvemshop.
- Teste o funil no Tag Assistant (view_item, add_to_cart, begin_checkout, purchase).
- No GA4, marque apenas o evento purchase como conversão principal (evita contagens duplicadas).
- Entenda diferenças de cancelamentos e refunds entre GA4 e Nuvemshop (datas e contagem de transações).
Helpjuice Warning Callout Title
Atenção sobre refunds e compras.
O GA4 pode retirar a receita na data do refund, mas ainda considera a compra no total de transações; já a Nuvemshop trata cancelamentos pela data da compra. Isso explica variações entre relatórios.
Configurar os produtos Google
1. Google Analytics 4 (GA4)
- Instalar via campo nativo no admin (Configurações > Códigos externos).
- Preencher ID GA4 (G-XXXXXXX) e chave secreta da API do Measurement Protocol.
- Ativar Medição Aprimorada para capturar cliques e rolagens.
- Usar apenas um ID GA4 ativo.
- Marcar purchase como conversão principal no GA4.
- Validar instalação via Relatório em Tempo Real + Tag Assistant.
- Verificar se o disparo de purchase na Nuvemshop está configurado para confirmação de compra ou finalização de compra (Configurações > Códigos externos).
- Definir a Identidade do relatório como “Baseada no dispositivo” para evitar perda de dados.
Se precisar, confira o nosso tutorial de configuração do GA4:
2. Google Ads
- Se o GA4 está vinculado ao Ads → Não usar integração nativa da Nuvemshop.
- Se já possuir Integração nativa Nuvemshop com Ads → Não vincular GA4 ao Ads.
-
Nunca duplicar fontes (Ads via GA4 + Ads via integração Nuvemshop).
- Verificar se os eventos de conversão estão disparando no Tag Assistant (disparo e parâmetros).
- Conferir se há apenas uma tag Ads ativa (nativa ou via GA4).
-
Não adicione códigos do Ads nos códigos externos da Nuvemshop ou no GTM se já tiver uma integração feita.
- Lembre-se que o Ads apenas mostra conversões advindas de anúncios Ads.
Se estiver utilizando a integração nativa do Google Ads, é importante validar alguns pontos adicionais:
- Em Administrador > Acesso e segurança > Usuários, confirme se o e-mail utilizado para o OAuth (autenticação com a Nuvemshop) está listado corretamente.
- Em Objetivos > Resumo, dentro do objetivo Compras, verificar se aparecem duas Conversion Actions:
- Nuvemshop Backend purchases e Nuvemshop Website purchases; ou
-
Tiendanube Backend purchases e Tiendanube Website purchases (dependendo do país da loja).
Helpjuice Warning Callout Title
Datas de conversão no Ads.
Na seção Objetivos > Conversões > Resumo, o Google Ads exibe as conversões pela data do clique (e não da compra), isso pode gerar diferenças de alguns dias.
Para visualizar as conversões pela data real da compra, é necessário gerar um Relatório personalizado no Google Ads. O processo é simples e pode ser configurado diretamente no painel de relatórios da ferramenta.
Se precisar, confira o nosso tutorial de configuração do Google Ads:
3. Google Tag Manager (GTM)
- Usar apenas se necessário (ex.: capturar cliques em WhatsApp, formulários, eventos customizados).
-
Evitar duplicar tags e eventos já enviadas nativamente pela Nuvemshop.
- Documentar todas as tags ativas no container.
- Testar alterações sempre no Preview Mode antes de publicar.
- Evitar tags de terceiros que causem conflito (⚠ RD Station é um caso comum).
- Alguns códigos podem sobrescrever o Datalayer da Nuvemshop. Verifique se funciona corretamente após adição de códigos.
Helpjuice Info Callout Title
Uma opção é: caso utilize muitos eventos customizados no GTM, não usar a integração nativa da Nuvemshop com o Ads, principalmente se notar que eventos personalizados não chegam ao Ads. O Google aponta que, em algumas situações, a integração por GTM é necessária para o funcionamento da medição.
Se precisar, confira o nosso tutorial de configuração do GTM:
4. Google Shopping / Merchant Center
- Usar a integração nativa da Nuvemshop (API) e manter apenas uma fonte de dados.
- Conferir se os produtos possuem campos obrigatórios preenchidos (MPN, faixa etária, sexo, categoria Google Shopping, GTIN, preço, uma imagem no mínimo) e as categorias possuem taxonomias Google. Veja como configurar:
- Se houver descontos por forma de pagamento, crie regras no Merchant Center para evitar erros de preço (o anúncio pode ser bloqueado).
-
❗ Produtos ocultos não são sincronizados.
-
❗ Produtos ocultos não são sincronizados.
- No Google Merchant Center, é importante validar o acesso: clique no ícone de engrenagem e acesse a seção Pessoas e acesso.
- Verifique se o e-mail utilizado no momento da autenticação (OAuth) com a Nuvemshop está listado.
- Caso o e-mail não apareça, a integração não funcionará corretamente.
- Em migrações, revise o feed (o histórico de itens se perde).
- Nossa solução não aproveita itens já existentes no Merchant Center antes da integração.
- A Nuvemshop cria novos itens no Merchant Center com base nas variantes cadastradas na loja (ex.: cor, tamanho).
Se precisar, confira o nosso tutorial de configuração do GTM:
📝 Como vincular a Nuvemshop com o Google shopping e o Google Ads?
5. Testes e validações
- Fazer uma compra teste e valide eventos no Tag Assistant (do view_item ao purchase).
- Conferir que há uma tag ativa por integração (evita duplicidade).
-
Comparar GA4 × Nuvemshop: é importante ter números próximos – diferenças moderadas podem ocorrer (janelas, refunds/cancelamentos, local do disparo do purchase).
- Uma diferença esperada é normalmente de até 10%.
- Uma diferença esperada é normalmente de até 10%.
- Validar campanhas no Ads após migração (especialmente Performance Max e campanhas baseadas em feeds).
6. Erros comuns a evitar
- Instalar GA4 nativo e via GTM simultaneamente.
- Manter scripts duplicados em Códigos externos.
- Vincular o Ads ao GA4 e manter a integração nativa do Ads ativa (gera duplicidade).
- Não revisar o catálogo no Merchant Center após migração.
- Após a integração, o catálogo pode levar alguns minutos para aparecer por completo, principalmente em lojas com muitas variantes de produto.
- Mesmo após sincronizado, os itens ainda precisam passar pelo processo de aprovação do Google, o que pode levar até alguns dias (aprovações podem levar ≥ 72h).
- Usar gatilhos genéricos no GTM (ex.: All Pages para purchase).
Checklist final para Agências
✔️ GA4 configurado via integração nativa (ID + chave API).
✔️ Apenas 1 tag GA4 ativa.
✔️ Apenas o evento purchase marcado como conversão principal.
✔️ Integração Ads definida (GA4 → Ads OU Nuvemshop → Ads, nunca ambas).
✔️ GTM usado apenas para eventos customizados, sempre sendo testados.
✔️ Merchant Center conectado via API da Nuvemshop.
✔️ Campos obrigatórios preenchidos no feed.
✔️ Teste completo de funil com Tag Assistant realizado.
✔️ Comparação de dados GA4 × Nuvemshop validada.
Informações adicionais
✔️ Valide o total de compras no GA4: ao analisar relatórios, lembre-se que o GA4 contabiliza refunds como parte das transações. Para ver apenas compras reais, utilize o evento purchase (marcado como único evento principal).
✔️ Use a função “Analisar” do GA4 para:
-
Obter listas detalhadas de compras e refunds.
- ❗ Importante: o refund sempre será enviado para purchases disparados na finalização do checkout em caso de cancelamento. Se o evento purchase estiver configurado para ocorrer apenas na confirmação de pagamento, o refund só será enviado quando o pedido for efetivamente pago.
- O Google reconhece o evento de refund por até 3 dias após a compra; depois desse prazo normalmente o GA4 ignora o evento e não o vincula ao pedido original.
- Criar relatórios personalizados, conforme a necessidade do cliente. Verifique as regras de negócio dele.
✔️ No painel principal do GA4, filtre por evento principal e marque apenas o purchase. Isso ajuda na filtragem de compras por evento principal.
✔️ Cheque a configuração da tag: em Fluxo de dados → Definir configurações da tag, confirme se a tag GA4 está apontando apenas para ela mesma. Somente nesse caso é recomendada a integração nativa.
E se eu quiser configurar tudo pelo GTM?
É possível, mas os eventos serão capturados apenas pelo frontend enquanto a página estiver aberta.
- Se o purchase estiver configurado para disparar somente após a confirmação de pagamento, e o cliente fechar a página antes disso, o evento não será capturado pelo GTM.
- Além disso, não receberá eventos de refund, pois são por backend.
Helpjuice Info Callout Title
Recomendamos consultar também os tutoriais com mais dicas e detalhes sobre o funcionamento dos produtos Google:
👉 Como funcionam juntos Google Analytics, Ads e Tag Manager?
👉 Quais os riscos de usar o Google Ads, Google Analytics e Google Tag Manager juntos na minha loja?
Pronto!
Com estes passos, sua agência configura as integrações da loja com segurança e eficiência, evitando duplicidades e garantindo dados confiáveis para decisões melhores.