Inizia

Collega ideal.shop a Clerk.io con un’Integrazione AI per la sincronizzazione dei dati e l’integrazione incorporata per Clerk.js e il tracciamento delle vendite. Poi configura Search e Recommendations per il tuo tema.
Abilita integrazione #
Collega il Clerk.io Store corrispondente prima di configurare gli Elements per il tuo negozio.
- In ideal.shop, vai su Indstillinger > Integrationer e apri Clerk.io.
- In my.clerk.io, apri il tuo Store e vai su Developers > API Keys.
- Copia la public API key in Public API key su ideal.shop.
- Copia la legacy private API key in Private API key.
- Abilita Aktivér tracking. Abilita Feed offentligt solo se intendi usare il feed JSON nativo alternativo.
- Clicca su Gem.
Controlla se sono già presenti codice Clerk.js e di tracciamento delle vendite prima di aggiungere qualsiasi cosa manualmente. L’abilitazione dell’integrazione nativa insieme a un’installazione separata può causare richieste o eventi di vendita duplicati.
Configura prodotti #
Importa prima i dati in modo che i tuoi Design, filtri e il contesto delle pagine usino i dati reali del webshop.
- Segui Sync Data per creare un utente API, configurare la AI Integration consigliata per tutti i tipi di dati e includere le pagine tramite la sitemap.
- Imposta le Recommendations con gli ID pagina verificati e i target di posizionamento.
- Imposta Search per gli input desktop e mobile.
- Tieni gli Elements in In preview durante i test.
Selettori, ID moduli, layout e funzioni JavaScript native variano tra i temi. Gli esempi di Fodmagasinet in queste guide mostrano come indagare un tema; controlla ogni valore sul tuo webshop.
Navigazione dinamica #
Alcuni temi sostituiscono il contenuto della pagina senza un ricaricamento completo. Clerk.io deve riconoscere il contenuto sostitutivo e usare gli ID correnti.
In my.clerk.io, controlla Settings > Features > SPA Auto Detect Changes. Questo permette a Clerk.js di rilevare i contenuti caricati dinamicamente. Testa la navigazione dopo averla abilitata: la sola impostazione non garantisce il funzionamento ad ogni aggiornamento del tema.
Verifica la navigazione prodotto-prodotto, la paginazione delle categorie, gli aggiornamenti del carrello e Avanti/Indietro. Se le recommendations scompaiono o usano l’ID della pagina precedente, segui la navigation FAQ.
Verifica configurazione #
Usa questa checklist prima di cambiare gli Elements da Preview a Live. Segui le best practice generali su Recommendations e Search per scegliere le esperienze più adatte.
- Apri le pagine desiderate usando
?clerk_content_mode=preview(o&clerk_content_mode=previewse esiste già una query). Ricontrolla la modalità dopo paginazione o navigazione native. - Controlla layout desktop e mobile: larghezza pagina nativa, card leggibili, prezzi chiari, immagini nitide, frecce slider funzionanti e nessun overflow orizzontale.
- Visita due prodotti, due categorie e due articoli diversi. Conferma che ogni Element invii l’ID attualmente importato.
- Aggiungi, rimuovi e cambia le quantità del carrello in un carrello di test concordato. Conferma che le recommendations usino gli ID dei prodotti correnti e gestiscano un carrello vuoto.
- Testa l’acquisto di semplici prodotti, la scelta delle varianti richieste, prodotti non disponibili e i messaggi di errore. Ripristina il carrello di test in seguito.
- Apri, scrivi, chiudi e riapri Search. Prova Escape, selezione con tasti freccia, Enter e controlli mobile. Chiudere Search deve preservare la pagina sottostante e la posizione di scroll.
- Ripeti la navigazione e Avanti/Indietro dopo aver usato Search. Controlla per Elements mancanti, risultati obsoleti, posizionamenti doppi o richieste duplicate dallo stesso Element.
- Conferma che Clerk.js sia caricato tramite l’integrazione nativa e che solo una installazione inizializzi lo Store. Controlla le richieste Network e gli errori nella console del browser.
- Verifica il tracciamento delle vendite su un ordine di test concordato o un ordine già completato con prove di tracciamento. Controlla ID ordine, ID prodotti, quantità, prezzi ed un solo evento vendita. Una sincronizzazione dati senza errori non verifica il tracciamento frontend.
- Apri esplicitamente
?clerk_content_mode=liveper uscire da Preview. Rimuovere solo il parametro Preview potrebbe lasciare ancora Preview attivo. Conferma l’esperienza Live desiderata.
Tieni fuori le soluzioni temporanee dall’installazione standard. Consulta le FAQ per casi limite relativi a feed, tema e navigazione.
Questa pagina è stata tradotta da un'utile intelligenza artificiale, quindi potrebbero esserci errori linguistici. Grazie per la comprensione.