Migrare URL Shopify a uno storefront headless senza perdere SEO

Perché le migrazioni URL Shopify si rompono

Quando passi da Shopify Liquid a uno storefront headless costruito con Next.js, Hydrogen o uno stack personalizzato, il redesign visivo raramente è la parte più rischiosa. Il rischio vero è il livello URL.

Shopify impone una struttura riconoscibile:

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

Uno storefront headless spesso introduce route più corte o più flessibili:

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

Questo può migliorare la nuova esperienza. Diventa però un problema il giorno del lancio se le vecchie URL Shopify sono ancora presenti in Google, email, campagne paid, link affiliati, QR code, pagine partner e preferiti dei clienti.

Il rischio di migrazione

Senza una mappa redirect, una migrazione headless crea quasi sempre tre problemi:

1. Errori 404: Googlebot e clienti reali arrivano su prodotti, collezioni e contenuti che non esistono più.
2. Perdita di segnali SEO: backlink, link interni e risultati già indicizzati non puntano più alla migliore destinazione nuova.
3. Rottura delle campagne: email, social paid, creator e affiliate portano traffico su pagine sbagliate o senza parametri.

[!WARNING] Non aspettare il cutover DNS per costruire i redirect. La mappa deve essere pronta, importata e scansionata in staging prima che lo storefront riceva traffico production.

1. Esporta le URL Shopify legacy

Prima di scrivere regole, esporta le URL che ricevono già traffico. Parti da Shopify, poi arricchisci l'elenco con dati SEO e analytics.

Metodo A: Shopify Admin

Vai su Products > Export e scegli "All products". Il CSV contiene una colonna Handle.

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

Da lì puoi ricostruire pattern come /products/cool-tshirt.

Metodo B: Sitemap

Per includere prodotti, collezioni, pagine e articoli, analizza il sitemap.xml Shopify.

# Installa un parser sitemap
npm install -g sitemap-to-csv
 
# Scarica e converti
sitemap-to-csv https://store.example/sitemap.xml > urls.csv

Metodo C: Search Console e analytics

Shopify non conosce tutte le URL che contano. Esporta anche:

• pagine con impression e clic da Google Search Console
• landing page da GA4 o data warehouse
• URL paid media con parametri UTM attivi
• link affiliati e partner
• email lifecycle e campagne vecchie

Queste URL vanno marcate come prioritarie nella mappa redirect.

2. Disegna la mappa redirect

Non serve sempre una regola uno-a-uno per ogni URL. Le regole a pattern gestiscono strutture Shopify prevedibili; le eccezioni coprono prodotti dismessi, categorie unite e pagine ad alto valore.

Scenario A: cambio prefisso semplice

• Vecchio: https://shop.example/products/blue-jeans
• Nuovo: https://shop.example/shop/blue-jeans

Regola UrlEdge:

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

Scenario B: rimuovere prefissi

• Vecchio: https://shop.example/products/blue-jeans
• Nuovo: https://shop.example/blue-jeans

Regola UrlEdge:

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

[!TIP] Fai attenzione alle URL prodotto alla root. Verifica che il nuovo router non entri in conflitto con /about, /contact, /cart o slug di collezione.

Scenario C: preservare parametri campagna

Molti link campagna restano vivi per mesi in email, SMS, post creator e annunci.

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

dovrebbe arrivare a:

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

Se il redirect elimina le query, la migrazione può sembrare riuscita nei crawler ma rompere l'attribuzione delle campagne.

3. Implementa i redirect all'edge

Puoi gestire i redirect dentro l'app headless, ma così le regole di migrazione diventano dipendenti dai deploy frontend. Per mappe grandi è più pulito tenerle in un layer edge dedicato.

Il problema della latenza

Se gestisci i redirect in next.config.js o Middleware, la richiesta deve arrivare al server origin, attivare compute, trovare la regola e rispondere.

Configurazione

Con UrlEdge puoi importare una mappa CSV o definire regole regex.

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

4. Verifica prima del cutover

Prima di cambiare DNS, testa l'inventario delle vecchie URL contro la nuova infrastruttura di redirect.

1. Dominio staging: punta un host controllato a UrlEdge e testa prima le URL ad alto valore.
2. Curl test:

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

3. Crawl test: usa Screaming Frog o un crawler simile per testare la lista legacy in staging.
4. Campaign test: prova URL con utm_source, utm_medium, utm_campaign, coupon e parametri affiliati.
5. Review eccezioni: i prodotti fuori catalogo dovrebbero andare alla migliore collezione, prodotto sostitutivo o pagina supporto, non alla homepage di default.

Ordine operativo consigliato

Per una migrazione Shopify verso headless, un ordine pragmatico è:

1. esporta prodotti, collezioni, pagine e post
2. unisci Search Console, analytics e campagne
3. definisci pattern comuni e eccezioni
4. importa la mappa redirect
5. testa in staging
6. correggi catene e 404
7. cambia DNS
8. monitora 404, redirect e conversioni per almeno 14 giorni

Questo ordine tiene SEO, engineering e marketing dentro la stessa fonte di verità.

Conclusione

Una migrazione Shopify headless ha due lanci: il nuovo storefront e l'infrastruttura di redirect che mantiene vivo il traffico vecchio. Tratta la mappa redirect come infrastruttura di lancio, non come pulizia post-release.

Spostare la logica all'edge ti permette di:

• tenere grandi mappe redirect fuori dal codice frontend
• validare le regole prima del cutover DNS
• preservare path di prodotto, collezione e campagna
• aggiornare eccezioni senza redeploy dello storefront

Pronto a pianificare la mappa? Crea un account UrlEdge gratuito e importa il primo batch prima del giorno di lancio.