User-agent と Client Hints

Adobe Targetは、user-agentを使用して、セグメンテーションとパーソナライゼーションに対する訪問者の選定を行います。

Web ブラウザーがサーバーにリクエストするたびに、ブラウザーに関する情報とブラウザーが実行される環境がリクエストのヘッダーに含まれます。 インターネットの初期の頃から、このデータは、user-agent と呼ばれる単一の文字列で集計されています。

以下のテキストに、Safari ブラウザーを使用する Mac OS X ベースのコンピューターの user-agent の例を示します。

Mozilla/5.0 (Linux; Android 12; SM-S908E) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/101.0.4951.41 Mobile Safari/537.36

リクエストを受け取ったサーバーは、この user-agent から、ブラウザーおよびオペレーティングシステムに関する以下の情報を識別できます。

user-agent 文字列に含まれるブラウザーおよびデバイス情報の量は、年々増加しています。

User-agent の使用例

ユーザーエージェントは、ブラウザー、オペレーティングシステム、デバイスがサイトコンテンツをどのように表示し、ユーザーがweb サイトとどのようにインタラクションしているかに関する重要なインサイトを、マーケティング部門や開発部門に提供するために長年使用されてきました。 また、User-agents は、スパムのブロックやサイトをクロールするボットのフィルタリングなど、様々な追加の目的にも使用されます。

しかし、近年、一部のサイト所有者やマーケティングベンダーは、リクエストヘッダーに含まれる他の情報と共に user-agent を使用して、ユーザーが知らないうちにユーザーを特定する手段として使用できる、デジタルフィンガープリントを作成しています。 サイト所有者にとって user-agent が重要な目的を果たすにもかかわらず、ブラウザー開発者は、サイト訪問者に関する潜在的なプライバシーの問題を制限するために、user-agents の動作方法の変更を決定しました。

ブラウザー開発者は、この課題の解決策としてUser-Agent クライアントヒントを作成しました。 クライアントヒントを使用すると、サイトは必要なブラウザー、オペレーティングシステム、デバイス情報を収集できるだけでなく、フィンガープリントなどの隠れたトラッキング方法に対する保護も強化できます。

クライアントヒント

User-Agent Client Hints は、web サイト所有者に、user-agent で利用できるのとほぼ同じ量の情報にアクセスする機能を、よりプライバシーが保護された方法で提供します。 モダンブラウザーが web サーバーに user-agent を送信する場合、それが必要かどうかにかかわらず、すべてのリクエストで user-agent 全体が送信されます。 一方、Client Hints は、サーバーがクライアントについて知りたい追加情報をブラウザーに問い合わせる必要があるモデルを強制します。 このリクエストを受け取ったブラウザーは、独自のポリシーやユーザー設定を適用して、どのデータが返されるかを決定できます。 すべてのリクエストに対してデフォルトで user-agent 全体を公開する代わりに、明示的で監査可能な方法でアクセスが管理されるようになりました。

User-Agent Client Hints は、Chrome バージョン 89 以降で利用できます。 Chromium ベースのブラウザー（Microsoft Edge、Opera、Brave、Chrome Android、Opera Android および Samsung Internet）の最近のバージョンも、Client Hints API をサポートしています。

ブラウザーから 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

情報は似ていますが、サーバーへの最初のリクエストには、user-agent 文字列で利用可能なもののサブセットのみを含む Client Hints が含まれています。 リクエストに含まれていないのは、OS アーキテクチャ、完全な OS のバージョン、レイアウトエンジン名、レイアウトエンジンのバージョンおよび完全なブラウザーのバージョンです。 ただし、その後のリクエストでは、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"
}

高エントロピー値には、デフォルトの Client Hints 情報では利用できない、いくつかの追加情報が含まれます。 以下の表に、デフォルトのリクエストと高エントロピーの User-Agent Client Hints 情報で利用できるデータの比較を示します。

Client Hints への移行

現在、Chromium ベースのブラウザーは、web サーバーに対するリクエストのヘッダーで、Client Hints と共に user-agent を送信し続けています。 ただし、2022年4月から2023年2月までは、user-agent 文字列に含まれるデータ量が削減されます。 Safari や Firefox などの他のブラウザーは、引き続き user-agent 文字列を利用しますが、そこに含まれる情報量は削減される予定です。

クライアントヒントを必要とするターゲットユースケース

以下に、Client Hints を必要とする Target の使用例を示します。

オーディエンス属性

Target オーディエンスを使用し、次のいずれかのオーディエンス属性を使用する場合、Targetでは、正しいセグメンテーションを実行するためにクライアントヒントが必要です。

プロファイルスクリプト

プロファイルスクリプトを使用して、（user-agent を参照する） user.browser 属性を参照する場合、1 つ以上の Client Hints も確認するようにプロファイルスクリプトを更新する必要がある可能性があります。 関数 user.clientHint('sec-ch-ua-xxxxx') を使用して、任意の Client Hints にアクセスすることもできます。 Client Hint ヘッダー名は、すべて小文字である必要があります。

以下の例に、プロファイルスクリプトで Windows OS を適切に検出する方法を示します。

"return (((user.browser != null) && (user.browser.indexOf(\"Windows\") > -1)) || " +
      "((user.clientHint('sec-ch-ua-platform') != null) &&
(user.clientHint('sec-ch-ua-platform') === 'Windows')));"

以下は、クライアントヒントと、それに対応するプロファイルスクリプトの使用状況セマンティクスの表です。

クライアントヒントをAdobe Targetに渡す方法

以下の節では、Targetの実装に応じて、クライアントヒントを渡す方法について詳しく説明します。

at.js バージョン 2.9.0（またはそれ以降）

at.js 2.9.0以降、User Agent Client Hintsはブラウザーから自動的に収集され、getOffer/getOffers()が呼び出されたときにTargetに送信されます。 デフォルトでは、at.js は、「低エントロピー」の Client Hints のみを収集します。 前の節で「高エントロピー」に分類されたデータに基づいてオーディエンスセグメンテーションを実行したり、プロファイルスクリプトを使用したりする場合、targetGlobalSettings を使用してブラウザーから「高エントロピー」の Client Hints を収集するように at.js を設定する必要があります。

window.targetGlobalSettings = { allowHighEntropyClientHints: true };

サーバーサイド SDK

サーバーサイド SDKを介してクライアントヒントを渡す方法について詳しくは、「サーバーサイド実装ドキュメント」の「​ クライアントヒント ​」を参照してください。