ユーザー エージェントの情報量削減のサポート終了トライアルでは、サイトで UA 文字列の削減後も完全なユーザー エージェント文字列を引き続き受け取ることができました。トライアルは 2023 年 9 月 23 日に終了しました。
Chrome 101 以降、ユーザー エージェント(UA)文字列で取得できる情報は、段階的なアプローチにより削減されます。削減されたユーザー エージェント文字列の使用から移行し、ユーザー エージェント クライアント ヒントへの移行を行う時間がまだないサイトでは、サポート終了トライアルに参加してユーザー エージェント文字列全体を引き続き受け取ることができます。
非推奨トライアルへの登録は Chrome 100 ベータ版から開始されます。これにより、サイトは Chrome 101 リリースに先立って完全なユーザー エージェント文字列を受信できます。マイナー バージョンの文字列は削減されます。Stable チャンネルでリリースする前に Chrome 100 Beta のオリジン トライアルをテストする場合は、Chrome 100 のリリース日(現在は 2022 年 3 月 31 日を予定)より前に登録してテストしてください。
以下に、非推奨トライアルの概要と今後の見通しを示します。フィードバックがある場合や、このトライアル中に問題が発生した場合は、UA Reduction GitHub リポジトリからお知らせください。
ウェブ デベロッパーへの影響
サポート終了トライアルに登録すると、サイトは引き続き navigator.userAgent
で完全な UA 文字列を受け取り、関連する navigator.platform
と navigator.appVersion
の JavaScript ゲッターで短縮されていない値を引き続き受け取ります。
User-Agent
HTTP リクエスト ヘッダーnavigator.userAgent
JavaScript ゲッターnavigator.platform
JavaScript ゲッターnavigator.appVersion
JavaScript ゲッター
サイトでは、User-Agent ヘッダーと関連 API の使用状況を引き続き監査する必要があります。また、必要に応じて、非推奨トライアル期間が終了する前に User-Agent Client Hints に移行する準備をしてください。User-Agent Reduction のロールアウトが完了すると、この非推奨トライアルが期限切れになります。
User-Agent Reduction のサポート終了トライアルに参加するにはどうすればよいですか?
トライアルに登録する
オリジン トライアルに登録してドメインのトークンを取得するには、ユーザー エージェント削減の非推奨トライアルのページにアクセスしてください。サードパーティの登録の場合は、[サードパーティの一致] チェックボックスをオンにしてください。
設定
トライアルに登録したら、HTTP レスポンス ヘッダーを次のように更新します。
- HTTP レスポンス ヘッダーに
Origin-Trial: <ORIGIN TRIAL TOKEN>
を追加します。<ORIGIN TRIAL TOKEN
> には、オリジン トライアルの登録時に取得したトークンが含まれます。 - HTTP レスポンス ヘッダーに
Accept-CH: Sec-CH-UA-Full
を追加します。Accept-CH
を設定すると、オリジンへの後続のリクエストでのみ、完全なユーザー エージェント文字列が送信されます。 - 最初のリクエストで完全なユーザー エージェント文字列が重要な場合は、HTTP レスポンス ヘッダーに
Accept-CH
ヘッダーとOrigin-Trial
ヘッダーに加えてCritical-CH: Sec-CH-UA-Full
を追加します。 データ削減の非推奨トライアルに参加する参加者には、すべてのサードパーティ ドメインに完全なユーザー エージェント文字列へのアクセスを許可することを推奨します。サードパーティ ドメインによる完全なユーザー エージェント文字列へのアクセスを拡張しない場合、独自の削減非推奨トライアルへの登録の有無にかかわらず、ユーザー エージェント文字列の完全なアクセスがブロックされます。ユーザー エージェント文字列によるサードパーティ ドメインへの完全なアクセスを許可するには、次の 2 つの方法があります。
- 完全なユーザー エージェント文字列を受け取るサードパーティのドメインを含む
Permissions-Policy
ヘッダーを追加します。- すべてのサードパーティのドメインを許可するには、
Permissions-Policy: ch-ua-full=*
を追加します。 - サードパーティ ドメインの名前付きリストを許可するには、
Permissions-Policy: ch-ua-full=(self "https://thirdparty.example.com")
を追加します。
- すべてのサードパーティのドメインを許可するには、
- 完全なユーザー エージェント文字列を受け取るサードパーティのドメインを含む
Accept-CH
メタタグを追加します(Chrome 100 以降のみ)。- サードパーティ ドメインの名前付きリストを許可するには、
<meta http-equiv="delegate-ch" value="sec-ch-ua-full https://thirdparty.example.com">
を追加します。 - メタタグの
*
を使用してすべてのサードパーティ ドメインに委任することはできません。
- サードパーティ ドメインの名前付きリストを許可するには、
- 完全なユーザー エージェント文字列を受け取るサードパーティのドメインを含む
Chrome 100 以降でウェブサイトを読み込み、引き続き完全なユーザー エージェント文字列を受信します。
デモ
トライアルのデモ(ソースコードと合わせて)については、https://uard-ot-demo.glitch.me をご覧ください。
トライアルが機能していることを確認するには、どうすればよいですか?
オリジン トライアルが機能していることを検証するには、リクエスト ヘッダーを調べて、次のことを確認します。
- User-Agent ヘッダーには完全版が含まれています。削減された値(削減されたユーザー エージェント文字列のサンプルのリストにあるもの)を含めることはできません。Chrome のマイナー バージョンの文字列を
0.0.0
にしないで、簡単に見分けることができます。 Sec-CH-UA-Full
ヘッダーが?1
に設定されている。
オリジン トライアル トークンを含む初期レスポンスのヘッダーは次のようになります。
![](https://developers.google.cn/static/privacy-sandbox/assets/images/blog/AIlPxFBDvO7jQrXuKfWU.png?authuser=6&hl=ja)
完全なユーザー エージェント文字列を含む後続のリクエスト ヘッダーは次のようになります。
![](https://developers.google.cn/static/privacy-sandbox/assets/images/blog/Hzi5O1mZQyZEKeokCQSe.png?authuser=6&hl=ja)
User-Agent Reduction のサポート終了トライアルへの参加を停止するにはどうすればよいですか?
試用期間中はいつでも、参加を中止して、短縮されたユーザー エージェント文字列を受け取ることができます。参加を停止するには:
- HTTP レスポンスで、
Sec-CH-UA-Full
を含まないAccept-CH
ヘッダーを送信します。サイトが他の Client Hints をリクエストしない場合は、空の値を持つAccept-CH
が有効な方法です。 - HTTP レスポンスから User-Agent Reduction の非推奨トライアルの
Origin-Trial
ヘッダーを削除します。 - 設定されている場合は、HTTP レスポンスの
Critical-CH
ヘッダーからSec-CH-UA-Full
を削除します。
このトライアルは、他のユーザー エージェントのオリジン トライアルとどう違うのですか?
Chrome では、ユーザー エージェントの情報量削減に関連するオリジン トライアルを 2 回実施しています。1 つ目は、User Agent Reduction オリジン トライアルです。サイトでは、削減されたユーザー エージェント文字列を受け取って、ユースケースをテストし、Chrome でデフォルトの動作になる前にフィードバックを提供することができました。
2 つ目は、サポート終了トライアルで、User-Agent Client Hints API への移行にもう少し時間がかかるサイトを対象としています。これにより、サイトで引き続き完全なユーザー エージェント文字列を受信できます。
非推奨トライアルはいつまで有効ですか?
User-Agent Reduction の非推奨トライアルは Chrome 100 から Chrome 115 で実施されます。Chrome 116 は、完全に削減されたユーザー エージェント文字列のみが送信される最初のリリースになります。
User-Agent Reduction のサポート終了トライアルに関するフィードバックを共有するにはどうすればよいですか?
問題やフィードバックがある場合は、User-Agent Reduction GitHub リポジトリに送信してください。