Pular para o conteúdo
ShelfFlow ShelfFlow

Setup Nuvemshop + GTM

Este guia cobre todo o processo de integracao: desde a instalacao do app ate as prateleiras aparecendo na loja.

Pre-requisitos

Seção intitulada “Pre-requisitos”

Parte 1: Instalar o ShelfFlow

Seção intitulada “Parte 1: Instalar o ShelfFlow”
  1. Acesse shelfflow.com.br e clique em Comecar gratis
  2. Informe seu email e complete o cadastro
  3. Na tela de onboarding, clique em Instalar na Nuvemshop
  4. Autorize o app na tela de permissoes da Nuvemshop
  5. Voce sera redirecionado de volta ao ShelfFlow

Parte 2: Criar sua primeira prateleira

Seção intitulada “Parte 2: Criar sua primeira prateleira”
  1. No painel do ShelfFlow, clique em Nova Prateleira
  2. Preencha o titulo (ex: “Mais Vendidos”)
  3. Selecione os produtos via curadoria manual ou categoria
  4. Escolha a posicao (ex: “Apos o banner”)
  5. Salve a prateleira

Parte 3: Configurar o Google Tag Manager

Seção intitulada “Parte 3: Configurar o Google Tag Manager”

O GTM e o metodo de injecao das prateleiras na sua loja. Ele carrega o script do ShelfFlow automaticamente em todas as paginas.

3.1 Criar o container GTM (se ainda nao tem)

Seção intitulada “3.1 Criar o container GTM (se ainda nao tem)”
  1. Acesse tagmanager.google.com
  2. Clique em Criar conta
  3. Preencha o nome da conta (nome da sua loja)
  4. Crie um container do tipo Web
  5. Copie o codigo de instalacao (dois snippets: <head> e <body>)

3.2 Instalar o GTM na Nuvemshop

Seção intitulada “3.2 Instalar o GTM na Nuvemshop”
  1. No admin da Nuvemshop, va em Configuracoes > Codigos externos
  2. Cole o snippet do <head> no campo Header
  3. Cole o snippet do <body> no campo Inicio do body
  4. Salve

3.3 Importar a tag do ShelfFlow no GTM

Seção intitulada “3.3 Importar a tag do ShelfFlow no GTM”

Durante o onboarding, o ShelfFlow fornece um arquivo de configuracao do GTM pronto para importar. Esse arquivo contem a tag com o script da sua loja.

Backup do GTM (recomendado)

Seção intitulada “Backup do GTM (recomendado)”

Antes de importar, faca um backup do seu container:

  1. No GTM, va em Administrador (engrenagem no topo)
  2. Na coluna do container, clique em Exportar container
  3. Selecione a versao mais recente e clique em Exportar
  4. Salve o arquivo JSON no seu computador

Importar o arquivo do ShelfFlow

Seção intitulada “Importar o arquivo do ShelfFlow”
  1. No onboarding do ShelfFlow, faca o download do arquivo GTM
  2. No GTM, va em Administrador (engrenagem no topo)
  3. Na coluna do container, clique em Importar container
  4. Selecione o arquivo baixado do ShelfFlow
  5. IMPORTANTE: Escolha a opcao Mesclar (Merge) — isso adiciona a tag do ShelfFlow sem apagar suas tags existentes
  6. Selecione Renomear tags conflitantes se solicitado
  7. Confirme a importacao
  8. Volte para o Espaco de trabalho, revise as alteracoes e clique em Enviar para publicar

3.4 Verificar a instalacao

Seção intitulada “3.4 Verificar a instalacao”
  1. Acesse a homepage da sua loja
  2. As prateleiras devem aparecer nas posicoes configuradas
  3. Se nao aparecerem, use o modo preview do GTM para debugar

Solucao de problemas

Seção intitulada “Solucao de problemas”
ProblemaSolucao
Prateleiras nao aparecemVerifique se o GTM esta publicado e o script esta correto
Produtos nao carregamVerifique se a loja esta conectada no painel ShelfFlow
Posicao erradaTente outra posicao ou use um seletor CSS customizado
So funciona no previewCertifique-se de ter clicado Enviar no GTM