Integration

Dopo aver collegato Shopify in Clerk.io, questa pagina è il tuo riferimento per le impostazioni di sincronizzazione specifiche di Shopify in my.clerk.io > Data > Configuration.

Usa questa guida insieme a Get Started e Sync Data.

Riferimento impostazioni #

Questa è una guida completa di riferimento per le impostazioni di sincronizzazione di Shopify in my.clerk.io > Data > Configuration.

Metodo di sincronizzazione #

Scegli quale tipo di connettore Shopify stai utilizzando. Usa Shopify per un’app creata nel Dev Dashboard di Shopify. Usa Shopify (Legacy Custom App) solo per un’app esistente creata nell’admin di Shopify.

Dominio Shopify #

Il dominio attuale .myshopify.com del negozio, ad esempio example-store.myshopify.com. Usa questo valore invece del dominio personalizzato pubblico. Puoi trovarlo in Shopify > Settings > Domains.

Client ID #

Per il metodo di sincronizzazione Shopify attuale, usa il Client ID dalla pagina Settings dell’app Clerk.io nel Dev Dashboard di Shopify.

Client Secret #

Per il metodo di sincronizzazione Shopify attuale, usa il Client Secret dalla stessa pagina nel Dev Dashboard di Shopify. Mantienilo privato e condividilo solo tramite un canale sicuro approvato.

Credenziali Legacy #

Per Shopify (Legacy Custom App), usa API Key, API Access Token e API Secret Key dell’app personalizzata esistente. Vedi Legacy Custom App per i passaggi di configurazione legacy.

Dimensione Immagine Predefinita #

Controlla quale risoluzione delle immagini di Shopify importa Clerk.io.

Formati comuni:

• 800x800
• 800x

Shopify genera le dimensioni delle immagini su richiesta. Se il rapporto dell’immagine sorgente è differente, Shopify restituisce la dimensione più vicina possibile.

Configurazione dei mercati #

Utilizza le seguenti impostazioni quando il negozio Shopify ha più mercati, lingue, domini o sedi di inventario. I valori devono corrispondere alla configurazione di Shopify prima di iniziare una nuova sincronizzazione.

Shop Market #

Usalo quando il negozio utilizza Shopify Markets. Inserisci il nome del mercato esattamente come configurato in Shopify (ad esempio Denmark, Europe o United States).

I mercati possono influenzare prodotti disponibili, prezzi, lingue e contesto inventario.

Shop Locale #

Usalo per configurazioni multilingua. Inserisci il codice standardizzato di lingua a 2 lettere (ad esempio da, sv, es).

Usa il codice lingua, non il codice paese.

Se non sei sicuro di quale locale utilizzare, chiedi a Shopify Sidekick quali locali sono configurati nel negozio.

Prefissa gli URL con il Locale #

Controlla se gli URL localizzati includono il prefisso del percorso locale.

Esempio:

• Sì: /da/product-name
• No: /product-name

Forza URL relativi #

Controlla se Clerk.io importa URL relativi o URL assoluti completi.

• Sì: forza percorsi relativi
• No: consenti URL completi con dominio

Sedi di inventario #

Elenco separato da virgole di una o più sedi di inventario da sincronizzare da Shopify.

Usalo quando la disponibilità dei prodotti differisce tra magazzini/sedi.

Impostazioni dati #

Usa le seguenti impostazioni per controllare quali dati Shopify importa Clerk.io e come vengono elaborati.

Attributi personalizzati #

Elenco separato da virgole di attributi Shopify aggiuntivi da importare, inclusi meta campi e altri attributi personalizzati.

Includi pagine #

Importa le pagine Shopify come oggetti pagina in Clerk.io, incluso il contenuto delle pagine blog e altre pagine CMS.

Includi tutti i prodotti esauriti #

Se abilitato, i prodotti completamente esauriti vengono comunque importati.

Includi prodotti con “Continua a vendere quando esauriti” #

Controlla se i prodotti che usano il comportamento “continua la vendita anche quando esaurito” di Shopify vengono importati.

Stato di pubblicazione Shopify #

Controlla quali stati di pubblicazione dei prodotti sono idonei all’importazione.

Uso tipico:

• solo prodotti pubblicati
• tutti i prodotti (inclusi quelli non pubblicati)

Stato pubblicazione categoria Shopify #

Come sopra, ma per lo stato di pubblicazione della categoria.

Stato pubblicazione pagine Shopify #

Come sopra, ma per lo stato di pubblicazione delle pagine.

Ora di sincronizzazione #

