Identificação de Usuário

Como associar sessões anônimas a usuários logados com mytrics.identify() e mytrics.getIds().

Voltar à Home
identify

Associar usuário logado à sessão

Por padrão, o Mytrics gera IDs anônimos (visitorId, sessionId) baseados em hash do IP+UA+dia. Quando o usuário faz login, chame window.mytrics.identify(userId, metadata) para vincular a sessão atual ao seu usuário real:

javascript
"color:#6a737d">// Após login bem-sucedido
window.mytrics.identify('user_42', {
  email: 'maria@exemplo.com',
  plano: 'pro',
  criadoEm: '2024-01-15'
});

Parâmetros

CAMPOTIPOOBRIG.DESCRIÇÃO
userIdstringSimID único do user no seu sistema
metadataobjectNãoPropriedades adicionais (email, plano, etc). Sem PII sensível.
Persiste em todas as sessões futuras
Depois de identificado, o userId fica salvo por 1 ano. Quando o usuário voltar (mesmo após logout), o Mytrics reconhece o mesmo userId e vincula a nova sessão.
getIds

Recuperar os IDs da sessão

Para passar o visitorId/sessionId para o seu backend (e.g. correlacionar com sua sessão de usuário, atribuir eventos server-side):

javascript
"color:#6a737d">// No checkout, envie os IDs pro backend junto com a compra
"color:#ff7b72">const ids = window.mytrics.getIds();

"color:#ff7b72">await fetch('/api/orders', {
  method: 'POST',
  body: JSON.stringify({
    productId: 'sku-123',
    price: 99.90,
    visitorId: ids.visitorId,
    sessionId: ids.sessionId
  })
});

Seu backend pode usar visitorId/sessionId como chaves de correlação ao enviar webhooks para a Revenue API (plano Pro+).

Reset

Resetar identificação (logout)

Em logout, chame identify com null para limpar a vinculação:

javascript
"color:#6a737d">// Logout
window.mytrics.identify(null);
SPA: re-identifique após cada login
Em Single-Page Apps, chame identify() toda vez que o estado de autenticação muda, não só na inicialização. Ex: após Google OAuth, magic link, etc.
LGPD

Identificação e LGPD

Identificar um usuário é considerado tratamento de dado pessoal. Certifique-se de ter base legal (consentimento, contrato ou legítimo interesse) e exponha isso na sua política de privacidade.

Email no metadata?
Pode enviar email no metadata (é dado pessoal, mas a base legal é a mesma do login). Não envie CPF, RG, endereço, dados financeiros ou de saúde.