Wie Yuphora die Standorterkennung in Next.js ohne Berechtigungsanfragen umsetzte

Die von APPDOOK herausgegebene Nachrichtenplattform Yuphora hat detailliert beschrieben, wie sie lokalisierte Inhaltsausgaben in 13 Ländern bereitstellt, ohne die Nutzer nach expliziten Geolocation-Berechtigungen im Browser zu fragen. Durch die Verlagerung der Auswahllogik in die Next.js-Middleware bestimmt die Plattform den Standort eines Lesers vor dem Rendern einer Seite und verlässt sich dabei vollständig auf bestehende Anfragedaten.

Eine gestaffelte Fallback-Reihenfolge

Um eine Ausgabe ohne Standortabfragen auszuwählen, wertet die Proxy-Schicht von Yuphora vier kontextbezogene Hinweise nacheinander aus. Wenn ein Nutzer zuvor manuell eine Ausgabe ausgewählt hat, besitzt ein gespeichertes Cookie die höchste Priorität, um VPN-Nutzer oder explizite Präferenzen zu berücksichtigen. Existiert kein Cookie, prüft die Middleware vom Host bereitgestellte Netzwerk-Geo-Header, die aus der IP-Adresse des Nutzers abgeleitet werden. Fehlen Geo-Header, nutzt sie die IANA-Zeitzone des Geräts als Ausweichlösung. Sollten alle Signale fehlschlagen, fällt das System standardmäßig auf die US-Ausgabe zurück.

Validierung von Headern und Filterung von Zeitzonen

Das Team stieß bei der Implementierung dieser Kette auf mehrere Sonderfälle. Host-Netzwerk-Header enthalten nicht immer gültige ISO-Ländercodes; Dienste wie Cloudflare verwenden nicht standardisierte Kennungen wie XX für unbekannte Herkünfte oder numerische Codes für Tor-Datenverkehr. Die Middleware entfernt diese, indem sie Ländercodes gegen ein zweistelliges Großbuchstaben-Format validiert.

Auch Zeitzonen brachten Herausforderungen bezüglich der Genauigkeit mit sich. Während Zonen wie Asia/Kolkata oder Australia/Perth eindeutig bestimmten Ländern oder Städten zugeordnet werden können, überschreiten viele Zeitzonen mehrere Landesgrenzen. Yuphora hat mehrdeutige länderübergreifende Zonen vollständig aus seiner Nachschlagetabelle gestrichen und zieht es vor, auf die Standardausgabe zurückzugreifen, anstatt eine ungenaue regionale Vermutung anzuzeigen.

Header-Sicherheit und Cache-Erhaltung

Um zu verhindern, dass Clients Standortattribute fälschen, löscht die Next.js-Middleware alle eingehenden lokalen Anfrage-Header, bevor sie ihre eigenen verifizierten Werte wie x-user-country für nachgelagerte Seitenziele schreibt. Zudem werden Stadt- und Regionenattribute nur dann übergeben, wenn die angeforderte Ausgabe mit dem erkannten Land des Lesers übereinstimmt.

Um eine hohe Leistung auf CDN- und Proxy-Caching-Schichten wie Nginx oder Cloudflare aufrechtzuerhalten, vermeidet Yuphora das Setzen von Standort-Cookies auf statischen Artikelseiten. Da das Setzen von HTTP-Cookies Edge-Caches daran hindert, Inhalte für Suchdatenverkehr zu speichern, bricht die Middleware bei Pfaden unter /news/ frühzeitig ab und verzögert die Cookie-Erstellung, bis ein Leser eine ausgabeabhängige Seite aufruft.

KI-generierte redaktionelle Illustration; kein Dokumentarfoto.

Quelle: Local news without a location prompt: how we pick a reader's edition in Next.js