User agent client hints

概要 overview

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

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

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`

ユースケース use-cases

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

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

Adobe Experience Cloudのユーザーエージェント文字列 user-agent-in-adobe

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

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

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

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

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

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

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

ブラウザーのサポート browser-support

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

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

カテゴリ categories

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

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

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

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

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

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

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

高エントロピーのクライアントヒントは、Experience Cloudソリューションに影響を与えます impact-in-experience-cloud-solutions

一部のAdobe Experience Cloud ソリューションでは、レポートの生成時に、高エントロピーのクライアントヒントに含まれる情報に依存します。

お使いの環境で高エントロピーのクライアントヒントを有効にしない場合、以下に説明するAdobe AnalyticsとAudience Managerのレポートおよび特性は機能しません。

高エントロピーのクライアントヒントに基づくAdobe Analytics レポート analytics

オペレーティングシステムディメンションには、高エントロピーのクライアントヒントとして保存されるオペレーティングシステムバージョンが含まれます。 高エントロピーのクライアントヒントが有効になっていない場合、Chromium ブラウザーから収集されたヒットのオペレーティングシステムバージョンが不正確になる場合があります。

高エントロピーのクライアントヒントに基づくAudience Manager特性 aam

Google は、User-Agent ヘッダーを介して収集される情報を最小限に抑えるために、Chrome ブラウザー機能を更新しました。 その結果、 プラットフォームを使用しているAudience Managerのお客様は、DILレベルのキーに基づく特性に関する信頼性の高い情報を受け取れなくなります。

ターゲティングにプラットフォームレベルのキーを使用するAudience Managerのお客様は、 特性ではなくExperience Platform Web SDK に切り替え、信頼性の高いDILデータを引き続き受け取るには 高エントロピーのクライアントヒントを有効にする必要があります。

高エントロピーのクライアントヒントの有効化 enabling-high-entropy-client-hints

Web SDK デプロイメントで高エントロピーのクライアントヒントを有効にするには、context フィールドに追加の highEntropyUserAgentHints コンテキストオプションを含める必要があります。

例えば、web プロパティから高エントロピーのクライアントヒントを取得するには、設定は次のようになります。

context: ["highEntropyUserAgentHints", "web"]

例 example

ブラウザーから web サーバーに送信される最初のリクエストのヘッダーに含まれる Client Hints には、ブラウザーのブランド、ブラウザーのメジャーバージョン、クライアントがモバイルデバイスであるかどうかのインジケーターが含まれます。 次に示すように、各データは、単一のユーザーエージェント文字列にグループ化されるのではなく、独自のヘッダー値を持ちます。

Sec-CH-UA: "Chromium";v="101", "Google Chrome";v="101", " Not;A Brand";v="99"

Sec-CH-UA-Mobile: ?0

Sec-CH-UA-Platform: "macOS

同じブラウザーに対して同等の User-Agent ヘッダーは、次のようになります。

Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/101.0.4951.54 Safari/537.36

情報は似ていますが、サーバーへの最初のリクエストには client hints が含まれています。 これには、ユーザーエージェント文字列で使用できるもののサブセットのみが含まれます。 リクエストに含まれていないのは、オペレーティングシステムのアーキテクチャ、完全なオペレーティングシステムのバージョン、レイアウトエンジン名、レイアウトエンジンのバージョンおよび完全なブラウザーのバージョンです。

ただし、その後のリクエストでは、Client Hints API を使用すると、web サーバーはデバイスに関する追加の詳細を問い合わせることができます。 これらの値がリクエストされた場合、ブラウザーのポリシーやユーザー設定によっては、ブラウザーの応答にその情報が含まれることがあります。

以下は、高エントロピー値がリクエストされた場合に Client Hints API によって返される JSON オブジェクトの例です。

{
   "architecture":"x86",
   "bitness":"64",
   "brands":[
      {
         "brand":" Not A;Brand",
         "version":"99"
      },
      {
         "brand":"Chromium",
         "version":"100"
      },
      {
         "brand":"Google Chrome",
         "version":"100"
      }
   ],
   "fullVersionList":[
      {
         "brand":" Not A;Brand",
         "version":"99.0.0.0"
      },
      {
         "brand":"Chromium",
         "version":"100.0.4896.127"
      },
      {
         "brand":"Google Chrome",
         "version":"100.0.4896.127"
      }
   ],
   "mobile":false,
   "model":"",
   "platformVersion":"12.2.1"
}