Identificação do usuário

Chame o identify do SDK depois que o usuário fizer login ou preencher o perfil, e antes de mostrar qualquer paywall. Esses dados melhoram o matching nas plataformas de anúncio, em especial no Facebook CAPI e na TikTok Events API. Usa RevenueCat e o app deixa comprar antes do cadastro? Chame o identify com userId: await Purchases.getAppUserID() antes do paywall. Sem isso a compra não se liga ao anúncio: aparece como Direto e a campanha mostra 0 vendas. Detalhes na página do RevenueCat.

import Paywallo from "@virex-tech/paywallo-sdk";

// Chama depois do login ou cadastro
async function onLoginSuccess(user: User) {
  await Paywallo.identify({
    email: user.email,
    phone: user.phone,
    firstName: user.firstName,
    lastName: user.lastName,
    dateOfBirth: user.dateOfBirth, // "YYYY-MM-DD"
    gender: user.gender,           // "m" | "f"
  });
}

Pra confirmar que os dados chegaram, procura o usuário em Usuários no dashboard.

O campo properties aceita atributos livres do tipo Record<string, string | number | boolean | null>. Use para passar contexto do usuário que seja útil nos seus segmentos e filtros.

await Paywallo.identify({
  email: user.email,
  properties: {
    userId: user.id,                        // identificador do seu usuário
    name: user.name,
    subscriptionStatus: user.status,        // "active" | "trial" | "expired"
    country: user.country,
    language: user.language,
  },
});

properties.userId é o identificador do seu usuário no seu sistema. É ele que liga todos os dispositivos da mesma pessoa a um único perfil, então a atribuição e os eventos continuam corretos quando o usuário troca de aparelho ou reinstala o app.

Chame o reset do SDK no logout ou na troca de conta. Ele apaga os dados de identificação guardados no aparelho e gera um id anônimo novo. Depois do próximo login, chame o identify() de novo: sem isso o aparelho volta a ser anônimo, e o envio de push por recipients deixa de encontrá-lo.

import Paywallo from "@virex-tech/paywallo-sdk";

async function handleLogout() {
  await Paywallo.reset();
  // navega pra tela de login
}