ユーザー エージェント ターゲティング

User-Agent これまでは入札リクエストにタグが含まれていました。 起動元のデバイスのブラウザやプラットフォームなどのデータをターゲットとします。ただし、 User-Agent は、使いづらいため、ブラウザでは大幅に秘匿化されることが多く、 ユーザーのプライバシーの保護を強化します。これに対処するために、Google は User-Agent Client Hints: User-Agent ヘッダーを補完するものとして、入札リクエストに含めることができます。 これらの Client Hints は、Sec-Ch-UA* ヘッダーまたは Client Hints API から呼び出すこともできます。

使用されるプロトコルに応じて、User-Agent ヘッダーはいずれかのプロトコルとともに公開されます。 次の文字列フィールドがあります。

  • OpenRTB: BidRequest.device.ua
  • Google RTB（サポート終了）: BidRequest.user_agent

Client Hints API が入力されている場合、UserAgent メッセージに Client Hints が挿入されます。 使用可能ですが、それ以外の場合は、UDM イベントで解析された値に基づいて User-Agent ヘッダー。使用されるプロトコルに応じて、これは 1 つの 次のフィールドの

  • OpenRTB: BidRequest.device.sua
  • Google RTB（サポート終了）: BidRequest.user_agent_data

ビッダーには、メッセージではなく UserAgent メッセージを使用することを強くおすすめします。 ユーザー エージェント文字列。

UserAgent の入力方法

User-Agent ヘッダーとは異なり、UserAgent メッセージはユーザー エージェントを表します。 特定の情報を得るために複数のフィールドに分割されます。

広告リクエストで Client Hints API の使用可否に応じて、 UserAgent メッセージは、次の方法で入力できます。

  • リクエストに少なくとも 低エントロピー Client Hints では、UserAgent はその内容に基づいて入力されます。
  • リクエストに User-Agent ヘッダーのみが含まれている場合、UserAgent は ヘッダーから解析可能な内容に基づいて入力されます。
で確認できます。

例: User-Agent ヘッダーに基づいて UserAgent を入力する

広告リクエストに対して、ブラウザが以下のヘッダーを送信するとします。

User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64)
            AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.0.0 Safari/537.36

User-Agent ヘッダーのみに基づいて入力された UserAgent は次のようになります。 次のとおりです。

browsers: [{ brand: "Mozilla", version: ["5", "0"] },
           { brand: "AppleWebKit", version: ["537", "36"] },
           { brand: "Chrome", version: ["103", "0", "0", "0"] },
           { brand: "Safari", version: ["537", "36"] }],
platform: { brand: "Windows NT", version: ["10", "0"] },
mobile: false,
architecture: "x86",
bitness: "64",
model: "x64",
source: USER_AGENT_STRING

例: Client Hints に基づいて UserAgent を入力する

広告リクエストに対して、ブラウザが以下のヘッダーを送信するとします。

User-Agent:                 Mozilla/5.0 (Windows NT 10.0; Win64; x64)
                            AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.0.0 Safari/537.36
Sec-Ch-Ua:                  ".Not/A)Brand";v="99", "Google Chrome";v="103", "Chromium";v="103"
Sec-Ch-Ua-Arch:             x86
Sec-Ch-Ua-Full-Version:     103.0.5060.134
Sec-Ch-Ua-Mobile:           ?0
Sec-Ch-Ua-Platform:         Windows
Sec-Ch-Ua-Platform-Version: 15.0.0

少なくとも低エントロピーの Client Hints を含める場合、UserAgent User-Agent である場合でも、これらのヘッダーの内容に基づいて入力されます。 ヘッダーがあります。次のようになります。

browsers: [{ brand: ".Not/A)Brand", version: ["99", "0", "0", "0"] },
           { brand: "Google Chrome", version: ["103", "0", "5060", "134"] },
           { brand: "Chromium", version: ["103", "0", "5060", "134"] }],
platform: { brand: "Windows", version: ["15", "0", "0"] },
mobile: false,
architecture: "x86",
bitness: "64",
source: CLIENT_HINTS_HIGH_ENTROPY

User-Agent ヘッダーに基づく入力と Client Hints API の使用

一部のフィールドは、基づいているかどうかによって入力方法が異なります User-Agent ヘッダーまたは Client Hints API を使用します。以下に、これらのポリシーの概要を 違いがあります。

  • 同一のブラウザとプラットフォームの場合、UserAgent.browsers.brand と 多くの場合、UserAgent.platform.brand は次の要素に基づいて UserAgent 間で異なります。 User-Agent ヘッダーまたは Client Hints API を使用します。たとえば 次のソフトウェアをベースとする Windows NT の場合、UserAgent.platform.brand は「Windows NT」と表示されることがあります。 User-Agent ヘッダー、Client Hints に基づく場合は「Windows」です。
  • 一部の UserAgent.browsers エントリは User-Agent ヘッダーに固有のものです。または、 Client Hints へ。たとえば、UserAgent の場合、「AppleWebKit」と表示されます。 User-Agent ヘッダーに基づいていましたが、「Chromium」は Client Hints が使用されます。
  • 固定された値を含めることができるのは、User-Agent ヘッダーに基づく UserAgent のみです。 たとえば、プラットフォームが Windows 11 22H2 の場合、 UserAgent.platform.brand は「Windows NT」に設定され、 UserAgent.platform.version は [“10”, “0”] に設定されます。これは、 10 以上の Windows バージョンの固定値。

