Plattformmigration

Die Übertragung Ihres Webshops von einer Plattform auf eine andere – zum Beispiel von Magento 2 zu Shopify oder von WooCommerce zu BigCommerce – umfasst mehr als nur die Neuinstallation der Clerk.io-Erweiterung.

Ihre Produkt-IDs werden sich wahrscheinlich ändern. Ihre Synchronisierungsmethode muss angepasst werden. Ihre Designs können plattformspezifische Attributnamen referenzieren. Und Ihre historischen Bestelldaten müssen übernommen werden, damit die KI ab Tag eins optimal arbeitet.

Diese Anleitung führt Sie Schritt für Schritt durch den Prozess.

Vor dem Start #

Bevor Sie irgendetwas in Clerk.io anfassen, beantworten Sie diese zwei Fragen:

Werden sich Ihre Produkt-IDs ändern? Bei den meisten Plattformwechseln erhalten Produkte neue IDs. Das ist wichtig, weil die AI von Clerk.io Produkte und Bestellungen über das Feld id verknüpft. Wenn sich die IDs ändern, beziehen sich alte Bestellungen auf IDs, die im neuen Katalog nicht mehr existieren.

Können Sie Produkt-IDs der Bestellhistorie zuordnen? Wenn Sie alte Produkt-IDs neuen zuordnen können (oder diese komplett beibehalten), können Sie Ihren bestehenden Clerk.io Store behalten – unabhängig davon, ob sich die Domain ändert. Die Bestellhistorie des Stores bleibt erhalten und die AI behält ihre erlernten Verbindungen.

Ist eine ID-Zuordnung nicht möglich und können Sie alte Bestellungen nicht mit neuen Produkten abgleichen, erstellen Sie einen neuen Store in my.clerk.io und beginnen Sie von vorn. Die Domain selbst ist nicht das entscheidende Kriterium.

1. IDs abgleichen #

Dies ist der wichtigste Schritt. Wenn Ihre neue Plattform neue Produkt-IDs vergibt, müssen Sie entscheiden, wie Sie die Diskrepanz zwischen alten Bestellungen und neuen Produkten handhaben.

Es gibt zwei Ansätze:

Option A — Alte IDs beibehalten Konfigurieren Sie die Synchronisierung Ihrer neuen Plattform so, dass sie dieselben id-Werte sendet, die auf der alten Plattform verwendet wurden. Viele Plattformen ermöglichen es, ein Legacy- oder externes ID-Feld im Datenfeed einzubinden.

Senden Sie die Produkt-ID der alten Plattform als id in Ihrem Clerk.io Feed oder bei CRUD-API-Aufrufen. Ihre bisherige Bestellhistorie wird dann weiterhin korrekt auf den neuen Katalog abgebildet.

Option B — IDs neu zuordnen und Bestellungen neu hochladen Wenn Sie die IDs nicht beibehalten können, müssen Sie eine eigene Mapping-Tabelle – außerhalb von Clerk.io – erstellen, die alte Produkt-IDs in neue übersetzt. Sobald Sie diese Zuordnung haben, laden Sie die historischen Bestellungen mit den korrigierten IDs neu hoch.

Clerk.io übernimmt die Zuordnung nicht für Sie. Ihr Entwickler erstellt einen korrigierten Satz an Bestelldaten, den Sie dann einspielen.

Die Mapping-Tabelle erstellen Der einfachste Ansatz ist, die Produkt-SKU als Brücke zu verwenden. SKUs bleiben beim Plattformwechsel fast immer gleich, auch wenn sich interne Datenbank-IDs ändern.

Das Vorgehen sieht so aus:

1. Exportieren Sie alle Bestellungen von der alten Plattform, wobei jede Bestellposition die alte Produkt-ID und die SKU enthalten soll.
2. Durchsuchen Sie die Datenbank der neuen Plattform, finden Sie jedes Produkt anhand der SKU und holen Sie dessen neue ID.
3. Ersetzen Sie in den Bestelldaten die alten IDs durch die neuen IDs.

Ein einfaches Beispiel in Pseudocode:

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

Das Ergebnis ist eine korrigierte Liste von Bestellungen, in der jede Produktreferenz die IDs der neuen Plattform verwendet.

Die korrigierten Bestellungen einspielen Nach Fertigstellung des Mappings spielen Sie die korrigierten Bestellungen in Clerk.io ein. Dafür gibt es zwei Wege:

Über die 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"
    }
  ]
}

Oder über einen JSON-Datenfeed, der das komplette Array der korrigierten Bestellungen enthält. Der Importer verarbeitet diese beim nächsten Sync. Dies ist meist die einfachere Lösung bei großen Mengen an historischen Bestellungen.

In jedem Fall sind 901 und 902 die Produkt-IDs der neuen Plattform – nicht die alten.

2. Synchronisieren neu einstellen #

Sobald Ihre ID-Strategie steht, passen Sie die Synchronisierungsmethode in Clerk.io an die neue Plattform an.

1. Gehen Sie zu Data > Configuration in my.clerk.io.
2. Ändern Sie die Synchronisierungsmethode auf die Integration oder Feed-URL der neuen Plattform.
3. Überprüfen Sie die Import-Schalter – stellen Sie sicher, dass Produkte, Kategorien und Bestellungen aktiviert sind.
4. Passen Sie Ihre IP-Whitelist an, falls Ihre neue Plattform eine andere Server-IP nutzt.
5. Klicken Sie auf Start New Data Sync und überwachen Sie das Synchronisierungsprotokoll.

Nach Abschluss der Synchronisierung vergewissern Sie sich unter Data > Health, dass die Produktanzahl und das Bestellvolumen stimmen.

