Shopify

Sync Data

Scopri come sincronizzare e personalizzare i dati dal tuo negozio Shopify

Sincronizza i tuoi prodotti Shopify, meta-campi e iscritti su Clerk.io. Questa guida copre la creazione di un’app nel Dev Dashboard di Shopify, la personalizzazione dei dati prodotto e la sincronizzazione delle informazioni sugli iscritti.

Configura la sincronizzazione #

La configurazione si compone di due parti: crea e installa un’app in 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 aggiornato del negozio. Segui i passaggi sul dominio Shopify se necessario.

In Shopify #

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

Crea l’app #

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

Configura l’app #

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

Configura gli scope #

Concedi gli scope qui sotto. Permettono a Clerk.io di importare catalogo, ordini, clienti, pagine, mercati, sedi e i dati correlati necessari per l’integrazione con Shopify. Puoi incollare l’elenco completo nel campo degli access-scope:

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

Puoi anche scegliere gli scope singolarmente:

  • Clienti (read_ e write_)
  • Inventario (read_)
  • Lingue (read_)
  • Sedi (read_)
  • Mercati (read_)
  • Markets Home (read_)
  • Metaobjects (read_)
  • Pagine del negozio online (read_)
  • Ordini (read_)
  • Tutti gli ordini (read_)
  • Prodotti (read_)
  • Pubblicazioni (read_)
  • Contenuti del negozio (read_)
  • Traduzioni (read_)

Torna al tab Versions dell’app e clicca su Release dopo aver aggiunto gli scope.

Installa l’app #

Installa l’app rilasciata sul negozio Shopify che deve sincronizzare con Clerk.io.

  1. Nell’app, apri Home e clicca su Install app.
  2. Seleziona o crea il negozio Shopify.
  3. Rivedi gli accessi richiesti e clicca su Install.

In Clerk.io #

Completa questi passaggi in my.clerk.io utilizzando le credenziali ottenute da Shopify. Il team del negozio può farlo direttamente, oppure condividere in modo sicuro le credenziali con una terza parte incaricata della configurazione della sincronizzazione con Clerk.io.

Configura la sincronizzazione #

  1. Nel Dev Dashboard di Shopify, apri le Settings dell’app Clerk.io e copia Client ID e Client Secret, o ottienili tramite una consegna sicura approvata dal team del negozio Shopify.
  2. In my.clerk.io, apri lo Store interessato e vai a Data > Configuration.
  3. Imposta Sync Method su Shopify.
  4. Inserisci il dominio .myshopify.com aggiornato del negozio Shopify in Shopify Domain. Non inserire il dominio personalizzato pubblico, https:// o un percorso.
  5. Incolla Client ID e Client Secret negli appositi campi.
  6. Clicca su Save, poi su Start Sync.

Tieni il Client Secret privato. Condividilo solo tramite un canale sicuro approvato e non aggiungerlo mai a un documento pubblico, ticket di supporto o chat.

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 in Shopify. Attendi semplicemente 1-2 minuti e riprova la sincronizzazione.

Mercati e inventario #

Se gestisci diversi mercati Shopify, lingue o sedi di inventario, controlla questi campi prima di sincronizzare:

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

Questi valori devono corrispondere alla configurazione dei mercati/domains Shopify. Per una mappa completa dei campi, consulta le impostazioni di integrazione Shopify.

Dati variante #

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

Attributi tipici delle varianti Shopify in Clerk.io includono:

  • variant_inventory_policy (lista stringhe)
  • variant_inventory_tracking (lista booleani)
  • variant_list_prices (lista numeri)
  • variant_names (lista stringhe)
  • variant_option_size (lista stringhe)
  • variant_prices (lista numeri)
  • variant_stocks (lista numeri)
  • variant_weight (lista numeri)
  • variant_weight_unit (lista stringhe)
  • variants (lista 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 Import only stock variant data è attivo, queste liste includono solo le varianti disponibili a stock.

Personalizzazione dei dati prodotto #

In Shopify, i meta-campi e altri attributi creati possono essere sincronizzati attraverso my.clerk.io > System status > Data sync.

Vai semplicemente al campo di input chiamato Custom Attributes e digita gli attributi prodotto da includere.

Per aggiungere più attributi, separali con una virgola.

Add attributes

Gli attributi vanno sempre scritti usando la loro key.

Questa di solito sarà tutta minuscola. Ad esempio, l’attributo “Sizes” dev’essere “sizes”.

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

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

Custom data

Sincronizza gli iscritti #

Shopify permette la gestione degli iscritti direttamente in piattaforma.

Questi possono essere facilmente sincronizzati con Clerk.io.

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

Potrà essere utilizzato poi per Auto-Email.

Vai semplicemente sul tuo store my.clerk.io, quindi Data -> Configuration e imposta Include Subscriber State su Yes. Poi 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 backend Shopify ha l’attributo unsub_url che può essere usato nei design Auto-Email nel campo unsubscribe: {{customer.unsub_url}}

La versione Webhooks API deve essere almeno la 2022-04, dove questo supporto è stato aggiunto. Puoi controllare questa impostazione nell’app che hai creato per Clerk.io nel Dev Dashboard sotto Settings.

App Custom Legacy #

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

Se hai già 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 valgono solo se il tuo store Shopify ha ancora accesso alla creazione di app custom nell’admin Shopify.

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

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

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

Permissions configuration

  1. Sotto Admin API access scopes, concedi accesso in sola lettura (scope che iniziano con read_) a quanto segue. Per Customers, impostalo su Lettura e scrittura (include write_customers).

    Perché serve l’accesso in scrittura? Clerk.io legge solo i dati, ma Shopify richiede lo scope write_customers per accedere ai campi customer marketing URL (ad esempio per sincronizzare customer.unsub_url).

    Puoi incollare la seguente stringa direttamente nel campo di input per aggiungere tutti gli scope contemporaneamente:

    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 aggiungerli singolarmente:

    • Clienti (read_ e write_)
    • Inventario (read_)
    • Lingue (read_)
    • Sedi (read_)
    • Mercati (read_)
    • Markets Home (read_)
    • Metaobjects (read_)
    • Pagine del negozio online (read_)
    • Ordini (read_)
    • Tutti gli ordini (read_)
    • Prodotti (read_)
    • Pubblicazioni (read_)
    • Contenuti del negozio (read_)
    • Traduzioni (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. Sotto Sync Method, seleziona Shopify (Legacy Custom App).

  2. Incolla questi valori nel form. Scegli la dimensione di default 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.