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 su Clerk.io. Questa guida copre la creazione di un’app nel Dev Dashboard di Shopify, la personalizzazione dei dati dei prodotti e la sincronizzazione delle informazioni sugli iscritti.

Configura la sincronizzazione #

La configurazione si compone di due parti: crea e installa un’app su Shopify, poi inserisci le sue credenziali in my.clerk.io. Completa entrambe le parti prima di avviare la prima sincronizzazione.

Prima di configurare la sincronizzazione, assicurati di avere il dominio .myshopify.com attuale dello store. Segui le istruzioni sul dominio Shopify se necessario.

In Shopify #

Completa questi passaggi nel Dev Dashboard di Shopify. Consulta la guida aggiornata alle app del Dev Dashboard di Shopify se le etichette cambiano.

Crea app #

  1. Apri il Shopify Dev Dashboard ed effettua l’accesso.
  2. Nella navigazione a sinistra, apri Apps e clicca su Create app.
  3. Seleziona Start from Dev Dashboard, inserisci Clerk.io come nome dell’app e clicca su Create.

Configura app #

  1. Apri la scheda Versions per la nuova app.
  2. In App URL, inserisci https://shopify.dev/apps/default-app-home. L’app fornisce solo accesso alle API e non necessita di un’interfaccia admin integrata.
  3. In Webhooks API Version, seleziona la versione più recente disponibile.
  4. Aggiungi gli access scopes elencati nella sezione successiva.

Configura gli scope #

Inizia con gli scope seguenti. Consentono a Clerk.io di importare il catalogo, ordini, clienti, pagine, markets, locations e i dati correlati necessari per l’integrazione con Shopify. Incolla questa lista nel campo access-scope:

Ometti read_all_orders quando crei la prima versione per evitare un errore di “invalid scopes”. Lo aggiungerai in una seconda versione prima di installare l’app.

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é abbiamo bisogno dell’accesso in scrittura? Clerk.io legge soltanto i dati, ma Shopify richiede lo scope write_customers per accedere ai campi URL marketing dei clienti, come customer.unsub_url.

Puoi anche scegliere gli scope singolarmente:

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

Clicca su Release per rilasciare la prima versione con questi scope, poi aggiungi l’accesso a tutti gli ordini qui sotto.

Aggiungi tutti gli ordini #

Aggiungi read_all_orders in una seconda versione affinché Clerk.io possa importare la cronologia completa degli ordini dello store.

  1. Nel Dev Dashboard, apri la scheda Versions dell’app e clicca su Create Version.
  2. Mantieni gli scope esistenti e aggiungi ,read_all_orders alla fine del campo access-scope.
  3. Salva la configurazione come nuova versione.
  4. Clicca su Release in basso.
  5. Se richiesto, inserisci facoltativamente un messaggio di versione come Read all orders was added, poi completa la pubblicazione.

L’elenco completo degli scope per questa seconda versione è:

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,read_all_orders

Installa app #

Installa l’app pubblicata sullo store Shopify che verrà sincronizzato con Clerk.io.

  1. Nell’app, apri Home e clicca su Install app.
  2. Seleziona o crea lo store Shopify.
  3. Rivedi i permessi richiesti e clicca su Install.

In Clerk.io #

Completa questi passaggi in my.clerk.io utilizzando le credenziali di Shopify. Il team dello store può farlo direttamente, oppure condividere in modo sicuro le credenziali con un terzo che sta configurando la sincronizzazione di Clerk.io.

Configura la sincronizzazione #

  1. Nel Shopify Dev Dashboard, apri le Settings dell’app Clerk.io e copia il Client ID e il Client Secret, oppure ottienili tramite una consegna sicura approvata dal team dello store Shopify.
  2. In my.clerk.io, apri lo Store relativo e vai su Data > Configuration.
  3. Imposta Sync Method su Shopify.
  4. Inserisci il dominio attuale .myshopify.com dello store Shopify in Shopify Domain. Non inserire il dominio personalizzato pubblico, https://, né un percorso.
  5. Incolla il Client ID e il Client Secret nei campi corrispondenti.
  6. Clicca su Save, poi clicca su Start Sync.

Mantieni il Client Secret privato. Condividilo solo tramite un canale sicuro approvato e non aggiungerlo mai a documenti pubblici, ticket di assistenza o chat.

Problema noto: Shopify potrebbe non generare un token durante la prima sincronizzazione, causando un errore di autenticazione. Si tratta di un problema intermittente noto di Shopify. Attendi semplicemente 1-2 minuti, poi riprova a sincronizzare.

Mercati e inventario #

Se gestisci più mercati, locali o magazzini Shopify, verifica questi campi prima della sincronizzazione:

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

Questi valori devono corrispondere alla configurazione dei mercati/domini su Shopify. Per una mappatura completa campo per campo, consulta Shopify integration settings.

Dati delle varianti #

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

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

  • variant_inventory_policy (lista di stringhe)
  • variant_inventory_tracking (lista booleana)
  • variant_list_prices (lista numerica)
  • variant_names (lista di stringhe)
  • variant_option_size (lista di stringhe)
  • variant_prices (lista numerica)
  • variant_stocks (lista numerica)
  • variant_weight (lista numerica)
  • variant_weight_unit (lista di stringhe)
  • variants (lista 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, queste liste includeranno solo le varianti 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 diversi attributi, separali con una virgola.

Gli attributi devono essere sempre scritti usando la loro key.

Solitamente questo è tutto minuscolo. Ad esempio, l’attributo “Sizes” sarà “sizes”.

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

In Shopify, trova le chiavi degli attributi sotto Settings > Custom data > Products/Variants.

Sincronizzazione degli iscritti #

Shopify supporta la gestione diretta degli iscritti sulla piattaforma.

Questi possono essere facilmente sincronizzati con Clerk.io.

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

Questo può poi essere usato per Auto-Email.

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

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

La versione delle Webhooks API deve essere impostata almeno a 2022-04, dove è stato aggiunto questo supporto. Puoi controllarlo nell’app che hai creato per Clerk.io nel Dev Dashboard alla voce Settings.

App personalizzata legacy #

Da gennaio 2026, Shopify non consente più la creazione di app personalizzate direttamente nell’admin di Shopify per i negozi. Le app personalizzate esistenti continueranno a funzionare, ma questo metodo dovrebbe essere utilizzato solo se hai già un’app personalizzata configurata. Per tutte le altre configurazioni, utilizza il metodo del Developer Dashboard sopra.

Se hai già un’app personalizzata e necessiti 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 può ancora creare app personalizzate dall’admin di Shopify.

  1. In Shopify, vai su Settings > Apps > Develop Apps.

  2. Clicca su Create app, dai il nome “Clerk.io”, scegli il developer dell’app, poi clicca di nuovo su Create app.

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

  4. Sotto Admin API access scopes, concedi l’accesso in sola lettura (scope che iniziano con read_) ai seguenti. Per Customers, imposta su Lettura e scrittura (include write_customers).

    Perché abbiamo bisogno dell’accesso in scrittura? Clerk.io legge soltanto i dati, ma Shopify richiede lo scope write_customers per accedere ai campi URL marketing dei clienti (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:

    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 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_)

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

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

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

  8. Incolla questi valori nel modulo. Scegli una dimensione standard per le immagini se richiesto, quindi clicca su Start Sync.

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