Słownik

User Agent Client Hints: co wysyłają i co widzi analityka

Taras Shynkarenko
Taras Shynkarenko
•Zaktualizowano: •10 min czytania
User Agent Client Hints: co wysyłają i co widzi analitykaUser Agent Client Hints: co wysyłają i co widzi analityka

W skrócie

10 min czytania

User-Agent Client Hints to następca pełnego ciągu User-Agent w Chromium. Każde żądanie zawiera trzy nagłówki o niskiej entropii: Sec-CH-UA, Sec-CH-UA-Mobile i Sec-CH-UA-Platform, z marką przeglądarki, wersją główną, flagą urządzenia mobilnego i nazwą systemu. Serwer prosi o więcej, na przykład o wersję systemu lub model urządzenia, nagłówkiem odpowiedzi Accept-CH, a skrypt może wywołać navigator.userAgentData.getHighEntropyValues(). Od Chrome 110 sam ciąg UA jest zamrożony na stałych wartościach platformy. Firefox i Safari nie obsługują client hints.

Czym są User Agent Client Hints?

Przeglądarki oparte na Chromium wysyłają User Agent Client Hints jako zestaw nagłówków żądania Sec-CH-UA, które przekazują dane o przeglądarce i platformie w osobnych polach, a szczegółowe pola wysyłają tylko na prośbę serwera. Dokumentacja Chrome dla programistów opisuje ten model jako taki, "where the server must ask the browser for a set of data about the client (the hints) and the browser applies its own policies or user configuration to determine what data is returned." Client hints są domyślnie włączone od Chrome 89.

Dawny nagłówek User-Agent upychał wszystko w jednym ciągu przy każdym żądaniu: przeglądarkę, pełną wersję, system operacyjny z wersją, a na Androidzie także model urządzenia. Artykuł Google o tej zmianie podaje, że takie połączenie "could contain enough information to allow individual users to be uniquely identified." Client hints dzielą te dane, dzięki czemu domyślne żądanie zawiera mniej, a o wszystko ponadto trzeba poprosić w sposób widoczny dla przeglądarki.

Jeśli prowadzisz analitykę witryny, ma to znaczenie dla dwóch raportów: podziału według przeglądarki i systemu oraz typu urządzenia. Oba nadal działają w Chrome, ale część szczegółów, które dawniej przychodziły same, wymaga teraz osobnej prośby.

Jedno żądanie przed zmianą i po niej
Dawny nagłówek User-Agent
  • Przeglądarka i pełna wersja
  • System operacyjny i wersja
  • Model urządzenia na Androidzie
  • Wszystko przy każdym żądaniu
Domyślne żądanie Chrome
  • Marka przeglądarki i wersja główna
  • Flaga urządzenia mobilnego
  • Nazwa systemu
  • Reszta czeka, aż poprosi o nią serwer
Domyślne żądanie zawiera mniej, a o dodatkowe szczegóły trzeba poprosić w sposób widoczny dla przeglądarki.

Które nagłówki Sec-CH-UA wysyła Chrome?

Chrome wysyła trzy nagłówki Sec-CH-UA przy każdym żądaniu HTTPS, a pozostałe wstrzymuje, dopóki serwer o nie nie poprosi. Specyfikacja WICG definiuje jedenaście nagłówków. Te ważne dla analityki to:

NagłówekPrzykładowa wartośćEntropiaWysyłany domyślnie?
Sec-CH-UA"Chromium";v="93", "Google Chrome";v="93"NiskaTak
Sec-CH-UA-Mobile?0 na komputerze, ?1 na urządzeniu mobilnymNiskaTak
Sec-CH-UA-Platform"macOS"NiskaTak
Sec-CH-UA-Platform-Version"10.0.0"WysokaNie, wymaga Accept-CH
Sec-CH-UA-Full-Version-List"Google Chrome";v="98.0.4738.0"WysokaNie, wymaga Accept-CH
Sec-CH-UA-Model"Pixel 3"WysokaNie, wymaga Accept-CH
Sec-CH-UA-Arch"arm"WysokaNie, wymaga Accept-CH
Sec-CH-UA-Bitness"64"WysokaNie, wymaga Accept-CH

Specyfikacja definiuje też Sec-CH-UA-WoW64, Sec-CH-UA-Form-Factors i przestarzały Sec-CH-UA-Full-Version. Client hints są przesyłane tylko przez bezpieczne połączenia, więc strona serwowana przez zwykłe HTTP nie dostaje żadnego z nich.

