Okres próbny wycofywania redukcji klienta użytkownika

Wersja próbna redukcji klienta użytkownika umożliwia witrynom dalsze otrzymywanie pełnego ciągu znaków User-Agent po ograniczeniu ciągu UA. Okres próbny zakończył się 23 września 2023 r.

Od wersji Chrome 101 informacje dostępne w ciągu znaków User-Agent (UA) będą ograniczone stopniowo. Witryny, które nie zdążyły zrezygnować z używania skróconego ciągu znaków User-Agent i przejść na wskazówki dla klienta użytkownika, mogą wziąć udział w okresie próbnym wycofywania, aby nadal otrzymywać pełny ciąg znaków klienta użytkownika.

Rejestracja na okres próbny wycofywania rozpocznie się w wersji beta Chrome 100. Dzięki temu witryny będą mogły otrzymywać pełny ciąg znaków klienta użytkownika przed Chrome 101, co spowoduje zmniejszenie ciągu wersji podrzędnej. Jeśli chcesz przetestować wersję próbną Chrome 100 Beta, zanim zostanie ona udostępniona w wersji stabilnej, zarejestruj się i przetestuj ją przed datą wydania wersji 100 (zaplanowanej na 31 marca 2022 r.).

Poniżej znajdziesz omówienie okresu próbnego wycofywania i tego, czego możesz się spodziewać. Jeśli chcesz podzielić się z nami swoją opinią lub napotkasz jakieś problemy podczas tego okresu próbnego, daj nam znać w repozytorium redukcji UA na GitHubie.

Co to oznacza dla programistów stron internetowych?

Jeśli zarejestrujesz się w okresie próbnym wycofywania, witryny nadal będą otrzymywać pełny ciąg znaków UA w navigator.userAgent i niezmniejszone wartości w odpowiednich żądaniach JavaScript navigator.platform i navigator.appVersion:

  • Nagłówek żądania HTTP User-Agent
  • Metoda pobierania JavaScriptu navigator.userAgent
  • Metoda pobierania JavaScriptu navigator.platform
  • Metoda pobierania JavaScriptu navigator.appVersion

Witryny nadal powinny sprawdzać użycie nagłówka User-Agent i powiązanych z nim interfejsów API, a także w razie potrzeby przygotować się do migracji do funkcji User-Agent Client Hints przed zakończeniem okresu próbnego. Okres próbny wycofywania ma się zakończyć po zakończeniu wdrażania redukcji klienta użytkownika.

Jak wziąć udział w okresie próbnym wycofania redukcji klienta użytkownika?

Zarejestruj się, aby skorzystać z okresu próbnego

Aby zarejestrować się w wersji próbnej origin i uzyskać token dla swoich domen, odwiedź stronę próbnej wycofania redukcji klienta użytkownika. Jeśli korzystasz z rozmowy przez firmę zewnętrzną, zaznacz pole „Dopasowanie przez inną firmę”.

Konfiguracja

Gdy zarejestrujesz się na okres próbny, zaktualizuj nagłówki odpowiedzi HTTP, podając te wartości:

  1. Dodaj Origin-Trial: <ORIGIN TRIAL TOKEN> do nagłówka odpowiedzi HTTP. <ORIGIN TRIAL TOKEN> zawiera token uzyskany podczas rejestracji w wersji próbnej origin.
  2. Dodaj Accept-CH: Sec-CH-UA-Full do nagłówka odpowiedzi HTTP. Ustawienie Accept-CH spowoduje, że pełny ciąg znaków klienta użytkownika będzie wysyłany tylko w kolejnych żądaniach do źródła.
  3. Jeśli pełny ciąg znaków klienta użytkownika przy pierwszym żądaniu ma kluczowe znaczenie, dodaj do nagłówka odpowiedzi HTTP nagłówek Critical-CH: Sec-CH-UA-Full oprócz nagłówków Accept-CH i Origin-Trial.

  4. Uczestnikom, którzy dołączają do okresu próbnego wycofywania redukcji, zalecamy zezwolenie wszystkim domenom zewnętrznym na dostęp do pełnego ciągu znaków User-Agent. Jeśli nie przedłużysz dostępu domen innych firm do pełnego ciągu znaków User-Agent, dostęp do ciągu znaków User-Agent zostanie dla nich zablokowany niezależnie od tego, jaka była rejestracja w okresie próbnym wycofania redukcji. Możesz zezwolić na pełny dostęp ciągu znaków User-Agent do domen zewnętrznych, korzystając z jednej z tych 2 opcji:

    • Dodaj nagłówek Permissions-Policy z domenami innych firm, które powinny otrzymywać pełny ciąg znaków User-Agent.
      • Aby zezwolić na wszystkie domeny innych firm, dodaj Permissions-Policy: ch-ua-full=*.
      • Aby zezwolić na nazwaną listę domen zewnętrznych, dodaj Permissions-Policy: ch-ua-full=(self "https://thirdparty.example.com").
    • Dodaj metatag Accept-CH z domenami innych firm, które powinny otrzymać pełny ciąg klienta użytkownika (tylko w Chrome 100 i nowszych).
      • Aby zezwolić na nazwaną listę domen zewnętrznych, dodaj <meta http-equiv="delegate-ch" value="sec-ch-ua-full https://thirdparty.example.com">.
      • Przekazywanie dostępu do wszystkich domen zewnętrznych za pomocą tagu * w metatagu nie jest możliwe.

  5. Załaduj witrynę w Chrome 100 (lub nowszej) i nadal odbieraj pełny ciąg znaków klienta użytkownika.

