クライアントヒントの概要とよくある質問

クライアントヒントは、ユーザーのデバイスに関する個々の情報です。それらは、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%未満と見積もっています。

NOTE
2023年1月の時点で、Mac および Windows オペレーティング システムの一部のバージョンがユーザーエージェントで正しく表示されず、高エントロピーのクライアントヒントでは正しく表示されます。詳しくは、オペレーティングシステムを参照してください。

Adobe Audience Managerでは、機能を完全に保持するために、高エントロピーのヒントを収集する必要があります。 Adobe Audience Managerへの サーバーサイド転送を使用している場合は、高エントロピーヒントの収集を有効にした方がよいでしょう。

よくある質問

クライアントヒントの詳細はどこで確認できますか?
この Google のブログ投稿は、開始するのに適した資料です。
クライアントヒントのコレクションを有効にするにはどうすればよいですか?

低エントロピーのヒントはブラウザーから自動的に提供され、デバイスとブラウザーの情報を取得するために取り込まれます。Web SDK の新しいバージョン(2.12.0 以降)および AppMeasurement(2.23.0 以降)は、それぞれのタグ拡張機能を使用して、または設定オプションを直接使用して、高エントロピーのヒントを収集するように設定できます。Web SDK および AppMeasurement の手順を参照してください。

どちらのライブラリでも、高エントロピーのヒントの収集は​ デフォルトで無効 ​になっています。

API で送信されたデータの場合(Data Insertion APIBulk 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"
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 のどの部分がいつ「フリーズ」されますか?
Google が公開しているタイムラインを参照してください。これは変更される場合があります。
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 が公開しているタイムラインを参照してください。

アドビでは、クライアントヒントをどのように使用してデバイス情報を取得しますか?
アドビでは、サードパーティの Device Atlas を使用していますが、これはクライアントヒントと User-Agent の両方を使用してデバイス情報を取得します。
クライアントヒントの影響を受けるブラウザーはどれですか?
クライアントヒントは、Google Chrome や Microsoft Edge などの Chromium ブラウザーにのみ適用されます。他のブラウザーやモバイルアプリからのデータには変更はありません。
クライアントヒントは、安全でない接続でサポートされていますか?
いいえ。クライアントヒントは、HTTPS などの安全な HTTP 接続を介してのみ収集できます。
API 送信を使用する際にクライアントヒントのデータを含めるには、どうすればよいですか?
一括データ挿入 API を使用してこれらを含める方法については、ドキュメントを参照してください。
クライアントヒントは、AdobeのSource Connector を介してAdobe Experience PlatformおよびCustomer Journey Analyticsに送信されるデータで利用できますか?
アドビは、2023年上半期に Adobe ソースコネクタを介したデータにクライアントヒントを含める予定です。
クライアントヒントは、XDM でどのように表されますか?
Adobe Experience Platform のスキーマドキュメントを参照してください。
Adobe Audience Manager サーバーサイド転送はクライアントヒントをサポートしますか?
はい。クライアントヒントは、Adobe Audience Managerに転送されるデータに含まれます。 なお、Adobe Audience Managerでは、機能を完全に保持するために、高エントロピーのヒントを収集する必要があります。 Adobe Audience Managerへの サーバーサイド転送を使用している場合は、高エントロピーヒントの収集を有効にした方がよいでしょう。
recommendation-more-help
df89a595-bae4-48f4-9606-e55c9666ee49