Lista marek zawiera celowe dziwactwo. Znajduje się na niej fałszywa marka, na przykład " Not;A Brand";v="99", którą dokumentacja Chrome nazywa GREASE i która może wystąpić na dowolnej pozycji i pod dowolną nazwą. MDN wyjaśnia, że ma ona powstrzymać serwery przed "rejecting unknown user agents outright." Każdy parser musi ignorować nierozpoznane marki, zamiast polegać na pozycji.

Czym różnią się wskazówki o niskiej i wysokiej entropii?

Wskazówki o niskiej entropii to pola, które przeglądarka wysyła do każdej witryny, bo ujawniają niewiele ponad to, co pokazują inne nagłówki. Wskazówki o wysokiej entropii to pola, które zawężają przeglądarkę na tyle, że pomagają ją zidentyfikować. Specyfikacja WICG podaje, że domyślne wskazówki ujawniają "only the user agent's branding information, and the significant version number", a oba te elementy są "fairly clearly sniffable" z innych nagłówków i z funkcji obsługiwanych przez przeglądarkę.

Określenie „wysoka entropia” pochodzi z teorii informacji. Dokumentacja Chrome opisuje je jako odniesienie do "the amount of information that these values reveal about the user's browser." Nazwa modelu, taka jak Pixel 3, albo dokładny numer kompilacji, taki jak 98.0.4738.0, dzieli populację użytkowników Chrome na znacznie mniejsze grupy niż „Chrome 98 na Androidzie”. Przewodnik po fingerprintingu przeglądarki wyjaśnia, jak takie pola sumują się po połączeniu.

Rzędy kabli sieciowych wpiętych w szafę serwerową, symbolizujące żądania i odpowiedzi przenoszące nagłówki Accept-CH między przeglądarką a serwerem.

Jak witryna prosi o wskazówki o wysokiej entropii przez Accept-CH?

Witryna prosi o wskazówki o wysokiej entropii, zwracając nagłówek odpowiedzi Accept-CH z nazwami potrzebnych wskazówek, a przeglądarka decyduje, czy wysłać je w kolejnych żądaniach do tego originu. Wymiana przebiega w czterech krokach:

  1. Przeglądarka żąda strony i wysyła tylko Sec-CH-UA, Sec-CH-UA-Mobile oraz Sec-CH-UA-Platform.
  2. Serwer odpowiada nagłówkiem, na przykład Accept-CH: Sec-CH-UA-Full-Version-List, Sec-CH-UA-Model, albo strona zawiera tę samą listę w tagu <meta http-equiv="Accept-CH">.
  3. Kolejne żądania do tego originu zawierają wskazówki, o które poproszono, jeśli pozwala na to polityka przeglądarki.
  4. Nowy nagłówek Accept-CH w całości zastępuje poprzedni zestaw, a pusty go czyści.

Trzy zasady z dokumentacji Chrome często sprawiają kłopot. Wskazówki zamówione przez Accept-CH obowiązują "for the duration of the browser session or until a different set of hints are specified." Są wysyłane tylko w żądaniach do tego samego originu, więc żądanie do cdn.example.net nie dostaje niczego, chyba że strona deleguje każdą wskazówkę nagłówkiem Permissions-Policy. Pierwsza wizyta zawiera zaś tylko wskazówki domyślne, bo serwer jeszcze o nic nie poprosił. Chromium dokumentuje osobny mechanizm dla wskazówek potrzebnych witrynie już przy pierwszym żądaniu.

Skrypty mają drugą drogę. navigator.userAgentData udostępnia wartości o niskiej entropii jako brands, mobile i platform, a navigator.userAgentData.getHighEntropyValues() zwraca obietnicę z polami takimi jak model, platformVersion i fullVersionList. Podobnie jak przy nagłówkach, Chrome zaznacza, że "it's down to the browser what values, if any, are returned."

Co zmieniło ograniczenie User-Agent w Chrome?

Ograniczenie User-Agent zamroziło większość ciągu User-Agent w Chrome na stałych wartościach, więc dawny nagłówek zawiera teraz tylko wersję główną przeglądarki, stały ciąg platformy i znacznik urządzenia mobilnego. Projekt Chromium wprowadzał tę zmianę etapami:

Wersja ChromeWydanieZmiana w ciągu UA
Chrome 10126 kwietnia 2022Numery minor, build i patch zamrożone na 0.0.0
Chrome 10725 października 2022Platforma i wersja systemu na komputerach zastąpione stałymi wartościami
Chrome 1107 lutego 2023Wersja Androida ustawiona na 10, a model urządzenia zastąpiony przez K
Chrome 1132023Koniec odwrotnego origin trial, więc każde wczytanie strony dostaje ograniczony ciąg

