Topics API demoları

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ı
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, 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.
Gerçek ve rastgele konuları gösteren Konu Durumu sekmesi.

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