クライアントヒントの概要とよくある質問
クライアントヒントは、ユーザーのデバイスに関する個々の情報です。それらは、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 日（PT）以降、2023 年 3 月 2 日（PT）まで、Analytics デバイス検索プロセスに組み込まれます。 現在、AppMeasurement と Web SDK の両方でヒントデータの収集がサポートされていますが、2月中旬まではデバイス検索では使用されません。後述のように、オペレーティングシステムのバージョンは 10月よりフリーズされていますが、段階的なロールアウトおよび多くのユーザーエージェントが既にフローズン OS バージョンを提供しているという事実（詳しくは、こちらを参照）により、アドビでは、これが影響するのは Chrome 訪問者の 3％未満と見積もっています。
NOTEAdobe 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月現在のクライアントヒントを次の表に示します。
| ヒント | 説明 | 高／低エントロピー | 例 |
|---|---|---|---|
| Sec-CH-UA | ブラウザーと重要なバージョン | 低 | "Google Chrome 84" |
| Sec-CH-UA-Mobile | モバイルデバイス（true または false） | 低 | true |
| Sec-CH-UA-Platform | オペレーティングシステム／プラットフォーム | 低 | "Android" |
| architecture | サイトのアーキテクチャ | 高 | "arm" |
| ビット | アーキテクチャのビット数 | 高 | "64" |
| fullVersionList | ブランドとそのバージョンのリスト | 高 | "Not A;Brand";v="99", "Chromium";v="98", "Google Chrome";v="98" |
| model | デバイスモデル | 高 | "Pixel 3" |
| platformVersion | オペレーティングシステム／プラットフォームのバージョン | 高 | "10" |
- 低エントロピーのヒントは、リクエストヘッダーで収集されます。
- 高エントロピーのヒントは、JavaScript で収集され、クエリ文字列パラメーター値で渡されます。クエリ文字列パラメーターは、
h.をイメージリクエストのプレフィックスとして使用します。 ブラウザーのメジャーバージョンは低エントロピーのヒントとしてキャプチャされるので、fullVersionList は現在収集されないことに注意してください。
高エントロピーヒントは、JavaScript 呼び出しで収集され、クエリパラメーターで渡されます
Analytics のデバイスレポートに何か変更はありますか？
User-Agent から派生する Analytics レポートフィールドはどれですか？
これらのフィールドは User-Agent から直接得られますが、User-Agent を使用すると、デバイスの詳細に応じて、他のデバイス関連フィールドの値を得ることができます。
User-Agent のどの部分がいつ「フリーズ」されますか？
Analytics はどのような方法でユーザーエージェントに依存しますか？
レポートのデバイス情報は、ユーザーエージェントから派生されます。ユーザーエージェントとクライアントヒントの両方が使用できる場合に、その両方を使用するようにプロセスを更新しました。
フォールバック ID（s_fid）は、ユーザーエージェントおよび IP アドレスから派生されます。この ID は、cookie を設定できない場合にのみ使用されるので、一般的には使用されていません
高エントロピーのヒントに格納された値から派生する Analytics レポートフィールドはどれですか？
これは、User-Agent のうち Google によって「凍結」される部分が増えるにつれて、徐々に変化します。最初に直接影響を受けるフィールドは、オペレーティングシステムのバージョンが含まれる「Operating System」です。User-Agent ヒントの「凍結」に関する Google の公開タイムラインによれば、2022年10月下旬から Chromium バージョン 107 でオペレーティングシステムのバージョンが凍結されます。その時点で、 User-Agent のオペレーティングシステムバージョンが不正確になる場合があります。
User-Agent の他の部分がフリーズするタイミングについては、Google が公開しているタイムラインを参照してください。
アドビでは、クライアントヒントをどのように使用してデバイス情報を取得しますか？
クライアントヒントの影響を受けるブラウザーはどれですか？
クライアントヒントは、安全でない接続でサポートされていますか？
API 送信を使用する際にクライアントヒントのデータを含めるには、どうすればよいですか？
クライアントヒントは、AdobeのSource Connector を介してAdobe Experience PlatformおよびCustomer Journey Analyticsに送信されるデータで利用できますか？
クライアントヒントは、XDM でどのように表されますか？
Adobe Audience Manager サーバーサイド転送はクライアントヒントをサポートしますか？
このトピックに関するその他のヘルプ
Analytics
- Analytics テクニカルノート
- Adobe Analytics for Google Analytics ユーザー
- イベントの影響を受けるデータの分析
- クライアントヒント
- Cookie
- リスニングデータの保持期間
- ドメイン
- データの除外
- IP アドレス
- 遅延
- 低トラフィック値
- Mobile Services の処理ルールの Adobe Analytics への移行
- 複数通貨のサポート
- プライバシーの概要
- 処理順序
- プログレッシブ Web アプリケーション
- リダイレクトとエイリアス
- セキュリティリソース
- 使用される用語（用語集）
- タイムスタンプオプション
- ログインのトラブルシューティング
- ログアウトのトラブルシューティング
- 未指定、その他および不明
- 訪問者の移行
- VISTA ルール
