A visão Trust: como ler a qualidade do seu rastreamento

A visão Trust fica no seu dashboard de domínio e oferece uma medição honesta de quanto do seu rastreamento está sendo capturado. Ela roda diariamente e compara três sinais — o tracker do navegador, a ingestão do lado do servidor e a verdade dos webhooks — para estimar lacunas e explicar de onde provavelmente vêm.

Este guia percorre como ler a visão e o que fazer quando algo merece investigação.

Onde encontrar

Em app.zenovay.com, abra qualquer dashboard de domínio e selecione a aba Trust do grupo Reliability na barra lateral (ela fica em /domains/{id}?tab=trust). A visão mostra os resultados de reconciliação dos últimos 7 dias.

Se este é um site novo, você pode ver um estado vazio amigável. A primeira linha de reconciliação aparece em até 24 horas após atividade (o job diário roda às 00:00 UTC).

O número principal

No topo, você verá uma porcentagem grande rotulada «perda de rastreamento estimada» ao lado de um chip de confiança:

• Porcentagem positiva (ex. 8,4 %) — seu tracker do navegador registra menos eventos do que a camada servidor ou webhook sugere. Alguma perda é normal; o detalhamento abaixo explica o porquê.
• Porcentagem negativa / «+X % super-contados» — seu servidor registra mais eventos que seu tracker do navegador. Não é um bug; geralmente significa que a ingestão do servidor capturou eventos que bloqueadores de anúncios ou quedas de rede teriam perdido.
• — (travessão) — ainda não há dados comparáveis suficientes, normalmente porque a camada servidor ou webhook está vazia para este site.

Abaixo da porcentagem está uma barra de completude. A seção esmeralda sólida mostra eventos que casaram entre camadas. A seção âmbar listrada mostra a lacuna estimada.

Rótulos de confiança

Toda métrica carrega um de três rótulos:

Chip	Significado
Confiança alta ●●●	Ambas as camadas têm ≥100 eventos e a perda está abaixo de 30 %. O número é confiável.
Confiança média ●●○	Alguma camada está na faixa de 50–100 eventos, ou a perda está entre 30 % e 60 %. Trate o número como direcional.
Dados limitados ●○○	Uma ou ambas as camadas têm menos de 50 eventos, ou a perda excede 60 %. A visão diz o pouco que vê, mas não aja apenas com base nesse número.

Confiança não é severidade. Uma perda de 5 % com alta confiança é informação mais útil que uma perda de 80 % com baixa confiança.

Lendo o detalhamento por métrica

Três linhas abaixo do número principal mostram a mesma comparação aplicada separadamente a páginas vistas, conclusões de objetivos e eventos de receita. Cada linha carrega seu próprio rótulo de confiança e três colunas (cliente / servidor / webhook), além de uma barra de completude.

Alguns padrões comuns:

• Páginas vistas: cliente e servidor devem estar próximos. Uma lacuna persistente normalmente aponta para bloqueadores de anúncios ou regras de CSP bloqueando silenciosamente o tracker em certas páginas.
• Objetivos: lacunas aqui são frequentemente legítimas — o visitante fechou a aba entre disparar o evento cliente e a confirmação do servidor. Preste mais atenção a mudanças de tendência do que a uma porcentagem isolada de um dia.
• Receita: a camada webhook é a fonte da verdade (foi ela que efetivamente cobrou o cliente). Uma lacuna aqui geralmente significa ou que eventos de compra do cliente não estão disparando em cada pagamento bem-sucedido, ou que entregas de webhook estão atrasadas.

Se você vir em uma linha uma pequena mensagem como «Ingestão do servidor ainda não em uso», significa que a camada de verdade para essa métrica está vazia. A reconciliação mostrará algo (Trust usa a camada existente), mas com baixa confiança.

Principais razões de mismatch

Abaixo do detalhamento por métrica, Trust classifica as principais razões suspeitas, ordenadas pelo número de eventos afetados nesta semana.

Três razões são marcadas como Acionável com uma pequena tag âmbar. Para estas, planos Pro e superiores veem um passo de ação de uma linha. As outras razões são diagnósticas — explicam o que está acontecendo sem exigir ação sua.

Razões acionáveis e o que fazer

Tracker cliente provavelmente bloqueado (client_blocked)

• O que vimos: contagens do servidor foram notavelmente maiores que as do navegador em pelo menos uma métrica.
• Causa provável: um bloqueador de anúncios, uma extensão de privacidade do navegador ou seu próprio cabeçalho Content-Security-Policy está bloqueando o tracker em algumas visitas.
• O que tentar: adicione api.zenovay.com à sua diretiva CSP connect-src. Se você usa uma CSP mais estrita com script-src, adicione lá também. Para perdas por extensões de privacidade, considere habilitar rastreamento first-party para que o tracker carregue do seu próprio domínio.

