ConverlayConverlay

Identification des utilisateurs

Utilisez converlay.identify() pour associer le visiteur actuel à des données client. Cela améliore les taux de correspondance sur les plateformes publicitaires comme Meta CAPI et TikTok Events API.

API

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

Champs IdentifyData

ChampTypeDescription
customerIdstringVotre identifiant client interne
emailstringAdresse e-mail du client
phonestringNuméro de téléphone (format E.164 recommandé)
firstNamestringPrénom du client
lastNamestringNom de famille du client

Hachage des PII

Toutes les données personnelles identifiables (e-mail, téléphone, nom) sont envoyées en texte clair au point de collecte Converlay, puis hachées avec SHA-256 côté serveur avant le transfert vers les plateformes publicitaires. Une normalisation spécifique au pays (mise en minuscules, suppression des espaces, formatage du téléphone) est appliquée avant le hachage.

Quand appeler identify

  • Après la connexion — dès que le client s'authentifie
  • Au checkout — lorsque les informations de livraison/facturation sont disponibles
  • Sur la page du compte — lorsque le client consulte ou met à jour son profil

Les données d'identité persistent pour la session en cours. Les appels track() suivants incluront automatiquement les données de l'utilisateur identifié.

Exemples

Après la connexion

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,
  })
}

À la finalisation de la commande

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,
      })),
    },
  })
}
Précédent← Suivi des événementsSuivantConsentement et confidentialité →