Shopify

Sync Data

Scopri come sincronizzare e personalizzare i dati dal tuo negozio Shopify

Sincronizza i tuoi prodotti Shopify, i meta-field e gli iscritti con Clerk. Questa guida copre la creazione di un’app nel Developer Dashboard di Shopify, la personalizzazione dei dati dei prodotti e la sincronizzazione delle informazioni sugli iscritti.

Configurare la sincronizzazione dei dati #

Per sincronizzare i dati del tuo store Shopify con Clerk, devi creare un’app nel Developer Dashboard di Shopify e configurarla in Clerk. L’utente che configura la sincronizzazione deve avere accesso al Developer Dashboard e le autorizzazioni per sviluppare app sullo store Shopify.

Requisiti di accesso: Solo i proprietari dello store o lo staff con permessi per il Developer Dashboard possono creare l’app (non tramite accesso collaborativo). Se si sta configurando per un cliente, è necessario lo staff access o le credenziali dell’app da parte loro.

Crea l’app #

  1. In Shopify, clicca su Settings.

  2. Clicca su Apps and sales channels.

  3. Clicca su Develop apps.

  4. Clicca su Build apps in Dev Dashboard.

    • Se non vedi questa opzione, clicca invece su Learn more.
    • Nella nuova finestra che si apre, clicca su Go to Dev Dashboard.
    • In alternativa, puoi apri direttamente il Dev Dashboard dopo l’accesso.

  5. Nel Developer Dashboard, clicca su Create App.

  6. Inserisci Clerk.io come nome dell’app.

  7. In App URL, aggiungi il placeholder standard di Shopify per le app: https://shopify.dev/docs/apps/default-app-home

  8. In Embed App in Shopify Admin, rimuovi la spunta. L’app deve essere installata solo una volta e non deve comparire nel menu laterale di Shopify.

  9. In Webhooks API Version, seleziona la versione più recente (almeno 2025-07).

Configura gli scope #

  1. In Access scopes, concedi accesso ai seguenti:

    • Customers (read_ e write_)
    • Inventory (read_)
    • Locales (read_)
    • Markets (read_)
    • Metaobjects (read_)
    • Online Store Pages (read_)
    • Orders (read_)
    • All Orders (read_)
    • Products (read_)
    • Store Content (read_)
    • Translations (read_)

  2. In fondo alla pagina, clicca su Release.

Installa l’app #

  1. Clicca su Home, poi clicca su Install app nell’angolo in alto a destra.

  2. Shopify ti reindirizza a una pagina dove selezioni lo store Shopify su cui installare l’app. Seleziona il tuo store dall’elenco.

  3. Nella pagina successiva, rivedi il sommario dei dettagli dell’app e clicca su Install nell’angolo in basso a destra.

Connetti a Clerk #

  1. Torna al Developer Dashboard e clicca su Settings all’interno dell’app Clerk.io. Qui troverai il Client ID e il Client Secret.

  2. Vai su my.clerk.io > Data > Configuration. In Sync Method, seleziona Shopify.

  3. Incolla il Client ID e il Client Secret nel modulo. Poi clicca su Start Sync.

Problema noto: Shopify potrebbe non generare un token alla prima sincronizzazione, causando un errore di autenticazione. Si tratta di un problema intermittente noto in Shopify. Basta attendere 1-2 minuti e riprovare a sincronizzare.

Personalizzazione dei dati dei prodotti #

In Shopify, i meta-field 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.

Add attributes

Gli attributi devono sempre essere scritti usando il loro key.

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

Non è necessario includere il namespace – Clerk lo troverà automaticamente in base alla key.

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

Custom data

Sincronizza gli 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 qualsiasi indirizzo email iscritto in Shopify.

Questo può poi essere utilizzato per l’Auto-Email.

Semplicemente vai nel tuo store my.clerk.io, poi Data -> Configuration e imposta Include Subscriber State su Yes. Poi clicca su Save e avvia una nuova sincronizzazione.

Subscriber state configuration

Se vuoi usare un link di disiscrizione per i clienti, allora ogni cliente che viene importato da un backend Shopify ha un attributo unsub_url che può essere usato nei design auto email nel campo di disiscrizione: {{customer.unsub_url}}

La versione dell’API Webhooks deve essere almeno la 2022-04, dove è stato aggiunto questo supporto. Puoi verificarlo nell’app creata per Clerk nel Developer Dashboard sotto Settings.

Legacy Custom App #

Da gennaio 2026, Shopify non consente più la creazione diretta di app personalizzate nell’admin di Shopify per gli store. Le app personalizzate esistenti continueranno a funzionare, ma questo metodo deve essere usato solo se hai già un’app personalizzata configurata. Per tutte le altre configurazioni, usa il metodo Developer Dashboard sopra.

Se hai già un’app personalizzata esistente e hai bisogno di usarla o modificarla, seleziona Shopify (Legacy Custom App) come Sync Method in my.clerk.io > Data > Configuration.

Questi passaggi valgono solo se il tuo store Shopify ha ancora accesso per creare app personalizzate nell’admin Shopify.

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

  1. Clicca su Create app, chiamala “Clerk.io”, scegli il sviluppatore dell’app, poi clicca ancora su Create app.

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

Permissions configuration

  1. In Admin API access scopes, concedi l’accesso in lettura (scopes che iniziano con read_) ai seguenti. Per Customers, imposta su Lettura e scrittura (inclusi write_customers) poiché Shopify lo richiede per accedere ai campi URL di marketing dei clienti (ad esempio per customer.unsub_url).

    • Customers (read_ e write_)
    • Inventory (read_)
    • Locales (read_)
    • Markets (read_)
    • Metaobjects (read_)
    • Online Store Pages (read_)
    • Orders (read_)
    • All Orders (read_)
    • Products (read_)
    • Store Content (read_)
    • Translations (read_)
API access scopes

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

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

API credentials

  1. Vai su my.clerk.io > Data > Configuration. In Sync Method, seleziona Shopify (Legacy Custom App).

  2. Incolla questi valori nel modulo. Scegli una dimensione immagine predefinita se richiesto, poi clicca su Start Sync.

Questa pagina è stata tradotta da un'utile intelligenza artificiale, quindi potrebbero esserci errori linguistici. Grazie per la comprensione.