ConverlayConverlay

Identificação de Usuários

Use converlay.identify() para associar o visitante atual com dados do cliente. Isso melhora as taxas de correspondência em plataformas de anúncios como Meta CAPI e TikTok Events API.

API

identify()
converlay.identify({
  customerId: 'cust_12345',
  email: 'jane@example.com',
  phone: '+15551234567',
  firstName: 'Jane',
  lastName: 'Doe',
})

Campos de IdentifyData

CampoTipoDescrição
customerIdstringSeu ID interno de cliente
emailstringEndereço de e-mail do cliente
phonestringNúmero de telefone (formato E.164 recomendado)
firstNamestringPrimeiro nome do cliente
lastNamestringSobrenome do cliente

Hashing de PII

Todas as informações de identificação pessoal (e-mail, telefone, nome) são enviadas em texto simples para o endpoint de coleta do Converlay, depois hasheadas com SHA-256 no servidor antes do encaminhamento para plataformas de anúncios. Normalização específica por país (conversão para minúsculas, remoção de espaços, formatação de telefone) é aplicada antes do hashing.

Quando chamar identify

  • Após o login — assim que o cliente se autenticar
  • No checkout — quando as informações de envio/cobrança estiverem disponíveis
  • Na página da conta — quando o cliente visualizar ou atualizar seu perfil

Os dados de identidade persistem durante a sessão atual. Chamadas subsequentes de track() incluirão os dados do usuário identificado automaticamente.

Exemplos

Após o login

typescript
async function handleLogin(email, password) {
  const user = await api.login(email, password)

  // Identify after login
  converlay.identify({
    customerId: user.id,
    email: user.email,
    firstName: user.firstName,
    lastName: user.lastName,
  })
}

Na finalização do pedido

typescript
function onCheckoutComplete(order) {
  // Identify + track purchase
  converlay.identify({
    customerId: order.customerId,
    email: order.email,
    phone: order.phone,
    firstName: order.shippingAddress.firstName,
    lastName: order.shippingAddress.lastName,
  })

  converlay.track('purchase', {
    ecommerce: {
      transaction_id: order.id,
      value: order.total,
      currency: order.currency,
      items: order.lineItems.map(item => ({
        item_id: item.variantId,
        item_name: item.title,
        price: item.price,
        quantity: item.quantity,
      })),
    },
  })
}
Anterior← Rastreamento de eventosPróximoConsentimento e privacidade →