Sebagai bagian dari Privacy Sandbox, Chrome mengusulkan Topics API eksperimental. Topics API menyediakan pemanggil pihak ketiga di halaman web (termasuk penyedia teknologi iklan) dengan topik iklan samar yang mungkin saat ini diminati pengunjung halaman. Topik tersebut dapat melengkapi informasi kontekstual tentang halaman saat ini, dan dapat berguna untuk mendukung periklanan menurut minat.
Eksperimen Topics API tersedia untuk partner RTB dalam permintaan bid. Isi formulir permintaan untuk bergabung dengan eksperimen Topics API. Hubungi Account Manager Anda untuk mendapatkan informasi selengkapnya.
Representasi permintaan bid
Protokol Authorized Buyers Google
Topik direpresentasikan dalam kolom topics
dalam pesan BidRequest
. Kolom ini tersedia dalam protokol versi beta terbuka.
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;
Protokol OpenRTB
Topik direpresentasikan sebagai segmen dalam pesan BidRequest.user.data
OpenRTB.
Kolom | Jenis | Deskripsi |
---|---|---|
Data.ext.segtax
|
Bilangan Bulat | ID untuk taksonomi yang terdaftar secara terpusat. Untuk Topics, 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 ditransmisikan ke string.
|
Data.ext
adalah ekstensi untuk pesan BidRequest.user.data
. Ekstensi ini tersedia dalam protokol versi beta terbuka.
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;
}
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
}
]
Protokol BidRequest protokol Authorized Buyers Google:
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 BidRequest:
{
"user": {
"data": [
{
"ext": {
"segtax": 600,
"segclass": "classifier_v1"
},
"segment": [
{ "id": "3" },
{ "id": "44" },
{ "id": "59" }
]
}
]
}
}
Dalam contoh sebelumnya, taxonomy_version
menyiratkan bahwa
pemetaan taxonomy_v1
digunakan. Berdasarkan taksonomi, ID topik ini sesuai dengan topik
berikut:
ID Topik | Nilai Topik |
---|---|
3 | /Kesenian & Hiburan/Komik |
44 | /Kesenian & Hiburan/Opera |
59 | /Mobil & Kendaraan/Kendaraan Klasik |
Ketersediaan
Keberadaan topik dalam permintaan bid tunduk pada perlindungan dan kontrol privasi yang sudah ada. Misalnya, topik tidak tersedia jika pengguna memilih tidak mengikuti iklan yang dipersonalisasi atau pada inventaris iklan yang tidak dipersonalisasi.