Minimum kurulumla, konuların ana makine adlarına göre nasıl tahmin edildiğini öğrenin ve denemeler yapın.
Uygulama durumu
- Topics API 已完成公开讨论阶段,目前可供 99% 的用户使用,扩容到可以达到 100%。
- 如需提供关于 Topics API 的反馈,请在 Topics 铺垫消息中创建一个问题,或参与改进网络广告业务群组中的讨论。解释器中有一些尚未解决的问题,但仍需进一步定义。
- Privacy Sandbox 时间表提供了 Topics API 和其他 Privacy Sandbox 提案的实现时间表。
- Topics API:最新更新详细介绍了 Topics API 和实现的相关变更和增强功能。
Topics API demosu, konuların ana makine adlarından nasıl tahmin edildiğine dair bir bakış sağlar. Çok az kurulum gerektiren bir demo siteyi ziyaret ettiğinizde hangi konuların gözlemlendiğini önizleyebilirsiniz.
Demomuz, API'nin nasıl uygulandığıyla ilgili bilgi edinmeniz için Topics API'nin çoğu özelliğini gösteren bir önizlemedir.
Topics sınıflandırıcı modelini denemek için Topics colab'ini de çalıştırabilirsiniz.
Aşağıdaki videoda demonun işleyiş şekli gösterilmektedir.
chrome://flags veya özellik bayraklarıyla test edin
Topics API'yi tek bir kullanıcı olarak denemenin iki yolu vardır: Chrome 101 veya sonraki bir sürümü çalıştırıyor olmanız gerekir:
chrome://settings/adPrivacy
altındaki tüm reklam gizliliği API'lerini etkinleştirin.Chrome'u aşağıdaki işaretlerle komut satırından çalıştırın:
--enable-features=BrowsingTopics,BrowsingTopicsParameters:time_period_per_epoch/15s/browsing_topics_max_epoch_introduction_delay/3s,PrivacySandboxAdsAPIsOverride,PrivacySandboxSettings3,OverridePrivacySandboxSettingsLocalTesting
Topics API demosu
Konular demosu, dönem uzunluğu gibi ayarları düzenlemek için ek işaretlerin nasıl kullanılacağını gösterir. Topics API'ye Chrome'u komut satırı işaretleriyle çalıştırarak erişiyorsanız chrome://flags
özelliğini ayarlamayın. Aksi takdirde bu ayarlar, komut satırı ayarlarını geçersiz kılabilir.
Chromium'u işaretlerle çalıştırma başlıklı makalede, Chrome ve diğer Chromium tabanlı tarayıcıları komut satırından çalıştırırken işaretlerin nasıl ayarlanacağı açıklanmaktadır. Ancak, bu demo Google Chrome'a özeldir.
Topics API başlıkları demosu
topics-fetch-demo.glitch.me adresindeki demoda, konulara erişmek ve bunları gözlemlendi olarak işaretlemek için fetch()
istek ve yanıt başlıklarının nasıl kullanılacağı gösterilmektedir.
Sec-Browsing-Topics
istek başlığına erişim
Bir kullanıcıya ait konuları görüntülemek için iFrame'den document.browsingTopics()
kullanmak yerine API çağrılarını yapan kişiler, gözlemlenen konulara seçenekler parametresinde {browsingTopics: true}
içeren fetch() isteğinin Sec-Browsing-Topics
istek başlığından veya deprecatedBrowsingTopics
özelliğini true
olarak ayarlayan XHR isteğinin aynı başlığından erişebilir.
Örneğin:
fetch('https://topics-server.glitch.me', {browsingTopics: true})
.then((response) => {
// Process the response
})
API'yi destekleyen tarayıcılarda fetch()
isteği, istek URL'si ana makine adı için gözlemlenen konuları listeleyen bir Sec-Browsing-Topics
başlığı içerir: bu örnekte topics-server.glitch.me
.
Bu ana makine adı ve bu kullanıcı için herhangi bir konu gözlemlenmemişse başlık dahil edilir ancak değer boş olur. Diğer bir deyişle, bir fetch()
isteğindeki Sec-Browsing-Topics
başlığı yalnızca kaynağı istek URL'sinin ana makine adıyla eşleşen bir arayan tarafından mevcut kullanıcının tarayıcısı için gözlemlenen konuları içerir. Bu, geçerli kullanıcı için gözlemlenen konuları görüntülemek için bir iframe'den document.browsingTopics()
çağrısı yapmakla aynıdır.
Uygun izin politikasına sahip olduğu, bağlamın güvenli olduğu ve kullanıcı ayarlarının izin verdiği durumlarda istek başlığı ile gönderilir. Gezinme istekleri için başlıklarda konular sağlanmaz.
Topics istek başlığı aşağıdaki gibi görünür:
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"
Bu örnekte Topics sınıflandırması'ndan iki konu (186 ve 265) ve her konunun sürüm bilgileri yer almaktadır.
XHR isteklerine konular başlığı yalnızca geçici olarak dahil edilebilir ve gelecekte destek kaldırılacaktır.
Observe-Browsing-Topics
ile konuları gözlemlendi olarak işaretleyin
Bir istek Sec-Browsing-Topics
üstbilgisi içeriyorsa ve bu isteğin yanıtı Observe-Browsing-Topics: ?1
üstbilgisi içeriyorsa istek başlığındaki konular tarayıcı tarafından gözlemlendi olarak işaretlenir. Gözlemlenen konular Topics API tarafından hesaplanmaya uygundur. Bu mekanizma, bir iframe'den JavaScript API kullanılarak sağlanan işlevlere uyacak şekilde tasarlanmıştır.
Aşağıdaki ekran görüntüsünde, API demo sayfasındaki siteleri ziyaret ederken kaydedilen konular gösterilmektedir.
![glitch.me'deki Topics API demo sayfası](https://developers.google.cn/static/privacy-sandbox/assets/images/topics-api-demo-page-gli-1a52a773264c2.png?authuser=6&hl=tr)
Bu listede, ilgilendiğiniz konuları kaydetmek için demodan ziyaret edebileceğiniz siteler gösterilir. Gördüğünüz gibi, ekran görüntüsündeki Sanat ve Eğlence/Mizah kategorisi bu web sitelerinden birinin konusu olmadığından, kaydedilen bu konu olası yüzde 5 rastgele konular olarak eklenmiş bir konudur.
- 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
sayfasının Konu Durumu sekmesinde hangi konuların gerçek, hangilerinin rastgele olduğunu görebilirsiniz. Bu ekran görüntüsünde farklı tarama oturumlarından bir örnek gösterilmektedir.
![Konular durum sekmesi, gözlemlenen konularla ilgili bilgi sağlar.](https://developers.google.cn/static/privacy-sandbox/assets/images/the-topics-state-tab-prov-4a016e2640bad.png?authuser=6&hl=tr)
Sonraki adımlar
Reklam teknolojisi geliştiricisiyseniz Topics API ile denemeler yapın ve katılın. Daha ayrıntılı kaynaklar için geliştirici kılavuzunu okuyun.
互动和分享反馈
- GitHub:阅读 Topics API 说明,以及在 API 代码库中提出问题和关注相关问题的讨论。
- W3C:在 Improving Web Advertising Business Group(改进网络广告业务小组)中讨论行业用例。
- 通告:加入或查看邮寄名单。
- Privacy Sandbox 开发者支持:在 Privacy Sandbox 开发者支持代码库中提问并加入讨论。
- Chromium:提交 Chromium 错误,以询问有关目前可在 Chrome 中测试的实现的问题。