Configuração Nuvemshop + GTM

Este guia cobre todo o processo de integração: desde a instalação do aplicativo até as prateleiras aparecendo na loja.

Pré-requisitos

Loja ativa na Nuvemshop com tema clássico
Conta no Google Tag Manager (gratuita)
Conta no ShelfFlow (crie em shelfflow.com.br)

Parte 1: Instalar o ShelfFlow

Acesse shelfflow.com.br e clique em Começar grátis
Informe seu e-mail e complete o cadastro
Na tela de ativação, clique em Instalar na Nuvemshop
Autorize o aplicativo na tela de permissões da Nuvemshop
Você será redirecionado de volta ao ShelfFlow

Parte 2: Criar sua primeira prateleira

No painel do ShelfFlow, clique em Nova Prateleira
Preencha o título (ex: “Mais Vendidos”)
Selecione os produtos via curadoria manual ou categoria
Escolha a posição (ex: “Após o banner”)
Salve a prateleira

Parte 3: Configurar o Google Tag Manager

O GTM é o método de inserção das prateleiras na sua loja. Ele carrega o código do ShelfFlow automaticamente em todas as páginas.

3.1 Criar o contêiner GTM (se ainda não tem)

Acesse tagmanager.google.com
Clique em Criar conta
Preencha o nome da conta (nome da sua loja)
Crie um contêiner do tipo Web
Copie o código de instalação (dois trechos: <head> e <body>)

3.2 Instalar o GTM na Nuvemshop

No admin da Nuvemshop, vá em Configurações > Códigos externos
Cole o trecho do <head> no campo Header
Cole o trecho do <body> no campo Início do body
Salve

3.3 Importar a tag do ShelfFlow no GTM

Durante a ativação, o ShelfFlow fornece um arquivo de configuração do GTM pronto para importar. Esse arquivo contém a tag com o código da sua loja.

Cópia de segurança do GTM (recomendado)

Antes de importar, faça uma cópia de segurança do seu contêiner:

No GTM, vá em Administrador (engrenagem no topo)
Na coluna do contêiner, clique em Exportar contêiner
Selecione a versão mais recente e clique em Exportar
Salve o arquivo JSON no seu computador

Importar o arquivo do ShelfFlow

Na ativação do ShelfFlow, baixe o arquivo GTM
No GTM, vá em Administrador (engrenagem no topo)
Na coluna do contêiner, clique em Importar contêiner
Selecione o arquivo baixado do ShelfFlow
IMPORTANTE: Escolha a opção Mesclar (Merge) — isso adiciona a tag do ShelfFlow sem apagar suas tags existentes
Selecione Renomear tags conflitantes se solicitado
Confirme a importação
Volte para o Espaço de trabalho, revise as alterações e clique em Enviar para publicar

3.4 Verificar a instalação

Acesse a página inicial da sua loja
As prateleiras devem aparecer nas posições configuradas
Se não aparecerem, use o modo de prévia do GTM para investigar

Solução de problemas

Problema	Solução
Prateleiras não aparecem	Verifique se o GTM está publicado e o código está correto
Produtos não carregam	Verifique se a loja está conectada no painel ShelfFlow
Posição errada	Tente outra posição ou use um seletor CSS customizado
Só funciona na prévia	Certifique-se de ter clicado Enviar no GTM