Quando Custom Fields è attivo nell'integrazione Klaviyo, JeriCommerce sincronizza gli attributi cliente come proprietà personalizzate del profilo tramite Klaviyo Profile Import API. Le proprietà sono disponibili in Klaviyo > Profiles > [Profile] > Custom Properties e si possono usare nei flussi, nei segmenti e nei contenuti dinamici.
Per l'elenco completo delle proprietà sincronizzate, il loro significato e il momento in cui vengono aggiornate, consulta Campi personalizzati: proprietà cliente sincronizzate.
Nomi delle proprietà Klaviyo ¶
La maggior parte dei nomi corrisponde a quelli generici, ma alcuni nomi e tipi di dati sono specifici di Klaviyo:
| Nome proprietà Klaviyo | Tipo |
|---|---|
balance |
Integer (come stringa) |
birthdate |
Date (yyyy-MM-dd) |
jericommerce_download_wallet_pass_url |
URL string |
tier-name |
String |
tier-balance |
Integer (come stringa) |
tier-entered-at |
Date (yyyy-MM-dd) |
tier-expires-at |
Date (yyyy-MM-dd) |
Differenze principali rispetto a Shopify ¶
- Identificazione del profilo: in Klaviyo i clienti vengono associati tramite email, mentre Shopify usa l'ID cliente GraphQL.
- Nome della proprietà: l'URL di download corrisponde a
jericommerce_download_wallet_pass_url(con trattini bassi invece di trattini). - Formato della data: le date vengono inviate come stringhe
yyyy-MM-dd. Se una data non è disponibile, viene inviato il valore"-".
Attiva Custom Fields ¶
In JeriCommerce, apri Settings → Integrations → Klaviyo, attiva Custom Fields e salva. La sincronizzazione iniziale in blocco completa i valori disponibili nei profili cliente idonei. I profili Klaviyo vengono associati tramite email, quindi i dati importati si sincronizzano quando è disponibile il profilo con l'email corrispondente.
Come funziona la sincronizzazione ¶
- In tempo reale: ogni proprietà si aggiorna tramite Klaviyo Profile Import API quando cambiano i dati (ritardo di 2 secondi).
- Sincronizzazione iniziale in blocco: alla prima attivazione di Custom Fields, viene eseguita un'importazione in blocco tramite Klaviyo Profile Bulk Import Jobs API, elaborando 500 clienti per gruppo. Sono inclusi solo i valori disponibili per ciascun cliente idoneo.
Consulta Registra gli eventi del wallet in Klaviyo per inviare a Klaviyo anche gli eventi JeriCommerce da usare come trigger dei flussi e nelle analisi.