Topics API kurulumu

Topics API ile web uygulamalarını kullanmak, test etmek ve geliştirmek için ortamınızı hazırlayın.

Yerel olarak derleme ve test etme

Bu bölümde, Topics API'yi bağımsız bir geliştirici olarak denemek için yerel ortamınızı nasıl ayarlayacağınız açıklanmaktadır. Uygulamaya başlamadan önce Topics'in nasıl çalıştığını anlamak için demoları incelemenizi öneririz.

Tarayıcınızda Topics'i etkinleştirme

Yerel test için kendi Chrome örneğinizde Topics API'yi etkinleştirmek üzere iki seçeneğiniz vardır:

  1. chrome://settings/adPrivacy bölümündeki tüm reklam gizliliği API'lerini etkinleştirin.
  2. (Önerilir) İhtiyacınıza göre yapılandırmak için Topics API'ye özgü parametreler kullanarak Chromium işaretleriyle Chrome'u komut satırından çalıştırın. Chrome'u komut satırından çalıştırarak Konular özelliklerini daha ayrıntılı bir şekilde kontrol edebilirsiniz. Örneğin, Topics dönemlerini (API'nin kullanıcı ilgi alanlarını hesaplamak için kullandığı zaman aralığı) ayarlayabilir ve API'nin davranışını ihtiyaçlarınıza göre yapılandırabilirsiniz.

Önemli öneriler

  1. İşaretleri kullanarak yeni bir işlem başlatmadan önce tüm Chrome işlemlerini kapatıp durdurduğunuzdan emin olun.
  2. chrome://settings/adPrivacy bölümünde tüm reklam gizliliği API'lerinin etkinleştirildiğinden emin olun.
  3. API beklendiği gibi çalışmıyorsa sorun giderme ipuçlarımızı deneyin.
  4. Sorularınız varsa açıklayıcıyla ilgili GitHub sorunlarına göz atın.

Chrome flag'leriyle Topics API'yi kontrol etme

Chrome bayrakları, Topics API'nin davranışını değiştirebilir. Testi kolaylaştırmak için belirtilen parametrelerle Chrome'u komut satırından çalıştırın. Örneğin, başlıklar demosu aşağıdaki işaretlerin kullanılmasını önerir:

--enable-features=BrowsingTopics,BrowsingTopicsParameters:time_period_per_epoch/15s/max_epoch_introduction_delay/3s,PrivacySandboxAdsAPIsOverride,PrivacySandboxSettings3,OverridePrivacySandboxSettingsLocalTesting

Aşağıdaki tabloda her bir parametre, varsayılan değeri ve amacı açıklanmaktadır.

