Cos'e il Locale Routing?

Il locale routing e il meccanismo con cui uno storefront decide quale URL, lingua, valuta e variante di contenuto servire a ogni richiesta in arrivo. In uno storefront composable a rendering edge e uno dei pezzi di infrastruttura piu importanti, perche determina cio su cui ogni altro livello, dal CMS al pricing, dai pagamenti alla ricerca, deve localizzare.

Definizione

Il locale routing di norma codifica la locale nel percorso dell'URL (/de/ch/produkt), in un sottodominio (de-ch.example.com), oppure in un top-level domain con codice paese (example.ch). Al momento della richiesta, il middleware su un edge CDN o nel framework risolve la locale effettiva seguendo una catena di priorita: segmento URL esplicito, cookie persistito, header Accept-Language, Geo-IP Detection e infine un Locale Fallback configurato. La locale risolta viene poi passata come contesto ai servizi a valle tramite la Storefront API o direttamente al livello di rendering.

Perche e importante

Un locale routing mal fatto e invisibile finche non si rompe: un acquirente tedesco che finisce su una homepage in inglese per colpa di un cookie non aggiornato, oppure un visitatore svizzero bloccato in un loop di redirect tra /de/de/ e /de/ch/. Oltre alla UX, il locale routing determina la crawlability: i motori di ricerca hanno bisogno di URL stabili e deterministici per ogni locale, integrati da annotazioni Hreflang. In uno stack di Composable Commerce, il livello di routing e spesso il primo punto in cui convergono Personalization, A/B Testing ed Edge-Personalization, quindi deve essere sia rapido che spiegabile.

Casi d'uso

Un retailer che gira su un frontend Jamstack usa un middleware edge per leggere l'URL, interpretare /en/gb/checkout come { language: "en", region: "GB" }, e iniettarlo in ogni query CMS e chiamata alla Storefront API. Un marketplace con una strategia di dominio ccTLD instrada example.fr verso la locale fr-FR e usa redirect 308 per mantenere ordinati i crawler. Un brand che si espande in Belgio offre sia nl-BE che fr-BE sullo stesso dominio e usa un selettore di locale che aggiorna l'URL invece di un cookie nascosto, cosi i link restano condivisibili. Per i visitatori alla prima visita, la Geo-IP Detection puo suggerire una locale, ma il livello di routing deve poi rispettare la scelta esplicita dell'utente, per evitare la classica esperienza di rimanere "bloccati nel paese sbagliato".

Correlati

Scopri Multi-Brand and Multi-Market.