Falls Ihre neue Plattform dies unterstützt, richten Sie Echtzeit-Updates ein – entweder über die Plattform-Erweiterung oder die CRUD API – sodass neue Produkte und Bestellungen sofort an Clerk.io gesendet werden und nicht nur zum nächsten geplanten Synchronisierungslauf.

3. Designs aktualisieren #

Designs referenzieren Produktattribute mit der Syntax {{ product.attribute_name }}. Falls Ihre neue Plattform andere Attributnamen verwendet, funktionieren diese Verweise nicht mehr oder bleiben leer.

Zum Beispiel kann bei Magento 2 ein benutzerdefiniertes Attribut {{ product.manufacturer }} synchronisiert werden, während Shopify dieselben Daten als {{ product.vendor }} überträgt. Jedes Design, das den alten Namen nutzt, muss angepasst werden.

Betroffene Designs finden: Verwenden Sie das Suchfeld auf der Seite Designs. Suchen Sie nach dem alten Attributnamen – die Suche durchsucht HTML und CSS aller Designs, sodass Sie jede betroffene Stelle finden.

Verweis aktualisieren: Öffnen Sie jedes betroffene Design und ersetzen Sie den alten Attributnamen durch den neuen.

Stattdessen Modifiers nutzen: Wenn Sie nicht viele Designs manuell anpassen möchten, nutzen Sie Modifiers, um in Clerk.io ein stabiles Attribut zu erstellen, das auf beliebige Bezeichner der neuen Plattform verweist.

Zum Beispiel: Erstellen Sie einen Modifier, der das Attribut vendor in ein neues Attribut mit dem Namen manufacturer kopiert. Ihre bestehenden Designs funktionieren dann weiterhin ohne Anpassungen:

Neues Attribut erstellen: manufacturer
Wert: {vendor}

Dies ist der risikoärmere Ansatz bei komplexen Setups mit vielen Designs.

4. Bestell-Kontinuität #

Clerk.io speichert Bestellungen unabhängig vom Produktkatalog. Erfasste Bestellungen werden nie gelöscht, selbst wenn Produkte aus einem Sync oder Feed entfernt werden – sie bleiben als Historie erhalten und beeinflussen die AI weiterhin.

Bei einem Plattformwechsel bedeutet das:

• Bestellungen mit alten Produkt-IDs bleiben im Store.
• Neue Bestellungen mit neuen Produkt-IDs kommen hinzu.
• Bis ausreichend viele neue Bestellungen da sind, kann die Personalisierungsqualität bei Logiken wie Visitor Recommendations und Best Cross-Sell Products abnehmen.

Um dies zu beschleunigen, importieren Sie Ihre Bestellhistorie erneut mit den neuen Produkt-IDs (siehe Schritt 1, Option B). So erhält die AI direkt zum Start ein vollständiges Bild und muss nicht bei null beginnen.

Bei hohen Bestellvolumen priorisieren Sie die letzten 12–24 Monate. Aktuelles Kaufverhalten hat für die AI mehr Gewicht als ältere Daten.

5. Tracking prüfen #

Nach dem Livegang auf der neuen Plattform stellen Sie sicher, dass das Tracking der Verkäufe durchgängig funktioniert.

Überprüfen Sie Folgendes:

1. Der log/sale-Aufruf wird auf der Bestellbestätigungsseite mit den neuen Produkt-IDs ausgeführt.
2. Die Bestellungen erscheinen unter Data > Orders mit Produkt-IDs, die dem neuen Katalog entsprechen.
3. Data > Health zeigt grün bei Sales tracking und Clerk sales.

Wenn das Tracking nicht funktioniert, klappt das Klick-zu-Kauf-Attributing nicht und die Umsatz-Zuordnung ist unvollständig. Die Sales Tracking guide beschreibt die Einrichtung und Fehlerbehebung.

Beispiel-Anleitung #

So läuft ein Umzug von Magento 2 zu Shopify ab – Schritt für Schritt.

Vor der Migration (Magento 2):

• Produkte werden mit Magento-Entity-IDs synchronisiert (z. B. id: 4521)
• Designs nutzen {{ product.manufacturer }} für die Marke
• Bestellungen werden über die Magento-Erweiterung verfolgt

Schritt 1 — ID Mapping: Exportieren Sie alle historischen Bestellungen aus Magento inklusive Produkt-IDs und SKUs. Suchen Sie in Shopify jedes Produkt über die SKU und ermitteln Sie die neue Shopify-ID. Ersetzen Sie dann die alten IDs in den Bestelldaten und spielen Sie die korrigierten Bestellungen per CRUD-API oder JSON-Feed in Clerk.io ein.

Schritt 2 — Synchronisierung wechseln: In Data > Configuration stellen Sie die Synchronisierung von der Magento 2-Integration auf die Shopify-Integration um. Führen Sie einen vollständigen Sync durch.

Schritt 3 — Designs anpassen: Suchen Sie in den Designs nach manufacturer. Ersetzen Sie diesen durch {{ product.vendor }} (das Shopify-Feld) oder erstellen Sie einen Modifier, der vendor → manufacturer abbildet, um die Designs unverändert zu lassen.

Schritt 4 — Prüfen: Legen Sie eine Testbestellung im neuen Shopify-Shop an. Überprüfen Sie in Data > Orders, ob sie mit den richtigen Shopify-Produkt-IDs erscheint. Kontrollieren Sie in Data > Health die grünen Anzeigen.

Der gesamte Vorgang dauert bei einfachen Migrationen meist nur wenige Stunden, bei umfangreichen Katalogen mit notwendigem Bestell-Re-Mapping ein bis zwei Tage.