Auf die Reduzierung des User-Agents in Chrome vorbereiten

bookmark_border Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Chrome reduziert weiterhin die im User-Agent-String weitergegebenen Informationen, um die Privatsphäre der Nutzer zu schützen.

Ab Chrome 110 (Februar 2023) führen wir nach und nach einen festen Wert für die Android-Version und das Gerätemodell ein. Der Standardwert ist immer Android 10 für ein Modell K. Wenn Sie die Betriebssystemversion, das Android-Gerätemodell oder die detaillierte Browserversion eines Besuchers anhand des User-Agents ermitteln, müssen Sie möglicherweise Maßnahmen ergreifen. Weitere Informationen finden Sie weiter unten.

Der User-Agent ist ein String, der Informationen zum Browser und zur Umgebung des Nutzers enthält. So können Sie beispielsweise feststellen, dass ein Besucher Ihrer Website Chrome-Version 110 auf Android verwendet. Ihr Browser sendet diese Informationen in einem HTTP-Header und stellt sie über JavaScript zur Verfügung.

Das Problem mit dem vollständigen User-Agent-String besteht darin, dass standardmäßig bei jeder Anfrage detaillierte Informationen zum Browser weitergegeben werden. Dies ist ein wichtiger Faktor für websiteübergreifendes Tracking. Unser Ziel ist es, die Möglichkeiten zur passiven Erhebung dieser Daten zu reduzieren und gleichzeitig APIs bereitzustellen, mit denen Sie bei Bedarf aktiv auf Daten zugreifen können.

Bisherige Reduzierung des User-Agents

Wir haben bereits damit begonnen, einige der standardmäßig verfügbaren User-Agent-Daten zu entfernen und durch feste Werte zu ersetzen.

Ab Chrome 101 haben wir die Minor-Versionsnummer durch Nullen ersetzt, z.B. Chrome/101.3.2.1 in Chrome/101.0.0.0.

Ab Chrome 107 haben wir die Version des Desktopbetriebssystems und die CPU-Informationen durch einen festen Wert für die Plattform ersetzt.

Korrektur der Android-Version und des Gerätemodells ab Chrome 110

Ab Chrome 110 führen wir nach und nach einen festen Wert für die Android-Version und das Gerätemodell ein. Statt Android 13 für Pixel 7 wird in einem Modell K immer Android 10 angezeigt.

Keine Änderung am User-Agent-Format

Durch die User-Agent-Reduzierung ändern sich die Werte, die im User-Agent zurückgegeben werden, das Format bleibt jedoch gleich. Wenn Sie den User-Agent nur zum Lesen des Betriebssystemtyps oder der Hauptversion des Browsers verwenden, werden diese Daten wie gewohnt aktualisiert und Sie müssen nichts unternehmen.

Alternativen zum User-Agent

Wenn Sie derzeit die detaillierteren Daten verwenden, sollten Sie immer prüfen, ob Sie stattdessen progressive Verbesserung oder Funktionserkennung verwenden können.

Denken Sie immer daran, dass der User-Agent wie jeder andere vom Nutzer bereitgestellte Wert ist. Sie sollten ihn prüfen und nicht davon ausgehen, dass er korrekt ist. Der User-Agent-Wert kann vom Nutzer, von Erweiterungen oder anderen Clients leicht geändert werden oder einfach gar nicht gesendet werden. In den meisten Fällen sollten Sie ohne User-Agent-Daten funktionierende Inhalte für Besucher bereitstellen können.

Detaillierte Daten mit User-Agent-Client-Hints anfordern

Es gibt viele triftige Gründe, auf detaillierte User-Agent-Daten zuzugreifen, z. B. die Bereitstellung gerätespezifischer Inhalte, Funktionen zur Betrugsprävention oder detaillierte Protokollierung. Wenn Sie die detaillierteren Daten benötigen, können Sie über die User-Agent Client Hints API (UA-CH) darauf zugreifen. Wie der User-Agent ist UA-CH über HTTP-Header oder JavaScript verfügbar.

