Lorsque Custom Fields est activé dans votre intégration Shopify, JeriCommerce crée et maintient des champs méta client dans l'espace de noms jericommerce.

Ils apparaissent dans Shopify Admin > Customers > [Customer] > Metafields et sont accessibles dans Shopify Liquid, Shopify Flow et l'API Shopify.

Pour consulter la liste complète des propriétés synchronisées, leur signification et leur fréquence de synchronisation, reportez-vous à Champs personnalisés : propriétés client synchronisées.

Clés de champs méta Shopify

Tous les champs méta se trouvent dans l'espace de noms jericommerce. Les clés suivantes sont créées pour chaque client :

Clé du champ méta
jericommerce.balance
jericommerce.birthdate
jericommerce.download-wallet-pass-url
jericommerce.tier-name
jericommerce.tier-balance
jericommerce.tier-entered-at
jericommerce.tier-expires-at

Activer Custom Fields

Dans JeriCommerce, accédez à Settings → Integrations → Shopify, activez Custom Fields, puis enregistrez. La synchronisation groupée initiale renseigne les valeurs disponibles pour les profils clients existants admissibles.

Lorsqu'un client est importé ou qu'un profil JeriCommerce existant est associé à un client Shopify, JeriCommerce enregistre d'abord les données du profil, puis place dans une file d'attente une tâche d'arrière-plan distincte pour synchroniser les champs actuellement disponibles pour ce client. Ils peuvent apparaître après l'exécution de cette tâche.

L'importation initiale s'effectue en plusieurs étapes d'arrière-plan dans cet ordre : Users, Loyalty, puis Custom Fields. Si Shopify ne fournit pas une propriété de profil, JeriCommerce conserve sa valeur existante.

Fonctionnement de la synchronisation Shopify

  • En temps réel : chaque champ méta est mis à jour au moyen d'une mutation Shopify GraphQL customerUpdate lorsque sa donnée change (temporisation de 2 secondes).
  • Synchronisation groupée initiale : lors de la première activation de Custom Fields, une opération groupée crée un fichier JSONL et l'importe via Staged Uploads et l'API Bulk Mutation de Shopify. Seules les valeurs disponibles pour chaque client admissible sont incluses.

Balises client

En plus des champs méta, JeriCommerce gère deux balises client pour suivre l'état d'installation du pass de portefeuille. Une seule balise est présente à la fois.

Balise Quand elle est attribuée
JericommercePassInstalled Lorsque le client enregistre le pass de portefeuille dans Apple Wallet ou Google Wallet.
JericommercePassUninstalled Lorsque le client supprime le pass de portefeuille d'Apple Wallet.

Ces balises apparaissent dans la liste des balises du client dans Shopify Admin. Vous pouvez les utiliser dans les segments, les flows et les automatisations Shopify.

Articles associés : Shopify Flow et événements : découvrez comment utiliser les événements JeriCommerce comme déclencheurs dans Shopify Flow.