Web'de Topics API için destek kaynakları

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 itibaren Block 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