ideal.shop

Kom godt i gang

Forbind din webshop og verificér Search, Recommendations og sporing.
ideal.shop integration settings for Clerk.io

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.

  1. Gå i ideal.shop til Indstillinger > Integrationer og åbn Clerk.io.
  2. I my.clerk.io, åbn din Store og gå til Developers > API Keys.
  3. Kopiér den offentlige API-nøgle ind i Public API key i ideal.shop.
  4. Kopiér den ældre private API-nøgle ind i Private API key.
  5. Aktiver Aktivér tracking. Aktiver Feed offentligt kun, hvis du planlægger at bruge det alternative native JSON-feed.
  6. 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.

  1. Følg Sync Data for at oprette en API-bruger, konfigurere den anbefalede AI-integration for alle datatyper, og inkludere sider via sitemap.
  2. Opsæt Recommendations med verificerede side-ID’er og placeringsmål.
  3. Opsæt Search til dine desktop- og mobilsøgninger.
  4. 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=preview hvis 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=live for 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.