Quando Custom Fields è attivo nell'integrazione Shopify, JeriCommerce crea e aggiorna i metafield cliente nello spazio dei nomi jericommerce.

Si trovano in Shopify Admin > Customers > [Customer] > Metafields e sono disponibili in Shopify Liquid, Shopify Flow e nell'API Shopify.

Per l'elenco completo delle proprietà sincronizzate, il loro significato e quando vengono aggiornate, consulta Campi personalizzati: proprietà cliente sincronizzate.

Chiavi dei metafield Shopify

Tutti i metafield sono nello spazio dei nomi jericommerce. Per ogni cliente vengono create le chiavi seguenti:

Chiave metafield
jericommerce.balance
jericommerce.birthdate
jericommerce.download-wallet-pass-url
jericommerce.tier-name
jericommerce.tier-balance
jericommerce.tier-entered-at
jericommerce.tier-expires-at

Attiva Custom Fields

In JeriCommerce, vai a Settings → Integrations → Shopify, attiva Custom Fields e salva. La sincronizzazione iniziale completa i valori disponibili per i profili cliente esistenti idonei.

Quando un cliente viene importato o un profilo JeriCommerce esistente viene collegato a un cliente Shopify, JeriCommerce salva prima i dati del profilo, poi accoda un processo in background separato per sincronizzare i campi attualmente disponibili per quel cliente. I campi potrebbero comparire dopo l'esecuzione del processo.

L'importazione iniziale procede in background in questo ordine: Users, Loyalty, poi Custom Fields. Se Shopify non fornisce un campo del profilo, JeriCommerce lascia invariato il valore esistente.

Come funziona la sincronizzazione Shopify

  • In tempo reale: ogni metafield viene aggiornato tramite una mutation GraphQL customerUpdate quando cambiano i dati (con un ritardo di 2 secondi).
  • Sincronizzazione iniziale in blocco: alla prima attivazione di Custom Fields, un'operazione in blocco genera un file JSONL e lo carica tramite Shopify Staged Uploads e Bulk Mutation API. Sono inclusi solo i valori disponibili per ciascun cliente idoneo.

Tag cliente

Oltre ai metafield, JeriCommerce gestisce due tag cliente per registrare lo stato di installazione del wallet pass. È presente un solo tag alla volta.

Tag Quando viene impostato
JericommercePassInstalled Quando il cliente salva il wallet pass in Apple Wallet o Google Wallet
JericommercePassUninstalled Quando il cliente rimuove il wallet pass da Apple Wallet

Questi tag compaiono nell'elenco dei tag del cliente in Shopify Admin e possono essere usati nei segmenti, flussi e automazioni Shopify.

Correlato: Shopify Flows ed eventi, scopri come usare gli eventi JeriCommerce come trigger in Shopify Flow.