ideal.shop

Synkroniser data

Importer komplette katalogdata, ordreoversigt og indholdssider.

Den anbefalede måde at synkronisere ideal.shop-data på er en AI Integration ved hjælp af shopens API. Opsæt det for alle datatyper, hvor indholdssider hentes via sitemap som en del af samme integration.

Opret API-bruger #

Opret en API-bruger i ideal.shop for at give AI Integration adgang til dine shopdata.

  1. Log ind på dit ideal.shop-backend.
  2. Gå til Indstillinger > Integrationer > API.
  3. Opret en ny API-bruger.
  4. Sæt flueben i Aktiv-feltet ved siden af API-brugeren. API-brugere aktiveres ikke automatisk, og integrationen virker ikke før brugeren er aktiv.
  5. Gem API Username og API code, der vises for brugeren. Du skal bruge begge under opsætningen.

AI Integration #

Brug API-adgangsoplysningerne til at oprette integrationen via Ask Clerk.io.

  1. I my.clerk.io, åbn den tilsvarende Store og gå til Ask Clerk.io.
  2. Bed om at opsætte en AI Integration til ideal.shop, der dækker alle datatyper. Inkluder din webshop-URL.
  3. Angiv API Username og API code, når du bliver bedt om adgangsoplysninger.
  4. Angiv din sitemap-URL og bed den hente indholdssider som en del af samme integration, som beskrevet i Import Pages.
  5. Gennemgå testresultater og eksempler på records, inden du gennemfører opsætningen og overdrager integrationen til Data Sync.
  6. Åbn Data > Configuration, start en datasync og tjek antal importerede records.

Tjek at første import dækker hele kataloget og den ønskede ordre-historik, og at løbende importer dækker alle ordrer siden sidste succesfulde sync. Se Data Sync for planlægning, status og logs.

Import Pages #

Artikler og andre indholdssider skal have deres egne records, før de kan vises i Search eller danne grundlag for sidebaserede anbefalinger.

Sider skal stadig hentes via webshopens sitemap. Inkluder dette i samme AI Integration som API-importen; en separat sideintegration er ikke nødvendig.

Angiv sitemap-URL’en i Ask Clerk.io og forklar, hvilke sidetyper der skal inkluderes og udelukkes. Bed den om at finde indeks for sitemaps og deres underliggende sitemaps, hente de relevante sider og foreslå eksempler på records til gennemsyn.

For Fodmagasinet er det eksempelvis https://www.fodmagasinet.dk/sitemap.xml, hvor forsiden og URL’er med /vare er udelukket. Disse regler passer til den shops URL-struktur; tjek dit eget sitemap, før du vælger filtre.

Valider hver test:

  • Et stabilt, unikt ID, der matcher butiksside-id’et, når du bruger sidebaserede anbefalinger.
  • Korrekt titel, kanonisk URL og relevant artikelindhold uden header, footer eller navigationstekst.
  • Ingen dubletter af URL’er, produktsider, kategorilister eller andre uønskede sidetyper.

Hvis importøren genererer andre IDs end dem, der udsendes af temaet, aftal en mapping med udvikleren, før du opsætter artikelanbefalinger. Tjek importerede eksempler og antal efter første kørsel.

Import af sider og visning af dem er separate trin. Search Design skal også kunne vise sideresultater; se Search.

Native Feed #

Det native JSON-feed er et alternativ til eksisterende feed-baserede opsætninger. Begrænsningerne herunder gælder kun dette feed, ikke den anbefalede API-baserede AI Integration.

Start med at aktivere integrationen, inkl. Feed offentligt.

Konfigurer Feed #

Uden specifikke begrænsninger returnerer feedet op til 50 records pr. datatype. Sæt separate grænser for produkter, kategorier og ordrer til det første historiske import.

  1. I ideal.shop, åbn Indstillinger > Integrationer > Clerk.io.
  2. Kopiér URL’en under Sti til feed.
  3. For en URL uden forespørgselsparametre, tilføj ?&products=10000&categories=10000&orders=10000:
