JeriCommerce invia automaticamente a Klaviyo tutti i 19 eventi cliente tramite Events API. Puoi così attivare flussi, creare segmenti e report in base alle attività fedeltà e alla scadenza dei coupon. Per l'elenco completo degli eventi e delle relative proprietà, consulta la guida di riferimento agli eventi.
Per l'evento Balance changed, event.previous contiene il saldo punti prima della modifica.
L'evento Coupon expiring include il codice e i dati di scadenza per le automazioni Klaviyo.
Attiva gli eventi ¶
Apri l'integrazione Klaviyo
Attiva la funzionalità Events
Attiva Events e salva le modifiche.
Controlla i profili Klaviyo
Da quel momento, ogni evento cliente genera una chiamata a Klaviyo Event API associata al profilo cliente. Gli eventi compaiono nella cronologia delle attività di ciascun profilo.

Nomi delle metriche degli eventi ¶
Ogni evento compare in Klaviyo come metrica con lo stesso nome riportato nella guida di riferimento agli eventi, per esempio Balance changed, Wallet pass installed, Customer birthday. Usa questi nomi quando configuri i trigger dei flussi o le condizioni dei segmenti in Klaviyo.
Per le cinque email automatiche JeriCommerce, usa queste metriche: Customer created, Wallet pass requested, Coupon assigned, Reward redeemable e Reward redeemed. La guida alle email automatiche spiega quali proprietà inserire in ciascuna email e quando disattivare l'email JeriCommerce corrispondente.
Payload degli eventi Klaviyo ¶
Ogni evento viene inviato tramite Klaviyo Events API con questa struttura:
{
"data": {
"type": "event",
"attributes": {
"time": "2026-03-08T12:00:00Z",
"properties": { ... },
"metric": {
"data": {
"type": "metric",
"attributes": { "name": "Balance changed" }
}
},
"profile": {
"data": {
"type": "profile",
"attributes": { "email": "customer@example.com" }
}
}
},
"unique_id": "event-uuid"
}
}
Il campo metric.name corrisponde ai nomi degli eventi nella guida di riferimento. Usali per configurare i trigger dei flussi o le condizioni dei segmenti in Klaviyo.
Campi personalizzati sincronizzati nel profilo ¶
Oltre agli eventi, JeriCommerce sincronizza automaticamente questi campi personalizzati in ogni profilo Klaviyo:
| Nome del campo | Formato | Descrizione |
|---|---|---|
balance |
Number | Saldo punti fedeltà corrente |
birthdate |
yyyy-MM-dd |
Data di nascita del cliente |
tier-name |
String | Nome del livello corrente |
tier-balance |
Number | Punti conteggiati per il livello |
tier-entered-at |
yyyy-MM-dd |
Data in cui il cliente è entrato nel livello corrente |
tier-expires-at |
yyyy-MM-dd |
Data del prossimo ricalcolo del livello |
jericommerce_download_wallet_pass_url |
URL | Link universale per scaricare il wallet pass |
Usa questi campi per creare segmenti Klaviyo, per esempio tutti i clienti del livello «Gold», oppure per personalizzare email e SMS con i dati fedeltà.