Sebagai bagian dari Privacy Sandbox, Chrome mengusulkan Topics API eksperimental. Topics API memberi pemanggil pihak ketiga di halaman web (termasuk penyedia teknologi iklan) topik periklanan terperinci yang mungkin diminati pengunjung halaman saat ini. Topik dapat melengkapi informasi kontekstual tentang halaman saat ini, dan dapat berguna untuk mendukung iklan berbasis minat.
Eksperimen Topics API tersedia untuk partner RTB dalam permintaan bid. Topik dikirim ke semua partner RTB berdasarkan ketersediaan.
Representasi permintaan bid
Protokol OpenRTB
Topik ditampilkan sebagai segmen dalam pesan OpenRTB.BidRequest.user.data
| Kolom | Jenis | Deskripsi |
|---|---|---|
Data.ext.segtax
|
Bilangan bulat | ID untuk taksonomi yang didaftarkan secara terpusat. Untuk Topik, ini adalah versi taksonomi iklan yang menentukan makna semantik setiap ID topik. 600 digunakan untuk taksonomi awal Topics Chrome. |
Data.ext.segclass
|
String | Setara dengan classifier_version.
|
Data.segment.id
|
String | Setara dengan id yang di-casting ke string.
|
Data.ext adalah ekstensi untuk pesan BidRequest.user.data. Ekstensi ini tersedia di versi beta terbuka protokol.
Berikut definisinya:
// 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;
}
Protokol Google RTB (tidak digunakan lagi)
Topik direpresentasikan di kolom topics dalam pesan BidRequest. Kolom ini tersedia di versi beta terbuka protokol.
Berikut definisinya:
// 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;
Contoh
Berikut adalah contoh cara protokol Google Authorized Buyers dan OpenRTB merepresentasikan topik yang ditampilkan oleh Chrome Topics API.
Respons Chrome Topics API, yang ditampilkan oleh document.browsingTopics():
[
{
"modelVersion": "classifier_v1",
"taxonomyVersion": "taxonomy_v1",
"topic": 3
},
{
"modelVersion": "classifier_v1",
"taxonomyVersion": "taxonomy_v1",
"topic": 44
},
{
"modelVersion": "classifier_v1",
"taxonomyVersion": "taxonomy_v1",
"topic": 59
}
]
OpenRTB BidRequest:
{
"user": {
"data": [
{
"ext": {
"segtax": 600,
"segclass": "classifier_v1"
},
"segment": [
{ "id": "3" },
{ "id": "44" },
{ "id": "59" }
]
}
]
}
}
Protokol Google RTB (tidak digunakan lagi) 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"
}
Dalam contoh Chrome Topics API di atas, taxonomy_version menyiratkan bahwa
pemetaan taxonomy_v1
digunakan. Berdasarkan taksonomi, ID topik ini sesuai dengan topik berikut:
| ID Topik | Nilai Topik |
|---|---|
| 3 | /Arts & Entertainment/Comics |
| 44 | /Arts & Entertainment/Opera |
| 59 | /Mobil & Kendaraan/Kendaraan Klasik |
Ketersediaan
Keberadaan topik dalam permintaan bid tunduk pada perlindungan dan kontrol privasi yang ada. Misalnya, topik tidak tersedia jika pengguna memilih untuk menonaktifkan iklan yang dipersonalisasi atau di inventaris iklan yang tidak dipersonalisasi.