Como instalar e validar o Google Tag Manager na Nuvemshop

A integração oficial do Google Tag Manager da Nuvemshop é destinada aos planos pagos e atualmente é uma integração básica. A central de ajuda, revisada em 29/07/2026, descreve eventos ecommerce nativos da plataforma, mas informa que a área ainda não inclui o módulo “Comércio eletrônico” no formato de integração ampliada. Leia as condições atuais da sua loja antes de planejar tags de compra.

Vincule o contêiner

1. No Google Tag Manager, crie ou selecione uma conta e um contêiner. Use plataforma de destino Web e copie o ID do contêiner no formato GTM-XXXXXXX no alto da área de trabalho.
2. Entre no painel administrativo da Nuvemshop e abra Configurações → Códigos externos → Google.
3. Cole o ID no campo ID do Google GTM e selecione Salvar alterações.
4. Se o campo não aparecer, confira se a loja está num plano pago e contate o suporte da Nuvemshop para pedir a liberação; não injete o snippet manual em tema ou código externo em paralelo sem confirmar como a integração oficial funciona.

Valide o contêiner e os eventos

1. No GTM, abra Visualizar. Informe a URL completa da loja com https:// e clique em Connect e depois Continue. Se usa domínio próprio, faça o teste nesse endereço; caso contrário use o domínio .lojavirtualnuvem.com.br.
2. A loja abrirá em nova aba. Navegue por busca, lista de produtos, detalhe, carrinho e início de checkout. Para compra real, use produto/pedido controlado que não gere cobrança/despacho acidental ou siga sandbox disponível no seu fluxo.
3. No Preview, confira se o contêiner conectou e observe os eventos recebidos. Compare o horário da navegação com a visão de Tag Assistant e DebugView do GA4.
4. A documentação Nuvemshop lista como eventos nativos search, view_item_list, select_item, view_item, add_to_cart, remove_from_cart, view_cart, begin_checkout, add_shipping_info, add_payment_info e purchase. Não crie outra tag para medir os mesmos eventos; isso pode duplicar dados. Para eventos customizados que não estão na lista, defina nome, parâmetros e acionador e valide separadamente.
5. As etapas de checkout podem ter restrições de segurança: a Nuvemshop diz bloquear certas variáveis JavaScript e tags HTML personalizadas na finalização. Não tente contornar o bloqueio por scripts injetados; consulte suporte/documentação da integração para os eventos permitidos.
6. Teste com consentimento aceito e recusado conforme sua política. Publique a versão do GTM só depois de conferir tags, gatilhos, duplicidade e as configurações de consentimento.

Adicione outras tags sem duplicar

Para instalar, por exemplo, um script de pesquisa/heatmap, vincule a tag ao contêiner da loja, configure o tipo e o acionador documentados pelo fornecedor e faça disparar somente nas páginas em que o serviço pode coletar. A Nuvemshop documenta o fluxo no próprio GTM: criar nova tag, adicionar o script, escolher o acionador apropriado, salvar e publicar. Não cole código em campos que a central não identifica.

Fontes oficiais: Instalar Google Tag Manager — Nuvemshop, adicionar scripts com GTM — Nuvemshop e Ajuda do Google Tag Manager. Consulte métricas.