Código de rastreamento (Google Tag Manager, GA4, Pixel da Meta, Hotjar) não vai no tema. Ele é colado na tela Scripts do painel, onde o cliente ou o gestor de tráfego cuida dele sem a IA. O Velk acrescenta duas coisas: consegue segurar um script até o visitante aceitar, e dispara um evento de conversão a cada lead.
Como incluir um script
-
Abra Scripts
Fica no menu do painel, com uma linha por código: o status e, quando o tema tem banner, o consentimento.
-
Crie o script
Dê um nome (GTM, Pixel da Meta) e cole o código exatamente como a ferramenta entrega.
-
Escolha a posição
O head da página (
head), o início do body (body_start) ou o final dele (body_end). O GTM tem dois códigos: o principal no head e o noscript no início do body. -
Ordem e ativação
Arraste as linhas para reordenar: dentro de uma posição, o GTM vem antes de tudo que manda dado para ele. Script inativo nunca chega ao navegador.
Consentimento
Analytics e pixel de anúncio não são necessários para o site funcionar, e leis como a LGPD pedem a permissão do visitante. O consentimento vem desligado em cada script: sem categoria, ele sempre carrega, o certo para uma tag de verificação de domínio ou um monitor de erros. Marcar “Este script exige consentimento” deixa você escolher uma das categorias que o tema declara no site.json:
| Modo | Comportamento |
|---|---|
Necessário (required) | Sempre carrega; o visitante não consegue desligar. |
Opt-out (opt_out) | Carrega até o visitante recusar. Costuma ser usado para análise, onde a lei permite. |
Opt-in (opt_in) | Só carrega depois que o visitante aceita. É o certo para marketing e remarketing; na dúvida, opt-in. |
Bom saber
- Sem categorias declaradas, a tela oferece “ativo por padrão” ou “inativo por padrão”, e o banner só consegue aceitar ou recusar tudo.
- Aceitar liga na hora os scripts segurados, sem recarregar. Recusar depois vale a partir da próxima página: o script que já rodou já gravou os cookies dele.
- Códigos do mesmo serviço ficam na mesma categoria, como os dois do GTM.
- Um script cuja categoria saiu do
site.jsonpara de carregar e aparece em vermelho.
Peça à IA
O site da clínica odontológica vai usar GA4 e o Pixel da Meta. Configura o consentimento com duas categorias: Análise, que carrega até o visitante recusar, e Marketing, só depois do aceite. Monta o banner no estilo do site, na parte de baixo da tela, com Aceitar tudo, Recusar e Preferências, e um link no rodapé para reabrir.
A IA declara as categorias e escreve o banner. Depois, cole os dois códigos em Scripts e escolha a categoria de cada um.
Todo lead vira conversão
Todo envio de formulário concluído manda um evento chamado velk_form_success para o dataLayer da página, a fila que o Google Tag Manager lê, com o id do formulário, o número do lead e a campanha da visita. Não há nada para ligar: no GTM, dispare as suas tags de lead (o generate_lead do GA4, Google Ads, Meta) de um acionador nesse evento, separando os formulários pelo form_id. O nome é fixo, então um contêiner serve para todo site Velk. Um cadastro de membro concluído manda velk_signup_success.
Sem gerenciador de tags, cole na tela do formulário um código para rodar a cada conversão; a biblioteca em si (gtag, fbq) continua em Scripts. Num formulário enviado sem recarregar a página, peça à IA para o tema rodar esse código.
Quando o evento dispara
| Situação | Dispara? |
|---|---|
| Um envio é concluído | Sim, uma vez. |
| Uma etapa intermediária de formulário em etapas | Não, só a última etapa. |
| Robô pego pelo honeypot, erro de validação, sessão expirada | Não. |
| O e-mail ou o webhook falhou | Sim: lead é lead. |
| A página é recarregada depois | Não. |
Conversões aprimoradas
Na tela de cada formulário, o bloco Rastreamento de conversão pergunta qual campo é o e-mail e qual é o telefone; nada vem mapeado. Mapeados, os dois vão no evento em texto puro, e a tag do Google faz o hash deles no navegador do visitante antes de enviar, para o Google Ads casar o lead quando o cookie falha. No cadastro de membro, incluir o e-mail é uma opção à parte em Scripts, desligada por padrão.
Formulário que termina numa página de obrigado (desde a v3.7.8)
Um formulário enviado sem recarregar a página, que depois vai para uma página de obrigado, perdia a conversão na troca. Peça à IA para enviar com _event=queue: o Velk segura o evento por até 10 minutos e dispara uma vez na página seguinte. Vale para qualquer formulário enviado assim, incluindo os em etapas e o cadastro de membro.
Peça à IA
Depois que o formulário de orçamento for enviado, leva o visitante para uma página de obrigado com o nosso botão de WhatsApp, e garante que a conversão continua chegando no GTM. Depois escreve uma nota curta para o nosso gestor de tráfego: o acionador, o form_id de cada formulário e os campos mapeados.
A IA envia o formulário com _event=queue, confere o evento na página de obrigado e escreve a nota a partir do formato fixo do evento.