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

1

Apri l'integrazione Klaviyo

2

Attiva la funzionalità Events

Attiva Events e salva le modifiche.

3

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.

Profilo Klaviyo con eventi JeriCommerce
Eventi JeriCommerce visibili nel profilo cliente Klaviyo

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à.