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.
Informazioni #
Questa sezione fornisce una panoramica rapida sullo stato della tua sincronizzazione:
- Il numero di prodotti, categorie, pagine, ordini e clienti che sono stati importati
- Timestamp dell’ultimo tentativo ed esecuzione completata di una sincronizzazione o analisi
- Timestamp dell’ultima volta che una sincronizzazione o analisi ha registrato una modifica a un prodotto
I dettagli di sincronizzazione si riferiscono a quando Clerk ha recuperato i dati dal webshop l’ultima volta, mentre i dettagli di analisi si riferiscono a quando Clerk ha processato e salvato i dati l’ultima volta.
Impostazioni #
Queste impostazioni ti permettono di configurare la sincronizzazione dei dati per ottenere accesso al webshop e modificare il modo in cui i dati vengono recuperati.
Metodo di sincronizzazione #
Clerk offre numerose integrazioni e metodi di sincronizzazione, rendendo possibile sincronizzare qualsiasi piattaforma eCommerce. Le integrazioni che creiamo utilizzano il proprio metodo di sincronizzazione per le piattaforme come Shopify, Magento, WooCommerce, ecc.
È anche possibile scegliere Demo Data come metodo di sincronizzazione. In questo caso, Clerk sincronizzerà un set di dati predefinito che puoi usare per i test. È utile se vuoi semplicemente esplorare my.clerk.io e la nostra API prima di iniziare una configurazione reale.
Orario di sincronizzazione #
Questa impostazione ti permette di scegliere intervalli di un’ora durante i quali la sincronizzazione deve essere eseguita. Scegliendo un orario, la sincronizzazione verrà eseguita solo in quella fascia oraria in tempo UTC. Ciò è utile se desideri risparmiare capacità del server durante le ore di carico elevato e sincronizzare solo quando il server è meno occupato.
Per impostazione predefinita, è selezionato Quando necessario (consigliato), che eseguirà la sincronizzazione regolarmente a seconda di quanto tempo impiega a caricare i tuoi dati. Se ci mette meno di 10 minuti, potrebbe eseguire la sincronizzazione ogni ora, mentre sincronizzazioni superiori a 60 minuti potrebbero essere eseguite solo una volta al giorno.
Importazione #
Puoi decidere esattamente quali punti dati importare selezionando Sì oppure 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, poiché sono il principale motore dei risultati di Clerk.
Le pagine importate tramite sincronizzazione dei dati sovrascriveranno qualsiasi modifica fatta in my.clerk.io a quelle pagine sincronizzate alla successiva sincronizzazione delle pagine.
Le pagine che carichi manualmente in Data > Pages vengono considerate protette e non sono sovrascritte dalla sincronizzazione dei dati.
AI Importers #

