Sync Data

Sincronizza i tuoi prodotti Shopify, i meta-fields e gli iscritti con Clerk. Questa guida copre la personalizzazione dei dati dei prodotti e la sincronizzazione delle informazioni degli iscritti.

Configura la sincronizzazione dei dati #

Per sincronizzare i dati del tuo negozio Shopify con Clerk, devi creare un’app personalizzata in Shopify e configurarla in Clerk.

1. In Shopify, vai su Apps > App and sales channel settings e clicca su Develop apps.

2. Clicca su Create app, chiamala “Clerk.io”, scegli lo sviluppatore dell’app, poi clicca nuovamente su Create app.

3. Clicca su Configuration → Admin API integration → Configure.

4. Sotto Admin API access scopes, concedi l’accesso in sola lettura (scopes che iniziano con read_) ai seguenti elementi:

   • Customers

   • Inventory

   • Locales

   • Markets

   • Online Store Pages

   • Orders

   • Products

   • Store Content

   • Translations

5. Clicca su Save, poi Install App → Install.

6. Apri API Credentials e copia il tuo Shopify Domain e le API Key, Access Token e Secret Key dell’app.

7. Vai su my.clerk.io > Data > Configuration e incolla questi valori nel modulo. Scegli una dimensione immagine predefinita se richiesto, poi clicca su Start Sync.

Personalizzazione dei dati del prodotto #

In Shopify, i meta-fields e altri attributi che crei possono essere sincronizzati tramite my.clerk.io > System status > Data sync.

Vai semplicemente al campo di input chiamato Custom Attributes e inserisci gli attributi dei prodotti da includere.

Per aggiungere più attributi, separali con una virgola.

Gli attributi devono essere sempre scritti usando il loro key.

Questo di solito sarà tutto minuscolo. Ad esempio, l’attributo “Sizes” deve essere scritto “sizes”.

Non è necessario includere il namespace - Clerk lo troverà automaticamente in base al key.

In Shopify, spesso puoi trovare queste chiavi individuando il tuo attributo in Settings > Custom data > Products/Variants:

Sincronizzazione degli iscritti #

Shopify supporta la gestione degli iscritti direttamente nella piattaforma.

Questi possono essere facilmente sincronizzati con Clerk.

Quando attivato, importeremo quell’attributo “subscribed: true” per ogni indirizzo email che risulta iscritto in Shopify.

Questo potrà poi essere utilizzato per l’Auto-Email.

Vai semplicemente sul tuo store my.clerk.io, quindi Data -> Configuration e imposta Include Subscriber State su Yes. Poi clicca su Save e avvia una nuova sincronizzazione.

Se vuoi utilizzare un link di disiscrizione per i clienti, ogni cliente sincronizzato dal backend Shopify avrà un attributo unsub_url che potrà essere usato nei design auto email all’interno del campo di disiscrizione: {{customer.unsub_url}}

La versione dell’API Webhook di Shopify deve essere impostata almeno su 2022-04, dove è stato aggiunto tale supporto. Puoi verificarlo nell’app che crei per Clerk > Configuration > Admin API integration > Edit > Webhook subscriptions