Lorsque Custom Fields est activé dans votre intégration Klaviyo, JeriCommerce synchronise les attributs client sous forme de propriétés personnalisées du profil via l’API Profile Import de Klaviyo. Elles apparaissent dans Klaviyo > Profiles > [Profile] > Custom Properties et peuvent être utilisées dans des flux, des segments et du contenu dynamique.

Pour consulter la liste complète des propriétés synchronisées, leur signification et le moment où chacune est synchronisée, consultez Champs personnalisés : propriétés client synchronisées.

Noms des propriétés Klaviyo

La plupart des noms de propriété correspondent aux noms génériques, mais Klaviyo présente des différences importantes de nommage et de type de données :

Nom de propriété Klaviyo Type
balance Nombre entier (sous forme de chaîne)
birthdate Date (yyyy-MM-dd)
jericommerce_download_wallet_pass_url Chaîne URL
tier-name Chaîne de caractères
tier-balance Nombre entier (sous forme de chaîne)
tier-entered-at Date (yyyy-MM-dd)
tier-expires-at Date (yyyy-MM-dd)

Principales différences par rapport à Shopify

  • Identification du profil : dans Klaviyo, les clients sont associés par adresse e-mail (contre l’identifiant client GraphQL de Shopify).
  • Nommage des propriétés : l’URL de téléchargement utilise jericommerce_download_wallet_pass_url (avec des tirets bas au lieu de tirets).
  • Format des dates : les dates sont envoyées sous forme de chaînes yyyy-MM-dd. Si une date est manquante, la valeur "-" est envoyée.

Activer Custom Fields

Dans JeriCommerce, ouvrez Settings → Integrations → Klaviyo, activez Custom Fields, puis enregistrez. La synchronisation groupée initiale renseigne les valeurs disponibles pour les profils clients admissibles. Les profils Klaviyo étant associés par adresse e-mail, les données client importées sont synchronisées lorsque le profil utilisant la même adresse e-mail est disponible.

Fonctionnement de la synchronisation

  • En temps réel : chaque propriété est mise à jour via l’API Profile Import de Klaviyo lorsque ses données changent (avec un délai de regroupement de 2 secondes).
  • Synchronisation groupée initiale : lorsque Custom Fields est activé pour la première fois, un import groupé est lancé à l’aide de l’API Profile Bulk Import Jobs de Klaviyo, à raison de 500 clients par lot. Seules les valeurs disponibles pour chaque client admissible sont incluses.

Consultez Enregistrer les événements Wallet dans Klaviyo pour également transmettre les événements JeriCommerce à Klaviyo afin de déclencher des flux et de créer des analyses.