Stałe wartości platformy na komputerach to dosłowne ciągi. Chromium wymienia Windows NT 10.0; Win64; x64, Macintosh; Intel Mac OS X 10_15_7, X11; Linux x86_64 i X11; CrOS x86_64 14541.0.0, a każdy telefon z Androidem zgłasza Linux; Android 10; K. Chromium zaznacza, że wartości te "will not update even if a user is on an updated operating system or device." Ograniczenie dotyczy systemów Windows, macOS, Linux i ChromeOS oraz Chrome na Androida. Chromium nie ma obecnie planów dla iOS ani Android WebView.

Strona Chromium mówi wprost, dokąd trafiły dawne szczegóły: "All of the information that was contained in the User-Agent string prior to reduction is available through the high entropy client hints."

Flowsery
Flowsery

Rozpocznij 14-dniowy okres próbny

Panel w czasie rzeczywistym

Śledzenie celów

Śledzenie bez cookie

Które przeglądarki obsługują User Agent Client Hints?

Obsługują je przeglądarki oparte na Chromium, a Firefox i Safari nie. Dane o zgodności w MDN wskazują obsługę Sec-CH-UA w Chrome i Edge od wersji 89 oraz w Operze od wersji 75, a Sec-CH-UA i Accept-CH wymieniają jako nieobsługiwane w Firefoksie i Safari. navigator.userAgentData ma taki sam podział.

Analityka ma więc dwie ścieżki parsowania. W Chrome i Edge ograniczony ciąg UA oraz wskazówki o niskiej entropii dają przeglądarkę, wersję główną, nazwę systemu i flagę urządzenia mobilnego. W Firefoksie i Safari jedynym źródłem pozostaje nagłówek User-Agent, a WebKit również zamroził swój ciąg. Strona o zapobieganiu śledzeniu wymienia wśród zmian przeciw fingerprintingowi to, że WebKit "altered the user agent string to not change with minor software updates."

Kilka smartfonów ułożonych obok laptopa na biurku, co pokazuje mieszankę urządzeń i przeglądarek, które raport analityczny musi rozróżnić.

Co narzędzie analityczne nadal odczyta do raportów o przeglądarkach, systemach i urządzeniach?

Narzędzie analityczne nadal odczytuje z każdej wizyty w Chrome nazwę przeglądarki, wersję główną, rodzinę systemu i informację, czy to urządzenie mobilne, czy komputer, bez proszenia o cokolwiek. Wersja systemu i model urządzenia wymagają wskazówek o wysokiej entropii. Praktyczny podział dla odwiedzającego w Chrome:

Pole raportuZ ograniczonego ciągu UAZ domyślnych wskazówek o niskiej entropiiWymaga wskazówki o wysokiej entropii
Nazwa przeglądarkiTakTak, Sec-CH-UANie
Wersja główna przeglądarkiTakTak, Sec-CH-UANie
Pełna wersja przeglądarkiNie, pokazuje .0.0.0NieSec-CH-UA-Full-Version-List
Nazwa systemuTakTak, Sec-CH-UA-PlatformNie
Wersja systemuNie, stała wartośćNieSec-CH-UA-Platform-Version
Urządzenie mobilne lub komputerTak, token MobileTak, Sec-CH-UA-MobileNie
Model telefonuNie, pokazuje KNieSec-CH-UA-Model

Każdy odwiedzający z Windows 11 w Chrome zgłasza w ciągu UA Windows NT 10.0, więc podział na Windows 10 i 11 oparty na tym ciągu jest błędny. Wszystkie wizyty z Chrome na Androidzie deklarują wersję 10. Jeśli wykres wersji systemu w twojej analityce pokazuje, że między końcem 2022 a połową 2023 jedna wersja przejęła całość, to efekt ograniczenia, a nie zmiana odbiorców. Trudniejsze staje się też wykrywanie botów, bo automatyczny klient kopiuje aktualny ciąg Chrome jednym wierszem kodu. Przewodnik po filtrowaniu ruchu botów omawia kontrole, które nie opierają się wyłącznie na UA.

Czy User Agent Client Hints ograniczają fingerprinting?

User Agent Client Hints ograniczają pasywny fingerprinting, bo witryna nie dostaje już przy każdym żądaniu pełnej wersji, wersji systemu i modelu urządzenia, ale nie powstrzymają skryptu, który celowo prosi o wartości o wysokiej entropii. Specyfikacja WICG mówi o obu stronach: celem jest "reduce the amount of default entropy exposed to the web at large", a jednak "it will still be possible for some, or all, hints to be requested and used for active fingerprinting purposes."

