Como funciona o script da Bevean
O que o script faz na sua loja, como instalá-lo em cada plataforma e como confirmar que ele está funcionando.
O script da Bevean é um código que você coloca no seu site para a Bevean enxergar o que os visitantes fazem — que produto olharam, o que colocaram no carrinho, se chegaram ao checkout — e para os formulários da Bevean aparecerem na página. A integração da loja traz os pedidos; o script cobre o que acontece antes deles.
Onde fica: FerramentasTracking. Ali você cria uma tag para a sua loja integrada ou para um site próprio, e a tela da tag mostra a chave pública e o código para instalar.
Criar tag só lista as integrações ativas que ainda não têm tag
Em Criar tag, a lista Integrações mostra as integrações ativas que aceitam o script e ainda não têm tag: Shopify, Bagy, Wbuy, VNDA, Wake, Nuvemshop, Loja Integrada e VTEX. Cada integração tem no máximo uma tag — se a sua já tem, abra a tag dela na lista. Quando não sobra nenhuma, o painel avisa: Nenhuma integração ativa com suporte a tracking está sem tag.
Site sem plataforma integrada usa a opção Site próprio. Veja Instalar o script em um site próprio.
O que o script faz
| Recurso | O que depende do script |
|---|---|
| Formulários | É o script que carrega o pop-up, o banner ou o formulário embutido no seu site. Vale para qualquer plataforma. |
| Gatilhos de comportamento | Produto visualizado, Produto adicionado ao carrinho e Produto abandonado só disparam com o script instalado e o visitante identificado. |
| Ao vivo | Os números de visitantes, sessões e páginas. |
| Métricas | Os eventos de navegação, produto e carrinho. Sem o script, eles não aparecem no catálogo. |
Como instalar em cada plataforma
O código é o mesmo tipo de coisa em todas, mas o lugar onde ele entra muda com a plataforma. A tela da tag mostra o passo a passo e o código certos para a sua integração.
| Plataforma | Onde você instala | O que fazer antes |
|---|---|---|
| Shopify | Dois códigos no admin da Shopify: um em Eventos do cliente e outro no tema da loja. | Nada além de ter acesso de administrador. Veja o passo a passo da Shopify. |
| Bagy | Tag HTML personalizada no Google Tag Manager. | Ter um contêiner do Google Tag Manager na loja. |
| Wbuy | Tag HTML personalizada no Google Tag Manager. | Ter um contêiner do Google Tag Manager na loja. |
| VNDA (Olist Vnda) | Tag HTML personalizada no Google Tag Manager, com o acionador Todas as páginas. | Ter acesso ao Google Tag Manager da loja. Se você não tem, peça ao suporte da Olist/VNDA antes de instalar. |
| Wake | Tag HTML personalizada no Google Tag Manager. | Liberar as URLs do script em Políticas de Segurança, no painel da Wake — sem isso o navegador bloqueia o script. |
| Nuvemshop | Tag HTML personalizada no Google Tag Manager. | Vincular o ID do seu contêiner em Configurações › Google Tag Manager, no painel da Nuvemshop. |
| Loja Integrada | Tag HTML personalizada no Google Tag Manager. | Instalar o aplicativo Google Tag Manager em Soluções › Aplicativos e informar o ID do contêiner. |
| VTEX | Dois códigos: uma tag no Google Tag Manager (vitrine) e o arquivo checkout6-custom.js (checkout). | Os dois são obrigatórios. Veja o passo a passo na página da VTEX. |
| Site próprio (sem plataforma integrada) | Dentro da tag <head> do site, em todas as páginas — ou numa tag HTML personalizada no Google Tag Manager, com o acionador Todas as páginas. | Nada. Veja Instalar o script em um site próprio. |
Os passos completos estão em Instalar o script na Shopify e em Instalar o script pelo Google Tag Manager. A VTEX tem o seu em Conectar a VTEX.
Em site próprio, o script sozinho só carrega os formulários
Os formulários funcionam assim que o script carrega. Produto visto, carrinho e compra não são capturados sozinhos: quem desenvolve o site precisa enviar esses eventos com window.bevean.push. Os eventos e o formato de cada um estão em Enviar eventos pelo código do site.
E o carrinho abandonado?
Ele depende da plataforma. Nas lojas Bagy e Shopify o gatilho vem da integração de carrinho, e o evento de checkout do script é ignorado — instalar o script não muda isso. Na VTEX ele só existe pelo script. Em site próprio, ele dispara com o evento de início de compra enviado pelo código do site, sem os itens do carrinho na mensagem — veja Enviar eventos pelo código do site. Os detalhes de cada gatilho estão em Escolher um gatilho.
A chave pública
Cada tag tem a sua chave pública, que diz à Bevean de qual conta vêm os dados. Ela já vem dentro do código: você não precisa colá-la em lugar nenhum.
Por isso não reaproveite o código de outra loja nem de outra integração. Ele carrega a chave da outra conta, e é lá que os dados vão parar.
Criar, remover e criar de novo
| Você clica em | O que acontece |
|---|---|
| Criar tag | A Bevean cria a chave pública e abre a tela da tag, com o código para copiar. |
| Remover (na tela da tag, ou no ícone de lixeira da linha, na lista) | Pede confirmação em Remover tag. A chave é inativada e o script instalado deixa de funcionar. |
| Criar uma tag nova, depois de remover | Cria uma chave nova. O código que já estava no site tem a chave antiga e não volta a funcionar: troque pelo código novo. |
Remover no painel não tira o código do site
A Bevean inativa a chave, mas não apaga o que você colou na sua loja. O código continua lá, sem efeito. Para limpar de vez, apague a tag ou o trecho de código por lá.
Como saber se está funcionando
Abra a sua loja em outra aba e navegue por algumas páginas.
Na Bevean, abra Ao vivo e veja se os visitantes e os eventos aparecem. Sem o script, a tela sinaliza que ele não foi identificado.
Se quiser conferir o histórico, procure o evento em Métricas. Um evento de hoje não soma na contagem no mesmo dia, então use o Ao vivo para o teste do momento.
Cada plataforma também tem a sua ferramenta de teste: a Shopify tem o botão Testar no pixel, e o Google Tag Manager tem o modo Visualizar.
Preciso do script se a integração já está conectada?
Para os pedidos, não: a integração sincroniza pedidos, clientes e produtos. Você precisa do script para os formulários, para os gatilhos de comportamento e para os números de navegação.
Instalei e não aparece nada. E agora?
Veja a lista de problemas do passo a passo da sua plataforma: a causa mais comum é o código estar no lugar errado ou não ter sido publicado. Se você removeu a tag e criou outra, a chave mudou: troque o código no site.
Passo a passo por plataforma