به عنوان بخشی از Privacy Sandbox ، کروم API آزمایشی Topics را پیشنهاد داد. API Topics به تماسگیرندگان شخص ثالث در صفحه وب (از جمله ارائهدهندگان فناوری تبلیغات) موضوعات تبلیغاتی جزئی را ارائه میدهد که ممکن است بازدیدکننده صفحه در حال حاضر به آنها علاقهمند باشد. این موضوعات میتوانند اطلاعات زمینهای در مورد صفحه فعلی را تکمیل کنند و برای پشتیبانی از تبلیغات مبتنی بر علاقه مفید باشند.
آزمایش API موضوعات برای شرکای RTB در درخواستهای پیشنهاد قیمت در دسترس است. موضوعات بر اساس در دسترس بودن برای همه شرکای RTB ارسال میشوند.
درخواست نمایندگی مناقصه
پروتکل OpenRTB
موضوعات به صورت بخشهایی در پیام OpenRTB BidRequest.user.data نمایش داده میشوند.
| میدان | نوع | توضیحات |
|---|---|---|
Data.ext.segtax | عدد صحیح | شناسهی یک طبقهبندی که به صورت مرکزی ثبت شده است. برای موضوعات، این نسخه از طبقهبندی تبلیغات است که معنای معنایی هر شناسهی موضوع را تعریف میکند. عدد ۶۰۰ برای طبقهبندی اولیهی موضوعات کروم استفاده میشود. |
Data.ext.segclass | رشته | معادل classifier_version است. |
Data.segment.id | رشته | معادل تبدیل 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;
}
پروتکل RTB گوگل (منسوخ شده)
موضوعات در فیلد topics در پیام BidRequest نمایش داده میشوند. این فیلد در نسخه بتای عمومی پروتکل موجود است.
تعریفش اینه:
// 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;
مثالها
در ادامه مثالی از نحوه نمایش موضوعات برگردانده شده توسط Chrome Topics API توسط خریداران مجاز گوگل و پروتکلهای OpenRTB ارائه شده است.
پاسخ API مربوط به Topics کروم، که توسط 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" }
]
}
]
}
}
پروتکل Google RTB (منسوخ شده) 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"
}
در مثال API مربوط به موضوعات کروم که در بالا ذکر شد، taxonomy_version نشان میدهد که از نگاشت taxonomy_v1 استفاده شده است. بر اساس طبقهبندی، این شناسههای موضوع با موضوعات زیر مطابقت دارند:
| شناسه موضوع | ارزش موضوع |
|---|---|
| ۳ | /هنر و سرگرمی/کمیک |
| ۴۴ | /هنر و سرگرمی/اپرا |
| ۵۹ | /خودروها و وسایل نقلیه/وسایل نقلیه کلاسیک |
در دسترس بودن
وجود موضوعات در درخواست پیشنهاد منوط به حفاظتها و کنترلهای حریم خصوصی موجود است. به عنوان مثال، اگر کاربر از تبلیغات شخصیسازیشده یا فهرست تبلیغات غیرشخصیشده انصراف دهد، موضوعات در دسترس نیستند.