Referensi dukungan untuk Topics API di Web

Temukan rekomendasi untuk proses debug, pemecahan masalah, dan referensi dukungan untuk Topik di Web.

Pemecahan masalah

Jika Anda melakukan panggilan document.browsingTopics() atau permintaan fetch() dengan header Sec-Browsing-Topics yang ditetapkan, tetapi menerima array kosong sebagai respons, ada sejumlah langkah proses debug yang dapat Anda lakukan untuk mengidentifikasi akar masalah, baik di lingkungan pengembangan lokal maupun di sistem aktif.

Men-debug secara lokal

Jika Anda menguji secara lokal, pastikan Anda menjalankan Chrome dengan parameter yang diperlukan.

  • Untuk mengabaikan pendaftaran, aktifkan tanda chrome://flags/#privacy-sandbox-enrollment-overrides dan tambahkan URL situs yang memanggil Topics.

  • Konfigurasikan Topics API untuk pengujian menggunakan tombol fitur. Flag ini memungkinkan Anda mengubah parameter seperti durasi epoch, jumlah topik teratas, dan lainnya, sehingga Anda dapat menguji Topics dengan nyaman. Anda dapat menggunakan flag fitur yang direkomendasikan ini:

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

  • Sebelum menjalankan Chrome dengan flag, pastikan Anda telah menutup semua instance dan proses Chrome lainnya.

  • Pastikan:

    • Anda menggunakan Chrome 101 atau yang lebih baru.
    • Skrip Anda telah memanggil Topics API untuk mengamati topik. Saat menguji, Anda dapat menyimulasikan perilaku pengguna dengan mengunjungi situs tempat skrip Anda disematkan. Lihat demo untuk contoh praktis.
    • Anda tidak menjalankan pemblokir iklan atau aplikasi atau ekstensi serupa.
    • Anda tidak menggunakan mode Samaran.
    • Dari chrome://settings/trackingProtection, opsi Block all third-party cookies dinonaktifkan.

Men-debug implementasi langsung

Jika Anda memanggil Topics API dari aplikasi aktif dalam minggu pertama pengamatan pengguna, hasil yang diharapkan adalah kosong, karena aplikasi Anda mungkin belum mengamati topik untuk pengguna. Anda dapat men-debug solusi dengan mengikuti rekomendasi kami.

  • Pastikan situs Anda terdaftar dengan Privacy Sandbox.
  • Uji kode frontend untuk memastikan JavaScript berfungsi seperti yang diharapkan.
  • Uji backend Anda untuk menerima hasil topik.
    • Jangan lupa untuk memastikan jenis data dan parameter API backend dikonfigurasi dengan benar.
    • Pastikan backend Anda dikonfigurasi untuk menskalakan dengan benar.
  • Berdasarkan pengalaman kami, Anda perlu menunggu minimal tiga minggu sebelum mulai mendapatkan hasil topik yang lebih relevan.
  • Tidak semua pengguna akan mengaktifkan Topics:
    • Pengguna dapat menonaktifkan Topics API secara eksplisit.
    • Halaman penayang dapat mengontrol kebijakan izin dan memilih tidak ikut situs mereka.
  • Tambahkan metrik dan visibilitas ke lingkungan ini: Anda memerlukannya untuk menganalisis hasil pertama. Contoh metrik meliputi:
    • Latensi panggilan.
    • Error HTTP pada panggilan topik.
  • Cobalah untuk membatasi perubahan pada penerapan Anda selama tiga minggu pertama.

Resource