Topics API ile ortamınızı web uygulamalarını kullanıma, test etmeye ve geliştirmeye hazır hale getirin.
Yerel olarak derleme ve test etme
Bu bölümde, Topics API'yi bireysel bir geliştirici olarak denemek için yerel ortamınızı nasıl ayarlayacağınız açıklanmaktadır. Uygulamaya geçmeden önce Topics'in işleyiş şeklini anlamak için demoları incelemenizi öneririz.
Tarayıcınızda Topics'i etkinleştirin
Kendi Chrome örneğinizde Topics API'yi yerel test için etkinleştirmek üzere iki seçeneğiniz vardır:
chrome://settings/adPrivacyaltındaki tüm reklam gizliliği API'lerini etkinleştirin.- (Önerilir) Chrome'u, gerektiği gibi yapılandırmak için Topics API'ye özgü parametreleri kullanarak Chromium işaretleriyle komut satırından çalıştırın. Chrome'u komut satırından çalıştırarak Topics özellikleri üzerinde daha ayrıntılı kontrol sahibi olabilirsiniz. Örneğin, Topics dönemleri (API'nin kullanıcı ilgi alanlarını hesaplamak için kullandığı zaman aralığı) ayarlamak ve API'nin davranışını ihtiyaçlarınıza göre yapılandırmak mümkündür.
Önemli öneriler
- İşaretleri kullanarak yenisini başlatmadan önce tüm Chrome işlemlerini kapattığınızdan ve durdurduğunuzdan emin olun.
chrome://settings/adPrivacyaltında tüm reklam gizliliği API'lerinin etkinleştirildiğinden emin olun.- API beklendiği gibi çalışmıyorsa sorun giderme ipuçlarımızı deneyin.
- Sorularınız varsa açıklayıcı makale için GitHub sorunlarını inceleyin.
Chrome flag'leriyle Topics API'yi kontrol etme
Chrome flag'leri, Topics API'nin davranışını değiştirebilir. Testi kolaylaştırmak için Chrome'u komut satırından belirtilen parametrelerle ç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 etkinleştirir: İlişkilendirme Raporlaması, Protected Audience, Topics, Çitli Çerçeveler. |
PrivacySandboxSettings4 |
devre dışı | Özel Korumalı Alan kullanıcı arayüzü ayarlarının dördüncü sürümünü etkinleştirir. |
OverridePrivacySandboxSettingsLocalTesting |
etkin | Bu ayar etkinleştirilirse tarayıcı, Özel Korumalı Alan özelliklerini etkinleştirmek için temel ayarların etkinleştirilmesini artık gerektirmez. |
BrowsingTopicsBypassIPIsPubliclyRoutableCheck |
devre dışı | Bu ayar etkinleştirilirse bir sayfanın konu hesaplamasına dahil edilmeye uygun olup olmadığı belirlenirken IP adresinin herkese açık şekilde yönlendirilebilir olup olmadığını kontrol etme adımı atlanır. |
BrowsingTopics:number_of_epochs_to_expose |
3 | İstekte bulunulan bağlama verilecek konuların hesaplanacağı dönem sayısı. Tarayıcı dahili olarak N+1 dönemlerine kadar izlemeye devam eder. |
BrowsingTopics:time_period_per_epoch |
7g-0sa-0dk-0 sn. | Her dönemin süresi. Hata ayıklama için bu değeri varsayılan yedi gün yerine 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 sınıflandırmasından rastgele döndürülme olasılığı. Rastgelelik, bir döneme ve siteye bağlıdır. |
BrowsingTopics:number_of_epochs_of_observation_data_to_use_for_filtering |
3 | Bir çağrı bağlamındaki konuları filtrelemek için kaç API kullanım verisi döneminin (ör. konu gözlemleri) kullanılacağı. |
BrowsingTopics:max_number_of_api_usage_context_domains_to_keep_per_topic |
1000 | Her bir üst konu için saklanacak 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 sorgu için veritabanından alınmasına izin verilen maksimum giriş sayısı. Sorgu, konular hesaplanırken her dönem için 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 adı 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. config_version güncellenmeden yapılandırma parametrelerinin güncellenmesi 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 güncellendiğinde). |
BrowsingTopics:taxonomy_version |
1 | API tarafından kullanılan sınıflandırma sürümü. |
Uygulamaya başlamadan önce
Uygulamaya başlamadan önce Topics API hakkında bilgi edinmek için bu kaynakları gözden geçirmenizi öneririz.
- Geliştirici belgelerini inceleyin:
- Topics API'nin amacını ve ilgi alanına dayalı reklamcılıktaki rolünü anlama
- Web'de Topics'in işleyiş şeklini anlayın.
- Demoları deneyin ve Topics demolarını, colab ve araçlar rehberli tur videosunu izleyin.
- Demoları çatallayın ve kendi sitenizden çalıştırın.
- Ayrıntıları daha iyi anlamak için API açıklamasını okuyun.
- Üçüncü taraf çerezlerinin artan bir kullanıcı oranı için kullanılamayacak olduğu gelecekte API'nin reklam alaka düzeyini destekleme konusundaki rolünü anlayın.
- API'deki durum değişikliklerinden haberdar olmak için geliştiricilere yönelik posta listesine katılın ve Topics'teki en son güncellemeleri takip edin.
- GitHub sorunları veya W3C çağrıları ile ilgili sohbete katkıda bulunun.
- Bilmediğiniz terimlerle karşılaşırsanız Özel Korumalı Alan sözlüğünü inceleyin.
- Chrome işaretleri gibi Chrome kavramları hakkında daha fazla bilgi için goo.gle/cc adresindeki kısa videoları ve makaleleri inceleyin.
Sonraki adımlar
Konuları uygulama
Aracıların konuları gözlemlemesi ve erişmesi için uygulama ayrıntılarına ve kod örneklerine göz atın.
Test etme ve yayınlama
Topics tabanlı çözümleri nasıl dağıtacağınızı, test edeceğinizi ve ölçeklendireceğinizi öğrenin.