Testar e diagnosticar o pixel

O endpoint de coleta responde 204 a tudo, inclusive a eventos recusados. Por isso “instalei e não vejo dado” é indistinguível de “não instalei”: nenhum erro aparece no console do navegador, na aba de rede ou no log do seu servidor. O retorno confiável é o painel.

Teste ponta a ponta

1. Abra o painel do pixel, na propriedade e no stream certos, e entre na aba Tempo real.

2. Em outra aba, abra uma página do seu site com a tag instalada.

3. Volte ao painel. A visita deve aparecer em alguns segundos.

4. Para testar um evento próprio, abra o console do navegador na página do seu site e rode:

   view.send("teste_integracao", { origem: "console" });

5. Confira no painel que o evento teste_integracao aparece.

6. Para testar a coleta direta, envie um evento com curl (veja Enviar eventos direto) usando um Origin de um domínio declarado, e confira no painel.

Se view não existe no console, a tag não carregou. Abra a aba de rede e procure a requisição ao arquivo .js do seu host de coleta.

Verificações por linha de comando

# A chave existe? 200 = sim, 404 = não.
curl -o /dev/null -sS -w '%{http_code}\n' https://px.exemplo.com.br/v/pk_00000000000000000000000000000000.js

# O host de coleta responde e tem certificado? Falha de TLS indica zona não verificada.
curl -sS -o /dev/null -w '%{http_code}\n' https://px.exemplo.com.br/saude

# A prova de posse do domínio está publicada?
dig +short TXT _owiew.exemplo.com.br

Um curl para /e que responde 204 não prova nada.

Problemas comuns

Quando nada aparece em alguns minutos, os motivos prováveis, nesta ordem:

Sintoma	Causa provável	O que fazer
Nada no tempo real, tag carregando	A origem não está declarada na propriedade e o stream já tem outro domínio ativo	Cadastre o domínio de origem no stream e confirme que está ativo.
Metade dos eventos some	A mesma chave está em dois domínios (por exemplo um layout compartilhado)	Use a chave da propriedade de cada domínio.
Falha de TLS no host de coleta	A zona não foi verificada ou o host foi apontado antes de cadastrado	Confira o TXT e a ordem: cadastrar o host no painel, depois o CNAME.
404 ao baixar o .js	Chave errada ou de outro ambiente	Copie a chave de novo do painel.
Eventos pararam depois de declarar o primeiro domínio	O stream saiu do modo permissivo e outras origens passaram a ser recusadas	Declare todas as origens legítimas.
Valor da compra absurdamente pequeno	Valor enviado em unidades no POST direto	Envie o valor em micros.
Visitantes recorrentes contados como novos no Safari	Limite de 7 dias do Safari para cookies em domínio apontado por CNAME	Esperado. Não há correção do lado da owiew.
Bloqueador de anúncios impede a coleta	Bloqueadores podem barrar o host	Use um subdomínio seu como host de coleta (CNAME de primeira parte).

Os motivos internos de recusa (chave ausente ou desconhecida, nome ou id ausente, domínio não declarado, cota, corpo inválido) são contados nas métricas do coletor da owiew e não aparecem na resposta.

Próximos passos

• Instalar o pixel
• Enviar eventos direto
• Visão geral das integrações