Okres próbny wycofywania redukcji klienta użytkownika

bookmark_border Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

W ramach testu wycofywania funkcji Redukcja klienta użytkownika witryny mogły nadal otrzymywać pełny ciąg znaków klienta użytkownika po usunięciu z niego ciągu znaków UA. Okres próbny zakończył się 23 września 2023 r.

Począwszy od Chrome 101 informacje dostępne w ciągu User-Agent (UA) będą zmniejszane w określonych etapach. Strony, które nie zdążyły przejść z użycia uproszczonego ciągu znaków klienta użytkownika na wskazówki dotyczące klienta użytkownika, mogą wziąć udział w próbnym wycofaniu, aby nadal otrzymywać pełny ciąg znaków klienta użytkownika.

Rejestracja w wersji próbnej przed wycofaniem rozpocznie się od Chrome 100 w wersji beta. Pozwoli to witrynom otrzymywać pełny ciąg znaków User-Agent przed wydaniem Chrome 101, w którym ciąg znaków wersji podrzędnej zostanie skrócony. Jeśli chcesz przetestować wersję próbną origin w Chrome 100 Beta, zanim zostanie ona udostępniona na kanale stabilnym, zarejestruj się i przetestuj ją przed datą wydania Chrome 100 (obecnie zaplanowaną na 31 marca 2022 r.).

Poniżej znajdziesz omówienie okresu testowego wycofywania i informacje o tym, czego możesz się spodziewać. Jeśli chcesz podzielić się opinią lub napotkasz jakieś problemy podczas testów, daj nam znać w repozytorium GitHub UA Reduction.

Co to oznacza dla programistów stron internetowych?

Po zarejestrowaniu się w programie testowania wycofania witryny będą nadal otrzymywać pełny ciąg znaków UA w pliku navigator.userAgent oraz nieprzetworzone wartości w powiązanych funkcjach JavaScripta navigator.platform i navigator.appVersion:

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

Strony powinny nadal sprawdzać, jak używają nagłówka User-Agent i powiązanych interfejsów API, oraz w razie potrzeby przygotować się do przejścia na wskazówki klienta User-Agent przed wygaśnięciem okresu próbnego. Zamierzamy zakończyć okres przejściowy po wdrożeniu funkcji Redukcja ciągu znaków User-Agent.

Jak wziąć udział w testach wycofania funkcji Redukcja klienta użytkownika?

Rejestracja w wersji próbnej

Aby zarejestrować się w testach wersji próbnej origin i uzyskać token dla swoich domen, odwiedź stronę testów wersji próbnej redukcji klienta użytkownika. Jeśli rejestrujesz się jako firma zewnętrzna, zaznacz pole „Dopasowywanie przez firmę zewnętrzną”.

Konfiguracja

Po zarejestrowaniu się w programie próbnym zaktualizuj nagłówki odpowiedzi HTTP, dodając te informacje:

1. Dodaj Origin-Trial: <ORIGIN TRIAL TOKEN> do nagłówka odpowiedzi HTTP. <ORIGIN TRIAL TOKEN> zawiera token uzyskany podczas rejestracji w wersji próbnej.
2. Dodaj Accept-CH: Sec-CH-UA-Full do nagłówka odpowiedzi HTTP. Ustawienie Accept-CH spowoduje wysłanie pełnego ciągu User-Agent tylko w przypadku kolejnych żądań wysyłanych do źródła.
3. Jeśli pełny ciąg znaków klienta użytkownika jest niezbędny w pierwszym żądaniu, 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 biorącym udział w testach wycofywania redukcji zalecamy zezwolenie wszystkim domenom innych firm na dostęp do pełnego ciągu tekstowego klienta użytkownika. Nierozszerzenie dostępu do pełnego ciągu klienta użytkownika do domen innych firm spowoduje zablokowanie pełnego ciągu klienta użytkownika niezależnie od tego, czy domeny innych firm zarejestrowały się w ramach testów w okresie przejściowym. Możesz zezwolić na pełny dostęp do ciągu znaków klienta użytkownika w domenach innych firm, 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 klienta użytkownika.
     • Aby zezwolić na wszystkie domeny zewnętrzne, dodaj Permissions-Policy: ch-ua-full=*.
     • Aby zezwolić na nazwaną listę domen innych firm, dodaj Permissions-Policy: ch-ua-full=(self "https://thirdparty.example.com").
   • Dodaj metatag Accept-CH z domenami innych firm, które powinny otrzymywać pełny ciąg tekstowy klienta użytkownika (tylko w Chrome 100 i nowszych wersjach).
     • Aby zezwolić na nazwaną listę domen innych firm, dodaj <meta http-equiv="delegate-ch" value="sec-ch-ua-full https://thirdparty.example.com">.
     • Nie można delegować wszystkich domen zewnętrznych za pomocą tagu meta *.

5. Otwórz witrynę w Chrome 100 (lub nowszej) i nadal otrzymuj pełny ciąg znaków User-Agent.

Prezentacja

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

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

Aby sprawdzić, czy próbna wersja pochodzenia działa, sprawdź nagłówki żądania i upewnij się, że:

1. Nagłówek User-Agent zawiera pełną wersję. Nie może zawierać żadnych wartości skróconych (znajdujących się na liście przykładów skróconych ciągów tekstowych User-Agent). Łatwo to sprawdzić, ponieważ ciąg znaków odpowiadający wersji podrzędnej Chrome nie powinien zawierać 0.0.0.
2. Nagłówek Sec-CH-UA-Full ma wartość ?1.

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

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

Jak zrezygnować z udziału w programie testowym wycofania funkcji Redukcja klienta użytkownika?

W dowolnym momencie okresu próbnego możesz zrezygnować z usługi i otrzymać skrócony ciąg znaków User-Agent. Aby zrezygnować z udziału:

1. W odpowiedzi HTTP wyślij nagłówek Accept-CH, który nie zawiera Sec-CH-UA-Full. Pamiętaj, że jeśli Twoja witryna nie wysyła żadnych innych Wskazówek klienta, możesz użyć wartości pustej w polu Accept-CH.
2. Usuń z odpowiedzi HTTP nagłówek Origin-Trial, który jest używany w ramach wycofywania z użycia nagłówka User-Agent.
3. Jeśli jest ustawiony, 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 dotyczących pochodzenia użytkownika?

Chrome przeprowadza 2 testy origin dotyczące redukcji klienta użytkownika. Pierwszym było testowanie origin w ramach redukcji klienta użytkownika, które pozwoliło witrynom na otrzymywanie skróconego ciągu tekstowego klienta użytkownika w celu przetestowania przypadków użycia i przesłania opinii, zanim stało się to domyślnym zachowaniem w Chrome.

Druga, o której mowa w tym artykule, to okres przejściowy przeznaczony dla witryn, które potrzebują więcej czasu na przejście na interfejs API User-Agent Client Hints. Dzięki temu witryny będą nadal otrzymywać pełny ciąg znaków klienta użytkownika.

Jak długo będzie trwał okres próbny przed wycofaniem?

Okres próbny wycofywania redukcji klienta użytkownika będzie trwał od wersji 100 do 115 Chrome. Chrome 116 będzie pierwszą wersją, w której wysyłany będzie tylko całkowicie zredukowany ciąg znaków User-Agent.

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

Przesyłaj wszelkie problemy lub opinie do repozytorium GitHub Redukcja klienta użytkownika.