Imposta la finestra di pianificazione per la prossima esecuzione di sincronizzazione (UTC).

Abilita aggiornamenti in tempo reale #

Se abilitato, Clerk.io riceve aggiornamenti da Shopify man mano che avvengono i cambiamenti (ad esempio modifiche di stock o prezzo), invece di attendere il successivo ciclo completo di sincronizzazione.

Importa solo varianti disponibili #

Controlla se gli attributi relativi alle varianti devono includere solo varianti disponibili in stock.

Esempio di output varianti:

• variant_names: ["Xs", "M"]
• variant_option_size: ["Xs", "M"]
• variant_stocks: [1, 7]
• variants: ["55970989179259", "55970989244795"]

Quando l’impostazione è Sì, gli elenchi delle varianti includono solo quelle disponibili in stock.

Separa opzioni variante #

Divide le opzioni variante in attributi separati, così ogni opzione può essere usata indipendentemente nei filtri e nei design.

Cronologia ordini #

Controlla quanti dati storici degli ordini vengono importati per ogni esecuzione.

Gli intervalli disponibili includono:

• 1 mese
• 3 mesi
• 6 mesi
• 1 anno
• tutto il periodo

Un approccio comune è tutto il periodo per la prima importazione, poi un periodo più breve (ad esempio 1 mese) per le importazioni ricorrenti.

Importa tag #

Controlla la strategia di importazione dei tag.

Modalità disponibili:

• importa tutti i tag
• escludi tag specifici
• includi tag specifici
• non importare tag

Tag specifici #

Tag separati da virgole usati quando Importa tag è impostato su includi/escludi tag specifici.

Separatore destrutturazione tag #

Carattere usato per dividere il nome e il valore dei tag durante la destrutturazione dei tag.

Esempio:

• Tag: sale_10
• Separatore: _

Prefisso destrutturazione tag #

Prefisso rimosso dai tag destrutturati prima di memorizzare il valore.

Usando sale_10 con separatore _ e prefisso sale permette di usare 10 come valore.

Includi stato iscritto #

Importa lo stato di iscritto per i clienti (stato newsletter/abbonamento) quando disponibile da Shopify.

Importa pacchi & stati ordini #

Importa informazioni sui pacchi/tracciabilità e valori di stato degli ordini da Shopify.

Questi dati vengono usati da Chat per rispondere a domande su spedizioni e stato ordini.

Disinstallazione #

Di seguito troverai una guida per rimuovere gli script di tracciamento e i passaggi generali per disinstallare Clerk.io dal tuo negozio Shopify.

Rimozione degli script di tracciamento #

Per rimuovere il tracciamento Clerk.io dal tuo webshop, dovrai rimuovere sia gli script di tracciamento Visitor che Sales dai file tema di Shopify e dalla sezione “Additional Scripts”.

• Per prima cosa, rimuovi gli script di tracciamento visitor dal file tema dove avevi inserito il codice di embed durante la configurazione iniziale.

Il tracciamento Visitor probabilmente si trova in “theme.liquid” o “index.liquid” del tuo webshop.

Puoi accedere a questo file effettuando l’accesso al pannello di amministrazione Shopify, poi seleziona “Online Store” > “Themes”. Poi, sotto “Live Theme”, scegli “Edit Code” dal menu a discesa “Actions”.

Individua il file tema principale, poi trova lo script di tracciamento Visitor e cancellalo:

• Successivamente, dovrai rimuovere entrambi gli script di tracciamento dalla sezione “Additional Scripts”.

Puoi trovarla nel pannello di amministrazione Shopify cliccando su “Settings” in basso a sinistra. Poi, elimina semplicemente entrambi gli script dalla casella di testo “Additional Scripts”.

Aggiornamento permessi delle app private #

Puoi anche modificare i permessi dell’app privata Clerk.io creata durante la configurazione per assicurarti che non ci sia accesso ai campi dati specificati.

Puoi trovare i permessi API della tua app effettuando l’accesso al pannello di amministrazione Shopify, selezionando “Apps” > “Manage Private Apps” > “Clerk.io”.

In “Admin API Permissions”, imposta ciascuno di questi menu a tendina, dove attualmente dice “Read Access”, su “No Access”:

Aggiornamento di my.clerk.io #

Puoi anche rimuovere l’API Key di Shopify, la password e il secret dal backend my.clerk.io del tuo negozio.

Effettua il login, scegli “Data” dal menu a sinistra e vai su “Configuration”. Assicurati di cliccare “Save” una volta completato: