Platformmigration

At flytte din webshop fra én platform til en anden — for eksempel fra Magento 2 til Shopify, eller WooCommerce til BigCommerce — involverer mere end blot at geninstallere Clerk.io-udvidelsen.

Dine produkt-ID’er vil sandsynligvis ændre sig. Din synkroniseringsmetode skal udskiftes. Dine designs kan henvise til platforms-specifikke attributnavne. Og dine historiske ordredata skal overføres for at holde AI’en præsterende fra dag ét.

Denne guide gennemgår hvert trin.

Før du går i gang #

Før du ændrer noget i Clerk.io, skal du besvare disse to spørgsmål:

Vil dine produkt-ID’er ændre sig?
De fleste platform-migrationer tildeler nye ID’er til produkter. Dette er vigtigt, fordi Clerk.io’s AI forbinder produkter til ordrer ved hjælp af id-feltet. Hvis ID’erne ændrer sig, vil gamle ordrer referere til ID’er, der ikke længere findes i den nye katalog.

Kan du matche produkt-ID’er til ordrehistorikken?
Hvis du kan matche gamle produkt-ID’er med nye (eller bevare dem helt), kan du beholde din eksisterende Clerk.io Store — uanset om domænet ændrer sig. Store’s ordrehistorik forbliver intakt og AI’en bevarer sine lærte sammenhænge.

Hvis ID-matching ikke er mulig, og du ikke kan matche gamle ordrer med nye produkter, skal du oprette en ny Store i my.clerk.io og starte forfra. Domænet i sig selv er ikke den afgørende faktor.

1. Map ID’er #

Dette er det vigtigste trin. Hvis din nye platform tildeler nye produkt-ID’er, skal du beslutte, hvordan du håndterer uoverensstemmelsen mellem gamle ordrer og nye produkter.

Der er to tilgange:

Mulighed A — Bevar gamle ID’er
Konfigurer din nye platforms synkronisering til at sende de samme id-værdier, som blev brugt på den gamle platform. Mange platforme giver dig mulighed for at inkludere et legacy- eller eksternt ID-felt i datafeed’et.

Send den gamle platforms produkt-ID som id i dit Clerk.io feed eller CRUD API-kald. Din eksisterende ordrehistorik vil derved stadig matche det nye katalog korrekt.

Mulighed B — Opmærk og upload ordrer på ny
Hvis du ikke kan bevare ID’erne, skal du selv opbygge en mapping-tabel — uden for Clerk.io — der oversætter gamle produkt-ID’er til nye. Når du har denne mapping, gen-uploader du de historiske ordrer med de korrigerede ID’er.

Clerk.io udfører ikke mappings for dig. Din udvikler udarbejder et korrigeret sæt ordredatak, og du uploader det.

Bygning af mapping-tabel
Den nemmeste tilgang er at bruge produkt-SKU som bro. SKU’er forbliver næsten altid de samme ved platformsflytning, selv når interne database-ID’er ændres.

Processen ser sådan ud:

1. Eksporter alle ordrer fra den gamle platform, hvor hver ordrelinje indeholder det gamle produkt-ID og SKU.
2. Forespørg den nye platforms database for at finde hvert produkt via SKU og få det nye ID.
3. Erstat de gamle ID’er med de nye i ordredataene.

Et simpelt eksempel i pseudokode:

for order in old_orders:
    for line in order.products:
        new_id = new_platform.find_product_by_sku(line.sku).id
        line.product_id = new_id

Resultatet er en korrigeret ordreliste, hvor alle produktreferencer bruger den nye platforms ID’er.

Upload af de korrigerede ordrer
Når mappingen er færdig, uploader du de korrigerede ordrer til Clerk.io. Der er to måder at gøre det på:

Via CRUD API:

POST https://api.clerk.io/v2/order/add

{
  "key": "your_public_api_key",
  "orders": [
    {
      "id": 5001,
      "products": [901, 902],
      "time": 1622548800,
      "email": "luke@skywalker.com"
    }
  ]
}

Eller via et JSON data feed, der indeholder hele den korrigerede ordrer-array. Importeren vil behandle det ved næste synkronisering. Dette er ofte det nemmeste for store mængder af historiske ordrer.

Uanset metode er 901 og 902 den nye platforms produkt-ID’er — ikke de gamle.

2. Skift synkronisering #

Når din ID-strategi er på plads, skal du opdatere synkroniseringsmetoden i Clerk.io, så den peger til den nye platform.

1. Gå til Data > Configuration i my.clerk.io.
2. Skift Sync method til din nye platforms integration eller feed-URL.
3. Verificer Import-toggles — sørg for, at Products, Categories og Orders alle er aktiverede.
4. Opdater din IP-allowlist, hvis din nye platform har en anden server-IP.
5. Klik på Start New Data Sync og overvåg synkroniseringsloggen.

Når synkroniseringen er færdig, verificer i Data > Health at produktantal og ordrevolumen ser korrekte ud.

Hvis din nye platform understøtter det, så konfigurer realtime-opdateringer via platformens udvidelse eller CRUD API — så nye produkter og ordrer sendes til Clerk.io, når de opstår, ikke kun under næste planlagte synkronisering.

3. Opdater Designs #

Designs refererer til produktattributter med syntaksen {{ product.attribute_name }}. Hvis din nye platform bruger andre attributnavne, vil disse referencer bryde eller blive tomme.

For eksempel kan et Magento 2-setup synkronisere en brugerdefineret attribut kaldet {{ product.manufacturer }}, mens Shopify sender de samme data som {{ product.vendor }}. Alle designs, der bruger det gamle navn, skal opdateres.

Sådan finder du berørte designs:
Brug søgefeltet på Designs siden. Søg efter det gamle attributnavn — søgningen scanner indhold i HTML og CSS for alle designs, så du kan finde alle designs, der refererer til det.

Opdatering af referencen:
Åbn hvert berørte design og erstat det gamle attributnavn med det nye.

Brug af Modifiers i stedet:
Hvis du vil undgå at redigere mange designs, kan du bruge Modifiers til at oprette en stabil attribut i Clerk.io, der mapper fra det navn den nye platform sender.

For eksempel kan du oprette en modifier, der kopierer vendor-attributten ind i en ny attribut kaldet manufacturer. Dine eksisterende designs fungerer så videre uden ændringer:

Create new attribute: manufacturer
Value: {vendor}

Dette er den mest sikre metode for komplekse opsætninger med mange designs.

4. Ordrekontinuitet #

Clerk.io gemmer ordrer uafhængigt af produktkataloget. Loggede ordrer slettes aldrig, selvom produkter fjernes fra en sync eller et feed — de forbliver som historiske poster og fortsætter med at påvirke AI’en.

Når du skifter platform, betyder det:

• Ordrer logget under gamle produkt-ID’er forbliver i Store.
• Nye ordrer logges under nye produkt-ID’er og begynder at akkumulere.
• Indtil der findes nok nye ordrer, kan du opleve nedsat personaliseringskvalitet for logikker som Visitor Recommendations og Best Cross-Sell Products.

For at accelerere dette, genimporter dine historiske ordrer med de nye produkt-ID’er (se Trin 1, Mulighed B). Dette giver AI’en det fulde billede fra dag ét, i stedet for at starte på bar bund.

Hvis du har store ordrer-mængder, så prioriter de seneste 12–24 måneders ordrer. Nyere købsadfærd vejer tungere for AI’en end ældre data.

5. Verificér Tracking #

Efter du er gået live på den nye platform, skal du bekræfte at salgstracking fungerer end to end.

Tjek følgende:

1. log/sale-kaldet affyres på ordrebekræftelsessiden med de nye produkt-ID’er.
2. Ordrer vises i Data > Orders med produkt-ID’er, der matcher det nye katalog.
3. Data > Health viser grønt for Sales tracking og Clerk sales.

Hvis tracking ikke virker, vil click-to-purchase attribution ikke fungere og rapportering af omsætningspåvirkning vil være ufuldstændig. Sales Tracking guide gennemgår, hvordan du sætter dette op og fejlsøger det.

Eksempelgennemgang #

Sådan ser en migration fra Magento 2 til Shopify ud fra ende til anden.

Før migration (Magento 2):

• Produkter synkroniseret med Magento entity-ID’er (fx id: 4521)
• Designs bruger {{ product.manufacturer }} til brand
• Ordrer trackes via Magento-udvidelsen

Trin 1 — ID-mapping:
Eksportér alle historiske ordrer fra Magento med produkt-ID og SKU. Forespørg Shopify for at finde hvert produkt via SKU og få det nye Shopify-ID. Erstat de gamle ID’er i ordredataene, og upload derefter de korrigerede ordrer til Clerk.io via CRUD API eller et JSON-feed.

Trin 2 — Skift synkronisering:
I Data > Configuration, skift synkroniseringsmetoden fra Magento 2 integrationen til Shopify integrationen. Kør en fuld sync.

Trin 3 — Fix designs:
Søg i designs efter manufacturer. Enten udskift med {{ product.vendor }} (Shopifys felt), eller tilføj en Modifier, der mapper vendor → manufacturer for at bevare designs.

Trin 4 — Verificér:
Afgiv en testordre i den nye Shopify shop. Bekræft, at den vises i Data > Orders med de rigtige Shopify produkt-ID’er. Tjek Data > Health for grønne indikatorer.

Hele processen tager typisk et par timer for simple migrationer og en dag eller to for store kataloger, hvor historisk ordre-mapping er nødvendig.