Chrome では、プライバシー サンドボックスの一部として、試験運用版の Topics API が提案されています。Topics API は、ウェブページ上のサードパーティの呼び出し元(広告テクノロジー プロバイダを含む)に、ページの訪問者が現在関心を持つ可能性がある大まかな広告トピックを提供します。トピックは、現在のページに関するコンテキスト情報を補完するもので、インタレスト ベース広告をサポートする場合に役立ちます。
RTB パートナーは、入札リクエストで Topics API のテストを利用できます。Topics API のテストに参加するには、リクエスト フォームに必要事項を入力してください。詳しくは、アカウント マネージャーにお問い合わせください。
入札リクエストに含まれる情報
Google 認定バイヤー プロトコル
トピックは、BidRequest
メッセージの topics
フィールドで表されます。このフィールドは、プロトコルのオープンベータ版で利用できます。
定義は次のとおりです。
// Experimental field; subject to change.
// A coarse-grained topic that a website visitor might currently be interested
// in based on recent browsing activity. See
// https://developer.chrome.com/docs/privacy-sandbox/topics/ and/or
// https://privacysandbox.com/intl/en_us/proposals/topics/ for more
// information about the Topics API. Reach out to your account manager to
// participate in the Topics API experiment.
message Topic {
// The value of a topic ID. A numerical identifier corresponding to a
// coarse-grained advertising topic. See
// https://github.com/patcg-individual-drafts/topics/blob/main/taxonomy_v1.md
// for a list of topics in the initial taxonomy.
optional int32 id = 1;
// The version of the advertising taxonomy which defines the semantic
// meaning of each topic ID for the topics, for example "v1".
optional string taxonomy_version = 2;
// The version of the classifier used by the browser to map hostnames to
// topic IDs in the taxonomy.
optional string classifier_version = 3;
}
// The list of topics that a website visitor might currently be interested in
// inferred by the browser based on recent browsing activity. See
// https://developer.chrome.com/docs/privacy-sandbox/topics/ and/or
// https://privacysandbox.com/intl/en_us/proposals/topics/ for more
// information about Topics API.
repeated Topic topics = 74;
OpenRTB プロトコル
トピックは、OpenRTB BidRequest.user.data
メッセージでセグメントとして表されます。
フィールド | タイプ | 説明 |
---|---|---|
Data.ext.segtax
|
整数 | 一元的に登録される分類の ID。Topics の場合、各トピック ID の意味を定義する広告分類のバージョンです。600 は Chrome の Topics の初期分類に使用されます。 |
Data.ext.segclass
|
String(文字列) | classifier_version と同じです。
|
Data.segment.id
|
String(文字列) | 文字列にキャストされる id と同じです。
|
Data.ext
は BidRequest.user.data
メッセージの拡張機能です。この拡張機能は、プロトコルのオープンベータ版で利用できます。
定義は次のとおりです。
// Ad Exchange extensions for the Data object.
message DataExt {
// The ID for a taxonomy that is registered centrally. Used to define the
// namespace and semantic meaning of the segment IDs. See
// https://github.com/InteractiveAdvertisingBureau/openrtb/blob/master/extensions/community_extensions/segtax.md#enumeration-of-taxonomies
// for the enumeration of the taxonomies that this value can take. Currently
// only Chrome Topics API taxonomy (segtax=600) is supported.
optional int32 segtax = 1;
// The version of the classifier which produced the segment IDs within the
// taxonomy. For example, in the case of Chrome Topics API (segtax=600), this
// is the version of the classifier used by the browser to map hostnames to
// topics in the taxonomy.
optional string segclass = 2;
}
例
Chrome Topics API から返されるトピックを、Google の認定バイヤーと OpenRTB プロトコルでどのように表するかの例を次に示します。
document.browsingTopics()
から返される Chrome Topics API レスポンス:
[
{
"modelVersion": "classifier_v1",
"taxonomyVersion": "taxonomy_v1",
"topic": 3
},
{
"modelVersion": "classifier_v1",
"taxonomyVersion": "taxonomy_v1",
"topic": 44
},
{
"modelVersion": "classifier_v1",
"taxonomyVersion": "taxonomy_v1",
"topic": 59
}
]
Google 認定バイヤー プロトコルの BidRequest:
topics {
id: 3
taxonomy_version: "taxonomy_v1"
classifier_version: "classifier_v1"
}
topics {
id: 44
taxonomy_version: "taxonomy_v1"
classifier_version: "classifier_v1"
}
topics {
id: 59
taxonomy_version: "taxonomy_v1"
classifier_version: "classifier_v1"
}
OpenRTB 入札リクエスト:
{
"user": {
"data": [
{
"ext": {
"segtax": 600,
"segclass": "classifier_v1"
},
"segment": [
{ "id": "3" },
{ "id": "44" },
{ "id": "59" }
]
}
]
}
}
上記の例の taxonomy_version
は、categories_v1 マッピングが使用されていることを意味します。分類に基づいて、これらのトピック ID は次のトピックに対応しています。
トピック ID | トピックの値 |
---|---|
3 | /アート、エンターテインメント/コミック |
44 | /アート、エンターテインメント/オペラ |
59 | /自動車、車両/クラシック カー |
対象
入札リクエストにトピックが含まれているかどうかは、既存のプライバシー保護と管理の対象になります。たとえば、ユーザーがパーソナライズド広告や非パーソナライズド広告の広告枠からオプトアウトしている場合、トピックは利用できません。