https://example.com/feeds/clerk_io_feed.json?&products=10000&categories=10000&orders=10000

Hvis din URL allerede har en querystring, tilføj parametrene med & og behold eventuelle eksisterende nødvendige parametre. Tilføj ikke et ekstra ? eller dupliker ikke en eksisterende grænse.

Disse værdier beder om op til 10.000 records af hver nævnte type. Hæv hver grænse efter behov; 10.000 er et eksempel, ikke en garanti for fuldt eksport. Andre datatyper beholder standardindstilling, medmindre de konfigureres særskilt.

For eksempel bruger Fodmagasinet’s feed samme syntaks på sit eget domæne:

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

Start Sync #

Konfigurer Clerk.io til at læse hele feed-URL’en, inklusive begrænsninger.

  1. I my.clerk.io, åbn den tilsvarende Store og gå til Data > Configuration.
  2. Vælg Clerk.io JSON Feed som sync-metode.
  3. Indsæt feed-URL og gem konfigurationen.
  4. Klik på Start New Data Sync og vent på, at det er færdigt.
  5. Sammenlign importerede antal med webshopens eksporttal, så du tager højde for bevidst udeladte records.

Et antal svarende til en grænse kan indikere afkortning. Hæv grænsen og sync igen. Tjek ældste importerede ordre og det totale antal; en succesfuld synkronisering kan stadig kun indeholde en del af historikken.

Se Data Sync for status og logs eller feed FAQ for afkortning og timeouts.

Løbende Imports #

Efter den første succesfulde historiske import, fjern &orders=10000. Behold de fulde kataloggrænser:

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

Fjernelse af orders genskaber standarden for de 50 nyeste ordrer. Det deaktiverer ikke ordreimport. Clerk.io bevarer tidligere importerede ordrer, så det løbende feed behøver kun at dække de nyeste ordrer.

Inden du bruger standarden, sammenlign webshopens ordremængde med tiden mellem succesfulde synchroniseringer, inklusiv forsinkelser eller mislykkede syncs. Tjek at den ældste ordre overlapper den sidste succesfulde import, og at alle ordrer siden da er til stede.

Hvis 50 ordrer ikke dækker det interval, behold et eksplicit orders-limit, der er stort nok til at dække det med overlap. For eksempel, tilføj kun &orders=500 hvis det dækker dit behov. Tjek igen efter en sync-fejl eller stigning i ordrer.

Behold products og categories højt nok til hele kataloget ved hver sync. Sænk dem ikke til standard, efter du har importeret én gang.

Valider Data #

En succesfuld status og rimelige antal beviser ikke, at data matcher butikken. Sammenlign repræsentative importerede records med den faktiske webshop.

TjekHvad skal verificeres
KategorierSkjulte eller upublicerede kategorier er udelukket som tilsigtet. Produkt-kategorireferencer matcher de korrekte importerede kategorirecords.
TilgængelighedPå lager, udsolgte og utilgængelige produkter opfører sig som tilsigtet i resultater og køb. Bekræft betydning og type af lagerfelter.
BillederBilleder forbliver skarpe ved faktisk kortstørrelse på desktop og mobil, inkl. skærme med høj densitet.
PriserPriser for forældre- og variantprodukt matcher webshopens valuta, momsbehandling og rabatter. Tjek nulpriser og produkter med flere variantpriser.
RabatterFelt for normalpris eksisterer og overstiger salgspris, før der vises gennemstreget pris eller tilbudsmærke.
SiderTitler, URL’er, indhold og artikel-ID’er matcher de tilsigtede indholdssider.

Se card data for prisvisning og FAQ for problemer med billede- eller kildedata.

Denne side er oversat af en hjælpsom AI, og der kan derfor være sproglige fejl. Tak for forståelsen.