İşaret adı Varsayılan değer Açıklama
BrowsingTopics etkin Topics API'nin etkin olup olmadığı.
PrivacySandboxAdsAPIsOverride etkin Reklam API'lerini (Attribution Reporting, Protected Audience, Topics, Fenced Frames) etkinleştirir.
PrivacySandboxSettings4 devre dışı Privacy Sandbox kullanıcı arayüzü ayarlarının dördüncü sürümünü etkinleştirir.
OverridePrivacySandboxSettingsLocalTesting etkin Etkinleştirilirse tarayıcı, Özel Korumalı Alan özelliklerinin etkinleştirilmesi için temel ayarların etkinleştirilmesini gerektirmez.
BrowsingTopicsBypassIPIsPubliclyRoutableCheck devre dışı Etkinleştirilirse bir sayfanın konular hesaplamasına dahil edilmeye uygun olup olmadığını belirlerken IP adresinin herkese açık şekilde yönlendirilebilir olup olmadığı kontrolü atlanır.
BrowsingTopics:number_of_epochs_to_expose 3 İstek gönderen bir bağlama verilecek konuların hesaplanacağı dönem sayısı. Tarayıcı, dahili olarak N+1 döneme kadar saklar.
BrowsingTopics:time_period_per_epoch 7d-0h-0m-0s Her dönemin süresi. Hata ayıklama için bu değeri varsayılan yedi gün yerine (örneğin) 15 saniye olarak ayarlamak yararlı olabilir.
BrowsingTopics:number_of_top_topics_per_epoch 5 Dönem başına hesaplanan konu sayısı.
BrowsingTopics:use_random_topic_probability_percent 5 Bir dönemdeki tek bir konunun, tüm konu taksonomisinden rastgele döndürülen bir konu olma olasılığı. Rastgelelik, bir dönem ve site için geçerlidir.
BrowsingTopics:number_of_epochs_of_observation_data_to_use_for_filtering 3 Bir çağırma bağlamı için konuları filtrelemek üzere kaç dönem API kullanım verisi (ör. konu gözlemleri) kullanılacak?
BrowsingTopics:max_number_of_api_usage_context_domains_to_keep_per_topic 1000 Her bir üst konu için tutulacak maksimum gözlemlenen bağlam alan sayısı. Amaç, kullanılan belleği sınırlamaktır.
BrowsingTopics:max_number_of_api_usage_context_entries_to_load_per_epoch 100.000 API kullanım bağlamları için her sorguda veritabanından alınmasına izin verilen maksimum giriş sayısı. Sorgu, konuların hesaplanma zamanında dönem başına bir kez gerçekleşir. Amaç, en yüksek bellek kullanımını sınırlamaktır.
BrowsingTopics:max_number_of_api_usage_context_domains_to_store_per_page_load 30 Sayfa yükleme başına depolanmasına izin verilen maksimum API kullanım bağlamı alanı sayısı.
BrowsingTopics:config_version 1 Topics API yapılandırma parametrelerini kodlar. Her sürüm numarası yalnızca bir yapılandırma grubuyla eşlenmelidir. Yapılandırma parametrelerini config_version'yı güncellemeden değiştirmek genellikle yerel test için sorun oluşturmaz ancak bazı durumlarda tarayıcıyı tutarsız bir durumda bırakabilir ve tarayıcının kilitlenmesine neden olabilir (ör. number_of_top_topics_per_epoch'yı güncelleme).
BrowsingTopics:taxonomy_version 1 API tarafından kullanılan sınıflandırma sürümü.

Uygulamaya başlamadan önce

Uygulamanıza başlamadan önce Topics API hakkında bilgi edinmek için bu kaynakları incelemenizi öneririz.

  1. Geliştirici belgelerini inceleyin:
    1. Topics API'nin amacını ve ilgi alanına dayalı reklamcılıktaki rolünü anlama
    2. Web'de Topics'in işleyiş şeklini öğrenin.
    3. Demoları deneyin ve Topics demoları, Colab ve araçlar rehber videosunu izleyin.
    4. Demoları çatallayın ve kendi sitenizden çalıştırın.
    5. Daha fazla ayrıntı için API açıklamasını okuyun.
  2. Gelecekte üçüncü taraf çerezlerinin kullanıcıların artan bir bölümü için kullanılamayacağı durumda API'nin reklam alaka düzeyini desteklemedeki rolünü anlayın.
  3. API'deki durum değişikliklerinden haberdar olmak için geliştiricilere yönelik posta listesine katılın ve en son Topics güncellemelerini takip edin.
  4. GitHub sorunları veya W3C görüşmelerinde sohbete katılın.
  5. Bilmediğiniz terimlerle karşılaşırsanız Özel Korumalı Alan sözlüğünü inceleyin.
  6. Chrome flag'leri gibi Chrome kavramları hakkında daha fazla bilgi edinmek için goo.gle/cc adresindeki kısa videoları ve makaleleri inceleyin.

Sonraki adımlar

Aracıların konuları gözlemlemesi ve erişmesi için uygulama ayrıntılarına ve kod örneklerine göz atın.
Topics tabanlı çözümleri nasıl dağıtacağınızı, test edeceğinizi ve ölçeklendireceğinizi öğrenin.