Identificação do usuário

Chame Paywallo.identify() depois que o usuário fizer login ou preencher o perfil, e antes de mostrar qualquer paywall. Os dados são usados para melhorar a correspondência de atribuição nas plataformas de anúncio, especialmente no Facebook CAPI e TikTok Events API.

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"
  });
}

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 é usado no campo recipients ao disparar notificações push — garantindo que a mensagem chegue ao usuário certo independente do dispositivo. Consulte a página de Notificações para ver como usar.

Chame Paywallo.reset() quando o usuário fizer logout. Isso limpa os dados de identificação associados à sessão atual.

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

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