Rastreamento do site
O rastreamento é um pequeno código que você cola no seu site. Com ele, o DeepLead registra as páginas que cada visitante vê e liga essas visitas ao contato quando descobre quem ele é. É o que alimenta o Analytics e a pontuação de lead scoring por visita.
# Onde fica
Configurações, com o módulo Marketing selecionado → Tracking. O cartão se chama Tracking Pixel.
# Instalar o código
O caminho mais simples é o assistente.
- Clique em Configurar Pixel.
- Passo 1, Copiar o código do pixel: veja o código e clique em Próximo. Aqui ele ainda traz
{{API_KEY}}no lugar da chave. - Passo 2, Configurar API Key: em Criar nova API Key, digite um nome, como
Tracking Pixel, e clique em Criar. A chave completa aparece uma única vez. Guarde-a e clique em Próximo. - Passo 3, Testar a conexão: clique em Executar teste. Com Teste aprovado, copie o Código final com sua API Key.
- Cole o código em todas as páginas do seu site, antes de
</body>. - Clique em Concluir.
No passo 2 também dá para clicar numa chave em API Keys existentes, mas o assistente só conhece o começo dela. Nesse caso o teste falha e o código final sai incompleto: troque o valor de
data-keypela chave completa que você guardou quando a criou. Na dúvida, crie uma chave nova.
# Outras formas de pegar o código
- Ver código do pixel mostra a tag, com
{{API_KEY}}para você substituir. O botão de copiar ao lado de Verificar copia essa mesma tag. - Versão inline (para CSP restritivo) mostra o código completo para colar direto na página. Use só se a política de segurança do seu site bloquear scripts externos. Nessa forma, correções futuras exigem colar o código de novo; na forma normal, o código se atualiza sozinho.
# O que é registrado
- cada página vista, inclusive em sites que trocam de página sem recarregar;
- o tempo na página e até onde a pessoa rolou;
- os parâmetros UTM do link de chegada (
utm_source,utm_medium,utm_campaign,utm_term,utm_content); - a página de origem, o idioma, a resolução da tela e o navegador.
# Como o visitante é identificado
- Toda visita começa anônima e já é registrada.
- O visitante é identificado quando chega por um link com o parâmetro
dl_email. Os links das campanhas de e-mail do DeepLead já levam esse parâmetro. - Depois da primeira visita identificada, o e-mail fica guardado no navegador do visitante, e as visitas seguintes naquele navegador já chegam identificadas.
- No momento da identificação, as páginas que ele viu naquela sessão passam para o histórico do contato.
A cada página vista por um contato identificado, o sistema atualiza o lead score e aplica as tags automáticas configuradas.
# Conferir a instalação
- Clique em Verificar.
- Digite a URL do site, de uma página onde o código deveria estar, e clique em Verificar.
- Leia o resultado: Pixel instalado corretamente ou Problemas encontrados.
| Verificação | O que confere |
|---|---|
| Script do DeepLead encontrado | O código está na página. Mostra a Versão. |
| API Key pertence à sua conta | A chave que está no código é uma das chaves da sua empresa. |
| URL da API correta | O código aponta para o endereço certo. |
| Eventos recebidos deste domínio | Já chegaram visitas desse site, com a quantidade e o Último evento. |
As listas de Erros e Avisos vêm em inglês. As mais comuns: chave que não é da sua conta, versão antiga do código e nenhum evento recebido ainda.
# Regras e limites
- O rastreamento não cria contatos. Se o e-mail identificado não é de um contato da sua empresa, a visita não é registrada para ninguém.
- A chave precisa estar ativa. Desativar ou excluir a chave em Integrações (API / Webhooks) interrompe o rastreamento na hora.
- Domínios permitidos: se a chave tem domínios permitidos definidos, visitas vindas de outro domínio são recusadas. Veja Webhooks e chaves de API.
- Versões antigas do código registram só a página de entrada em sites que trocam de página sem recarregar. Substitua pela tag atual.
- O código não coleta o que a pessoa digita nem dados de formulário.
# Problemas comuns
| O que aparece | O que fazer |
|---|---|
| “Você precisa criar uma API Key em Configurações → Webhooks para usar o tracking pixel.” | Crie a chave pelo assistente Configurar Pixel ou na seção de integrações. |
| Teste falhou com “Invalid or inactive API key” | A chave usada está incompleta, inativa ou não existe. Crie uma nova no passo 2. |
| Teste falhou com “Domain not allowed” | A chave restringe domínios e o teste parte do DeepLead. Verifique os domínios permitidos da chave. |
| “Selecione ou crie uma API Key primeiro” | Volte ao passo 2 e escolha ou crie a chave. |
| Problemas encontrados, com o script não encontrado | O código não está na página informada. Cole a tag antes de </body>, publique o site e verifique de novo. |
| Visitas aparecem só como Visitante anônimo | Ninguém chegou por link identificado. Divulgue as páginas pelas campanhas de e-mail. |