Identificazione utenti
Usa converlay.identify() per associare il visitatore corrente ai dati del cliente. Questo migliora i tassi di corrispondenza sulle piattaforme pubblicitarie come Meta CAPI e TikTok Events API.
API
identify()
converlay.identify({
customerId: 'cust_12345',
email: 'jane@example.com',
phone: '+15551234567',
firstName: 'Jane',
lastName: 'Doe',
})Campi di IdentifyData
| Campo | Tipo | Descrizione |
|---|---|---|
customerId | string | Il tuo ID cliente interno |
email | string | Indirizzo email del cliente |
phone | string | Numero di telefono (formato E.164 consigliato) |
firstName | string | Nome del cliente |
lastName | string | Cognome del cliente |
Hashing dei PII
Tutte le informazioni personali identificabili (email, telefono, nome) vengono inviate in chiaro all'endpoint di raccolta di Converlay, quindi sottoposte a hashing con SHA-256 sul server prima dell'inoltro alle piattaforme pubblicitarie. Prima dell'hashing viene applicata una normalizzazione specifica per paese (conversione in minuscolo, rimozione degli spazi, formattazione del telefono).
Quando chiamare identify
- Dopo il login — non appena il cliente si autentica
- Al checkout — quando le informazioni di spedizione/fatturazione sono disponibili
- Nella pagina account — quando il cliente visualizza o aggiorna il proprio profilo
I dati di identità persistono per la sessione corrente. Le successive chiamate a track() includeranno automaticamente i dati dell'utente identificato.
Esempi
Dopo il 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,
})
}Al completamento del checkout
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,
})),
},
})
}