Sync
Avviare 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 informazioni rapide sullo stato della sincronizzazione:
- Il numero di prodotti, categorie, pagine, ordini e clienti che sono stati importati
- Timestamp di quando una sincronizzazione o un’analisi è stata tentata e completata per l’ultima volta
- Timestamp di quando una sincronizzazione o un’analisi ha registrato per l’ultima volta una modifica a un prodotto
I dettagli della sincronizzazione si riferiscono a quando Clerk ha recuperato i dati dal webshop per l’ultima volta, mentre i dettagli dell’analisi si riferiscono a quando Clerk ha elaborato e salvato i dati per l’ultima volta.
Impostazioni #
Queste impostazioni ti consentono di configurare la sincronizzazione dei dati per avere accesso al webshop e apportare modifiche su come vengono recuperati i dati.
Metodo di sincronizzazione #
Clerk offre una serie di integrazioni e metodi di sincronizzazione, che rendono possibile la sincronizzazione da qualsiasi piattaforma eCommerce. Le integrazioni che creiamo utilizzano il loro metodo di sincronizzazione per le piattaforme come Shopify, Magento, WooCommerce, e così via.
È anche possibile scegliere Demo Data come metodo di sincronizzazione. Con questa opzione, Clerk sincronizzerà un dataset predefinito che puoi utilizzare per effettuare dei test. Questo è utile se vuoi semplicemente esplorare my.clerk.io e la nostra API prima di avviare una configurazione reale.
Ora di sincronizzazione #
Questa impostazione consente di scegliere intervalli di un’ora in cui deve essere eseguita la sincronizzazione. Scegliendo un orario la sincronizzazione verrà eseguita solo all’interno di quella fascia oraria in orario UTC. Questo è utile se vuoi risparmiare capacità del server durante le ore di maggiore carico ed eseguire la sincronizzazione solo quando il server è meno occupato.
Per impostazione predefinita, è impostato su When Needed (Recommended) che eseguirà la sincronizzazione regolarmente a seconda di quanto tempo impiega a caricare i tuoi dati. Se impiega meno di 10 minuti, la sincronizzazione potrebbe avvenire ogni ora, mentre le sincronizzazioni che impiegano 60+ minuti potrebbero essere eseguite solo una volta al giorno.
Importazione #
Puoi decidere esattamente quali dati importare selezionando Yes o No per ciascuno di:
- 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 la sincronizzazione dei dati sovrascriveranno eventuali modifiche apportate in my.clerk.io a quelle pagine sincronizzate la volta successiva che le pagine vengono sincronizzate.
Le pagine che carichi manualmente in Data > Pages sono considerate protette e non vengono sovrascritte dalla sincronizzazione dei dati.
AI Importers #

Gli AI Importers ti permettono di creare un’integrazione personalizzata da zero, senza alcuna configurazione predefinita. Se la tua piattaforma espone un’API, Clerk.io può collegarsi ad essa.
La configurazione è gestita tramite Ask Clerk.io. Descrivi a quale piattaforma vuoi collegarti, e Ask Clerk.io ti guida nell’inserimento delle credenziali, costruisce l’importatore, testa la connessione e passa a Data Sync con la configurazione completa attiva.
Gli AI Importers sono integrazioni autonome. Se il tuo store funziona su Shopify, ad esempio, e vuoi importare dati aggiuntivi che l’importatore standard di Shopify non copre, puoi configurare un nuovo AI Importer per collegarti direttamente a Shopify.
Quell’AI Importer gestirà tutto: i dati standard così come eventuali campi aggiuntivi di cui hai bisogno.
Una volta stabilita la connessione, puoi estendere ciò che viene importato — aggiungendo attributi extra, importando dati da integrazioni di terze parti o regolando la logica per adattarla al tuo catalogo — tutto tramite Ask Clerk.io.
Leggi di più sul processo di configurazione su AI Importer.
Importatori multipli #
Gli importatori multipli ti permettono di combinare diversi metodi di sincronizzazione per diversi tipi di dati in una singola configurazione dello store.
Questo è utile quando i tuoi dati si trovano in più di un luogo. Potresti importare prodotti, categorie e ordini da Magento 1, mentre importi i dati dei clienti da una piattaforma di segmentazione e le pagine da WordPress.
Ogni tipo di dato viene 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 ciascun tipo.
Vai su Data > Configuration e usa il pulsante + Add importer per aggiungere un secondo metodo di sincronizzazione insieme a quello già esistente.
Per ciascun importatore, puoi configurare quali tipi di dati deve importare. Se un tipo di dato è assegnato a un importatore, non deve essere abilitato anche in un altro — ogni tipo deve avere esattamente una fonte.
Prodotti e categorie sono necessari affinché Clerk.io funzioni correttamente. Assicurati che almeno un importatore sia responsabile per ciascuno di questi.
Log di sincronizzazione #
Questa sezione mostra lo stato della sincronizzazione mentre è in esecuzione e quando è completata. È utile per confermare che tutto funzioni correttamente e aiuta nella risoluzione dei problemi se dovessero sorgere.
Puoi accedervi cliccando su Show latest sync log details.

