Konuların nasıl tahmin edildiğini, kullanıcıların tarayıcılarına nasıl atandığını ve kullanıcıların konu listelerini nasıl kontrol edebileceklerini öğrenin.
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.
Konu nedir?
Topics API'deki konu, bir kullanıcının ilgilendiği bir konudur ve bu konu, ziyaret ettiği web sitelerine göre kanıtlanır.
Konular, reklam teknolojisi platformlarının alakalı reklamları seçmesine yardımcı olan bir sinyaldir. Üçüncü taraf çerezlerinin aksine bu bilgiler, kullanıcının kendisi veya tarama etkinliği hakkında daha fazla bilgi göstermeden paylaşılır.
Topics API, reklam teknolojisi platformları gibi üçüncü tarafların kullanıcıların ilgi alanlarını gözlemleyip onlara erişmelerini sağlar. Örneğin, API, knitting.example
web sitesini ziyaret eden bir kullanıcı için "Fiber & Textile Arts" konusunu önerebilir.
Topics API tarafından kullanılan konu listesi herkese açıktır, gerçek kişiler tarafından seçilmiştir ve hassas kategorilerden kaçınmak için tasarlanmıştır. Bu, zaman içinde genişletilecek olan mevcut listedir. Liste bir sınıflandırma olarak yapılandırılır. Konular üst düzey veya daha özel olabilir. Örneğin, Food & Drink
, Cooking & Recipes
alt kategorisine sahip geniş bir kategoridir. Alt kategoriler ek alt kategorilere ayrılabilir.
Konuların bu şekilde sınıflandırılması için fayda ile gizlilik arasında bir denge kurulması gerekir. Konular çok spesifikse tek bir kullanıcıyı tanımlamak için kullanılabilirler. Bunlar çok genel olursa reklam veya diğer içeriği seçmek için kullanışlı olmaz.
Konular sınıflandırması, aşağıdaki iki temel gereksinim göz önünde bulundurularak oluşturulur:
- İlgi alanına dayalı reklamcılığı destekleme
- Kullanıcıların güvenliğini sağlayın ve gizliliklerini koruyun
Bu durum, size birkaç soru yöneltebilir. Örneğin:
- API'nin kullanıcının gizliliğini korurken tarama etkinliğine dayalı olarak bir kullanıcının ilgi alanlarını belirlemesinin en iyi yolu nedir?
- Bu sınıflandırma daha kullanışlı hale getirilecek şekilde nasıl yapılandırılabilir?
- Sınıflandırma hangi spesifik öğeleri içermelidir?
API, bir sitenin konularını nasıl tahmin eder?
Konular, web sitesi adlarını sıfır veya daha fazla konuyla eşleyen bir sınıflandırıcı modelinden türetilir. Ek bilgilerin (tam URL'ler veya sayfa içerikleri gibi) analiz edilmesi daha alakalı reklamlara olanak tanısa da gizliliği azaltabilir.
Ana makine adlarını konularla eşlemeye yönelik sınıflandırıcı modeli herkese açık bir şekilde kullanıma sunulmuştur ve açıklayıcıda belirtildiği gibi, bir sitenin konularını tarayıcı geliştirici araçlarıyla görüntülemek mümkündür. Modelin zaman içinde gelişmesi, iyileşmesi ve düzenli aralıklarla güncellenmesi beklenmektedir. Bu durumun sıklığı hâlâ değerlendirilmektedir.
Konu sıklığı hesaplamalarına uygun tarama geçmişine yalnızca Topics API'yi çağıran kod içeren siteler dahil edilir ve API arayanları yalnızca gözlemledikleri konuları alır. Başka bir deyişle, site veya API'yi çağıran yerleşik bir hizmet olmadan konu sıklığı hesaplamaları kullanılamaz.
Ayrıca, arayan kişi yalnızca kullandığı kodun "gördüğü" konuları alabilir. Bu nedenle, başka bir arayanın kodu bir kullanıcının tarayıcısı için, örneğin /Autos & Vehicles/Motor Vehicles (By Type)/Hatchbacks
gibi bir konu kaydettiyse ve kodunuz, bu konunun söz konusu kullanıcının tarayıcısına kaydedilmesine neden olmadıysa, yerleştirilmiş kodunuzdan API'yi çağırdığınızda söz konusu kullanıcının tarayıcısı için söz konusu konuyu öğrenemezsiniz. API artık gözlemlenen üst öğeleri içerdiğinden, yukarıdaki /Autos & Vehicles/Motor Vehicles (By Type)/Hatchbacks
örneğinin de Autos & Vehicles
ve Motor Vehicles
gözlemlenmesine neden olacağını unutmayın.
Kullanıcı için döndürülen konular, arayan için üst düzey siteye bağlı olarak yeniden hesaplanır. Örneğin, adtech.example
kullanıcısı news-a.example
, ardından news-b.example
ve ardından news-c.example
tarihinde kullanıcının konularını isterse onlara döndürülen konular her sitede yeniden hesaplanır. Bu, bir kullanıcı için döndürülen (en fazla) üç konu, son üç dönem için ilk beşten rastgele seçildiğinden (rastgele bir konu edinme olasılığı% 5'tir), bir arayanın farklı üst düzey sitelerdeki kullanıcı için farklı konular alma olasılığının yüksek olduğu anlamına gelir. Bu, farklı üst düzey sitelerde (aynı kullanıcı, arayan ve dönem için bile) farklı olabileceğinden, arayanın bir kullanıcıyı konularına göre tanımlamasını zorlaştırır.
Sınıflandırıcı modeli
Konular,en popüler 50.000 alan için manuel olarak seçilir ve bu seçim, sınıflandırıcıyı eğitmek için kullanılır. Bu liste, Sınıflandırıcı sekmesindeki geçerli model altında chrome://topics-internals/
adresinde bulunan override_list.pb.gz
adresinde bulunabilir. Listedeki alan-konu ilişkilendirmeleri, API tarafından modelin çıktısı yerine kullanılır.
![Sınıflandırıcı panelinin seçili olduğu chrome://topics-internals sayfası.](https://developers.google.cn/static/privacy-sandbox/assets/images/chrometopics-internals-8d62cfff441e4.png?authuser=5&hl=tr)
chrome://topics-internals
sayfası Sınıflandırıcı paneli, model sürümünü, yolunu ve listelenen her bir ana makineyle ilişkili konuları listeler.Modeli doğrudan çalıştırmak için TensorFlow'un model çalıştırma kılavuzuna bakın.
override_list.pb.gz
dosyasını incelemek için önce paketinden çıkarın:
gunzip -c override_list.pb.gz > override_list.pb
Metin olarak incelemek için protoc
kullanın:
protoc --decode_raw < override_list.pb > output.txt
GitHub'da kimlikleri içeren konuların tam bir sınıflandırmasını bulabilirsiniz.
Sınıflandırıcı modeliyle ilgili geri bildirim veya giriş sağlama
Topics API ile ilgili geri bildirim sağlamak için kullanabileceğiniz çeşitli kanallar vardır. Sınıflandırıcı modeliyle ilgili geri bildirim için bir GitHub sorunu göndermenizi veya mevcut bir sorunu yanıtlamanızı öneririz. Örneğin:
- Hangi konu sınıflandırması uzun vadede kullanılmalıdır?
- Bir site atanan konuları kabul etmezse ne olur?
Kullanıcının ilk beş konusu nasıl seçilir?
API, her dönem için en fazla üç konu olacak şekilde bir konu döndürür. Üç sonuç döndürülürse geçerli dönem ve önceki iki dönem için konular dahildir.
- Tarayıcı, her dönemin sonunda aşağıdaki ölçütleri karşılayan sayfaların listesini derler:
- Sayfa, dönem sırasında kullanıcı tarafından ziyaret edildi.
- Sayfa,
document.browsingTopics()
kodunu çağıran kod içeriyor. - API etkinleştirilmiş olmalıdır (örneğin, kullanıcı tarafından veya bir yanıt başlığı aracılığıyla engellenmemiştir).
- Kullanıcının cihazındaki tarayıcı, her sayfanın ana makine adını bir konu listesiyle eşlemek için Topics API tarafından sağlanan sınıflandırıcı modelini kullanır.
- Tarayıcı, konu listesini toplar.
- Tarayıcı, sıklığa göre ilk beş konunun listesini oluşturur.
Daha sonra document.browsingTopics()
yöntemi, her dönem için en iyi beşten rastgele bir konu döndürür. Konuların tam sınıflandırmasından rastgele seçilme olasılığı% 5 olur. Chrome'da kullanıcılar ayrıca, API tarafından döndürülen konuların sayısını azaltmak için tek tek konuları kaldırabilir veya tarama geçmişlerini temizleyebilirler. Kullanıcılar API'yi devre dışı bırakabilir.
chrome://topics-internals
sayfasında, güncel dönemde gözlemlenen konularla ilgili bilgileri görüntüleyebilirsiniz.
API, hangi arayanların hangi konuları göreceğini nasıl belirler?
API arayanları yalnızca yakın zamanda gözlemledikleri konuları alır ve kullanıcı konuları her dönemde bir yenilenir. Bu, API'nin belirli bir arayanın belirli konuları alabileceği bir kayan pencere sağladığı anlamına gelir.
Aşağıdaki tabloda, bir kullanıcı için tek bir dönemdeki varsayımsal tarama geçmişine ilişkin bir örnek (gerçekçi olmayacak kadar küçük olsa da) özetlenmiştir. Örnekte, kullanıcının ziyaret ettiği sitelerle ilişkili konular ve her bir sitede sunulan API arayanları (sitedeki JavaScript kodunda document.browsingTopics()
çağrısı yapan varlıklar) yer almaktadır.
Site | Konular | Sitede API arayanları |
---|---|---|
yoga.example | Fitness | adtech1.example adtech2.example |
knitting.example | El Sanatları | adtech1.example |
yürüyüş-tatil.ornek | Fitness, Seyahat ve Ulaşım | adtech2.example |
diy-giyim.ornek | El Sanatları, Moda ve Stil | [hiçbiri] |
Dönemin sonunda (şu anda bir haftadır) Topics API, tarayıcının hafta boyunca en çok ilgi gören konularını oluşturur.
- adtech1.example, yoga.example ve knitting.example sayfalarında gözlemlediği için artık "Fitness" ve "El Sanatları" konularını almaya uygundur.
- adtech1.example, kullanıcının yakın zamanda ziyaret ettiği ve bu konuyla ilişkili sitelerde yer almadığından, bu kullanıcı için "Seyahat ve Ulaşım" konusunu almaya uygun değildir.
- adtech2.example, "Fitness" ve "Seyahat ve Ulaşım" konularını görmüş ancak "El İşleri" konusunu görmemiştir.
Kullanıcı, "Moda ve Stil " konusunun bulunduğu diy-clothing.example sitesini ziyaret etti ancak bu sitede Topics API'ye çağrı olmadı. Bu noktada "Moda ve Stil" konusunun API tarafından hiçbir arayan için döndürülmeyeceği anlamına gelir.
İkinci haftada, kullanıcı başka bir siteyi ziyaret eder:
Site | Konular | Sitede API arayanları |
---|---|---|
sewing.example | El Sanatları | adtech2.example |
Ayrıca, adtech2.example kodu diy-clothing.example adresine eklenir:
Site | Konular | Sitede API arayanları |
---|---|---|
diy-giyim.ornek | El Sanatları, Moda ve Stil | adtech2.example |
1. haftadaki "Fitness" ve "Seyahat ve Ulaşım" alanlarının yanı sıra bu, adtech2.example'nin artık "El Sanatları" ve "Moda ve Stil" konularını alabileceği anlamına gelir. Ancak bir sonraki dönem olan 3. haftaya kadar bunu alamaz. Bu, üçüncü tarafların bir kullanıcının geçmişi (bu durumda modaya olan ilgi) hakkında, çerezlerden daha fazla bilgi edinememesini sağlar.
İki hafta daha geçtikten sonra kullanıcı, adtech2.example kodlarını içeren ve bu konularla ilgili siteleri ziyaret etmezse "Fitness" ve "Seyahat ve Ulaşım" kategorileri adtech2.example'nin uygun konular listesinden çıkabilir.
Kullanıcı kontrolleri, şeffaflık ve kapsam dışında kalmayı seçme
Kullanıcılar Topics API'nin amacını anlayabilmeli, hakkında söylenenleri anlayabilmeli, API'nin ne zaman kullanıldığını bebilmeli ve API'yi etkinleştirme ya da devre dışı bırakmaya yönelik kontroller sağlanmalıdır.
API'nin kullanıcılar tarafından okunabilir sınıflandırması, kullanıcıların tarayıcıları tarafından önerilebilecek konular hakkında bilgi edinmesini ve bunları kontrol etmesini sağlar. Kullanıcılar, Topics API'nin reklamverenlerle veya yayıncılarla paylaşmasını özellikle istemedikleri konuları kaldırabilir. Kullanıcıyı API hakkında bilgilendirmek ve API'nin nasıl etkinleştirileceğini veya devre dışı bırakılacağını göstermek için kontroller olabilir. Chrome, chrome://settings/adPrivacy
adresinde Topics API ile ilgili bilgi ve ayar sağlar. Ayrıca, konular Gizli modda API arayanları tarafından kullanılamaz ve tarama geçmişi temizlendiğinde konular temizlenir.
Döndürülen konu listesi şu durumlarda boş olur:
- Kullanıcı,
chrome://settings/adPrivacy
adresindeki tarayıcı ayarları üzerinden Topics API'yi devre dışı bırakır. - Kullanıcı konularını temizledi (
chrome://settings/adPrivacy
adresindeki tarayıcı ayarlarından) veya çerezlerini temizledi. - Tarayıcı Gizli modda.
Açıklayıcı, gizlilik hedefleri ve API'nin bunları nasıl ele almaya çalıştığı hakkında daha ayrıntılı bilgi sağlar.
Siteyi devre dışı bırakma
Kullanıcıların bu özelliği devre dışı bırakmasının yanı sıra, sitenizde veya sitenizdeki sayfalarda Topics'i devre dışı bırakabilirsiniz. Bunun nasıl yapılacağı Geliştirici kılavuzunda açıklanmıştır.
prebid.js
içeren web sitelerinde Topics API'yi kullanma
Prebid 7 sürümünde belirtildiği gibi, topluluk, yeni bir modül aracılığıyla Topics API ile etkin bir entegrasyon geliştirdi. Bu modül Aralık 2022'de birleştirildi.
Buradan daha fazla bilgi edinebilirsiniz:
- Prebid'in Topics API modülü dokümanlarını okuyun.
- Daha fazla bilgi için, sundukları standart kanaldan Prebid.js'ye ulaşın.
Sonraki adımlar
- Reklam teknolojisi geliştiricisiyseniz Topics API ile deneme yapın ve katılın.
- Daha ayrıntılı kaynaklar için geliştirici kılavuzunu okuyun.
- Belirli reklam teknolojisi kullanım alanları hakkında ayrıntılı bilgi için Topics API entegrasyon kılavuzuna göz atın.
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.