آزمایش کنید و بیاموزید که چگونه موضوعات از نام میزبان با حداقل تنظیمات استنتاج می شوند.
وضعیت پیاده سازی
- Topics API مرحله بحث عمومی را تکمیل کرده است و در حال حاضر برای 99 درصد از کاربران در دسترس است و تا 100 درصد مقیاس بندی شده است.
- برای ارائه بازخورد خود در مورد موضوعات API، یک مشکل در توضیح موضوعات ایجاد کنید یا در بحثهای گروه تجاری بهبود وب تبلیغات شرکت کنید. توضیح دهنده تعدادی سؤال باز دارد که هنوز نیاز به تعریف بیشتری دارد.
- جدول زمانی Privacy Sandbox جدول زمانی پیاده سازی را برای Topics API و سایر پیشنهادات Privacy Sandbox ارائه می دهد.
- Topics API: آخرین بهروزرسانیها جزئیات تغییرات و پیشرفتهای Topics API و پیادهسازیها را نشان میدهند.
نسخه ی نمایشی Topics API نگاهی به نحوه استنتاج موضوعات از نام میزبان ارائه می دهد. هنگام بازدید از یک سایت آزمایشی، که به تنظیمات بسیار کمی نیاز دارد، میتوانید پیشنمایش موضوعاتی را مشاهده کنید.
نسخه ی نمایشی ما پیش نمایشی است که اکثر ویژگی های Topics API را نشان می دهد تا شما با نحوه پیاده سازی API آشنا شوید.
همچنین می توانید با اجرای Topics colab مدل طبقه بندی کننده Topics را امتحان کنید.
ویدئوی زیر نحوه عملکرد دمو را نشان می دهد.
با chrome://flags یا پرچم های ویژگی تست کنید
دو راه برای امتحان Topics API به عنوان یک کاربر وجود دارد. باید Chrome 101 یا بالاتر را اجرا کنید:
- همه APIهای حریم خصوصی تبلیغات را در
chrome://settings/adPrivacy
فعال کنید. Chrome را از خط فرمان با پرچم های زیر اجرا کنید:
--enable-features=BrowsingTopics,BrowsingTopicsParameters:time_period_per_epoch/15s/browsing_topics_max_epoch_introduction_delay/3s,PrivacySandboxAdsAPIsOverride,PrivacySandboxSettings3,OverridePrivacySandboxSettingsLocalTesting
نسخه ی نمایشی Topics API
نسخه ی نمایشی Topics نحوه استفاده از پرچم های اضافی برای تنظیم تنظیمات، مانند طول دوره را نشان می دهد. اگر با اجرای Chrome با پرچمهای خط فرمان به Topics API دسترسی پیدا میکنید، chrome://flags
را تنظیم نکنید، زیرا میتوانند تنظیمات خط فرمان را لغو کنند.
اجرای Chromium با پرچمها نحوه تنظیم پرچمها هنگام اجرای Chrome و سایر مرورگرهای مبتنی بر Chromium را از خط فرمان توضیح میدهد، اگرچه این نسخه نمایشی مختص Google Chrome است.
نسخه ی نمایشی هدر Topics API
نسخه نمایشی در topics-fetch-demo.glitch.me نحوه استفاده از fetch()
درخواست و سرصفحه پاسخ برای دسترسی به موضوعات و علامت گذاری آنها به عنوان مشاهده شده را نشان می دهد.
به سربرگ درخواست Sec-Browsing-Topics
دسترسی پیدا کنید
به جای استفاده از document.browsingTopics()
از iframe برای مشاهده موضوعات برای یک کاربر، فراخوانکنندگان API میتوانند از سربرگ درخواست Sec-Browsing-Topics
از یک درخواست fetch که شامل {browsingTopics: true}
در پارامتر گزینههای آن است، به موضوعات مشاهده شده دسترسی داشته باشند. —یا از همان هدر یک درخواست XHR که صفت deprecatedBrowsingTopics
را روی true
تنظیم می کند.
به عنوان مثال:
fetch('https://topics-server.glitch.me', {browsingTopics: true})
.then((response) => {
// Process the response
})
در مرورگرهایی که از API پشتیبانی میکنند، درخواست fetch()
شامل سرصفحه Sec-Browsing-Topics
میشود که موضوعات مشاهدهشده برای نام میزبان URL درخواست را فهرست میکند: در این مثال، topics-server.glitch.me
.
اگر هیچ موضوعی برای این نام میزبان و این کاربر مشاهده نشده باشد، هدر گنجانده شده است اما مقدار آن خالی است. به عبارت دیگر، هدر Sec-Browsing-Topics
در یک درخواست fetch()
فقط شامل موضوعاتی می شود که برای مرورگر کاربر فعلی توسط تماس گیرنده ای که منشاء آن با نام میزبان URL درخواست مطابقت دارد، مشاهده شده است. این همان چیزی است که اگر از یک iframe برای مشاهده موضوعات مشاهده شده برای کاربر فعلی، document.browsingTopics()
را فراخوانی کنید.
سرصفحه درخواست تا زمانی روی یک درخواست ارسال میشود که دارای خطمشی مجوز مناسب باشد، زمینه امن باشد و تنظیمات کاربر اجازه آن را بدهد. موضوعات در سربرگ برای درخواست های ناوبری ارائه نشده است.
سربرگ درخواست Topics به شکل زیر است:
Sec-Browsing-Topics: 186;version="chrome.1:1:2206021246";config_version="chrome.1";model_version="2206021246";taxonomy_version="1", 265;version="chrome.1:1:2206021246";config_version="chrome.1";model_version="2206021246";taxonomy_version="1"
این مثال شامل دو موضوع از طبقه بندی موضوعات ، 186 و 265، به همراه اطلاعات نسخه هر موضوع است.
گنجاندن هدر موضوعات در درخواست های XHR فقط به طور موقت در دسترس است و پشتیبانی در آینده حذف خواهد شد.
موضوعات مشاهده شده را با Observe-Browsing-Topics
علامت گذاری کنید
اگر درخواستی شامل سرصفحه Sec-Browsing-Topics
باشد و پاسخ به آن درخواست شامل سرصفحه Observe-Browsing-Topics: ?1
، آنگاه موضوعات از سرصفحه درخواست توسط مرورگر به صورت مشاهده شده علامت گذاری می شوند. موضوعات مشاهده شده برای محاسبه توسط Topics API واجد شرایط هستند. این مکانیسم برای مطابقت با عملکرد ارائه شده با استفاده از JavaScript API از iframe طراحی شده است.
اسکرین شات زیر موضوعات ضبط شده از بازدید از سایت ها در صفحه نمایشی API را نشان می دهد.
![صفحه نمایشی موضوعات API در glitch.me](https://developers.google.cn/static/privacy-sandbox/assets/images/topics-api-demo-page-gli-1a52a773264c2.png?hl=fa)
این لیست سایت هایی را نشان می دهد که می توانید از نسخه ی نمایشی برای ثبت موضوعات مورد علاقه از آنها بازدید کنید. همانطور که می بینید، دسته Arts & Entertainment/Humor در اسکرین شات موضوع یکی از این وب سایت ها نیست، بنابراین این موضوع ضبط شده یکی از موضوعاتی است که به عنوان موضوعات تصادفی احتمالی 5 درصد اضافه شده است.
- pets-animals-pets-cats.glitch.me
- cats-cats-cats-cats.glitch.me
- cats-pets-animals-pets.glitch.me
- cats-feline-meow-purr-whiskers-pet.glitch.
در برگه وضعیت موضوعات صفحه chrome://topics-internals
می توانید بررسی کنید که ببینید کدام موضوعات واقعی و کدام تصادفی هستند. این اسکرین شات نمونه ای از جلسات مختلف مرور را نشان می دهد.
![برگه وضعیت موضوعات اطلاعاتی در مورد موضوعات مشاهده شده ارائه می دهد.](https://developers.google.cn/static/privacy-sandbox/assets/images/the-topics-state-tab-prov-4a016e2640bad.png?hl=fa)
مراحل بعدی
اگر یک توسعهدهنده فناوری تبلیغات هستید، با Topics API آزمایش کنید و شرکت کنید . برای منابع عمیق تر ، راهنمای توسعه دهنده را بخوانید.
مشارکت کنید و بازخورد را به اشتراک بگذارید
- GitHub : توضیح دهنده Topics API را بخوانید و سوالاتی را مطرح کنید و مباحث مربوط به مخزن API را دنبال کنید .
- W3C : موارد استفاده از صنعت را در گروه تجاری بهبود وب تبلیغاتی مورد بحث قرار دهید.
- اطلاعیه ها : به لیست پستی بپیوندید یا مشاهده کنید .
- پشتیبانی از برنامهنویس Privacy Sandbox : سؤال بپرسید و به بحثهای مربوط به مخزن پشتیبانی توسعهدهنده Privacy Sandbox بپیوندید.
- Chromium : یک اشکال Chromium را بایگانی کنید تا در مورد پیاده سازی که در حال حاضر برای آزمایش در Chrome در دسترس است سؤال بپرسید.