Topics API demoları

Konuların, çok az kurulum işlemi ile ana makine adlarından nasıl tahmin edildiğini öğ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.

Topics API demosu, konuların ana makine adlarından nasıl çıkarıldığına dair bir bakış sunar. Demo sitelerini ziyaret ettiğinizde hangi konuların gözlemlendiğini önizleyebilirsiniz. Bu işlem çok az kurulum gerektirir.

Demomuz, API'nın nasıl uygulandığını öğrenmeniz için Topics API'nin çoğu özelliğini gösteren bir önizlemedir.

Konular sınıflandırıcı modelini denemek için Konular 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 daha yeni bir sürüm kullanmanız gerekir:

  • chrome://flags/#privacy-sandbox-ads-apis Chrome sayfasından API'yi etkinleştirin:

    chrome://flags/#privacy-sandbox-ads-apis sayfasını kullanarak Topics API'yi etkinleştirin
    API'yi etkinleştirebileceğiniz veya devre dışı bırakabileceğiniz chrome://flags/#privacy-sandbox-ads-apis sayfası.

  • Chrome'u aşağıdaki işaretlere sahip 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. Chrome'u komut satırı işaretleriyle çalıştırarak Topics API'ye erişiyorsanız chrome://flags değerini ayarlamayın. Bu değerler komut satırı ayarlarını geçersiz kılabilir.

Bu demo Google Chrome'a özel olsa da, Chromium'u bayraklarla çalıştır'da, Chrome ve diğer Chromium tabanlı tarayıcılar çalıştırılırken komut satırından işaretlerin nasıl ayarlanacağı açıklanmaktadır.

Topics API başlıkları demosu

topics-fetch-demo.glitch.me adresindeki demo, 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ğını gösterir.

Sec-Browsing-Topics istek başlığına erişme

API çağrıları, bir kullanıcının konularını görüntülemek için bir iframe'den document.browsingTopics() kullanmak yerine, gözlemlenen konulara, seçenekler parametresinde {browsingTopics: true} içeren bir fetch() isteğinin Sec-Browsing-Topics istek başlığından veya deprecatedBrowsingTopics özelliğini true olarak ayarlayan bir 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 üstbilgisi 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 eklenir ancak değer boş olur. Diğer bir deyişle, fetch() isteğindeki Sec-Browsing-Topics üstbilgisi yalnızca, kaynağı istek URL'sinin ana makine adıyla eşleşen bir arayan tarafından geçerli kullanıcının tarayıcısında gözlemlenen konuları içerir. Bu işlem, geçerli kullanıcı için gözlemlenen konuları görüntülemek üzere bir iframe'den document.browsingTopics() çağrısıyla aynıdır.

İstek başlığı; uygun izin politikasının geçerli olması, bağlamın güvenli olması ve kullanıcı ayarlarının buna izin vermesi durumunda gönderilir. Gezinme isteklerinin başlıklarda konuları sağlanmaz.

Konular isteğinin başlığı şöyle 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 her konunun sürüm bilgisiyle birlikte Topics taksonomisi, 186 ve 265'ten iki konu bulunmaktadır.

Konular başlığının XHR isteklerine eklenmesi yalnızca geçici olarak mevcuttur ve ileride destek kaldırılacaktır.

Konuları Observe-Browsing-Topics ile gözlemlendi olarak işaretleyin

İstek bir Sec-Browsing-Topics başlığı içeriyorsa ve bu isteğe verilen yanıt Observe-Browsing-Topics: ?1 başlığı içeriyorsa istek başlığındaki konular tarayıcı tarafından gözlemlenmiş olarak işaretlenir. Gözlemlenen konular Topics API tarafından hesaplanmaya uygundur. Bu mekanizma, bir iframe'den JavaScript API'sı kullanılarak sağlanan işlevle eşleşecek şekilde tasarlanmıştır.

Aşağıdaki ekran görüntüsünde, API demo sayfasındaki sitelerin ziyaretlerinden kaydedilen konular gösterilmektedir.

glitch.me adresindeki Topics API demo sayfası
API'yi denemek için glitch.me demosu.

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 kaydedilmiş konu, olası yüzde 5 rastgele konu 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ındaki Konular Durumu sekmesinden hangi konuların gerçek, hangilerinin rastgele olduğunu görebilirsiniz. Bu ekran görüntüsünde, farklı göz atma oturumlarından bir örnek gösterilmektedir.

Konular durumu sekmesi, gözlemlenen konular hakkında bilgi sağlar.
Gerçek ve rastgele konuların gösterildiği Konular Durumu sekmesi.

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.

Etkileşimde bulunun ve geri bildirim paylaşın