Möglicherweise haben Sie bereits die Standard-Header mit dem Präfix Sec-CH-UA- gesehen, die den Browser, seine Hauptversion, das Betriebssystem und ob der Browser auf einem Mobilgerät ausgeführt wird, angeben.

⏫ Standard-User-Agent-Client-Hints-Anfrageheader aus Chrome:

Sec-CH-UA: "Chromium";v="110", "Not A(Brand";v="24", "Google Chrome";v="110"
Sec-CH-UA-Mobile: ?1
Sec-CH-UA-Platform: "Android"

Sie können den Accept-CH-Header in Ihrer Antwort verwenden, um weitere Daten anzufordern. In diesem Fall können Sie Sec-CH-UA-Platform-Version und Sec-CH-UA-Model anfordern, um diese Android-Version und diesen Gerätetyp in nachfolgenden Anfragen wiederzuerhalten.

⏬ Antwortheader von Ihrem Server mit Angabe der Plattformversion und des Modells:

Accept-CH:
  Sec-CH-UA-Platform-Version,
  Sec-CH-UA-Model

⏫ Header von Chrome anfordern, einschließlich Android-Version und Modellname:

Sec-CH-UA-Platform-Version: "13.0.0"
Sec-CH-UA-Model: "Pixel 7"

Das Gleiche ist auch in JavaScript möglich. Rufen Sie dazu getHighEntropyValues() in der userAgentData API auf und geben Sie ein Array mit den gewünschten Werten an: platformVersion und model. Dies gibt ein Versprechen mit einem Objekt zurück, das die entsprechenden Werte enthält.

navigator.userAgentData
 .getHighEntropyValues(
   ['platformVersion', 'model']
 ).then(ua => { console.log(ua)
 });

{
  "platformVersion": "13.0.0",
  "model": "Pixel 7"
}

Ursprungsübergreifende oder anfängliche Anfragen

Wenn Sie Ressourcen mit unterschiedlichen Ursprung auf Ihrer Seite haben, für die diese Werte erforderlich sind, können Sie den Zugriff über den Permissions-Policy-HTTP-Header oder das Delegate-CH-Meta-Tag in Ihrem HTML-Code zulassen.

Wenn für Ihre Website diese sensiblen Werte bereits in der allerersten Anfrage auf oberster Ebene erforderlich sind, können Sie den Critical-CH-HTTP-Header verwenden. Dadurch wird der Browser aufgefordert, die ursprüngliche Anfrage mit diesen zusätzlichen Hinweisen noch einmal zu versuchen. Das kann für ältere Systeme hilfreich sein, die nur schwer zu aktualisieren sind. Idealerweise sollten Sie diese sensiblen Werte jedoch nicht zum Ausliefern Ihrer ursprünglichen HTML-Seite verwenden.

Weitere Informationen

Hier sehen Sie den reduzierten User-Agent-String in Aktion:

• Den reduzierten User-Agent-String für Ihr Gerät finden Sie unter goo.gle/reduced-ua-demo.
• Alle JavaScript- und HTTP-Header-User-Agent-Client-Hinweise für Ihr Gerät finden Sie unter goo.gle/ua-ch-demo.
• Aktivieren Sie die #reduce-user-agent Chrome-Flag, um den reduzierten User-Agent-String in Ihrem Browser zu senden.

Sie können sich auch noch für den Ursprungstest zur Verringerung des User-Agents registrieren, um den reduzierten User-Agent auf Ihrer Website zu erhalten. Wir werden diesen Test jedoch Anfang März beenden, da wir den Versand des reduzierten User-Agents standardmäßig weiter ausweiten.

Weitere Ressourcen finden Sie auf der Landingpage zur Reduzierung des User-Agents. Außerdem können Sie Probleme in unserem speziellen GitHub-Repository zur Reduzierung des User-Agents melden.