Sync

Avvio di una sincronizzazione #

Puoi sempre avviare una sincronizzazione completa da my.clerk.io andando su Data > Configuration e cliccando su Start New Data Sync.

Questo importerà tutti i dati più recenti dal tuo webshop, utilizzando il metodo di sincronizzazione che hai selezionato.

Dopo aver cliccato su Start New Data Sync, Data Sync mostra il tempo di attesa previsto e lo stato della coda prima che inizi l’elaborazione:

• Inizia tra [tempo] significa che la sincronizzazione è in attesa che finisca il termine di raffreddamento.
• Leggero ritardo nella coda di download significa che ci sono 20–99 processi in attesa.
• Ritardo moderato nella coda di download significa che ci sono 100–499 processi in attesa.
• Ritardo significativo nella coda di download significa che ci sono 500 o più processi in attesa.
• Sincronizzazione dati in avvio… significa che non ci sono ritardi rilevanti.

Informazioni #

Questa sezione fornisce rapide informazioni sullo stato della sincronizzazione:

• Il numero di prodotti, categorie, pagine, ordini e clienti importati
• La durata dell’ultima sincronizzazione e la durata media di una sincronizzazione completa
• I timestamp di quando una sincronizzazione o un’analisi sono state tentate e completate l’ultima volta
• I timestamp di quando una sincronizzazione o un’analisi hanno registrato l’ultima modifica a un prodotto

I Dettagli Sincronizzazione si riferiscono a quando Clerk ha recuperato i dati dal webshop l’ultima volta, mentre i Dettagli Analisi si riferiscono a quando Clerk ha elaborato e salvato i dati l’ultima volta.

Impostazioni #

Queste impostazioni ti permettono di configurare la sincronizzazione dei dati per poter accedere al webshop e modificare come vengono recuperati i dati.

Metodo di sincronizzazione #

Clerk offre numerose integrazioni e metodi di sincronizzazione, rendendo possibile sincronizzare da qualsiasi piattaforma eCommerce. Le integrazioni che costruiamo utilizzano il proprio metodo di sincronizzazione per le piattaforme come Shopify, Magento, WooCommerce, e così via.

È anche possibile scegliere Demo Data come metodo di sincronizzazione. In questo modo, Clerk sincronizzerà un set di dati predefinito che puoi usare per i test. Questo è utile se vuoi semplicemente esplorare my.clerk.io e la nostra API prima di avviare una configurazione reale.

Ora della sincronizzazione #

Questa impostazione ti consente di scegliere intervalli di 1 ora in cui deve essere eseguita la sincronizzazione. Scegliendo un orario, la sincronizzazione verrà eseguita solo in quella fascia oraria secondo l’orario UTC. Questo è utile se desideri risparmiare capacità del server durante le ore di carico elevato e sincronizzare solo quando il server è meno occupato.

Di default, è impostato su Quando necessario (consigliato), che eseguirà la sincronizzazione regolarmente in base al tempo richiesto per caricare i tuoi dati. Se richiede meno di 10 minuti, la sincronizzazione potrebbe essere eseguita ogni ora, mentre sincronizzazioni che impiegano più di 60 minuti potrebbero essere eseguite solo una volta al giorno.

Importazione #

Puoi decidere esattamente quali punti dati importare selezionando Sì o No per ciascuno di essi:

• Prodotti
• Categorie
• Ordini
• Clienti
• Pagine

Clerk richiede prodotti e categorie per funzionare correttamente, ed è fortemente consigliato importare anche gli ordini, in quanto sono la forza trainante principale dei risultati di Clerk.

Le pagine importate tramite la sincronizzazione dati sovrascriveranno eventuali modifiche apportate in my.clerk.io a quelle pagine sincronizzate la prossima volta che le pagine verranno sincronizzate.

Le pagine che carichi manualmente in Data > Pages sono trattate come protette e non vengono sovrascritte dalla sincronizzazione dati.

Importatori AI #

Gli Importatori AI ti consentono di creare un’integrazione personalizzata da zero, senza alcuna configurazione predefinita. Se la tua piattaforma espone un’API, Clerk.io può connettersi ad essa.

La configurazione viene gestita tramite Ask Clerk.io. Descrivi a quale piattaforma vuoi connetterti e Ask Clerk.io ti guida attraverso le credenziali, crea l’importatore, testa la connessione e passa il testimone a Data Sync con la configurazione completa.

Puoi anche gestire domande su importatore e sincronizzazione nella stessa conversazione Ask Clerk.io. Se una sincronizzazione richiede credenziali o una decisione, Ask Clerk.io spiega cosa serve prima di continuare.

Gli Importatori AI sono integrazioni indipendenti. Se ad esempio il tuo store è su Shopify e vuoi importare dati aggiuntivi non coperti dall’importatore standard di Shopify, puoi configurare un nuovo AI Importer per dialogare direttamente con Shopify.

Quell’AI Importer quindi gestisce tutto: i dati standard così come qualsiasi campo extra che ti serve.

