クライアントヒントの概要とよくある質問
クライアントヒントは、ユーザーのデバイスに関する個々の情報です。それらは、Google Chrome や Microsoft Edge などの Chromium ブラウザーによって提供されます。これらのブラウザーでは、クライアントヒントは User-Agent をデバイス情報のソースとして徐々に置き換えます。Adobe Analytics は、User-Agent に加えてクライアントヒントを使用してデバイス情報を決定するように、デバイス検索プロセスをアップデートします。
低エントロピーと高エントロピーのクライアントヒント
Google では、User-Agent Client Hints が 2 つのカテゴリ（低エントロピーと高エントロピーのヒント）に分類されています。
-
低エントロピーのヒント には、デバイスに関するより一般的な情報が含まれています。Chromium ブラウザーによってこれらのヒントが自動的に提供されます。
-
高エントロピー ヒントには、より詳細な情報が含まれています。リクエストがあった場合にのみ、これらのヒントを利用できます。AppMeasurement と Web SDK はどちらも、高エントロピーのヒントをリクエストするように設定できます。デフォルトでは、どちらのライブラリも高エントロピーのヒントをリクエスト しません。
2022年10月以降、Chromium ブラウザーの新しいバージョンでは、User-Agent 文字列で表されるオペレーティングシステムバージョンの「フリーズ」が開始されました。オペレーティングシステムのバージョンは高エントロピーのヒントなので、レポートでオペレーティングシステムのバージョンの正確性を維持するには、これらの高エントロピーのヒントを収集するようにコレクションライブラリを設定する必要があります。User-Agent の他のデバイス情報は時間の経過とともにフリーズされ、デバイスレポートの正確性を維持するためにクライアントヒントが必要になります。
クライアントヒントは、2023 年 2 月 27 日以降、Analytics デバイス参照プロセスに組み込まれ、2023 年 3 月 2 日に終了します。 現在、AppMeasurement と Web SDK の両方でヒントデータの収集がサポートされていますが、2月中旬まではデバイス検索では使用されません。後述のように、オペレーティングシステムのバージョンは 10月よりフリーズされていますが、段階的なロールアウトおよび多くのユーザーエージェントが既にフローズン OS バージョンを提供しているという事実（詳しくは、こちらを参照）により、アドビでは、これが影響するのは Chrome 訪問者の 3％未満と見積もっています。
Adobe Audience Managerでは、機能を完全に保持するために、高エントロピーのヒントを収集する必要があります。 を使用している場合、 Adobe Audience Managerへのサーバー側転送 次に、高エントロピーのヒントの収集を有効にすることができます。
よくある質問
低エントロピーのヒントはブラウザーから自動的に提供され、デバイスとブラウザーの情報を取得するために取り込まれます。Web SDK の新しいバージョン（2.12.0 以降）および AppMeasurement（2.23.0 以降）は、それぞれのタグ拡張機能を使用して、または設定オプションを直接使用して、高エントロピーのヒントを収集するように設定できます。Web SDK および AppMeasurement の手順を参照してください。
どちらのライブラリでも、高エントロピーのヒントの収集は デフォルトで無効 になっています。
API で送信されたデータの場合（Data Insertion API や Bulk Data Insertion API など）、ヒントは、ペイロードに明示的に含める必要があります。詳しくは、それぞれのドキュメントを参照してください。
現時点ではできません。高エントロピーのヒントをすべて収集するか、まったく収集しないかを選択できます。
ブラウザのメジャーバージョンは低エントロピーのヒントとして取り込まれるので、fullVersionList は現在収集されていません。
2022年10月現在のクライアントヒントを次の表に示します。
| table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4 6-row-4 7-row-4 8-row-4 | |||
|---|---|---|---|
| ヒント | 説明 | 高／低エントロピー | 例 |
| Sec-CH-UA | ブラウザーと重要なバージョン | 低 | "Google Chrome 84" |
| Sec-CH-UA-Mobile | モバイルデバイス（true または false） | 低 | true |
| Sec-CH-UA-Platform | オペレーティングシステム／プラットフォーム | 低 | "Android" |
| アーキテクチャ | サイトのアーキテクチャ | 高 | "arm" |
| 硬さ | アーキテクチャのビット度 | 高 | "64" |
| fullVersionList | ブランドとそのバージョンのリスト | 高 | "Not A;Brand";v="99", "Chromium";v="98", "Google Chrome";v="98" |
| model | デバイスモデル | 高 | "Pixel 3" |
| platformVersion | オペレーティングシステム／プラットフォームのバージョン | 高 | "10" |
- 低エントロピーのヒントは、リクエストヘッダーで収集されます。
- 高エントロピーのヒントは、JavaScript で収集され、クエリ文字列パラメーター値で渡されます。クエリー文字列パラメーターは、
h.をイメージリクエストのプレフィックスとして使用します。 ブラウザのメジャーバージョンは低エントロピーヒントとして取り込まれるので、fullVersionList は現在収集されていません。
高エントロピーヒントは、JavaScript 呼び出しで収集され、クエリパラメーターで渡されます
これらのフィールドは User-Agent から直接得られますが、User-Agent を使用すると、デバイスの詳細に応じて、他のデバイス関連フィールドの値を得ることができます。
レポートのデバイス情報は、ユーザーエージェントから派生されます。ユーザーエージェントとクライアントヒントの両方が使用できる場合に、その両方を使用するようにプロセスを更新しました。
フォールバック ID（s_fid）は、ユーザーエージェントおよび IP アドレスから派生されます。この ID は、cookie を設定できない場合にのみ使用されるので、一般的には使用されていません
これは、User-Agent のうち Google によって「凍結」される部分が増えるにつれて、徐々に変化します。最初に直接影響を受けるフィールドは、オペレーティングシステムのバージョンが含まれる「Operating System」です。User-Agent ヒントの「凍結」に関する Google の公開タイムラインによれば、2022年10月下旬から Chromium バージョン 107 でオペレーティングシステムのバージョンが凍結されます。その時点で、 User-Agent のオペレーティングシステムバージョンが不正確になる場合があります。
User-Agent の他の部分がフリーズするタイミングについては、Google が公開しているタイムラインを参照してください。