Shopify-URLs ohne SEO-Verlust zu einer Headless-Storefront migrieren

Warum Shopify-URL-Migrationen brechen

Wenn Sie von Shopify Liquid zu einer Headless-Storefront mit Next.js, Hydrogen oder einem eigenen Stack wechseln, ist das visuelle Redesign selten der gefährliche Teil. Das Risiko liegt in der URL-Schicht.

Shopify erzwingt ein starres Schema:

• /products/{handle}
• /collections/{handle}
• /pages/{handle}

Ein Headless-Build führt oft kürzere oder flexiblere Routen ein:

• /shop/{handle}
• /c/{handle}
• /{handle}

Das kann für die neue Storefront gut sein. Es ist am Launch-Tag schlecht, wenn alte Shopify-URLs noch in Google, E-Mails, bezahlten Anzeigen, Affiliate-Links, QR-Codes, Partnerseiten und Kunden-Lesezeichen auftauchen.

Das Migrationsrisiko

Ohne Redirect-Map erzeugt eine Headless-Migration meist drei Probleme:

1. 404-Fehler: Googlebot und echte Käufer landen auf Produkt-, Kollektions- und Content-URLs, die nicht mehr existieren.
2. Verlorene Ranking-Signale: Backlinks, interne Links und alte Suchergebnisse zeigen nicht mehr sauber auf das beste neue Ziel.
3. Kampagnenbrüche: E-Mail, Paid Social, Influencer- und Affiliate-Links bringen Käufer nicht mehr zuverlässig zum richtigen Produkt oder zur richtigen Kategorie.

[!WARNING] Warten Sie nicht bis zum DNS-Cutover, um Redirects zu bauen. Die Redirect-Map sollte vor Produktions-Traffic fertig, importiert und im Staging gecrawlt sein.

Schritt 1: Alte Shopify-URLs exportieren

Bevor Sie Redirect-Regeln schreiben, exportieren Sie die URLs, die bereits Traffic erhalten. Beginnen Sie mit Shopify und ergänzen Sie die Liste anschließend mit SEO- und Analytics-Daten.

Methode A: Shopify Admin

Gehen Sie zu Products > Export und wählen Sie „All products“. Sie erhalten eine CSV mit einer Handle-Spalte.

Handle,Title,Variant Price
cool-tshirt,Cool T-Shirt,29.99
blue-jeans,Blue Jeans,49.99

Methode B: Sitemap-Parsing

Für eine breitere Liste mit Produkten, Collections, Seiten und Blogposts parsen Sie die Shopify-sitemap.xml.

# Sitemap-Parser installieren
npm install -g sitemap-to-csv
 
# Abrufen und konvertieren
sitemap-to-csv https://store.example/sitemap.xml > urls.csv

Methode C: Search- und Analytics-Exporte

Shopify kennt nicht jede URL, die wichtig ist. Exportieren Sie hochwertige URLs aus:

• Google-Search-Console-Seiten mit Impressionen und Klicks
• Google Analytics oder Warehouse-Reports zu Landingpages
• Paid-Media-URLs mit aktiven UTM-Parametern
• Affiliate- und Partnerlinks
• Kunden-E-Mails und Lifecycle-Kampagnen

Diese URLs sollten in der Redirect-Map als hohe Priorität markiert werden.

Schritt 2: Redirect-Map entwerfen

Sie brauchen nicht immer eine 1:1-Regel für jede URL. Pattern-Regeln können vorhersehbare Shopify-Strukturen abdecken, während Einzelregeln ausgelaufene Produkte, zusammengelegte Kategorien und hochwertige Ausnahmen behandeln.

Szenario A: Einfacher Prefix-Wechsel

• Alt: https://shop.example/products/blue-jeans
• Neu: https://shop.example/shop/blue-jeans

UrlEdge-Regel:

• Source: ^/products/(.*)$
• Destination: /shop/$1
• Type: 301 (Permanent)