Una volta stabilita la connessione, puoi estendere ciò che viene importato — aggiungendo attributi extra, integrando dati da terze parti o regolando la logica per adattarla al tuo catalogo — tutto tramite Ask Clerk.io.

Leggi di più sul flusso di configurazione nella pagina AI Importer.

Importatori multipli #

Gli Importatori Multipli ti permettono di combinare diversi metodi di sincronizzazione per diversi tipi di dati in una singola configurazione.

Questo è utile quando i tuoi dati sono distribuiti in più luoghi. Potresti importare prodotti, categorie e ordini da Magento 1, mentre i dati dei clienti da una piattaforma di segmentazione e le pagine da WordPress.

Ogni tipo di dato è gestito da un solo importatore alla volta — non puoi importare lo stesso tipo da due fonti contemporaneamente. Ma hai il pieno controllo su quale importatore è responsabile di ogni tipo.

Vai su Data > Configuration e usa il pulsante + Add importer per aggiungere un secondo metodo di sincronizzazione insieme a quello esistente.

Per ciascun importatore, puoi configurare quali tipi di dati dovrà importare. Se un tipo di dato è assegnato a un importatore, non dovrebbe essere abilitato anche in un altro — ogni tipo deve avere esattamente una fonte.

Prodotti e categorie sono obbligatori affinché Clerk.io funzioni correttamente. Assicurati che almeno un importatore sia responsabile per ciascuno di essi.

Log di sincronizzazione #

Questa sezione mostra lo stato della sincronizzazione mentre è in corso e quando è completata. È utile per confermare che tutto funzioni correttamente e ti aiuta a risolvere eventuali problemi.

Puoi accedervi cliccando su Show latest sync log details.

Whitelisting indirizzo IP #

Se il tuo server ha un blocco IP, devi inserire nella whitelist l’indirizzo IP del sistema Data Sync di Clerk per consentire l’accesso ai tuoi dati.

L’indirizzo IP è 52.57.0.11

Questo IP potrebbe cambiare. Se Data Sync restituisce un errore 403 o simile, torna semplicemente su questa pagina per trovare l’indirizzo IP attuale.

Aggiornamenti in tempo reale #

Questo è il modo migliore per mantenere Clerk aggiornato con il tuo webshop senza ritardi. Mentre la sincronizzazione completa dei dati è ottima per caricare grandi quantità di dati a intervalli regolari, gli aggiornamenti in tempo reale vengono usati per inviare modifiche minori man mano che accadono.

La maggior parte delle nostre estensioni e integrazioni li include di default, senza necessità di configurazione aggiuntiva. Per qualsiasi altra piattaforma, possono essere configurati tramite la nostra CRUD API.

Con gli aggiornamenti in tempo reale abilitati, Clerk è in grado di recuperare modifiche come un semplice aggiornamento di prezzo, ma anche di aggiungere o rimuovere completamente prodotti.

Questo significa che Clerk non dovrà aspettare una sincronizzazione completa ogni volta che apporti piccole modifiche, mantenendo la tua configurazione aggiornata immediatamente.

Quando aggiungi un prodotto attraverso la sincronizzazione in tempo reale, apparirà istantaneamente sul tuo webshop dopo che sarà visibile nel backend di Clerk.io.

Quando un prodotto viene aggiunto attraverso la sincronizzazione in tempo reale, è immediatamente visibile in Search, Recommendations ed Email, ma il ranking del prodotto non è incluso. Questo significa che potrebbe non essere visualizzato come prodotto popolare fino a quando non viene eseguita la sincronizzazione completa dei dati.

File CSV #

Questo è un metodo di sincronizzazione speciale che può essere utilizzato per dimostrare le funzionalità di Clerk.io tramite una Live Demo caricando un’esportazione una tantum del tuo catalogo. Puoi usarlo scegliendo One-Time CSV Upload dal menu a tendina Sync method.

La schermata di upload mostra una barra di avanzamento in tempo reale mentre Clerk.io elabora i file. L’elaborazione può continuare dopo il termine del trasferimento, quindi attendi il completamento della barra prima di continuare.

Genera file CSV almeno per prodotti, categorie e ordini e, se vuoi vedere tutte le potenzialità di Clerk, anche per clienti e pagine.

Scarica un file zip contenente i template CSV per tutti i tipi di dati.

Tutti i file utilizzano la virgola come separatore. Qualsiasi valore che contiene una virgola deve essere racchiuso tra doppi apici, ad esempio "1,2,3" per un elenco di ID.

Prodotti #

Ogni riga rappresenta un prodotto.

Categorie #

Ogni riga rappresenta una categoria.

Ordini #

Ogni riga rappresenta un articolo dell’ordine. Un ordine con più prodotti comprende più righe, tutte con lo stesso id.

Clienti #

Ogni riga rappresenta un cliente. Deve essere presente almeno uno tra id o Email. Qualsiasi colonna extra sarà importata come attributo personalizzato e può essere utilizzata per la segmentazione dell’audience.

* È richiesto almeno uno tra id o Email.

Pagine #

Ogni riga rappresenta una pagina di contenuto.