Shopify

Sync Data

Scopri come sincronizzare e personalizzare i dati dal tuo negozio Shopify

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

Configura la sincronizzazione #

Per sincronizzare i dati del tuo store Shopify con Clerk, è necessario creare un’app nella Developer Dashboard di Shopify e configurarla in Clerk. L’utente che sta configurando la sincronizzazione deve avere accesso alla Developer Dashboard e i permessi per sviluppare app sullo store Shopify.

Requisiti di accesso: Solo il proprietario dello store o lo staff con permessi di Amministratore può creare l’app (non tramite accesso collaborativo). Se configuri per un cliente, hai bisogno dei permessi staff o delle 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 la Dev Dashboard dopo aver effettuato il login.

  5. Nella 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. 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 l’ultima versione disponibile (almeno 2025-07).

Configura gli scope #

  1. In Access scopes, concedi l’accesso agli scope elencati di seguito. Puoi incollare direttamente la seguente stringa nel campo di 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_)

  2. In fondo alla pagina, clicca su Release.

Installa l’app #

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

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

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

Connetti a Clerk #

  1. Torna alla 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 durante la 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.

Markets e inventario #

Se gestisci più markets Shopify, lingue (locales) o sedi di inventario, conferma questi campi prima della sincronizzazione:

  • Shopify Market
  • Shopify Locale
  • Prefix URLs with Locale
  • Force Relative URLs
  • Sedi inventario

Questi valori devono corrispondere alla configurazione market/dominio del tuo Shopify. Per una mappatura completa campo-per-campo, vedi Impostazioni integrazione Shopify.

Dati variante #

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

Gli attributi tipici delle varianti Shopify in Clerk.io includono:

  • variant_inventory_policy (lista di stringhe)
  • variant_inventory_tracking (lista di boolean)
  • 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 variante)

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 è attivato, queste liste includeranno solo le varianti disponibili in stock.

Personalizzazione dei dati prodotto #

In Shopify, i meta-campi 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 digita gli attributi dei prodotti da includere.

Per aggiungere più attributi, separali con una virgola.

Add attributes

Gli attributi devono sempre essere scritti utilizzando il loro key.

Generalmente sono tutti in minuscolo. Ad esempio, l’attributo “Sizes” va scritto “sizes”.

Non occorre includere il namespace – Clerk lo troverà automaticamente in base al key.

In Shopify, spesso puoi trovare questi key cercando l’attributo in Settings > Custom data > Products/Variants:

Custom data

Sincronizza iscritti #

Shopify consente di gestire gli 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.

Può quindi essere utilizzato per Auto-Email.

Vai nel tuo store my.clerk.io, poi Data -> Configuration e imposta Include Subscriber State su Yes. Infine 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 ha un attributo unsub_url che può essere utilizzato nei design auto email del campo di disiscrizione: {{customer.unsub_url}}

La versione della Webhooks API deve essere almeno la 2022-04, in cui questo supporto è stato aggiunto. Puoi verificarlo nell’app che hai creato per Clerk nella Developer Dashboard in Settings.

Custom App legacy #

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

Se hai già un’app custom e hai bisogno di 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 store Shopify ha ancora la possibilità di creare app custom 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, chiamala “Clerk.io”, scegli l’App developer e 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 (scope che iniziano con read_) a quanto segue. Per Customers, imposta su Lettura e scrittura (include write_customers) poiché Shopify lo richiede per accedere ai campi marketing URL clienti (ad esempio per customer.unsub_url).

    Puoi incollare la seguente stringa direttamente nel campo di 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, quindi su Install App → Install.

  2. Apri API Credentials e copia il tuo Shopify Domain insieme a 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.