Zenovay mostra um de três badges ao lado de cada visitante — Anonymous, Identified ou Paying. Os badges aparecem no Globo 3D (em um popup ao passar o cursor sobre um visitante) e dentro da aba Journeys → Users. Este artigo explica o que cada estado significa, como um visitante muda de um para outro e como mascarar os dados ao compartilhar o dashboard externamente.
Os três badges
| Badge | O que significa | Quando o visitante recebe |
|---|---|---|
| Anonymous (cinza) | O visitante navega sem fazer login. Zenovay sabe seu dispositivo, país e comportamento, mas não quem ele é. | Padrão para qualquer pageview não identificada. Nenhum cookie é definido em modo cookieless. |
| Identified (azul) | O visitante está logado no seu produto. Zenovay sabe seu e-mail, nome e quaisquer traits personalizados que você enviou. | Após seu site chamar zenovay('identify', userId, { email, name }) — geralmente logo após login ou cadastro. |
| Paying (verde) | O registro do visitante está vinculado a uma assinatura paga ou tem receita acumulada maior que zero. | Automaticamente, quando Zenovay recebe um webhook de pagamento de Stripe, LemonSqueezy, Polar ou PayPal — sem chamada extra ao tracker. |
Como tornar visitantes "Identified"
A identificação é opt-in: seu site precisa chamar zenovay('identify', ...) quando um usuário faz login. A chamada mais simples:
// Logo após login, signup ou sempre que tiver um usuário conhecido
zenovay('identify', user.id, {
email: user.email,
name: user.name
});
É só isso. A próxima pageview é associada a essa identidade, e o badge muda de Anonymous para Identified. Erro comum: chame identify() apenas com IDs estáveis (a primary key do seu banco) — não passe e-mail ou username como userId, pois usuários podem alterá-los.
Para configuração passo-a-passo com exemplos de código para Next.js, React, Vue, HTML simples, Shopify e WordPress, consulte a documentação Visitor Identification.
Trabalhando com Claude Code, Cursor, ChatGPT ou GitHub Copilot? Aponte seu assistente de IA para a doc Visitor Identification e peça a ele para configurar zenovay('identify') para sua stack. A doc tem snippets prontos para copiar e colar para os principais frameworks.
Como visitantes se tornam "Paying"
Você não torna um visitante Paying com uma chamada ao tracker. Zenovay recebe eventos de webhook dos provedores de pagamento que você conecta (Stripe, LemonSqueezy, Polar, PayPal) e vincula o registro do cliente automaticamente. Assim que um pagamento chega, o badge do visitante muda para Paying. A receita acumulada e a contagem de pedidos aparecem no painel de detalhes do visitante.
Se um visitante cancelar a assinatura depois, ele mantém o badge Paying enquanto total_revenue for maior que zero — o valor passado do cliente continua relevante para sua equipe.
E se eu só tenho um customer ID, sem e-mail?
Algumas integrações (por exemplo apps mobile com user ID interno mas ainda sem e-mail) podem chamar:
zenovay('identify', user.id, {
customer_id: 'cus_internal_123'
});
Esse visitante conta como Identified — o badge aparece, e o card de detalhes do visitante mostra ID only na linha de e-mail. Ele se torna Paying no momento em que um webhook de pagamento vincula esse customer ID a uma conta Stripe / LemonSqueezy / Polar / PayPal.
Ocultando identificadores em screenshots e demos
Abra /profile → Preferences → ative Blur identifiers. E-mails são renderizados com tudo exceto os primeiros caracteres e domínio de nível superior mascarados (por exemplo jo••••@ex••.com) e nomes mantêm apenas a primeira letra de cada parte (por exemplo J••• D•) em todo o seu dashboard. O toggle persiste por navegador — você não precisa reativá-lo após recarregar.
Blur é um auxílio de apresentação, não controle de acesso. Um usuário com DevTools do navegador ainda pode ver os dados sem máscara mesmo com o toggle ATIVADO. Para restringir realmente o acesso aos identificadores, gerencie sua membresia de equipe em Settings → Team.
Dashboards públicos sempre mascaram
Sempre que você compartilha um dashboard público somente leitura, os identificadores são mascarados independentemente do estado do toggle. E-mails são renderizados com tudo exceto os primeiros caracteres e domínio de nível superior mascarados (por exemplo jo••••@ex••.com) e nomes como J••• D• mesmo para o proprietário do dashboard se ele acessar pela URL pública. A Globe API também omite completamente os campos identity_email, identity_name e identity_plan da resposta pública — os dados não estão apenas escondidos na UI, eles nunca são transmitidos.
Esta é uma garantia dura: você pode compartilhar um link público sem vazar e-mails reais de clientes para quem o receber.
Onde os badges aparecem
- Globo 3D: clique em um marcador de visitante para abrir seu popup — o popup mostra o badge (verde para Paying, azul para Identified).
- Aba Journeys → Users: cada linha na lista Users mostra o badge, mais um card de identidade completo no painel de detalhes do visitante mostrando e-mail, nome, plano e quaisquer traits personalizados enviados com
identify(). Você pode filtrar a lista com os filtros de goal, device, OS, país e source acima da tabela.
Perguntas frequentes
P: Preciso de cookies para usar identify()?
R: Não. O modo cookieless do Zenovay usa um visitor ID em memória com escopo de janela — identify() vincula a sessão existente ao usuário sem definir nenhum cookie ou entrada no localStorage.
P: identify() requer consentimento sob GDPR / ePrivacy?
R: Depende da sua base de processamento. O tracker cookieless em si não armazena nada no dispositivo do usuário, então não aciona o artigo 5(3) da ePrivacy. No entanto, a chamada identify() processa dados pessoais (e-mail, nome) — você precisa de base legal sob o artigo 6 do GDPR para isso. Para a maioria dos produtos, "execução de contrato" (o usuário está logado no seu produto) é a base.
P: Posso usar identify() para marcar um visitante como pagante diretamente, sem webhook?
R: Não por design. O status Paying é derivado de total_revenue > 0 ou de um customer ID de provedor de pagamento, ambos definidos por webhooks. Isso mantém o valor verificável — sua equipe financeira confia no badge porque ele está vinculado a dinheiro real. Se você precisar marcar um visitante manualmente para testes, execute um pagamento de teste de $0 via Stripe Test Mode.
P: O que acontece se eu chamar identify() com um ID diferente para a mesma sessão de navegador?
R: Zenovay trata isso como uma troca de conta — a nova identidade substitui a antiga para esse registro de visitante. O evento identify anterior permanece na timeline para que você possa auditar trocas de conta.
Artigos relacionados
- Como compartilho um dashboard público? — mascaramento e controle de acesso para links compartilhados
- Zenovay usa cookies? — como a identificação funciona sem cookies
- Integração Stripe Revenue — conectando webhooks de pagamento para badges Paying