Minimum kurulumla, konuların ana makine adlarına göre nasıl tahmin edildiğini öğrenin ve denemeler yapın.
Uygulama durumu
- Herkese açık tartışma aşamasını tamamlayan Topics API, şu anda kullanıcıların %99'unun kullanımına sunulmuştur ve ölçeği %100'e kadar çıkmaktadır.
- Topics API hakkında geri bildirimde bulunmak için Topics açıklayıcı'da bir sorun oluşturun veya Web Advertising Business Group'u (Web Reklamcılığını İyileştirme İşletme Grubu) tartışmalarına katılın. Açıklayıcıda hâlâ daha ayrıntılı tanımlama gereken birkaç açık soru vardır.
- Özel Korumalı Alan zaman çizelgesi, Topics API ve diğer Özel Korumalı Alan teklifleri için uygulama zaman çizelgeleri sağlar.
- Topics API: son güncellemeler Topics API ve uygulamalarla ilgili değişiklikler ve geliştirmeleri ayrıntılarıyla açıklar.
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=5&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=5&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.
Etkileşimde bulunun ve geri bildirim paylaşın
- GitHub: Topics API açıklamasını okuyun ve API deposundaki soruları sorun ve tartışmaları takip edin.
- W3C: Web Reklamcılığı İş Grubunu İyileştirme bölümünde sektördeki kullanım alanlarını tartışın.
- Duyurular: Posta listesine katılın veya listeyi görüntüleyin.
- Özel Korumalı Alan geliştirici desteği: Özel Korumalı Alan Geliştirici Desteği deposunda sorular sorun ve tartışmalara katılın.
- Chromium: Chrome'da şu anda test edilmek üzere kullanılabilen uygulama hakkında soru sormak için Chromium hatası bildiriminde bulunun.