Różnica polega na widoczności. Prośba o Sec-CH-UA-Model pojawia się w nagłówku Accept-CH witryny lub w wywołaniu getHighEntropyValues(), co mogą wykryć narzędzia ochrony prywatności i audytorzy. Dawny ciąg przekazywał te same dane po cichu. Dla właściciela witryny zasada jest prosta: proś o wskazówkę o wysokiej entropii tylko wtedy, gdy potrzebuje jej konkretna funkcja, na przykład wybór właściwego pliku do pobrania dla architektury procesora, a nie w celu wzbogacania profili analitycznych.

Co Flowsery raportuje o przeglądarkach i urządzeniach?

Flowsery raportuje w analityce dane o urządzeniach, przeglądarkach i systemach bez fingerprintingu przeglądarki, bez plików cookie w trybie cookieless i bez przechowywania danych osobowych. API Flowsery zwraca podział według przeglądarek z liczbą odwiedzających i przychodami na przeglądarkę, filtruje według nazw takich jak Chrome, Safari, Firefox i Edge, przy czym „Safari automatycznie obejmuje Mobile Safari”, i grupuje odwiedzających według wymiarów obejmujących browser_version oraz os_version. Punkt końcowy odwiedzającego zwraca typ urządzenia, przeglądarkę, system i wymiary obszaru widoku z ostatniej odsłony. W trybie bez plików cookie Flowsery używa codziennie zmienianego hasha odwiedzającego, więc te pola opisują sesje w twojej witrynie bez budowania wielodniowego profilu urządzenia, co jest jednym z powodów, dla których unikalni odwiedzający znaczą w różnych narzędziach co innego. Na stronie funkcji analityki stawiającej na prywatność znajdziesz listę tego, co zbiera skrypt śledzący.

Najczęściej zadawane pytania

Czy User Agent Client Hints zastępują nagłówek User-Agent?

Nie, Chrome nadal wysyła nagłówek User-Agent, ale w ograniczonej formie, z zamrożoną wersją poboczną i stałymi wartościami platformy. Usunięte z niego szczegóły są dostępne przez client hints o wysokiej entropii, o które witryna musi poprosić.

Czy Firefox wysyła nagłówki Sec-CH-UA?

Nie. Dane o zgodności w MDN wymieniają Sec-CH-UA i Accept-CH jako nieobsługiwane w Firefoksie i Safari. Te przeglądarki nadal opisują się wyłącznie przez nagłówek User-Agent.

Dlaczego analityka pokazuje wszystkich użytkowników Androida na Androidzie 10?

Chrome 110 ustawił wersję Androida w ciągu UA na 10, a model urządzenia zastąpił przez K. Każde narzędzie analizujące tylko ciąg UA zgłasza Androida 10 dla każdej wizyty z Chrome na Androidzie. Prawdziwa wersja wymaga wskazówki Sec-CH-UA-Platform-Version.

Czy analityka odróżni Windows 11 od Windows 10 w Chrome?

Nie na podstawie ciągu UA, który dla obu podaje Windows NT 10.0. Witryna, która poprosi o Sec-CH-UA-Platform-Version przez Accept-CH lub wywoła getHighEntropyValues(), otrzyma wersję platformy, którą Chrome zdecyduje się udostępnić.

Czy client hints wymagają HTTPS?

Tak. Chrome wysyła client hints tylko przez bezpieczne połączenia, więc witryna na zwykłym HTTP nie otrzymuje żadnych nagłówków Sec-CH-UA.

Czy client hints o wysokiej entropii to dane osobowe?

Sam model urządzenia lub numer kompilacji systemu nie wskazuje konkretnej osoby. Połączone z innymi sygnałami w stabilny identyfikator stają się jednak częścią odcisku, a odcisk wyróżniający urządzenie jest w świetle RODO daną osobową, dlatego analityka stawiająca na prywatność go nie buduje.

Czym jest fałszywa marka w nagłówku Sec-CH-UA?

To wpis GREASE, na przykład " Not;A Brand";v="99", który może wystąpić na dowolnej pozycji i pod dowolną nazwą. Ma powstrzymać serwery przed odrzucaniem nieznanych klientów. Parser powinien ignorować nierozpoznane marki, zamiast polegać na pozycji.

Flowsery
Flowsery

Rozpocznij 14-dniowy okres próbny

Panel w czasie rzeczywistym

Śledzenie celów

Śledzenie bez cookie

Jak uzyskać w analityce pełną wersję Chrome lub model urządzenia?

