Sebagai bagian dari Privacy Sandbox, Chrome mengusulkan proposal Topics API. Tujuan Topics API menyediakan pemanggil pihak ketiga di halaman web (termasuk teknologi iklan penyedia) dengan topik iklan terperinci yang mungkin dilihat oleh pengunjung halaman Anda minati. Topiknya dapat melengkapi informasi kontekstual tentang halaman saat ini, dan dapat bermanfaat untuk mendukung layanan periklanan.
Eksperimen Topics API tersedia untuk partner RTB dalam permintaan bid. Topik dikirim ke semua partner RTB berdasarkan availability [ketersediaan].
Representasi permintaan bid
Protokol OpenRTB
Topik ditampilkan sebagai segmen di BidRequest.user.data
OpenRTB
untuk membuat pesan email baru.
Kolom | Jenis | Deskripsi |
---|---|---|
Data.ext.segtax
|
Bilangan Bulat | ID untuk taksonomi yang terdaftar secara terpusat. Untuk Topik, versi ini adalah versi taksonomi iklan yang menentukan makna semantik dari 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 ditransmisikan ke string.
|
Data.ext
adalah ekstensi untuk pesan BidRequest.user.data
. Ekstensi ini
tersedia dalam protokol versi beta terbuka.
Berikut ini 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 ditampilkan di kolom topics
di pesan BidRequest
. Ini
tersedia di protokol versi beta terbuka.
Berikut ini 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 bagaimana Google Authorized Buyers dan OpenRTB yang mewakili 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
}
]
BidRequest
OpenRTB:
{
"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"
}
Pada contoh Chrome Topics API di atas, taxonomy_version
menyiratkan bahwa
pemetaan taksonomi_v1
digunakan. Berdasarkan taksonomi, ID topik ini sesuai dengan
topik:
ID Topik | Nilai Topik |
---|---|
3 | /Seni & Hiburan/Komik |
44 | /Seni & Hiburan/Opera |
59 | /Mobil & Kendaraan/Kendaraan Klasik |
Ketersediaan
Keberadaan topik dalam permintaan bid tunduk kepada privasi yang ada perlindungan dan kontrol. Misalnya, topik tidak tersedia jika pengguna memilih dari iklan yang dipersonalisasi atau pada iklan yang tidak dipersonalisasi inventaris Anda.