Instalar o script pelo Google Tag Manager
Crie uma tag HTML personalizada, teste em modo de visualização e publique — o caminho de Bagy, Wbuy, VNDA, Wake, Nuvemshop e Loja Integrada.
O Google Tag Manager deixa você instalar o script sem mexer no código da loja: você cria uma tag com o código da Bevean, testa em modo de visualização e só depois publica. É o caminho de Bagy, Wbuy, VNDA, Wake, Nuvemshop e Loja Integrada — e a primeira metade da instalação da VTEX.
Ao final, a tag da Bevean dispara em todas as páginas do site. Na Shopify o caminho é outro: veja Instalar o script na Shopify.
Antes de começar
- Você tem acesso de edição ao contêiner do Google Tag Manager do site.
- A integração está conectada. Para conferir, abra Integrações.
- Você sabe a URL do site, para testar a tag antes de publicar.
Algumas plataformas pedem uma etapa antes da tag. Se a sua está na tabela, faça primeiro:
| Plataforma | Faça antes |
|---|---|
| Nuvemshop | No painel da Nuvemshop, em Configurações › Google Tag Manager, vincule o ID do seu contêiner. Se você ainda não tem um, crie gratuitamente em tagmanager.google.com. Como instalar o Google Tag Manager na Nuvemshop (abre em nova aba). |
| Loja Integrada | No painel da Loja Integrada, em Soluções › Aplicativos, instale o aplicativo Google Tag Manager e informe o ID do seu contêiner. Como configurar o Google Tag Manager na Loja Integrada (abre em nova aba). |
| VNDA (Olist Vnda) | Se você não tem acesso ao Google Tag Manager da loja, peça ao suporte da Olist/VNDA. Como adicionar ferramentas externas pelo Google Tag Manager (abre em nova aba). |
| Wake | Nada antes da tag. Depois de publicá-la, há uma liberação obrigatória no painel da Wake — veja o passo 6. |
| Bagy e Wbuy | Nada além de ter o Google Tag Manager na loja. |
Passo 1: copiar o código na Bevean
Abra FerramentasTracking e clique em Criar tag.
Em Integrações, escolha a sua integração e clique em Criar tag.
Se a integração não aparece, ela já tem uma tag — feche o painel e abra essa tag na lista — ou não está ativa.
Site sem plataforma integrada? Escolha Site próprio — veja Instalar o script em um site próprio.
Na tela da tag, clique em Copiar script. O código já traz a chave pública e a plataforma corretas da sua integração.
Passo 2: criar a tag no Google Tag Manager
Acesse tagmanager.google.com (abre em nova aba) e abra o contêiner do site.
Clique em Tags › Nova.
Em Configuração da tag, escolha o tipo HTML personalizado.
Cole o código no campo de HTML, do jeito que foi copiado, com o
<script>e o</script>incluídos.Deixe Suporte para document.write desmarcado: o código da Bevean não usa.
Se quiser, troque o nome da tag no topo — por exemplo, para
Bevean.
Passo 3: escolher quando a tag dispara
Em Acionamento, clique para escolher um acionador.
Selecione Todas as páginas ou Inicialização – Todas as páginas. O que importa é a tag disparar em todas as páginas do site.
Clique em Salvar.
O Inicialização – Todas as páginas dispara antes de todos os outros acionadores e já vem em todo contêiner do Google Tag Manager. O Todas as páginas dispara quando a página começa a carregar. A Bevean aceita os dois.
Passo 4: testar antes de publicar
É opcional, mas recomendado: a tag salva não está no site até você publicar, e o teste usa o rascunho.
No Gerenciador de tags, clique em Visualizar, no canto superior direito.
No Assistente de tags, informe a URL do site e clique em Conectar. Se o seu site quebrar com o parâmetro de depuração, desmarque Incluir o sinal de depuração no URL.
O site abre em uma nova janela, marcado como Conectado. Volte à aba do Assistente de tags e clique em Continuar.
Na interface de depuração, confirme que a tag da Bevean aparece em Tags disparadas.
Passo 5: publicar
De volta ao Gerenciador de tags, clique em Enviar, no canto superior direito.
Na tela Enviar alterações, escolha Publicar e criar versão.
Dê um nome à versão (por exemplo,
Script Bevean) e clique em Publicar.Aguarde a confirmação de que a versão foi publicada.
Salvar a tag não publica
Criar e salvar a tag só a coloca no rascunho do contêiner. Enquanto você não fizer o passo 5, nada muda no site. É a causa mais comum de "instalei e não funciona".
Passo 6 (só na Wake): liberar as URLs do script
A Wake bloqueia no navegador tudo o que não está na lista de URLs permitidas — inclusive o script da Bevean, mesmo com a tag publicada e funcionando. É uma política de segurança da Wake.
Na Bevean, na tela da tag, abaixo do código, copie a URL do SDK e a URL da API, cada uma com o botão Copiar URL.
No painel da Wake, abra Configurações › Políticas de Segurança › URLs Permitidas.
Clique em + Adicionar novas URL, informe a URL e salve. Faça isso para as duas.
Se tiver dúvida, a tela URLs Bloqueadas da Wake lista o que o navegador barrou: se as URLs da Bevean estiverem lá, a liberação não foi feita. Como gerenciar as Políticas de Segurança na Wake (abre em nova aba).
Passo 7: conferir na Bevean
Abra a sua loja em outra aba, navegue por algumas páginas e veja em Ao vivo se os visitantes e os eventos aparecem. Sem o script, a tela sinaliza que ele não foi identificado.
Quando algo não funciona
| O que você vê | O que verificar |
|---|---|
| A tag não aparece em Tags disparadas no teste | O acionador não cobre todas as páginas. Use Inicialização – Todas as páginas ou Todas as páginas. |
| O teste funciona, mas o site em produção não muda | Falta publicar: Enviar › Publicar e criar versão › Publicar. |
| Nuvemshop ou Loja Integrada: a tag está publicada e nada acontece | O contêiner do Google Tag Manager não está vinculado à loja. Faça a etapa "antes de começar" da sua plataforma. |
| Wake: o script carrega, mas os dados não chegam | As URLs do SDK e da API não foram liberadas. Faça o passo 6. |
| O código foi colado de um jeito estranho | Copie de novo com Copiar script, sem editar o conteúdo. |
| Os dados vão parar na loja errada, ou não chegam | O código veio de outra integração ou de outra loja. Cada uma tem a sua chave: copie o código da tag da integração correta. |
| Tudo funcionava e parou depois de remover a tag de tracking e criar outra | A chave mudou. Edite a tag no Google Tag Manager, cole o código novo e publique outra vez. |
| VTEX: a tag está publicada, mas o carrinho abandonado não aparece | A tag do Tag Manager cobre só a vitrine. O checkout precisa do código no arquivo checkout6-custom.js. Veja Conectar a VTEX. |
Remover ou trocar a tag
Remover a tag de tracking na Bevean inativa a chave, mas a tag do Google Tag Manager continua no seu contêiner, sem efeito. Para tirá-la de vez, exclua a tag no Google Tag Manager e publique de novo. Para trocar o código, edite a tag existente em vez de criar outra, para não ficar com duas tags da Bevean no mesmo contêiner.