Integration

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

Usa questa guida insieme a Get Started e Sync Data.

Riferimento impostazioni #

Questa è una consultazione completa delle impostazioni di sincronizzazione Shopify in my.clerk.io > Data > Configuration.

Metodo di sincronizzazione #

Scegli quale tipo di connettore Shopify stai utilizzando. La maggior parte delle configurazioni dovrebbe usare Shopify dal flusso Dev Dashboard.

Dominio Shopify #

Il dominio .myshopify.com del negozio, ad esempio example-store.myshopify.com. Puoi trovarlo nell’amministratore Shopify e nell’URL del negozio.

Shopify API Key #

La API key dell’app Shopify che hai creato per Clerk.io nello Shopify Dev Dashboard.

Shopify API Access Token #

Il token di accesso della stessa app Shopify. Clerk.io lo usa per leggere i dati di sincronizzazione.

Shopify API Secret Key #

La secret key dell’app Shopify.

Dimensione immagine predefinita #

Controlla quale risoluzione delle immagini Shopify viene importata da Clerk.io.

Formati comuni:

• 800x800
• 800x

Shopify genera le dimensioni delle immagini su richiesta. Se il rapporto dell’immagine sorgente differisce, Shopify restituisce la dimensione più simile disponibile.

Mercato negozio #

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

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

Locale negozio #

Usa questa impostazione per configurazioni multilingua. Inserisci il codice standardizzato del locale della lingua a 2 lettere (ad esempio da, sv, es).

Usa il codice lingua, non il codice paese.

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

Prefisso URL con Locale #

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

Esempio:

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

Forza URL relative #

Controlla se Clerk.io importa URL relative o URL complete assolute.

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

Attributi personalizzati #

Lista separata da virgole di attributi Shopify aggiuntivi da importare, inclusi meta fields e altri attributi personalizzati.

Posizioni magazzino #

Lista separata da virgole di una o più posizioni di inventario da sincronizzare da Shopify.

Usa questa impostazione quando la disponibilità dei prodotti varia in base al magazzino/posizione.

Includi pagine #

Importa le pagine Shopify come oggetti pagina in Clerk.io, inclusi contenuti come blog e altre pagine CMS.

Includi tutti i prodotti esauriti #

Se abilitata, i prodotti completamente esauriti vengono comunque importati.

Includi prodotti con vendita continua anche se esauriti #

Controlla se i prodotti con comportamento Shopify “continua a vendere anche se esaurito” vengono importati.

Stato di pubblicazione prodotto Shopify #

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

Uso tipico:

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

Stato di pubblicazione categoria Shopify #

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

Stato di pubblicazione pagine Shopify #

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

Orario di sincronizzazione #

Imposta la finestra temporale per la prossima esecuzione della sincronizzazione (UTC).

Abilita aggiornamenti in tempo reale #

Se abilitato, Clerk.io riceve aggiornamenti da Shopify man mano che si verificano cambiamenti (ad esempio cambi di stock o prezzo), invece di attendere il prossimo ciclo di sincronizzazione completo.

Importa solo varianti disponibili #

Controlla se gli attributi relativi alle varianti dovrebbero includere solo le varianti disponibili in magazzino.

Esempio output variante:

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

Quando l’impostazione è Sì, le liste varianti includono solo le varianti disponibili.

Opzioni variante separate #

Divide le opzioni variante in attributi separati così che ogni opzione possa essere utilizzata indipendentemente in filtri e design.

Storico ordini #

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

Intervalli disponibili:

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

Un approccio comune è tutto il tempo 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 utilizzati quando Import Tags è impostato per includere/escludere tag specifici.

Separatore di destrutturazione tag #

Carattere utilizzato per dividere il nome e il valore del tag durante la destrutturazione.

Esempio:

• Tag: sale_10
• Separatore: _

Prefisso destrutturazione tag #

Prefisso rimosso dai tag destrutturati prima di memorizzare il valore.

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

Includi stato iscrizione #

Importa lo stato di iscrizione dei clienti (newsletter/stato iscrizione) quando disponibile da Shopify.

Importa pacchi e stati ordini #

Importa informazioni su pacchi/spedizioni e valori di stato ordine da Shopify.

Questi dati sono utilizzati da Chat quando si risponde a domande su spedizioni e stato ordini.

Disinstallazione #

Di seguito trovi una guida per la rimozione degli script di tracking e i passi generali per disinstallare Clerk dal tuo negozio Shopify.

Rimozione degli script di tracking #

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

• Prima di tutto, rimuovi gli script di tracciamento visitor dal file tema dove hai inizialmente inserito il codice di embed durante la configurazione.

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

Puoi accedere a questo file effettuando il login al portale admin Shopify, selezionando “Online Store” > “Themes”. Poi, sotto “Live Theme”, scegli “Edit Code” dal menù “Actions”.

Trova il tuo file tema principale, poi trova lo script di Visitor Tracking, ed eliminalo:

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

Puoi trovare questa sezione nel portale admin Shopify cliccando su “Settings” nell’angolo in basso a sinistra. Poi, cancella semplicemente entrambi gli script dalla casella di testo “Additional Scripts”.

Aggiornamento permessi app privata #

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

Puoi trovare i permessi API della tua app accedendo al portale admin Shopify, selezionando “Apps” > “Manage Private Apps” > “Clerk.io”.

In “Admin API Permissions”, modifica ciascuna di queste tendine che attualmente indica “Read Access” in “No Access”:

Aggiornamento my.clerk.io #

Puoi anche rimuovere Shopify API Key, password e secret dal backend my.clerk.io del tuo negozio.

Accedi, scegli “Data” dal menu laterale sinistro e vai su “Configuration”. Assicurati di cliccare su “Save” al termine: