Shopify

Sync Data

Scopri come sincronizzare e personalizzare i dati dal tuo negozio Shopify

Sincronizza i prodotti, i metacampi e gli iscritti del tuo Shopify su Clerk. Questa guida spiega come creare un’app nel Developer Dashboard di Shopify, personalizzare i dati dei prodotti e sincronizzare le informazioni degli iscritti.

Configura la sincronizzazione dei dati #

Per sincronizzare i dati del tuo negozio 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 i permessi per sviluppare app sul negozio Shopify.

Requisiti di accesso: Solo i proprietari del negozio o i membri dello staff con permessi di Amministratore possono creare l’app (non tramite accesso collaborativo). Se stai configurando per un cliente, ti serve l’accesso come staff oppure le credenziali dell’app fornite dal cliente.

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 aprire direttamente il Dev Dashboard dopo aver effettuato l’accesso.

  5. Nel Developer Dashboard, clicca su Create App.

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

  7. In App URL, aggiungi il link 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 apparire nel menu laterale di Shopify.

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

Configura i permessi (scopes) #

  1. In Access scopes, concedi l’accesso ai permessi elencati di seguito. Puoi incollare la seguente stringa direttamente nel campo di input per aggiungere tutti i permessi in una volta sola:

    read_all_orders,read_customers,write_customers,read_inventory,read_locales,read_markets,read_metaobjects,read_online_store_pages,read_orders,read_products,read_content,read_translations

    Oppure puoi selezionarli singolarmente:

    • 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 schermata, clicca su Release.

Installa l’app #

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

  2. Shopify ti reindirizzerà a una pagina in cui selezionare il negozio Shopify su cui installare l’app. Seleziona il tuo negozio dall’elenco.

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

Collega 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 al primo tentativo di sincronizzazione, causando un errore di autenticazione. Si tratta di un problema intermittente noto di Shopify. Basta attendere 1-2 minuti e riprovare a sincronizzare.

Personalizzazione dei dati prodotto #

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

Basta andare nel campo di input chiamato Custom Attributes e digitare gli attributi dei prodotti da includere.

Per aggiungere più attributi, separarli con una virgola.

Add attributes

Gli attributi devono essere sempre scritti utilizzando la loro key.

Di solito è tutto minuscolo. Ad esempio, l’attributo “Sizes” deve essere “sizes”.

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

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

Custom data

Sincronizzazione degli iscritti #

Shopify supporta la gestione degli iscritti direttamente sulla piattaforma.

Questi possono essere facilmente sincronizzati con Clerk.

Quando attivato, importeremo quell’attributo “subscribed: true” per qualsiasi indirizzo email iscritto su Shopify.

Potrà quindi essere usato per Auto-Email.

Basta andare sul negozio my.clerk.io, poi Data -> Configuration e impostare Include Subscriber State su Yes. Quindi clicca su Save e avvia una nuova sincronizzazione.

Subscriber state configuration

Se vuoi usare un link di disiscrizione per i clienti, ogni cliente importato da un backend Shopify avrà un attributo unsub_url che può essere usato nei design Auto-Email per il campo di disiscrizione: {{customer.unsub_url}}

La versione dell’API Webhooks deve essere almeno 2022-04, in quanto il supporto è stato aggiunto da quella versione. Puoi controllarlo nell’app che hai creato per Clerk nel Developer Dashboard sotto Settings.

App Personalizzata Legacy #

Da gennaio 2026, Shopify non permette più di creare app personalizzate direttamente dall’admin dei negozi. Le app personalizzate già esistenti continuano a funzionare, ma questo metodo dovrebbe essere usato solo se hai già configurato un’app personalizzata. Per tutte le altre configurazioni, usa il metodo Developer Dashboard sopra descritto.

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

Questi passaggi si applicano solo se il tuo negozio Shopify ha ancora accesso alla creazione di app personalizzate dall’admin.

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

  1. Clicca su Create app, assegna il nome “Clerk.io”, scegli lo sviluppatore dell’app, poi clicca di nuovo su Create app.

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

Permissions configuration

  1. In Admin API access scopes, concedi l’accesso in sola lettura (scopi che iniziano con read_) a quanto segue. Per Customers, impostalo su Lettura e scrittura (include write_customers) poiché Shopify lo richiede per accedere ai campi URL di marketing cliente (ad esempio per customer.unsub_url).

    Puoi incollare la seguente stringa direttamente nel campo di input per aggiungere tutti i permessi contemporaneamente:

    read_all_orders,read_customers,write_customers,read_inventory,read_locales,read_markets,read_metaobjects,read_online_store_pages,read_orders,read_products,read_content,read_translations

    Oppure puoi selezionarli singolarmente:

    • 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.