ideal.shop

Sincronizza dati

Importa dati completi del catalogo, cronologia degli ordini e pagine di contenuti.

Il modo consigliato per sincronizzare i dati di ideal.shop è tramite una AI Integration utilizzando le API del negozio. Configurala per tutti i tipi di dati, con le pagine di contenuto recuperate tramite la sitemap come parte della stessa integrazione.

Creazione utente API #

Crea un utente API in ideal.shop per dare alla AI Integration l’accesso ai dati del tuo negozio.

  1. Accedi al backend di ideal.shop.
  2. Vai su Indstillinger > Integrationer > API.
  3. Crea un nuovo utente API.
  4. Seleziona la casella Aktiv accanto all’utente API. Gli utenti API non sono attivati automaticamente e l’integrazione non funzionerà finché l’utente non è attivo.
  5. Conserva i valori di API Username e API code mostrati per l’utente. Ti serviranno entrambi durante la configurazione.

AI Integration #

Utilizza le credenziali API per configurare l’integrazione tramite Ask Clerk.io.

  1. Su my.clerk.io, apri lo Store corrispondente e vai su Ask Clerk.io.
  2. Chiedi di configurare una AI Integration per ideal.shop che copra tutti i tipi di dati. Includi l’URL del tuo webshop.
  3. Fornisci l’API Username e l’API code quando richiesto.
  4. Fornisci l’URL della sitemap e chiedi di recuperare le pagine di contenuto come parte della stessa integrazione, come descritto in Import Pages.
  5. Esamina i risultati dei test e i record di esempio prima di completare la configurazione e trasferire l’integrazione a Data Sync.
  6. Apri Data > Configuration, avvia una sincronizzazione dei dati e controlla i conteggi importati e i record.

Verifica che la prima importazione includa l’intero catalogo e lo storico degli ordini desiderato, e che le importazioni successive includano tutti gli ordini dal precedente sync riuscito. Consulta Data Sync per la pianificazione, lo stato e i log.

Import Pages #

Articoli e altre pagine di contenuto necessitano di record dedicati prima che possano apparire in Search o fornire contesto per le recommendations basate sulle pagine.

Le pagine devono comunque essere recuperate tramite la sitemap del webshop. Includi questa operazione nella stessa AI Integration dell’importazione tramite API; non è richiesta un’integrazione separata per le pagine.

Fornisci l’URL della sitemap in Ask Clerk.io e spiega quali tipi di pagina includere o escludere. Chiedi di individuare gli indici della sitemap e relative child sitemaps, recuperare le pagine richieste e proporre dei record di esempio da valutare.

Per Fodmagasinet, la fonte di esempio di discovery è https://www.fodmagasinet.dk/sitemap.xml, con la homepage e gli URL contenenti /vare esclusi. Queste regole si adattano alla struttura degli URL di quel webshop; controlla la tua sitemap prima di applicare dei filtri.

Valida ogni record di esempio:

  • Un ID stabile e univoco che corrisponda all’ID dell’articolo nel front store quando usi recommendations basate sulle pagine.
  • Il titolo corretto, URL canonico e contenuto utile dell’articolo 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 rispetto a quelli esposti dal tema, concorda una mappatura con lo sviluppatore prima di configurare le recommendations sugli articoli. Verifica campioni e conteggi importati dopo la prima esecuzione.

L’importazione e la visualizzazione delle pagine sono passaggi separati. Il Search Design deve anche rendere i risultati delle pagine; vedi Search.

Native Feed #

Il feed JSON nativo è un’alternativa per le configurazioni già basate su feed. I limiti seguenti si applicano solo a quel feed, non alla AI Integration raccomandata basata su API.

Prima abilita l’integrazione, incluso Feed offentligt.

Configura Feed #

In assenza di limiti espliciti, il feed restituisce fino a 50 record per tipo di dato. Imposta limiti separati per prodotti, categorie e ordini alla 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 stringa di query, aggiungi i parametri con & e mantieni eventuali altri parametri obbligatori. Non aggiungere un secondo ? né duplicare un limite già esistente.

Questi valori richiedono fino a 10.000 record per ogni tipo elencato. Aumenta ogni limite se necessario; 10.000 è solo un esempio e non garantisce l’esportazione completa. Gli altri tipi di dati mantengono il valore predefinito se non configurati separatamente.

Ad 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 Sync #

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

  1. Su my.clerk.io, apri lo Store corrispondente e vai su Data > Configuration.
  2. Scegli Clerk.io JSON Feed come metodo di sync.
  3. Incolla l’URL del feed e salva la configurazione.
  4. Fai clic su Start New Data Sync e attendi il completamento.
  5. Confronta i conteggi importati con i totali esportabili dal webshop, considerando eventuali record esclusi intenzionalmente.

Un conteggio uguale al limite richiesto può indicare una troncatura. Aumenta il limite ed esegui nuovamente la sync. Controlla anche l’ordine più vecchio importato oltre al totale; una sync riuscita può comunque contenere solo parte dello storico.

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

Importazioni continue #

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

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

La rimozione di orders ripristina il valore predefinito di 50 ordini più recenti. Questo non disabilita l’import degli ordini. Clerk.io mantiene gli ordini già importati; quindi il feed aggiornato deve coprire solo i nuovi ordini più recenti.

Prima di usare il valore predefinito, confronta il volume degli ordini del webshop con l’intervallo di tempo tra due sync riuscite, inclusi eventuali ritardi o sync fallite. Controlla che l’ordine più vecchio restituito copra l’ultima importazione riuscita e che tutti gli ordini dalla sincronizzazione precedente siano presenti.

Se 50 ordini non sono sufficienti per quel periodo, mantieni nel feed un limite esplicito orders abbastanza alto da coprirlo con sovrapposizione. Ad esempio, aggiungi &orders=500 solo se copre il tuo volume. Ricontrolla dopo un’interruzione della sincronizzazione o un aumento degli ordini.

Mantieni products e categories sufficientemente alti per coprire l’intero catalogo attuale ad ogni sync. Non ridurli al valore predefinito dopo aver importato una volta.

Valida Dati #

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

VerificaCosa controllare
CategorieLe categorie nascoste o non pubblicate sono escluse come previsto. I riferimenti tra prodotti e categorie corrispondono ai record importati corretti.
DisponibilitàI prodotti disponibili, esauriti e non disponibili si comportano come previsto nei risultati e nell’acquisto. Conferma significato e tipo dei campi stock.
ImmaginiLe immagini restano nitide nelle dimensioni effettive della card su desktop e mobile, anche su schermi ad alta densità.
PrezziI prezzi di master e varianti corrispondono a valuta, tassazione e sconti del webshop. Controlla prezzi a zero e prodotti con più prezzi per variante.
ScontiIl campo regular-price esiste ed è superiore al prezzo di vendita prima di mostrare il prezzo sbarrato o il badge di sconto.
PagineTitoli, URL, contenuto e ID articolo corrispondono alle pagine di contenuto previste.

Vedi card data per la visualizzazione prezzi e la FAQ per problemi di immagini e dati sorgente.

Questa pagina è stata tradotta da un'utile intelligenza artificiale, quindi potrebbero esserci errori linguistici. Grazie per la comprensione.