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 spiega 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 store Shopify con Clerk, devi creare un’app nel Developer Dashboard di Shopify e configurarla in Clerk. L’utente che effettua la sincronizzazione deve avere accesso al Developer Dashboard e i permessi per sviluppare app sullo store Shopify.

Requisiti di accesso: Solo i proprietari dello store o il personale con permessi da Amministratore possono creare l’app (non tramite accesso collaborativo). Se configuri per un cliente, hai bisogno dell’accesso come staff o delle credenziali dell’app.

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, invece clicca 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: https://shopify.dev/docs/apps/default-app-home

  8. Sotto Embed App in Shopify Admin, rimuovi il segno di spunta. L’app deve essere installata solo una volta e non è necessario che appaia nel menu laterale di Shopify.

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

Configura gli scope #

  1. Sotto Access scopes, concedi l’accesso agli scope elencati di seguito. Puoi incollare direttamente la seguente stringa nell’input per aggiungerli tutti insieme:

    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

    Oppure puoi selezionarli 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_)

  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à su una pagina dove scegliere lo store Shopify su cui installare l’app. Seleziona il tuo store dall’elenco.

  3. Nella pagina successiva, rivedi il riepilogo dei dettagli dell’app e clicca su Install 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. Sotto Sync Method, seleziona Shopify.

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

Problema noto: Shopify può non generare un token alla prima sincronizzazione, causando un errore di autenticazione. Si tratta di un problema intermittente noto in Shopify. Attendi semplicemente 1-2 minuti, quindi riprova la sincronizzazione.

Markets e inventario #

Se gestisci più markets, località o punti di inventario Shopify, conferma questi campi prima della sincronizzazione:

  • Shopify Market
  • Shopify Locale
  • Prefix URLs with Locale
  • Force Relative URLs
  • Inventory locations

Questi valori dovrebbero corrispondere alla configurazione market/dominio di Shopify. Per una mappatura completa campo per campo, vedi Shopify integration settings.

Dati delle varianti #

I dati delle varianti Shopify possono comportarsi in modo diverso a seconda dell’impostazione Import only stock variant data.

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

  • variant_inventory_policy (elenco di stringhe)
  • variant_inventory_tracking (elenco booleano)
  • variant_list_prices (elenco numerico)
  • variant_names (elenco di stringhe)
  • variant_option_size (elenco di stringhe)
  • variant_prices (elenco numerico)
  • variant_stocks (elenco numerico)
  • variant_weight (elenco numerico)
  • variant_weight_unit (elenco di stringhe)
  • variants (elenco di stringhe, ID delle 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 Import only stock variant data è abilitato, questi elenchi includeranno solo le varianti disponibili in stock.

Personalizzazione dei dati prodotto #

In Shopify, i meta-field e altri attributi creati 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 essere sempre scritti usando la loro key.

Di solito saranno tutti in 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 cercando il tuo attributo in Settings > Custom data > Products/Variants:

Custom data

Sincronizza gli iscritti #

Shopify consente di gestire gli iscritti direttamente dalla piattaforma.

Questi possono essere facilmente sincronizzati con Clerk.

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

Questo può poi essere usato su Auto-Email.

Vai semplicemente 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 utilizzare un link di disiscrizione 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 disiscrizione: {{customer.unsub_url}}

La versione delle Webhooks API deve essere impostata ad almeno 2022-04, dove è stato aggiunto questo supporto. Puoi verificarlo nell’app che hai creato per Clerk nel Developer Dashboard sotto Settings.

Legacy Custom App #

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

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

Questi passaggi si applicano solo se il tuo store Shopify può ancora creare app custom tramite l’admin di 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, nomina l’app “Clerk.io”, scegli lo sviluppatore dell’app, poi clicca nuovamente su Create app.

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

Permissions configuration

  1. Sotto Admin API access scopes, dai l’accesso Read (scope che iniziano con read_) ai seguenti. Per Customers, imposta su Read e write (include write_customers) poiché Shopify lo richiede per accedere ai campi url marketing cliente (ad esempio per customer.unsub_url).

    Puoi incollare direttamente la seguente stringa nell’input per aggiungere tutti gli scope insieme:

    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

    Oppure puoi selezionarli 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 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.