Client Hints に基づく UserAgent のデータは、通常、 固定または秘匿化された情報の不正確な置き換えもし User-Agent ヘッダーと UserAgent の不整合を、Client ヒント。UserAgent からの情報が優先されます。

UserAgent オブジェクトのフィールド

このセクションでは、Google の RTB 固有の特徴を中心に、各フィールドの概要を説明します。 ベスト プラクティスを紹介します。

ブラウザ

次を含む: BrandVersion 通常は具体性によって順序付けられます。たとえば、 browsers の内容をリストすると、各エントリの brand が表示されることがあります。 次の順序で並べます。

ブランド 意味
Mozilla Mozilla 互換
AppleWebKit AppleWebKit ベースで、Mozilla のサブセットです。
Chrome Chrome ブラウザ（AppleWebKit 対応ブラウザのサブセット）
Safari パソコン版ではなく、パソコン版を用意している。

UserAgent は、ブラウザを特定の順序で一覧表示するとは限りません（特に Client Hints が使用されます。以下では、その他の違いについて説明します。 source の値に基づいて表示されます。

  • USER_AGENT: version フィールドはメジャー バージョンに縮小されるか、 固定（エージェント固有のポリシーによって異なります）。なお、 値が固定されていることを示します。
  • CLIENT_HINTS_LOW_ENTROPY、CLIENT_HINTS_HIGH_ENTROPY: エントリ どの条件にも当てはまらないたとえば、同じブラウザがこれらの URL を エントリの順序が異なる場合がありますまた、 GREASE エントリ。これは、 無視します。
  • CLIENT_HINTS_HIGH_ENTROPY: ブラウザにあるすべての version フィールドが できません。

プラットフォーム

BrandVersion: エントリが含まれます。User-Agent 間で互換性がない場合がある ヘッダーと Client Hints の使用ができないため、プラットフォームによってはターゲティングにテストが必要になる場合があります 2 つの名前があります。たとえば、Apple の Macintosh オペレーティング システムは User-Agent ヘッダーでは「Macintosh」、Client Hints では「macOS」と表示されます。 以下では、 source の値:

  • USER_AGENT: version フィールドはメジャー バージョンに縮小されるか、 表示されます。値が固定されたことを示す表示はありません。
  • CLIENT_HINTS_LOW_ENTROPY: version フィールドには入力されません。
  • CLIENT_HINTS_HIGH_ENTROPY: version フィールドは完全な値に設定できます。 できます。

モバイル

広告などのコンテンツを小さな画面や、 タップ入力。ただし、これは必ずしもデバイスタイプの指標ではありません。 モバイル ブラウザでは「PC 版サイト」をリクエストするように設定できます。

アーキテクチャ

プラットフォームのアーキテクチャを識別します（x86、arm など）。

Client Hints に基づく UserAgent の場合は、値が入力されるだけです。 source が CLIENT_HINTS_HIGH_ENTROPY に設定されている場合。

ビット数

プラットフォームのビット数（32 ビットか 64 ビットかなど）を識別する できます。このフィールドは整数文字列で、リソースに関する追加情報を そのアーキテクチャ、たとえば、「x86」アーキテクチャの場合、ビット数を 「32」または「64」を選択します

Client Hints に基づく UserAgent の場合は、値が入力されるだけです。 source が CLIENT_HINTS_HIGH_ENTROPY に設定されている場合。

モデル

デバイスのモデルを識別する ID を指定します。モバイル デバイスの場合、つまりノートパソコンや （「Google Pixel 6 Pro」など）のモデル名が入力されます。

以下では、 source の値:

  • USER_AGENT
    • モバイル以外のデバイス: model フィールドには、 （Windows の場合は「x64」など）ビット数の値を指定します。この値は クロスプラットフォームではないたとえば、Linux では同じ文字列に「x86_64」を使用し、 あります。
    • モバイル デバイス: このフィールドにはアーキテクチャとビット数は含まれません。 これらの値の詳細については、UserAgent.architecture と UserAgent.bitness。
  • CLIENT_HINTS_LOW_ENTROPY: model フィールドには入力されません。
  • CLIENT_HINTS_HIGH_ENTROPY: model フィールドには、次の場合にのみ値が入力されます。 モバイル デバイスのデバイスモデルです。デスクトップ プラットフォームには値が設定されていません。

ソース

UserAgent の作成に使用されたヘッダーを識別します。Client Hints API では これにより、次の 2 つのケースも区別されます。

  • CLIENT_HINTS_LOW_ENTROPY: 基本的な Client Hints を使用できます。
  • CLIENT_HINTS_HIGH_ENTROPY: 次の Client Hints の使用: 1 つのフィールドが高エントロピーとして分類されます。