User agent client hints

最終更新日： 2025年5月5日
  • トピック：

作成対象：

  • 開発者

概要

Web ブラウザーが web サーバーにリクエストを送信するたびに、リクエストのヘッダーにブラウザーとブラウザーが動作している環境に関する情報が含まれます。 これらのデータはすべて、ユーザーエージェント文字列と呼ばれる文字列に集計されます。

Mac OS デバイスで動作しているChrome ブラウザーからのリクエストでユーザーエージェント文字列がどのように表示されるかを次の例に示します。

NOTE
ユーザーエージェント文字列に含まれるブラウザーおよびデバイス情報の量は、長年にわたって、何度も増加および変更されています。 以下の例に、最も一般的なユーザーエージェント情報の選択を示します。
Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/105.0.0.0 Safari/537.36`
フィールド値
ソフトウェア名Chrome
ソフトウェアバージョン105
完全なソフトウェアバージョン105.0.0.0
レイアウトエンジン名AppleWebKit
レイアウトエンジンのバージョン537.36
オペレーティングシステムMAC OS X
オペレーティングシステムのバージョン10.15.7
デバイスインテル（R） Mac OS X 10_15_7

ユースケース

ユーザーエージェント文字列は、長い間、マーケティングチームや開発チームに対して、ブラウザー、オペレーティングシステム、デバイスによるサイトコンテンツの表示方法や、ユーザーによる web サイトとのやり取りに関する重要なインサイトを提供するために使用されてきました。

また、ユーザーエージェント文字列は、スパムのブロックやサイトをクロールするボットのフィルタリングなど、様々な追加の目的にも使用されます。

Adobe Experience Cloudのユーザーエージェント文字列

Adobe Experience Cloud ソリューションは、様々な方法でユーザーエージェント文字列を使用します。

  • Adobe Analyticsは、ユーザーエージェント文字列を利用して、web サイトへの訪問に使用するオペレーティングシステム、ブラウザー、デバイスに関連する追加情報を補強および派生します。
  • Adobe Audience ManagerおよびAdobe Targetは、ユーザーエージェント文字列から提供される情報に基づいて、セグメント化およびパーソナライゼーションキャンペーンの対象をエンドユーザーに限定します。

User Agent の概要クライアントヒント

近年、サイト所有者やマーケティングベンダーは、リクエストヘッダーに含まれる他の情報と共にユーザーエージェント文字列を使用して、デジタル指紋を作成しています。 これらの指紋は、ユーザーが知らないうちにユーザーを特定する手段として使用できます。

ユーザーエージェント文字列がサイト所有者に役立つという重要な目的にもかかわらず、ブラウザー開発者は、エンドユーザーに対して発生する可能性のあるプライバシーの問題を制限するために、ユーザーエージェント文字列の動作方法を変更することにしました。

彼らが開発したソリューションは、user agent client hints と呼ばれます。 Client Hints を使用すると、web サイトで必要なブラウザー、オペレーティングシステム、デバイスの情報を収集できると同時に、フィンガープリントのような秘密の追跡方法に対する保護を強化できます。

Client Hints は、web サイト所有者に、ユーザーエージェント文字列で利用できるのとほぼ同じ量の情報に、よりプライバシーが保護された方法でアクセスできます。

モダンブラウザーがユーザーを web サーバーに送信する場合、それが必要かどうかにかかわらず、すべてのリクエストでユーザーエージェント文字列全体が送信されます。 一方、Client Hints は、サーバーがクライアントについて知りたい追加情報をブラウザーに問い合わせる必要があるモデルを強制します。 このリクエストを受け取ったブラウザーは、独自のポリシーやユーザー設定を適用して、どのデータが返されるかを決定できます。 デフォルトですべてのリクエストにユーザーエージェント文字列全体を公開する代わりに、アクセスを明示的かつ監査可能な方法で管理するようになりました。

ブラウザーのサポート

User Agent client hints は、Google Chrome バージョン 89 で導入されました。

その他の Chromium ベースのブラウザーは、次のような Client Hints API をサポートしています。

  • Microsoft Edge
  • Opera
  • Brave
  • Chrome for Android
  • Opera for Android
  • Samsung Internet

カテゴリ

User Agent クライアントヒントには、次の 2 つのカテゴリがあります。

低エントロピーのクライアントヒント

低エントロピーのクライアントヒントには、ユーザーのフィンガープリントに使用できない基本情報が含まれています。 ブラウザーのブランド、プラットフォーム、要求の発信元がモバイルデバイスであるかどうかなどの情報。

Web SDK では、低エントロピーのクライアントヒントがデフォルトで有効になっており、リクエストのたびに渡されます。

HTTP ヘッダーJavaScriptデフォルトで User-Agent に含まれるデフォルトで client hints に含まれる
Sec-CH-UAbrands○○
Sec-CH-UA-Platformplatform○○
Sec-CH-UA-Mobilemobile○○

高エントロピーのクライアントヒント

高エントロピーのクライアントヒントは、プラットフォームのバージョン、アーキテクチャ、モデル、ビット数（64 ビットまたは 32 ビットプラットフォーム）、完全なオペレーティングシステムバージョンなど、クライアントデバイスに関するより詳細な情報です。 この情報は、フィンガープリントに使用できる可能性があります。

プロパティ説明HTTP ヘッダーXDM パス例デフォルトでユーザーエージェントに含まれるデフォルトで client hints に含まれる
オペレーティングシステムのバージョンオペレーティングシステムのバージョン。Sec-CH-UA-Platform-Versionxdm.environment.browserDetails.
userAgentClientHints.platformVersion		10.15.7○×
アーキテクチャ基盤となる CPU アーキテクチャ。Sec-CH-UA-Archxdm.environment.browserDetails.
userAgentClientHints.architecture		x86○×
デバイスモデル使用されるデバイスの名前。Sec-CH-UA-Modelxdm.environment.browserDetails.
userAgentClientHints.model		Intel Mac OS X 10_15_7○×
ビット数基になる CPU アーキテクチャがサポートするビット数です。Sec-CH-UA-Bitnessxdm.environment.browserDetails.
userAgentClientHints.bitness		64○×
ブラウザーベンダーブラウザーを作成した会社。 低エントロピーのヒント Sec-CH-UA でも、この要素が収集されます。Sec-CH-UA-Full-Version-Listxdm.environment.browserDetails.
userAgentClientHints.vendor		Google○×
ブラウザー名使用されるブラウザー。 低エントロピーのヒント Sec-CH-UA でも、この要素が収集されます。Sec-UA-Full-Version-Listxdm.environment.browserDetails.
userAgentClientHints.brand		Chrome○×
ブラウザーバージョンブラウザーの重要なバージョン。 低エントロピーのヒント Sec-CH-UA でも、この要素が収集されます。 正確なブラウザーバージョンは自動的に収集されません。Sec-UA-Full-Version-Listxdm.environment.browserDetails.
userAgentClientHints.version		105○×

Web SDK では、高エントロピーのクライアントヒントは、デフォルトで無効になっています。 これを有効にするには、高エントロピーのクライアントヒントをリクエストするように Web SDK を手動で設定する必要があります。