Gli AI Importers ti permettono di costruire un’integrazione personalizzata da zero, senza alcuna configurazione predefinita. Se la tua piattaforma espone un’API, Clerk.io può collegarsi ad essa.
Invece di compilare un insieme fisso di campi, descrivi semplicemente cosa vuoi importare in linguaggio naturale.
L’AI genera quindi i campi di input necessari per effettuare la connessione — come una URL, una chiave API o credenziali di accesso — a seconda di ciò che richiede la piattaforma.
Quando aggiungi un nuovo AI Importer, non ci sono campi di configurazione predefiniti. Per iniziare, indica all’AI a quale piattaforma desideri collegarti e fornisci una URL del tuo store.
Da lì, l’AI ti chiederà le credenziali necessarie e costruirà la configurazione. In molti casi può trovare autonomamente la documentazione API rilevante, ma puoi anche fornirla direttamente per darle più contesto.
Dopo aver stabilito la connessione, puoi affinare ed estendere ciò che viene importato — aggiungendo attributi extra, integrando dati da terze parti o modificando la logica per adattarla al tuo catalogo.
Al momento, gli AI Importers sono integrazioni standalone. Se il tuo negozio è su Shopify, ad esempio, e vuoi importare dati aggiuntivi che l’importatore Shopify standard non copre, puoi configurare un nuovo AI Importer per parlare direttamente con Shopify.
Tale AI Importer gestirà tutto: sia i dati standard sia eventuali campi aggiuntivi di cui hai bisogno.
In futuro, sarà possibile estendere direttamente gli importer standard — così potrai chiedere di “importare anche i dati di traduzione Langify” oppure “acquisire dati di stock di terze parti da questo modulo Magento” senza dover ricominciare da zero.
Importatori multipli #
Gli Importatori Multipli ti permettono di combinare diversi metodi di sincronizzazione per diversi tipi di dati all’interno di una singola configurazione dello store.
Ciò è utile quando i tuoi dati risiedono in più di una posizione. Potresti importare prodotti, categorie e ordini da Magento 1, mentre importi dati dei clienti da una piattaforma di segmentazione e le pagine da WordPress.
Ogni tipo di dato è gestito da un solo importer alla volta — non puoi importare lo stesso tipo da due fonti simultaneamente. Ma hai il pieno controllo su quale importer sia responsabile di ciascun tipo.
Vai su Data > Configuration e utilizza il pulsante + Add importer per aggiungere un secondo metodo di sincronizzazione insieme a quello esistente.
Per ogni importer, puoi configurare quali tipi di dati deve importare. Se un tipo di dato è assegnato a un importer, non deve essere abilitato anche su un altro — ogni tipo deve avere esattamente una fonte.
Prodotti e categorie sono obbligatori affinché Clerk.io funzioni correttamente. Assicurati che almeno un importer sia responsabile di ciascuno di essi.
Registro sincronizzazioni #
Questa sezione mostra lo stato della sincronizzazione mentre è in esecuzione e una volta completata. È utile per confermare che tutto funzioni correttamente e aiuta a effettuare il debug se si verificano problemi.
Puoi accedervi cliccando su Show latest sync log details.

Whitelist degli indirizzi IP #
Se il tuo server ha un blocco IP, devi aggiungere l’indirizzo IP del sistema di Data Sync di Clerk nella whitelist per consentire l’accesso ai tuoi dati.
L’indirizzo IP è 52.57.0.11
Questo IP può 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 alcun ritardo. Mentre la sincronizzazione completa è ottima per caricare grandi quantità di dati a intervalli regolari, gli aggiornamenti in tempo reale vengono utilizzati per inviare modifiche minori nel momento in cui accadono.
La maggior parte delle nostre estensioni e integrazioni li ha già integrati, senza bisogno di configurazione aggiuntiva. Per qualsiasi altra piattaforma, possono essere impostati 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 aggiungere o rimuovere prodotti interamente.
Ciò significa che Clerk non dovrà attendere una sincronizzazione completa ogni volta che fai modifiche minori, mantenendo la tua configurazione sempre immediatamente aggiornata.
Quando aggiungi un prodotto tramite la sincronizzazione in tempo reale, apparirà nel tuo webshop istantaneamente dopo che compare nel backend di Clerk.io.
Quando un prodotto viene aggiunto tramite la sincronizzazione in tempo reale, è immediatamente visibile in Search, Recommendations ed Email, ma il ranking del prodotto non è incluso. Questo significa che potrebbe non apparire come prodotto popolare finché non verrà eseguita la sincronizzazione completa.
File CSV #
Questo è un metodo di sincronizzazione speciale che può essere utilizzato per mostrare le funzionalità di Clerk.io tramite una Demo Live caricando un’esportazione unica del tuo catalogo. Puoi usarlo selezionando One-Time CSV Upload dal menu a tendina Sync method.
Genera file CSV almeno per i tuoi prodotti, categorie e ordini e, se vuoi vedere tutte le potenzialità di Clerk, anche per i tuoi clienti e pagine.
Scarica un file zip contenente i template dei file CSV per tutti i tipi di dati.
Questa pagina è stata tradotta da un'utile intelligenza artificiale, quindi potrebbero esserci errori linguistici. Grazie per la comprensione.