Wersja demonstracyjna

Na stronie https://uard-ot-demo.glitch.me znajdziesz prezentację wersji próbnej (wraz z kodem źródłowym).

Jak sprawdzić, czy okres próbny działa?

Aby upewnić się, że wersja próbna origin działa, sprawdź nagłówki żądań i upewnij się, że:

  1. Nagłówek User-Agent zawiera pełną wersję. Nie powinien zawierać żadnych zredukowanych wartości (znajdziesz je na liście próbek zredukowanych ciągów znaków klienta użytkownika). Można łatwo stwierdzić, że ciąg znaków wersji podrzędnej w Chrome nie powinien mieć wartości 0.0.0.
  2. Nagłówek Sec-CH-UA-Full jest ustawiony na ?1.

Nagłówki odpowiedzi początkowej zawierające token próbny origin powinny wyglądać tak:

Kolejne nagłówki żądań zawierające pełny ciąg klienta użytkownika powinny wyglądać tak:

Jak przestać uczestniczyć w okresie próbnym wycofania redukcji klienta użytkownika?

W dowolnym momencie okresu próbnego możesz przestać korzystać z usługi i otrzymać zmniejszony ciąg znaków klienta użytkownika. Aby przestać brać udział w programie:

  1. Wyślij w odpowiedzi HTTP nagłówek Accept-CH, który nie zawiera nagłówka Sec-CH-UA-Full. Pamiętaj, że pole Accept-CH z pustą wartością to prawidłowy sposób wykonania tego zadania, jeśli Twoja witryna nie żąda żadnych innych wskazówek klienta.
  2. Usuń z odpowiedzi HTTP nagłówek Origin-Trial na potrzeby próby wycofania redukcji klienta użytkownika.
  3. Jeśli jest ustawione, usuń Sec-CH-UA-Full z nagłówka Critical-CH w odpowiedzi HTTP.

Czym ta wersja próbna różni się od innych wersji próbnych origin klienta użytkownika?

W Chrome są przeprowadzane 2 testy origin związane z redukcją klienta użytkownika. Pierwszym z nich był test origin redukcji klienta użytkownika, który pozwalał witrynom otrzymywać zredukowany ciąg znaków klienta użytkownika na potrzeby testowania przypadków użycia i przekazywania opinii, zanim stanie się to domyślnym działaniem w Chrome.

Druga, wspomniana tu funkcja, to okres próbny wycofywania przeznaczony dla witryn, których przejście na interfejs User-Agent Client Hints API wymaga trochę więcej czasu. Dzięki temu witryny mogą nadal otrzymywać pełny ciąg znaków klienta użytkownika.

Ile będzie trwał okres próbny wycofywania?

Okres próbny wycofywania klienta użytkownika będzie realizowany w Chrome 100 i Chrome 115. Chrome 116 będzie pierwszą wersją, w której wysyłany będzie tylko całkowicie ograniczony ciąg znaków klienta użytkownika.

Jak przesłać opinię na temat okresu próbnego amortyzacji klienta użytkownika?

Jeśli napotkasz problemy lub prześlesz opinię, prześlij opinię do repozytorium redukcji klienta użytkownika na GitHubie.