Zwróć nagłówek Accept-CH z nazwami potrzebnych wskazówek, takich jak Sec-CH-UA-Full-Version-List i Sec-CH-UA-Model. Skrypt może też wywołać navigator.userAgentData.getHighEntropyValues(). W obu przypadkach to przeglądarka decyduje, co i czy w ogóle zwróci.

Czy client hints trafiają do żądań do innych domen?

Wskazówki zamówione przez Accept-CH są wysyłane tylko w żądaniach do tego samego originu. Żądanie do cdn.example.net nie dostaje niczego, chyba że strona deleguje każdą wskazówkę nagłówkiem Permissions-Policy.

Czy Chrome wysyła wskazówki o wysokiej entropii przy pierwszej wizycie?

Pierwsza wizyta zawiera tylko trzy wskazówki domyślne, bo serwer nie poprosił jeszcze o więcej. Gdy serwer wyśle Accept-CH, kolejne żądania zawierają zamówione wskazówki przez czas sesji przeglądarki lub do określenia innego zestawu. Chromium dokumentuje osobny mechanizm dla wskazówek potrzebnych witrynie już przy pierwszym żądaniu.

Czy ten artykuł był pomocny?

Chętnie poznamy opinię!

Częściej widoczni w Google

Jedno kliknięcie ustawia Flowsery jako preferowane źródło, dzięki czemu nasze artykuły pojawiają się wyżej w Najważniejszych artykułach, trybie AI i Przeglądach od AI.

Jeszcze jedno...

Flowsery

Flowsery

Analityka witryny skupiona na przychodach

Każdy odwiedzający, źródło i konwersja w czasie rzeczywistym. Prosto, skutecznie i bez plików cookie.

Panel w czasie rzeczywistym

Śledzenie celów

Śledzenie bez cookie

Powiązane hasła ze słownika

Co się stało z wycofywaniem plików cookie stron trzecich w ChromeCo się stało z wycofywaniem plików cookie stron trzecich w Chrome
Słownik

Co się stało z wycofywaniem plików cookie stron trzecich w Chrome

Wycofywanie plików cookie stron trzecich w Chrome: od planu z 2020 r. do odwrotu w 2025 r. Wszystkie ogłoszenia Google, stan obecny i ich znaczenie.

•9 min czytania
Co naprawdę psują SameSite Lax, Strict i NoneCo naprawdę psują SameSite Lax, Strict i None
Słownik

Co naprawdę psują SameSite Lax, Strict i None

SameSite Lax, Strict i None na podstawie tekstu RFC i udokumentowanego domyślnego zachowania Chrome'a, z wymogiem Secure i skutkami każdego trybu.

•9 min czytania
Dlaczego współczynnik odrzuceń w GA4 to odwrócony współczynnik zaangażowaniaDlaczego współczynnik odrzuceń w GA4 to odwrócony współczynnik zaangażowania
Słownik

Dlaczego współczynnik odrzuceń w GA4 to odwrócony współczynnik zaangażowania

Współczynnik odrzuceń w GA4 to odsetek sesji bez zaangażowania. Sprawdź, jak definiuje go Google, czym różni się od Universal Analytics i gdzie go dodać.

•8 min czytania
Co liczy raport stron docelowych w GA4 i gdzie pojawiają się puste wierszeCo liczy raport stron docelowych w GA4 i gdzie pojawiają się puste wiersze
Słownik

Co liczy raport stron docelowych w GA4 i gdzie pojawiają się puste wiersze

Raport stron docelowych w GA4 pokazuje pierwszą stronę każdej sesji. Gdzie go znaleźć, jakie ma domyślne wskaźniki, skąd (not set) i jak dodać źródło.

•8 min czytania
Jak GA4 rejestruje to, co odwiedzający wpisują w wyszukiwarkę witrynyJak GA4 rejestruje to, co odwiedzający wpisują w wyszukiwarkę witryny
Słownik

Jak GA4 rejestruje to, co odwiedzający wpisują w wyszukiwarkę witryny

Skonfiguruj wyszukiwanie w witrynie w GA4 przez pomiar zaawansowany, dodaj własne parametry zapytań, znajdź wymiar Search term i śledź wyszukiwania bez adresu URL.

•8 min czytania
Jak ustawiać właściwości użytkownika w GA4 i raportować o nichJak ustawiać właściwości użytkownika w GA4 i raportować o nich
Słownik

Jak ustawiać właściwości użytkownika w GA4 i raportować o nich

Ustaw właściwości użytkownika w GA4 przez gtag lub Tag Manager, zarejestruj je jako wymiary niestandardowe o zakresie użytkownika i zmieść się w limicie 25.

•9 min czytania

Powiązane artykuły