Szenario B: Prefixe entfernen

• Alt: https://shop.example/products/blue-jeans
• Neu: https://shop.example/blue-jeans

UrlEdge-Regel:

• Source: ^/products/(.*)$
• Destination: /$1

[!TIP] Seien Sie bei Produkt-URLs auf Root-Ebene vorsichtig. Stellen Sie sicher, dass Ihr neuer Router nicht mit /about, /contact, /cart oder Collection-Slugs kollidiert.

Szenario C: Kampagnenparameter bewahren

Kampagnenlinks überleben oft monatelang in E-Mails, SMS, Creator-Posts und bezahlten Anzeigen.

https://shop.example/products/blue-jeans?utm_source=newsletter&utm_campaign=spring

sollte hier landen:

https://shop.example/shop/blue-jeans?utm_source=newsletter&utm_campaign=spring

Wenn der Redirect Query-Parameter versehentlich entfernt, kann die Migration in Crawl-Tools erfolgreich aussehen, während die Kampagnenattribution leise bricht.

Schritt 3: Redirects am Edge umsetzen

Sie können Redirects in der Headless-App verarbeiten, aber dann hängt das Migrationsrouting an Frontend-Deployments. Bei großen Redirect-Maps ist es meist sauberer, Redirects in einer dedizierten Edge-Schicht zu halten.

Das Latenzproblem

Wenn Sie Redirects in next.config.js oder Middleware behandeln, muss die Anfrage zuerst Ihren Origin-Server (Vercel/Node.js) erreichen, eine Compute-Instanz starten, die Regel auswerten und dann antworten.

Konfiguration

Mit UrlEdge können Sie Ihre CSV-Zuordnung importieren oder Regex-Regeln direkt definieren.

{
  "rules": [
    {
      "source": "^/products/(.*)",
      "destination": "/shop/$1",
      "type": 301
    },
    {
      "source": "^/pages/contact-us",
      "destination": "/contact",
      "type": 301
    }
  ]
}

Schritt 4: Verifizieren

Bevor Sie DNS umstellen, testen Sie das alte URL-Inventar gegen die neue Redirect-Schicht.

1. Staging-Domain: Zeigen Sie einen Staging-Hostnamen auf UrlEdge und testen Sie zuerst hochwertige URLs.
2. Curl-Test:

curl -I https://staging.shop.example/products/old-product
 
# Erwartete Ausgabe:
# HTTP/2 301 
# location: /shop/old-product
# x-urledge-rule: regex-product-match

3. Crawl-Test: Nutzen Sie Screaming Frog oder ein ähnliches Tool, um die alte URL-Liste gegen die Staging-Umgebung zu testen.
4. Kampagnentest: Prüfen Sie mindestens einige URLs mit utm_source, utm_medium, utm_campaign, Coupon-Parametern und Affiliate-Parametern.
5. Ausnahmen prüfen: Stellen Sie sicher, dass ausgelaufene Produkte auf die beste Collection, ein Ersatzprodukt oder eine Support-Seite weiterleiten statt standardmäßig auf die Homepage.

Fazit

Eine Headless-Shopify-Migration braucht zwei Launches: die neue Storefront und die Redirect-Schicht, die alten Traffic am Leben hält. Behandeln Sie die Redirect-Map als Launch-Infrastruktur, nicht als Aufräumarbeit.

Redirect-Logik am Edge hilft Ihrem Team:

• große Redirect-Maps aus dem Frontend-Code herauszuhalten;
• Regeln vor dem DNS-Cutover zu validieren;
• Produkt-, Collection- und Kampagnenpfade zu bewahren;
• Ausnahmen zu aktualisieren, ohne die Storefront neu zu deployen.

Bereit, die Redirect-Map zu planen? Starten Sie Ihren kostenlosen UrlEdge-Account und importieren Sie den ersten Batch vor dem Launch-Tag.