Kom godt i gang

Forbind ideal.shop til Clerk.io med en AI-integration for datasynkronisering og den indbyggede integration til Clerk.js og salgssporing. Konfigurer derefter Search og Recommendations til dit tema.
Aktiver integration #
Forbind den tilsvarende Clerk.io Store, før du opsætter dine butikselementer.
- Gå i ideal.shop til Indstillinger > Integrationer og åbn Clerk.io.
- I my.clerk.io, åbn din Store og gå til Developers > API Keys.
- Kopiér den offentlige API-nøgle ind i Public API key i ideal.shop.
- Kopiér den ældre private API-nøgle ind i Private API key.
- Aktiver Aktivér tracking. Aktiver Feed offentligt kun, hvis du planlægger at bruge det alternative native JSON-feed.
- Klik på Gem.
Tjek for eksisterende Clerk.js- og salgssporingskode, før du tilføjer noget manuelt. Hvis du aktiverer den indbyggede integration samtidig med en separat installation, kan det give dobbelte forespørgsler eller salgshændelser.
Konfigurer produkter #
Importer data først, så dine Designs, filtre og sidekontekst bruger rigtige webshopdata.
- Følg Sync Data for at oprette en API-bruger, konfigurere den anbefalede AI-integration for alle datatyper, og inkludere sider via sitemap.
- Opsæt Recommendations med verificerede side-ID’er og placeringsmål.
- Opsæt Search til dine desktop- og mobilsøgninger.
- Hold Elements i In preview under testning.
Vælgere, modul-ID’er, layouts og native JavaScript-funktioner varierer mellem temaer. Fodmagasinet-eksemplerne i disse guider viser, hvordan du undersøger et tema; tjek hver værdi på din egen webshop.
Dynamisk navigation #
Nogle temaer udskifter sideindhold uden fuld genindlæsning. Clerk.io skal opdage det nye indhold og bruge de aktuelle ID’er.
Tjek i my.clerk.io Settings > Features > SPA Auto Detect Changes. Dette lader Clerk.js opdage dynamisk indlæst indhold. Test navigationen, efter du har aktiveret det – indstillingen alene er ikke nok til at garantere, at alle temaopdateringer fungerer.
Verificer navigation mellem produkter, kategoripaginering, kurvopdateringer og Tilbage/Frem. Hvis anbefalinger forsvinder eller bruger et tidligere side-ID, følg navigation FAQ.
Verificer opsætning #
Brug denne tjekliste, før du ændrer Elements fra Preview til Live. Følg de generelle Recommendations og Search best practices, når du vælger oplevelser.
- Åbn de ønskede sider med
?clerk_content_mode=preview(eller&clerk_content_mode=previewhvis der allerede er en forespørgsel). Tjek tilstanden igen efter native paginering eller navigation. - Tjek desktop- og mobil-layouts: sidebredde, læsbare kort, tydelige priser, skarpe billeder, fungerende sliderpile og ingen horisontal sideløb.
- Besøg to forskellige produkter, kategorier og artikler. Bekræft, at hvert Element sender det aktuelle importerede ID.
- Læg varer i, fjern og ændr kurvmængderne i en aftalt testkurv. Bekræft, at anbefalinger bruger de aktuelle produkt-ID’er og håndterer en tom kurv.
- Test køb af simple produkter, påkrævede variantsvalg, utilgængelige produkter og fejlfelter. Genskab testkurven bagefter.
- Åbn, skriv i, luk og genåbn Search. Test Escape, piletastvalg, Enter og mobilkontroller. Lukning af Search skal bevare den underliggende side og scrollposition.
- Gentag navigation og Tilbage/Frem efter brug af Search. Tjek for manglende Elements, forældede resultater, dublerede placeringer eller dobbelte forespørgsler fra samme Element.
- Bekræft, at Clerk.js indlæses gennem den indbyggede integration, og at kun én installation initialiserer Store. Inspicér browserens netværksforespørgsler og konsolfejl.
- Verificer salgssporing mod en aftalt testordre eller en eksisterende gennemført ordre med tracking-dokumentation. Tjek ordrenummer, produkt-ID’er, antal, priser og én salgshændelse. En vellykket datasynkronisering i sig selv bekræfter ikke frontend-sporing.
- Åbn eksplicit
?clerk_content_mode=livefor at forlade Preview. At fjerne Preview-parameteren alene kan lade Preview være aktiv. Bekræft den ønskede Live-oplevelse.
Hold midlertidige rettelser ude af standardinstallationen. Se FAQ for feed-, tema- og navigationsudfordringer.
Denne side er oversat af en hjælpsom AI, og der kan derfor være sproglige fejl. Tak for forståelsen.