Formulários e eventos de conversão
Captura automática
Seção intitulada “Captura automática”
O script injetado escuta o envio de qualquer formulário do HTML. Você não precisa adicionar atributo nenhum.
No envio, o app:
- Reconhece nome, e-mail e telefone pelos nomes dos campos (
nome,name,email,telefone,phone,whatsapp…). - Cria o contato, ou reaproveita o existente pelo e-mail ou telefone.
- Registra a conversão com o evento da página, os campos do formulário, as UTMs e os identificadores de clique dos anúncios (guardados por 90 dias em cookie próprio da página).
- Descarta envios de robô pelo campo escondido (honeypot).
Envio sem nenhum dado de contato não cria conversão.
Quem digita e-mail ou telefone e não envia vira abandono — contato sim, conversão não. Veja LGPD: cookies, aviso e abandono.
Ajustes por atributo no HTML
Seção intitulada “Ajustes por atributo no HTML”Se precisar, alguns atributos no <form> mudam o comportamento:
| Atributo | Efeito |
|---|---|
data-smart-ignore | O formulário é ignorado (ex.: um campo de busca). Também não recebe o campo anti-robô |
data-smart-event="nome" | Este formulário envia outro evento no CRM em vez do padrão da página |
data-smart-source="form-topo" | Define a origem (lead_source) da conversão |
data-smart-meta-event="Subscribe" | Define o evento enviado à Meta por este formulário |
data-smart-thanks="#obrigado" | O app segura o envio, espera o servidor confirmar e só então troca o formulário pelo bloco #obrigado (que começa com hidden). Sem isso, o envio da página segue como está |
data-smart-whatsapp="https://wa.me/55…" | Com data-smart-thanks: se o envio falhar, a mensagem de erro oferece o WhatsApp |
data-smart-precollect="false" | Desliga o abandono (pré-coleta) só neste formulário |
E dentro do formulário: data-smart-sensitive num campo ou <fieldset> (só sobe no envio final) e data-smart-step="nome" num botão de etapa. Detalhes em LGPD: cookies, aviso e abandono.
Página com JS próprio
Seção intitulada “Página com JS próprio”Formulário sem data-smart-thanks não é interrompido — mas o app avisa o que aconteceu: o <form> recebe o evento smart:sent (com detail.ok, detail.status, detail.attempts) quando o CRM confirmou, ou smart:failed quando não. Mostre o “obrigado” no smart:sent, nunca antes.
O app tenta 3 vezes (rede fora, 429, 5xx). Se nem assim subir, o envio fica guardado no navegador e sobe sozinho na próxima visita da pessoa à página.
O que estiver configurado na aba Avançado (eventos por formulário) vale quando o atributo não existe no HTML.
Evento da página
Seção intitulada “Evento da página”Cada página tem um Evento de conversão (aba Conteúdo). É o identificador que aparece nos relatórios de conversão e nos filtros. Em branco, o padrão é lead_<site>_<caminho>.
Eventos por formulário (aba Avançado)
Seção intitulada “Eventos por formulário (aba Avançado)”
Página com mais de um formulário, cada um com finalidade diferente? Ligue Ativar eventos por formulário.
O app lista os formulários que encontrou no HTML (com o texto do botão pra você reconhecer). Pra cada um:
- Identificar por: ordem na página ou
iddo form. Prefiraidse o HTML pode mudar de ordem. - Evento no CRM: o identificador da conversão.
- Origem (lead_source): ex.
form-topo,form-rodape. - Evento padrão da Meta: padrão do site ou um nome específico (
Lead,Subscribe…).
As mudanças valem na próxima publicação. Desligar guarda as configurações.
Onde a conversão aparece
Seção intitulada “Onde a conversão aparece”
- No contato, na linha do tempo.
- No funil, como qualquer conversão, com campanha, origem e meio.
- Na aba Resultados da página e em Relatórios › Landing Pages.
- Como gatilho em fluxos e automações (grupo Conversão / Abandono).
Os abandonos ficam na coluna própria da tela de Conversões e não entram em nenhum desses números.