Shopify

Sync Data

Scopri come sincronizzare e personalizzare i dati dal tuo negozio Shopify

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

Configura la sincronizzazione #

Per sincronizzare i dati del tuo negozio Shopify con Clerk, è necessario 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 nello store Shopify.

Requisiti di accesso: Solo i proprietari dello store o lo staff con permessi di amministratore possono creare l’app (non tramite accesso collaborativo). Se configuri per un cliente, ti serve l’accesso come staff 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 aprire direttamente il Dev Dashboard dopo aver effettuato il login.

  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. Sotto Embed App in Shopify Admin, rimuovi la spunta. L’app necessita solo di essere installata una volta e non deve apparire nel menu laterale di Shopify.

  9. In Webhooks API Version, seleziona l’ultima versione disponibile (almeno 2025-07).

Configura gli scope #

  1. Sotto Access scopes, concedi accesso agli scope elencati di seguito. Puoi incollare la seguente stringa direttamente nel campo di input per aggiungere tutti gli scope in una volta sola:

    read_all_orders,read_customers,write_customers,read_inventory,read_locales,read_locations,read_markets,read_markets_home,read_metaobjects,read_online_store_pages,read_orders,read_products,read_publications,read_content,read_translations
    Perché serve il permesso di scrittura? Clerk legge solo i dati, ma Shopify richiede lo scope write_customers per accedere ai campi di marketing di URL del cliente (ad esempio per sincronizzare customer.unsub_url).

    In alternativa puoi sceglierli individualmente:

    • Customers (read_ e write_)
    • Inventory (read_)
    • Locales (read_)
    • Locations (read_)
    • Markets (read_)
    • Markets Home (read_)
    • Metaobjects (read_)
    • Online Store Pages (read_)
    • Orders (read_)
    • All Orders (read_)
    • Products (read_)
    • Publications (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 nell’angolo in alto a destra.

  2. Shopify ti reindirizzerà su una pagina dove selezionare il negozio Shopify su cui installare l’app. Scegli il tuo negozio dalla lista.

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

Collega Clerk #

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

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

  3. Incolla i valori di Client ID e Client Secret nel form, poi clicca Start Sync.

Problema noto: Shopify potrebbe non generare un token alla prima sincronizzazione, causando un errore di autenticazione. Questo è un problema intermittente già noto di Shopify. Basta attendere 1–2 minuti e poi riprovare la sincronizzazione.

Markets e inventario #

Se gestisci più Shopify markets, località o posizioni di inventario, conferma questi campi prima di sincronizzare:

  • Shopify Market
  • Shopify Locale
  • Prefix URLs with Locale
  • Force Relative URLs
  • posizioni dell’inventario

Questi valori devono corrispondere alla configurazione del mercato/dominio di Shopify. Per una mappatura dettagliata dei campi, consulta le impostazioni di integrazione Shopify.

Dati delle varianti #

I dati delle varianti in Shopify possono comportarsi diversamente a seconda della configurazione Import only stock variant data.

Le tipiche proprietà delle varianti Shopify in Clerk.io includono:

  • variant_inventory_policy (lista di stringhe)
  • variant_inventory_tracking (lista di booleani)
  • variant_list_prices (lista di numeri)
  • variant_names (lista di stringhe)
  • variant_option_size (lista di stringhe)
  • variant_prices (lista di numeri)
  • variant_stocks (lista di numeri)
  • variant_weight (lista di numeri)
  • variant_weight_unit (lista di stringhe)
  • variants (lista di stringhe, ID varianti)

Esempio:

{
  "variant_inventory_policy": ["deny", "deny"],
  "variant_inventory_tracking": [true, true],
  "variant_list_prices": [240, 240],
  "variant_names": ["Xs", "M"],
  "variant_option_size": ["Xs", "M"],
  "variant_prices": [120, 120],
  "variant_stocks": [1, 7],
  "variant_weight": [0.4, 0.4],
  "variant_weight_unit": ["KILOGRAMS", "KILOGRAMS"],
  "variants": ["55970989179259", "55970989244795"]
}

Quando la funzione Import only stock variant data è attiva, queste liste includono solo le varianti in stock.

Personalizzazione dati prodotto #

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

Semplicemente vai 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 essere scritti sempre usando la loro key.

Normalmente saranno in minuscolo. Ad esempio, l’attributo “Sizes” va scritto “sizes”.

Non hai bisogno di includere il namespace - Clerk lo troverà automaticamente in base alla key.

In Shopify, puoi spesso trovare queste key cercando 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 ogni indirizzo email iscritto in Shopify.

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

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

Subscriber state configuration

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

La versione delle Webhooks API deve essere almeno 2022-04, quando questo supporto è stato aggiunto. Puoi controllare questo nell’app che hai creato per Clerk in Developer Dashboard in Settings.

Legacy Custom App #

Da gennaio 2026, Shopify non permette più la creazione di app personalizzate direttamente dall’admin dello store. Le app personalizzate esistenti continueranno a funzionare, ma questo metodo va usato solo se hai già un’app custom configurata. Per tutte le altre configurazioni, utilizza il metodo Developer Dashboard sopra.

Se hai già un’app personalizzata 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 consente ancora la 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, assegnale il nome “Clerk.io”, scegli il developer dell’app e poi clicca nuovamente su Create app.

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

Permissions configuration

  1. Sotto Admin API access scopes, dai accesso di Lettura (scope che iniziano con read_) ai seguenti. Per Customers, imposta Lettura e scrittura (include write_customers).

    Perché serve il permesso di scrittura? Clerk legge solo i dati, ma Shopify richiede lo scope write_customers per accedere ai campi di marketing di URL del cliente (ad esempio per sincronizzare customer.unsub_url).

    Puoi incollare la seguente stringa direttamente nel campo di input per aggiungere tutti gli scope in una volta sola:

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

    In alternativa puoi sceglierli singolarmente:

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

  1. Clicca su Save, poi 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. Sotto Sync Method, seleziona Shopify (Legacy Custom App).

  2. Incolla questi valori nel form. Scegli una dimensione predefinita dell’immagine 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.