Wenn Custom Fields in Ihrer Shopify-Integration aktiviert ist, erstellt und pflegt JeriCommerce Kunden-Metafelder im Namespace jericommerce.

Diese Felder erscheinen unter Shopify Admin > Customers > [Customer] > Metafields und stehen in Shopify Liquid, Shopify Flow und der Shopify-API zur Verfügung.

Die vollständige Liste der synchronisierten Eigenschaften, ihre Bedeutung und ihren Synchronisierungszeitpunkt finden Sie unter Custom Fields: synchronisierte Kundeneigenschaften.

Shopify-Metafeldschlüssel

Alle Metafelder liegen im Namespace jericommerce. Für jeden Kunden werden folgende Schlüssel erstellt:

Metafeldschlüssel
jericommerce.balance
jericommerce.birthdate
jericommerce.download-wallet-pass-url
jericommerce.tier-name
jericommerce.tier-balance
jericommerce.tier-entered-at
jericommerce.tier-expires-at

Custom Fields einschalten

Öffnen Sie in JeriCommerce Settings → Integrations → Shopify, schalten Sie Custom Fields ein und speichern Sie. Bei der ersten gebündelten Synchronisierung werden verfügbare Werte für geeignete bestehende Kundenprofile ergänzt.

Wenn ein Kunde importiert oder ein bestehendes JeriCommerce-Profil mit einem Shopify-Kunden verknüpft wird, speichert JeriCommerce zuerst die Profildaten und stellt dann im Hintergrund einen separaten Auftrag bereit, der die verfügbaren Felder für diesen Kunden synchronisiert. Die Felder werden möglicherweise erst angezeigt, nachdem dieser Auftrag ausgeführt wurde.

Der erste Import durchläuft diese Hintergrundschritte in der folgenden Reihenfolge: Users, Loyalty und anschließend Custom Fields. Wenn Shopify ein Profilfeld nicht übermittelt, lässt JeriCommerce dessen vorhandenen Wert unverändert.

Funktionsweise der Synchronisierung mit Shopify

  • In Echtzeit: Bei einer Datenänderung wird jedes Metafeld über eine Shopify-GraphQL-customerUpdate-Mutation aktualisiert (Verzögerung von 2 Sekunden).
  • Erste gebündelte Synchronisierung: Bei erstmaliger Aktivierung von Custom Fields wird durch eine Bulk-Operation eine JSONL-Datei erstellt und über Shopify Staged Uploads und die Bulk Mutation API hochgeladen. Für jeden geeigneten Kunden werden nur verfügbare Werte eingeschlossen.

Kundentags

Zusätzlich zu Metafeldern verwaltet JeriCommerce zwei Kundentags, um die Installation des Wallet-Passes zu erfassen. Es ist immer nur ein Tag vorhanden.

Tag Wird hinzugefügt, wenn
JericommercePassInstalled der Kunde den Wallet-Pass zu Apple Wallet oder Google Wallet hinzufügt
JericommercePassUninstalled der Kunde den Wallet-Pass aus Apple Wallet entfernt

Diese Tags erscheinen in Shopify Admin in der Tagliste des Kunden und können in Shopify-Segmenten, Flows und Automatisierungen verwendet werden.

Verwandt: Shopify Flows und Ereignisse – Erfahren Sie, wie Sie JeriCommerce-Ereignisse als Auslöser in Shopify Flow verwenden.