Migrer les URL Shopify vers une vitrine headless sans perte SEO

Pourquoi les migrations d'URL Shopify cassent

Lorsque vous passez de Shopify Liquid à une vitrine headless construite avec Next.js, Hydrogen ou un stack personnalisé, le redesign visuel est rarement la partie dangereuse. Le risque se situe dans la couche URL.

Shopify applique une structure rigide :

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

Un build headless introduit souvent des routes plus courtes ou plus flexibles :

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

C'est utile pour la nouvelle vitrine. C'est risqué au lancement si les anciennes URL Shopify apparaissent encore dans Google, emails, publicités payantes, liens d'affiliation, QR codes, pages partenaires et favoris clients.

Le risque de migration

Sans carte de redirection, une migration headless crée généralement trois problèmes :

1. Erreurs 404 : Googlebot et les vrais acheteurs atteignent des URL produit, collection et contenu qui n'existent plus.
2. Signaux de classement perdus : backlinks, liens internes et anciens résultats de recherche ne pointent plus proprement vers la meilleure nouvelle destination.
3. Campagnes cassées : email, paid social, influenceurs et liens d'affiliation n'amènent plus les acheteurs vers le bon produit ou la bonne catégorie.

[!WARNING] N'attendez pas le cutover DNS pour construire les redirections. La carte de redirection doit être prête, importée et crawlée en staging avant que la nouvelle vitrine reçoive du trafic de production.

Étape 1 : Exporter vos anciennes URL Shopify

Avant d'écrire des règles de redirection, exportez les URL qui reçoivent déjà du trafic. Commencez par Shopify, puis enrichissez la liste avec les données SEO et analytics.

Méthode A : Administrateur Shopify

Allez sur Products > Export et choisissez "Tous les produits". Cela vous donne un CSV avec une colonne Handle.

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

Méthode B : analyse du sitemap

Pour une liste plus large incluant produits, collections, pages et articles de blog, analysez le sitemap.xml Shopify.

# Installer un parser de sitemap
npm install -g sitemap-to-csv
 
# Récupérer et convertir
sitemap-to-csv https://store.example/sitemap.xml > urls.csv

Méthode C : exports Search et Analytics

Shopify ne connaît pas toutes les URL importantes. Exportez les URL à forte valeur depuis :

• les pages Google Search Console avec impressions et clics
• Google Analytics ou les rapports warehouse de landing pages
• les URLs paid media avec paramètres UTM actifs
• les liens d'affiliation et partenaires
• les emails clients et campagnes lifecycle

Ces URL doivent être marquées comme prioritaires dans la carte de redirection.

Étape 2 : Concevoir la carte de redirection

Vous n'avez pas toujours besoin d'une règle 1:1 pour chaque URL. Les règles par pattern peuvent gérer les structures Shopify prévisibles, tandis que des règles ponctuelles couvrent les produits arrêtés, catégories fusionnées et exceptions à forte valeur.

Scénario A : simple changement de préfixe

• Ancien : https://shop.example/products/blue-jeans
• Nouveau : https://shop.example/shop/blue-jeans

Règle UrlEdge :

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

Scénario B : suppression de préfixes

• Ancien : https://shop.example/products/blue-jeans
• Nouveau : https://shop.example/blue-jeans

Règle UrlEdge :

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

[!TIP] Soyez prudent avec les URL produit à la racine. Assurez-vous que votre nouveau routeur n'entre pas en conflit avec /about, /contact, /cart ou des slugs de collection.

Scénario C : préserver les paramètres de campagne

Les liens de campagne survivent souvent pendant des mois dans emails, SMS, posts créateurs et publicités payantes.

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

doit arriver sur :

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

Si la redirection supprime les paramètres de query par accident, votre migration peut sembler réussie dans les outils de crawl pendant que l'attribution de campagne se casse discrètement.

Étape 3 : implémenter les redirections à l'Edge

Vous pouvez gérer les redirections dans l'application headless, mais cela lie le routage de migration aux déploiements frontend. Pour de grandes cartes de redirection, il est généralement plus propre de garder les redirections dans une couche Edge dédiée.

Le problème de latence

Si vous gérez les redirections dans next.config.js ou Middleware, la requête doit atteindre votre serveur d'origine (Vercel/Node.js), lancer une instance de calcul, correspondre à la règle et répondre.

Configuration

Avec UrlEdge, vous pouvez importer votre carte CSV ou définir directement des règles d'expression régulière.

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

Étape 4 : Vérification

Avant de changer le DNS, testez l'ancien inventaire d'URL contre la nouvelle couche de redirection.

1. Domaine de staging : faites pointer un hostname de staging vers UrlEdge et testez d'abord les URL à forte valeur.
2. Test curl :

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

3. Test de crawl : utilisez Screaming Frog ou un crawler similaire pour tester l'ancienne liste d'URL contre l'environnement de staging.
4. Test campagne : vérifiez au moins quelques URL avec utm_source, utm_medium, utm_campaign, paramètres coupon et paramètres d'affiliation.
5. Revue des exceptions : assurez-vous que les produits arrêtés routent vers la meilleure collection, un produit de remplacement ou une page support plutôt que vers la home par défaut.

Conclusion

Une migration Shopify headless a besoin de deux lancements : la nouvelle vitrine et la couche de redirection qui garde l'ancien trafic vivant. Traitez la carte de redirection comme une infrastructure de lancement, pas comme du nettoyage.

Déplacer la logique de redirection à l'Edge permet à votre équipe de :

• garder les grandes cartes de redirection hors du code frontend ;
• valider les règles avant le cutover DNS ;
• préserver les chemins produit, collection et campagne ;
• mettre à jour les exceptions sans redéployer la vitrine.

Prêt à planifier la carte de redirection ? Créez votre compte UrlEdge gratuit et importez votre premier lot avant le jour du lancement.