Sync
Avvio di una sincronizzazione #
Puoi sempre avviare una sincronizzazione completa da my.clerk.io accedendo a 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 dell’inizio dell’elaborazione:
- Starts in [time] significa che la sincronizzazione è in attesa che termini il cooldown.
- Slight delay in the download queue significa che ci sono tra 20 e 99 lavori in coda.
- Moderate delay in the download queue significa che ci sono tra 100 e 499 lavori in coda.
- Significant delay in the download queue significa che ci sono 500 o più lavori in coda.
- Data sync starting… significa che non ci sono ritardi significativi.
Informazioni #
Questa sezione offre una panoramica rapida sullo stato della tua sincronizzazione:
- Il numero di prodotti, categorie, pagine, ordini e clienti che sono stati importati
- La durata dell’ultima sincronizzazione e la durata media di una sincronizzazione completa
- I timestamp relativi a quando è stata tentata e completata l’ultima sincronizzazione o analisi
- I timestamp relativi a quando una sincronizzazione o un’analisi ha registrato l’ultima modifica a un prodotto
I dettagli della sincronizzazione si riferiscono a quando Clerk ha recuperato l’ultima volta i dati dal webshop, mentre i dettagli dell’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 accedere al webshop e modificare il modo in cui i dati vengono raccolti.
Metodo di sincronizzazione #
Clerk offre numerose integrazioni e metodi di sincronizzazione, rendendo possibile la sincronizzazione da qualsiasi piattaforma eCommerce. Le integrazioni che costruiamo utilizzano il proprio metodo di sincronizzazione per piattaforme come Shopify, Magento, WooCommerce, e così via.
È anche possibile scegliere Demo Data come metodo di sincronizzazione. In questo modo, Clerk sincronizzerà un dataset predefinito che puoi usare per testare. 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 1 ora in cui la sincronizzazione deve essere eseguita. Scegliendo un orario, la sincronizzazione verrà eseguita solo in quel lasso di tempo secondo l’orario UTC. Utile se vuoi risparmiare capacità del server durante gli orari di maggiore carico e sincronizzare solo quando il server è meno occupato.
Per impostazione predefinita, è selezionata la modalità When Needed (Recommended) che esegue la sincronizzazione regolarmente in base a quanto tempo richiede il caricamento dei dati. Se dura meno di 10 minuti, la sincronizzazione potrebbe essere eseguita ogni ora, mentre sincronizzazioni di 60 minuti o più potrebbero essere eseguite solo una volta al giorno.
Importazione #
Puoi decidere esattamente quali dati importare selezionando Sì o No per ciascuno dei seguenti:
- Prodotti
- Categorie
- Ordini
- Clienti
- Pagine
Clerk richiede prodotti e categorie per funzionare correttamente e si raccomanda vivamente di 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 prossima volta che le pagine verranno sincronizzate.
Le pagine caricate 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 nessuna configurazione predefinita. Se la tua piattaforma espone un’API, Clerk.io può collegarsi ad essa.
La configurazione viene gestita tramite Ask Clerk.io. Descrivi a quale piattaforma vuoi collegarti e Ask Clerk.io ti guida attraverso le credenziali, costruisce l’importer, testa la connessione e trasferisce il controllo a Data Sync con la configurazione completa.
Puoi gestire domande riguardanti l’importer e la sincronizzazione nella stessa conversazione Ask Clerk.io. Se una sincronizzazione necessita di credenziali o un’altra decisione, Ask Clerk.io spiega ciò di cui ha bisogno prima di proseguire.
Gli AI Importers sono integrazioni autonome. Se ad esempio il tuo store è su Shopify e vuoi importare dati aggiuntivi che l’importatore standard di Shopify non prevede, configura un nuovo AI Importer impostato per comunicare direttamente con Shopify.
Quell’AI Importer gestisce quindi tutto: i dati standard così come qualsiasi campo aggiuntivo necessario.
Una volta stabilita la connessione, puoi ampliare ciò che viene importato — aggiungendo attributi extra, importando dati da integrazioni di terze parti o modificando la logica per adattarla al tuo catalogo — tutto tramite Ask Clerk.io.
Leggi di più sul processo di configurazione in AI Importer.
Importatori Multipli #
Gli Importatori Multipli consentono di combinare diversi metodi di sincronizzazione per diversi tipi di dati all’interno di un’unica configurazione dello store.
Questo è utile quando i tuoi dati risiedono in più luoghi. Potresti importare prodotti, categorie e ordini da Magento 1, mentre importi i dati 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 è responsabile di ciascun tipo.
Vai su Data > Configuration e usa il pulsante + Add importer per aggiungere un secondo metodo di sincronizzazione accanto a quello già 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 in un altro — ogni tipo deve avere esattamente una fonte.
Prodotti e categorie sono richiesti affinché Clerk.io funzioni correttamente. Assicurati che almeno un importer sia responsabile per ciascuno di questi.
Log della sincronizzazione #
Questa sezione mostra lo stato della sincronizzazione mentre è in corso e quando è terminata. È utile per confermare che tutto funzioni senza problemi e per aiutarti a risolvere eventuali problemi.
Puoi accedervi cliccando su Show latest sync log details.
Whitelist dell’indirizzo IP #
Se il tuo server ha un blocco IP, devi aggiungere in 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 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 ritardi. Mentre la sincronizzazione completa dei dati è ottima per caricare grandi quantità di dati a intervalli regolari, gli aggiornamenti in tempo reale sono utilizzati per inviare modifiche minori mentre avvengono.
La maggior parte delle nostre extensions e integrations li includono già, senza ulteriori configurazioni. 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 una semplice variazione di prezzo, ma anche di aggiungere o rimuovere completamente i prodotti.
Questo significa che Clerk non dovrà attendere una sincronizzazione completa ogni volta che effettui piccole modifiche, mantenendo la tua configurazione sempre aggiornata immediatamente.
Quando aggiungi un prodotto tramite la sincronizzazione in tempo reale, questo apparirà sul tuo webshop istantaneamente dopo che appare 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 essere visualizzato come prodotto popolare fino a che non viene eseguita una sincronizzazione completa dei dati.
File CSV #
Questo è un metodo speciale di sincronizzazione che può essere utilizzato per dimostrare le funzionalità di Clerk.io tramite una Live Demo caricando una esportazione una tantum del tuo catalogo. Puoi utilizzarlo scegliendo One-Time CSV Upload dal menu a tendina Sync method.
La schermata di caricamento mostra una barra di avanzamento in tempo reale mentre Clerk.io elabora i file. L’elaborazione può continuare anche dopo che il trasferimento dei file è terminato, quindi attendi che l’avanzamento sia completato prima di procedere.
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 file template CSV per tutti i tipi di dati.
Tutti i file sono separati da virgole. Qualsiasi valore che contiene una virgola deve essere racchiuso tra doppi apici, ad esempio "1,2,3" per una lista di ID.
Prodotti #
Ogni riga rappresenta un prodotto.
| Campo | Richiesto | Descrizione |
|---|---|---|
id | Richiesto | Identificativo univoco del prodotto |
Name | Richiesto | Nome del prodotto |
description | Richiesto | Descrizione del prodotto |
price | Richiesto | Prezzo di vendita attuale |
image | Richiesto | URL completo all’immagine del prodotto |
url | Richiesto | URL completo alla pagina prodotto |
categories | Richiesto | ID delle categorie di appartenenza del prodotto separati da virgola. Usa le virgolette per elencare più valori: "1,2,3" |
list_price | Facoltativo | Prezzo originale prima di eventuali sconti |
Vendor | Facoltativo | Nome del brand o del fornitore |
Tags | Facoltativo | Tag del prodotto separati da virgola |
Status | Facoltativo | Stato del prodotto, ad es. active |
Categorie #
Ogni riga rappresenta una categoria.
| Campo | Richiesto | Descrizione |
|---|---|---|
id | Richiesto | Identificativo univoco della categoria |
name | Richiesto | Nome della categoria |
url | Richiesto | URL completo alla pagina della categoria |
subcategories | Richiesto | ID delle sottocategorie separati da virgola. Lascia vuoto se non ce ne sono |
image | Facoltativo | URL completo all’immagine della categoria |
description | Facoltativo | Descrizione della categoria |
Ordini #
Ogni riga rappresenta una voce d’ordine. Un ordine con più prodotti occupa più righe, tutte con lo stesso id.
| Campo | Richiesto | Descrizione |
|---|---|---|
id | Richiesto | Identificativo dell’ordine. Ripetuto per ordini con più prodotti |
time | Richiesto | Timestamp Unix del momento dell’ordine |
Product_Id | Richiesto | ID del prodotto acquistato in questa riga |
Email | Raccomandato | Indirizzo email del cliente, usato per la personalizzazione |
quantity | Raccomandato | Quantità del prodotto in questa voce d’ordine |
price | Raccomandato | Prezzo pagato per il prodotto in questa voce d’ordine |
Clienti #
Ogni riga rappresenta un cliente. Deve essere presente almeno id o Email. Tutte le colonne aggiuntive che includi saranno importate come attributi personalizzati e potranno essere usate per la segmentazione dell’audience.
| Campo | Richiesto | Descrizione |
|---|---|---|
id | Richiesto* | Identificativo univoco del cliente |
Email | Richiesto* | 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 | Richiesto | Descrizione |
|---|---|---|
id | Richiesto | Identificativo univoco della pagina |
type | Richiesto | Tipo di pagina, es. blog o article |
url | Richiesto | URL completo della pagina |
title | Richiesto | Titolo della pagina |
text | Richiesto | 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.