Entrega de webhook atrasada (webhook_delay)

• O que vimos: eventos de compra do cliente superaram as chegadas de webhooks E a contagem de webhook de hoje caiu bem abaixo da linha base de 6 dias.
• Causa provável: seu provedor de pagamento (tipicamente Stripe) ainda não entregou alguns webhooks. Isso geralmente se resolve sozinho em horas.
• O que tentar: abra o painel de entregas de webhook do seu provedor e procure webhooks falhos ou pendentes. Se vir retentativas, a lacuna deve fechar conforme elas chegam. Se webhooks estão falhando completamente, verifique se seu endpoint está acessível e retorna respostas 2xx.

Mismatch de normalização de rota (route_mapping)

• O que vimos: 1–2 rotas específicas representam mais da metade da lacuna.
• Causa provável: essas rotas são normalizadas de forma diferente entre o tracker do navegador e o servidor. Caso comum: uma rota SPA que o tracker reporta como /checkout/abc123 mas o servidor registra como /checkout/[id].
• O que tentar: revise o tratamento de rotas SPA do seu tracker para as URLs afetadas. A tabela drilldown Pro+ mostra exatamente quais rotas contribuem para a lacuna.

Razões diagnósticas (sem ação necessária)

• Eventos duplicados suprimidos — o pipeline de ingestão detectou eventos do navegador duplicados com a mesma chave de idempotência e manteve apenas um. Comportamento correto.
• Lacunas de identidade de visitante — o ID do navegador de um visitante não casou limpamente entre eventos registrados no servidor. Comum quando o visitante limpou cookies no meio da sessão.
• Ingestão do servidor não em uso — você ainda não começou a enviar eventos do lado do servidor para POST https://api.zenovay.com/e/{trackingCode}. Reconciliação do servidor não é possível sem isso. Veja Eventos do servidor para configuração.
• Nenhuma causa dominante identificada — a lacuna está abaixo do limite para qualquer razão específica. Frequentemente significa apenas que seu rastreamento está saudável.

A tabela drilldown Pro+

Se seu plano é Pro ou superior, você verá embaixo uma tabela Lacuna por rota listando as maiores diferenças de uma única rota entre contagens cliente e servidor desta semana, ordenadas por lacuna de eventos.

É a parte mais acionável da visão: diz exatamente onde olhar. Alguns exemplos:

• Uma única página de detalhe de produto representando a maior parte da lacuna de páginas vistas → verifique se essa página tem uma regra CSP, um script inline personalizado ou um layout testado em A/B que quebra o tracker.
• Uma rota /checkout aparecendo apenas no servidor → seu tracker do cliente pode não estar instalado na página de checkout (omissão comum em fluxos de pagamento isolados).
• Um padrão /blog/[slug] com centenas de rotas contribuindo cada uma 1–2 eventos → esperado; ignorar.

Perguntas frequentes

A aba Trust diz que estou perdendo 12 % das páginas vistas. Devo me preocupar?

Não necessariamente. Referências do setor para analytics baseado em navegador colocam perda por bloqueadores entre 20 % e 40 % em alguns verticais. Uma perda medida de 12 % com comparação real do servidor é muito melhor que a perda não medida de uma ferramenta de analytics típica. A pergunta acionável é se a lacuna está concentrada em rotas específicas (reparável) ou distribuída uniformemente (custo do negócio).

Por que meu número mostra «+5 % super-contados»?

Seu servidor capturou mais eventos que seu tracker do navegador. É boa notícia — a ingestão do servidor está preenchendo lacunas que seu tracker teria perdido. O «+» deixa claro que não é perda.

A visão diz «Dados limitados» para receita. O que isso significa?

Ou você não tem muitos eventos de compra esta semana (menos de 50 na janela), ou apenas uma das camadas de verdade está populada (ex. você tem eventos de compra do cliente mas nenhum webhook do Stripe configurado). A solução geralmente é esperar mais eventos ou conectar a camada faltante.

Por que não vejo passos de ação para algumas razões?

Passos de ação para as três razões acionáveis estão disponíveis a partir do Pro. No Free, você verá o nome da razão e a contagem de eventos, mas a sugestão de correção está bloqueada. As razões em si e os números principais são visíveis em todos os planos.

A aba Trust aparece nos meus dashboards públicos?

Não. Trust é uma superfície de diagnóstico apenas interna. Dashboards compartilhados publicamente nunca a incluem.

Guias relacionados

• Taxa de rejeição e duração de sessão — combina bem com reconciliação ao investigar qualidade de engajamento
• Entendendo métricas — definições das contagens subjacentes que Trust agrega
• Eventos do servidor — como conectar a camada servidor que alimenta a reconciliação