Instalar o pixel e enviar eventos
Do snippet ao primeiro evento na timeline: instalação do pixel first-party, eventos automáticos, eventos personalizados via _cl e identificação de usuário logado.
O pixel do CrazyLeads é um script único que coleta pageviews, rolagem, vídeo e formulários do seu site — e entrega cada evento já resolvido a uma pessoa, com identidade unificada entre dispositivos. Este guia leva do zero ao primeiro evento na timeline.
1. Crie a fonte Pixel no projeto
No app, abra Fontes de Dados → Adicionar fonte → Pixel. Informe o domínio do seu site (ex.: seusite.com.br). O domínio é um portão de segurança: o pixel só roda nos domínios cadastrados — em qualquer outro host ele morre em silêncio, então ambiente de desenvolvimento não suja seus dados.
2. Instale o snippet
Cole o snippet antes do fechamento do <head>, em todas as páginas. O identificador em data-project é o UUID do seu projeto — o app mostra o snippet pronto na tela da fonte, com o seu ID já preenchido.
<script>
(function (w, d, s) {
var f = d.getElementsByTagName(s)[0],
j = d.createElement(s);
j.async = true;
j.setAttribute('data-project', 'SEU_PROJECT_UUID');
j.src = 'https://d1yai1huv6xqdp.cloudfront.net/tagPixel.min.js';
f.parentNode.insertBefore(j, f);
})(window, document, 'script');
</script>Aplicação de página única (React, Next.js, Vue)? Nada a configurar: o pixel intercepta a navegação do histórico e emite um pageView novo a cada troca de rota.
O que é coletado automaticamente
| Evento | Quando dispara | Para que serve |
|---|---|---|
| pageView | Cada página vista (inclui navegação SPA) | Tráfego, funil de páginas, atribuição |
| Scroll | Em 25%, 50%, 75% e 100% da página | Engajamento real com o conteúdo |
| Vídeo | Progresso de players na página | Quem assistiu até o pitch |
| Formulários | Envio de formulário com e-mail | Vira identidade: o visitante anônimo ganha nome |
| UTMs e cliques de anúncio | Chegada com utm_*, fbclid | Atribuição de campanha e match com o Meta |
3. Envie eventos personalizados
O canal público do pixel é o array global _cl, no padrão dataLayer: você empurra objetos, o pixel processa. Tem replay — o que for empurrado antes de o script carregar é processado quando ele sobe, então a ordem de carregamento nunca é problema.
window._cl = window._cl || [];
window._cl.push({
event: 'checkout_iniciado',
plano: 'pro',
valor: 297,
});Objetos sem a chave event viram super properties: grudam em todo evento seguinte do visitante — bom para contexto que vale a sessão inteira, como o produto da página ou a variante de um teste.
window._cl.push({ tipo_de_pagina: 'venda', produto: 'Curso X' });Enviando do jeito certo
| Regra | Por quê |
|---|---|
| Nome em snake_case, estável (checkout_iniciado) | O nome é a chave de tudo: filtro, conversão, Envio. Renomear depois quebra o histórico. |
| Propriedades só com valores primitivos (texto, número, booleano) | Objeto aninhado não vira coluna filtrável — chega, mas não serve para segmentar. |
| Evento = fato que aconteceu; super property = contexto que dura | "checkout_iniciado" é evento; "plano: pro" é contexto que gruda nos próximos. |
| Grafia de valor consistente (pro, não Pro/PRO/pró) | Filtro e conversão comparam texto — três grafias viram três segmentos. |
| E-mail e telefone SÓ pelo identify, nunca como propriedade de evento | Identidade tem caminho próprio, com validação e merge; propriedade solta vira dado morto. |
| Dispare no SUCESSO da ação, não no clique | Clique que falhou não é conversão — o handler de sucesso é o lugar do evento. |
Antes de sair instrumentando tudo: escolha meia dúzia de eventos que respondem perguntas de verdade (o que decide ativação? o que precede a compra?) e nomeie-os num vocabulário que o time inteiro entende. Evento que ninguém consulta é só custo.
4. Identifique o usuário logado
Num SaaS ou área de membros, você já sabe quem é a pessoa — conte isso ao pixel. A identificação liga toda a navegação anônima anterior à conta, e funciona entre dispositivos: o mesmo e-mail em dois aparelhos vira uma pessoa só na timeline.
window._cl = window._cl || [];
window._cl.push(function (pixel) {
var email = 'usuario@empresa.com'; // e-mail da sessão logada
if (pixel.getEmail && pixel.getEmail() === email) return; // já identificado
pixel.eventManager.trackLead({ email: email });
});Rastreando o próprio app logado? Desligue a captura automática de formulários na configuração da fonte: formulário de convite de equipe carrega o e-mail de OUTRA pessoa, e a captura automática gravaria essa identidade por cima da sessão. Nós usamos o pixel no nosso próprio app exatamente assim.
5. Confira o dado chegando
- 01Abra a fonte Pixel no app: o contador de eventos e o último evento recebido aparecem no topo.
- 02Visite seu site e navegue por 2 ou 3 páginas — o pageView chega em segundos.
- 03Abra Leads: a visita vira um lead (anônimo até ter e-mail; identificado depois do identify ou de um formulário).
- 04Abra a timeline do lead: cada pageView, scroll e evento personalizado aparece em ordem.
A partir daqui, todo evento está disponível nas Consultas (SQL), nos artefatos de análise, nas conversões e nos Envios para Meta, Google e os demais destinos — sem instrumentar nada duas vezes.