Whitelisting dell’indirizzo IP #
Se il tuo server ha un blocco IP, devi aggiungere l’indirizzo IP del sistema di Data Sync di Clerk alla whitelist per consentire l’accesso ai tuoi dati.
L’indirizzo IP è 52.57.0.11
Questo IP può cambiare. Se Data Sync risponde con errore 403 o simili, 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 utilizzati per inviare modifiche più piccole man mano che accadono.
La maggior parte delle nostre extensions e integrations li include già, senza bisogno di configurazioni extra. Per qualsiasi altra piattaforma, possono essere configurati tramite la nostra CRUD API.
Con gli aggiornamenti in tempo reale attivati, Clerk è in grado di recuperare modifiche come un semplice aggiornamento di prezzo, ma anche aggiungere o rimuovere completamente dei prodotti.
Questo significa che Clerk non dovrà attendere una sincronizzazione completa ogni volta che apporti piccole modifiche, mantenendo la tua configurazione sempre aggiornata immediatamente.
Quando aggiungi un prodotto tramite la sincronizzazione in tempo reale, apparirà immediatamente nel tuo webshop dopo che sarà visibile 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. Ciò significa che potrebbe non essere visualizzato tra i prodotti popolari finché 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 attraverso una Live Demo caricando un’esportazione una tantum del tuo catalogo. Puoi utilizzarlo scegliendo One-Time CSV Upload dal menu a tendina di Sync method.
Genera file CSV almeno per i tuoi prodotti, categorie e ordini e, se vuoi vedere tutte le funzionalità di Clerk, anche per i tuoi clienti e pagine.
Scarica un file zip contenente i template CSV per tutti i tipi di dati.
Tutti i file utilizzano la separazione tramite virgole. Qualsiasi valore che contiene una virgola deve essere racchiuso tra virgolette, ad esempio "1,2,3" per un elenco di ID.
Prodotti #
Ogni riga rappresenta un prodotto.
| Campo | Obbligatorio | Descrizione |
|---|---|---|
id | Obbligatorio | Identificatore unico del prodotto |
Name | Obbligatorio | Nome del prodotto |
description | Obbligatorio | Descrizione del prodotto |
price | Obbligatorio | Prezzo di vendita attuale |
image | Obbligatorio | URL completo dell’immagine del prodotto |
url | Obbligatorio | URL completo della pagina del prodotto |
categories | Obbligatorio | ID delle categorie di appartenenza separati da virgola. Usa le virgolette per più valori: "1,2,3" |
list_price | Facoltativo | Prezzo originale prima di eventuali sconti |
Vendor | Facoltativo | Marca o nome del fornitore |
Tags | Facoltativo | Tag del prodotto separati da virgola |
Status | Facoltativo | Stato del prodotto, es. active |
Categorie #
Ogni riga rappresenta una categoria.
| Campo | Obbligatorio | Descrizione |
|---|---|---|
id | Obbligatorio | Identificatore unico della categoria |
name | Obbligatorio | Nome della categoria |
url | Obbligatorio | URL completo della pagina della categoria |
subcategories | Obbligatorio | ID delle categorie figlie separati da virgola. Lascia vuoto se non ce ne sono |
image | Facoltativo | URL completo dell’immagine della categoria |
description | Facoltativo | Descrizione della categoria |
Ordini #
Ogni riga rappresenta una voce dell’ordine. Un ordine con più prodotti si estende su più righe, tutte con lo stesso id.
| Campo | Obbligatorio | Descrizione |
|---|---|---|
id | Obbligatorio | Identificatore dell’ordine. Ripetuto su più righe per ordini con più prodotti |
time | Obbligatorio | Timestamp Unix della data dell’ordine |
Product_Id | Obbligatorio | ID del prodotto acquistato nella riga |
Email | Raccomandato | Indirizzo email del cliente, usato per la personalizzazione |
quantity | Raccomandato | Quantità del prodotto in questa voce |
price | Raccomandato | Prezzo pagato per il prodotto in questa voce |
Clienti #
Ogni riga rappresenta un cliente. Deve essere presente almeno uno tra id o Email. Eventuali colonne aggiuntive saranno importate come attributi personalizzati e possono essere utilizzate per la segmentazione dell’audience.
| Campo | Obbligatorio | Descrizione |
|---|---|---|
id | Obbligatorio* | Identificatore unico del cliente |
Email | Obbligatorio* | Indirizzo email del cliente |
name | Facoltativo | Nome completo |
First Name | Facoltativo | Nome |
Last Name | Facoltativo | Cognome |
* È richiesto almeno uno tra id o Email.
Pagine #
Ogni riga rappresenta una pagina di contenuto.
| Campo | Obbligatorio | Descrizione |
|---|---|---|
id | Obbligatorio | Identificatore unico della pagina |
type | Obbligatorio | Tipo della pagina, ad es. blog o article |
url | Obbligatorio | URL completo della pagina |
title | Obbligatorio | Titolo della pagina |
text | Obbligatorio | Testo completo della pagina |
image | Facoltativo | URL completo dell’immagine della pagina |
Questa pagina è stata tradotta da un'utile intelligenza artificiale, quindi potrebbero esserci errori linguistici. Grazie per la comprensione.