Sincronizza dati

Importa i dati di ideal.shop prima di configurare Search e Recommendations. Prima abilita l’integrazione, incluso Feed offentligt.

Configura Feed #

Senza limiti espliciti, il feed restituisce fino a 50 record per tipo di dato. Imposta limiti separati per prodotti, categorie e ordini per la prima importazione storica.

1. In ideal.shop, apri Indstillinger > Integrationer > Clerk.io.
2. Copia l’URL sotto Sti til feed.
3. Per un URL senza parametri di query, aggiungi ?&products=10000&categories=10000&orders=10000:

https://example.com/feeds/clerk_io_feed.json?&products=10000&categories=10000&orders=10000

Se il tuo URL ha già una query string, aggiungi i parametri con & e mantieni tutti i parametri richiesti già esistenti. Non aggiungere un secondo ? né duplicare un limite già presente.

Questi valori richiedono fino a 10.000 record per ogni tipo nominato. Aumenta ogni limite dove necessario; 10.000 è un esempio, non una garanzia di un’esportazione completa. Altri tipi di dati mantengono il valore predefinito se non configurati separatamente.

Per esempio, il feed di Fodmagasinet usa la stessa sintassi sul proprio dominio:

https://www.fodmagasinet.dk/feeds/clerk_io_feed.json?&products=10000&categories=10000&orders=10000

Avvia la sincronizzazione #

Configura Clerk.io per leggere l’intero URL del feed, inclusi i relativi limiti.

1. In my.clerk.io, apri il negozio corrispondente e vai su Data > Configuration.
2. Scegli Clerk.io JSON Feed come metodo di sincronizzazione.
3. Incolla l’URL del feed e salva la configurazione.
4. Clicca su Start New Data Sync e attendi il completamento.
5. Confronta i conteggi importati con i totali esportabili del webshop, tenendo conto dei record esclusi intenzionalmente.

Un conteggio uguale a un limite richiesto può indicare troncamento. Aumenta quel limite e sincronizza di nuovo. Controlla anche l’ordine importato più vecchio oltre al totale; una sincronizzazione riuscita può comunque contenere solo parte della cronologia.

Consulta Data Sync per stato e log, o la feed FAQ per troncamenti e timeout.

Importazioni continue #

Dopo la prima importazione storica riuscita, rimuovi &orders=10000. Mantieni i limiti completi del catalogo:

https://example.com/feeds/clerk_io_feed.json?&products=10000&categories=10000

Rimuovere orders ripristina il valore predefinito delle 50 ordini più recenti. Non disattiva l’importazione degli ordini. Clerk.io conserva gli ordini precedentemente importati, quindi il feed in corso deve solo coprire gli ordini recenti.

Prima di usare il valore predefinito, confronta il volume di ordini del webshop con l’intervallo di tempo tra sincronizzazioni riuscite, includendo ritardi o errori di sincronizzazione. Verifica che l’ordine più vecchio restituito si sovrapponga all’ultima importazione riuscita e che tutti gli ordini successivi siano presenti.

Se 50 ordini non coprono quell’intervallo, mantieni un limite esplicito orders abbastanza grande da coprirlo con sovrapposizione. Ad esempio, aggiungi &orders=500 solo se copre il tuo volume. Ricontrolla dopo un’interruzione di sincronizzazione o un aumento degli ordini.

Mantieni products e categories sufficientemente alti per l’intero catalogo corrente ad ogni sincronizzazione. Non ridurli al valore predefinito dopo una sola importazione.

Importa pagine #

Articoli e altre pagine di contenuto necessitano dei propri record prima di poter apparire in Search o fornire contesto alle recommendations basate sulle pagine.

Verifica copertura #

Esamina la collezione pages del feed nativo e le pagine importate in Clerk.io. Confronta gli URL e gli ID degli articoli noti; la sola presenza nella sitemap non significa che il feed nativo esporti quella pagina.

Se il feed nativo include già i contenuti necessari, usa quei record. Evita di importare di nuovo lo stesso URL tramite un altro importatore.

Estendi importazione #

Se mancano pagine, apri Ask Clerk.io e richiedi un’ AI Integration per le pagine di contenuto. Fornisci l’URL della sitemap del webshop e spiega quali tipi di pagine includere o escludere.

Chiedi che rilevi index sitemap e le relative sitemap figlie, recuperi le pagine desiderate e proponga un’importazione di esempio da revisionare. Conferma che l’importatore delle pagine possa funzionare assieme all’importazione nativa del catalogo senza sostituire o duplicare i suoi record.

Per Fodmagasinet, la fonte di discovery di esempio è https://www.fodmagasinet.dk/sitemap.xml, con esclusione della homepage e delle URL che contengono /vare. Queste regole si adattano alla struttura URL di quel webshop; esamina la tua sitemap prima di scegliere i filtri.

Valida ciascun record di esempio:

• Un ID stabile e unico che corrisponde all’ID articolo dello shopfront quando usi recommendations basate sulle pagine.
• Il titolo corretto, URL canonico e contenuto dell’articolo utile senza testo di header, footer o navigazione.
• Nessun URL duplicato, pagina prodotto, elenco categorie o altri tipi di pagina indesiderati.

Se l’importatore genera ID diversi da quelli esposti dal tema, concorda una corrispondenza con lo sviluppatore prima di configurare recommendations per gli articoli. Verifica i campioni importati e i conteggi dopo la prima esecuzione.

Importare pagine e visualizzarle sono passaggi separati. Anche il Search Design deve rendere i risultati delle pagine; vedi Search.

Valida dati #

Uno stato di successo e conteggi plausibili non provano che i dati corrispondano al sito. Confronta rappresentativi record importati con il webshop reale.

Consulta card data per la visualizzazione dei prezzi e la FAQ per problemi su immagini e dati di origine.