Web'deki Konular için hata ayıklama, sorun giderme ve destek kaynaklarıyla ilgili öneriler
Sorun giderme
Sec-Browsing-Topics
başlığı ayarlanmış bir document.browsingTopics()
çağrısı veya fetch()
isteği yaparsanız ancak yanıt olarak boş bir dizi alırsanız hem yerel geliştirme ortamınızda hem de canlı sistemde sorunun temel nedenini belirlemek için uygulayabileceğiniz çeşitli hata ayıklama adımları vardır.
Yerel olarak hata ayıklama
Yerel olarak test ediyorsanız Chrome'u gerekli parametrelerle çalıştırdığınızdan emin olun.
- Kayıt işlemini atlamak için
chrome://flags/#privacy-sandbox-enrollment-overrides
işaretini etkinleştirin ve Topics'ı çağıran sitenin URL'sini ekleyin. Özellik işaretlerini kullanarak Topics API'yi test için yapılandırın. Bu işaretler, Topics'ı rahatça test edebilmeniz için dönem süresi, en popüler konuların sayısı gibi parametreleri değiştirmenize olanak tanır. Önerilen özellik işaretlerini kullanabilirsiniz:
--enable-features=BrowsingTopics,BrowsingTopicsParameters:time_period_per_epoch/15s/max_epoch_introduction_delay/3s,PrivacySandboxAdsAPIsOverride,PrivacySandboxSettings3,OverridePrivacySandboxSettingsLocalTesting
Chrome'u işaretlerle çalıştırmadan önce diğer tüm Chrome örneklerini ve işlemlerini kapattığınızdan emin olun.
Aşağıdakilerden emin olun:
- Chrome 101 veya sonraki bir sürümü kullanıyorsunuz.
- Komut dosyanız, konuları gözlemlemek için Topics API'yi çağırmıştır. Test sırasında, komut dosyanızın yerleştirildiği siteleri ziyaret ederek kullanıcı davranışını simüle edebilirsiniz. Pratik bir örnek için demo'ya bakın.
- Reklam engelleyici veya benzer bir uygulama ya da uzantı çalışmıyor.
- Gizli modda değilseniz.
chrome://settings/trackingProtection
tarihinden itibarenBlock all third-party cookies
seçeneği devre dışı bırakılır.
Canlı uygulamada hata ayıklama
Bir kullanıcıyı gözlemlemenin ilk haftası içinde Topics API'yi yayındaki bir uygulamadan çağırıyorsanız uygulamanız henüz kullanıcının konularını gözlemlememiş olabileceğinden boş sonuç elde edebilirsiniz. Önerilerimizi uygulayarak çözümünüzde hata ayıklama yapabilirsiniz.
- Sitenizin Özel Korumalı Alan'a kaydolduğundan emin olun.
- JavaScript'inizin beklendiği gibi çalıştığından emin olmak için ön uç kodunuzu test edin.
- Konu sonuçlarını almak için arka uç sisteminizi test edin.
- Veri türlerinin ve arka uç API parametrelerinin doğru şekilde yapılandırıldığından emin olun.
- Arka uç sunucunuzun uygun şekilde ölçeklenecek şekilde yapılandırıldığından emin olun.
- Deneyimlerimizden yola çıkarak, daha alakalı konu sonuçları almaya başlamak için en az üç hafta beklemeniz gerektiğini söyleyebiliriz.
- Tüm kullanıcılar için Topics etkinleştirilmez:
- Kullanıcılar Topics API'yi açıkça devre dışı bırakabilir.
- Yayıncı sayfaları izin politikasını kontrol edebilir ve sitelerini devre dışı bırakabilir.
- Bu ortama metrikler ve gözlemlenebilirlik ekleyin: İlk sonuçları analiz etmek için bunlara ihtiyacınız olacaktır. Örnek metrikler:
- Aramaların gecikmesi.
- Topics çağrılarında HTTP hataları.
- İlk üç hafta boyunca uygulamanızdaki değişiklikleri sınırlamaya çalışın.
Kaynaklar
- GitHub: Topics API açıklamasını okuyun ve API deposundaki sorunlarda soru sorabilir ve tartışmaları takip edebilirsiniz.
- W3C: Web Reklamcılığını Geliştirme İş Grubu'nda sektördeki kullanım alanlarını tartışın.
- Özel Korumalı Alan geliştirici desteği: Özel Korumalı Alan Geliştirici Desteği deposunda soru sorabilir ve tartışmalara katılabilirsiniz.
- Chromium: Chrome'daki uygulamayla ilgili sorular sormak için Chromium hatası gönderin.