Menguji, men-deploy, dan menskalakan solusi berbasis Topics

Halaman ini membahas cara membuat, menguji, dan menskalakan penerapan untuk produksi menggunakan Topics API.

Implementasi backend topik

Penerapan backend Anda bergantung pada cara Anda ingin menggunakan topik yang dihitung di browser. Sebaiknya solusi teknologi iklan menggunakan Topik sebagai sinyal IBA tambahan.

// Use the language/framework/stack of your preference
function processTopicsBackendAPI(topics) {
 // If the list is not empty, continue
 // Use topics as an additional signal
}

Menggunakan Topics sebagai sinyal tambahan

Data topik dapat dipertimbangkan bersama sinyal lain seperti URL, kata kunci, atau metadata lainnya, sebagai sinyal tambahan tentang audiens Anda.

Seperti yang dijelaskan dalam Memaksimalkan relevansi iklan setelah cookie pihak ketiga, ada beberapa pendekatan untuk memanfaatkan Topics guna menayangkan iklan yang relevan. Beberapa di antaranya melibatkan penggunaan Topik untuk membuat audiens, dan pendekatan lainnya menyarankan penggunaan Topik sebagai salah satu sinyal di antara sinyal lainnya untuk melatih model machine learning yang akan digunakan untuk menyimpulkan minat tambahan audiens atau bahkan untuk mengoptimalkan logika bidding.

Mem-build dan men-deploy

  1. Kumpulkan topik dengan mengamati pengguna dalam produksi (estimasi waktu penerapan: sekitar satu minggu):
    • Pahami opsi Anda: cara memanggil Topics dengan header HTTP atau iframe dan JavaScript.
    • Tentukan domain iframe yang akan memanggil Topics API.
    • Buat solusi Anda, menggunakan demo header atau demo JavaScript sebagai referensi kode.
    • Integrasikan Topics ke dalam kode yang disematkan penayang di situs mereka (misalnya, iframe iklan Anda). Pastikan Anda memanggil topik dari sematan.
    • Untuk mulai mengamati topik pengguna, sematkan versi terbaru skrip Anda di situs produksi Anda. Sebaiknya uji penerapan di situs Anda sendiri yang memiliki sejumlah kecil kunjungan bulanan terlebih dahulu. Pada tahap ini, sebaiknya sematkan solusi berbasis topik baru Anda di setidaknya lima situs.
    • Pada tahap ini, API diharapkan menampilkan array kosong sebagai hasilnya. Hal ini karena belum ada topik yang diamati untuk pengguna. Diperlukan waktu hingga tiga minggu untuk mulai mendapatkan topik pengguna.
    • Lakukan pengujian dan validasi fungsional. Anda dapat menguji solusi secara manual atau otomatis. Contoh:
      • Buka browser Anda dengan tanda pengenal dan setel epoch ke 15 detik, sehingga browser menghitung ulang Topik lebih cepat.
      • Kunjungi situs yang menyematkan skrip Anda.
      • Periksa apakah topik diamati oleh skrip Anda di chrome://topics-internals/.
      • Lihat hasil yang dapat Anda harapkan.
  2. Menggunakan data Topics bersama dengan sinyal kontekstual lainnya (seperti URL, metadata, dll.) (perkiraan waktu: sekitar 3 hari).
    • Setelah tiga minggu dalam produksi, skrip Anda akan mengamati beberapa topik pengguna. Pada tahap ini, Anda dapat menggunakan data Topik sebagai sinyal tambahan.
    • Setelah mulai menerima daftar topik yang tidak kosong, Anda dapat mengirimkannya ke backend dengan sinyal kontekstual lainnya.

Men-deploy ke situs target

Setelah Anda mengintegrasikan panggilan Topics ke dalam skrip, pastikan skrip tersebut disematkan di beberapa situs produksi untuk pengujian pertama. Pastikan penerapan Anda berfungsi seperti yang diharapkan:

  • Topics API dipanggil.
  • Topik dapat diamati di lingkungan yang terkontrol ini.
  • Topik dapat diakses (API menampilkan topik yang diamati untuk pengguna).

Pilih situs target

Sebelum men-deploy solusi Anda ke situs penayang, sebaiknya uji di lingkungan yang terkontrol, di situs yang Anda miliki. Sebaiknya pilih situs target sebagai berikut:

  • Situs mendapatkan sejumlah kecil kunjungan bulanan (kurang dari sekitar satu juta kunjungan/bulan): Anda harus memulai dengan men-deploy API ke audiens kecil terlebih dahulu.
  • Anda memiliki dan mengontrol situs: Jika perlu, Anda dapat menonaktifkan penerapan dengan cepat tanpa persetujuan yang rumit.
  • Situs tidak penting untuk bisnis: Mulai dengan situs target berisiko rendah.
  • Total tidak lebih dari lima situs: Anda tidak memerlukan banyak traffic atau eksposur untuk saat ini.
  • Situs target mewakili tema yang berbeda-beda: Pilih situs yang mewakili kategori yang berbeda-beda (misalnya, satu tentang olahraga, satu lagi tentang berita, satu lagi dari makanan dan minuman). Anda dapat menggunakan alat topik internal di Chrome untuk memvalidasi domain dan cara domain tersebut diklasifikasikan oleh pengklasifikasi machine learning Topics.

Pengujian dan validasi fungsional

Saat memanggil Topics API di lingkungan terbatas ini, Anda dapat mengharapkan hasil berikut:

  • Array topik [] yang kosong, jika ini adalah panggilan pertama perangkat ini, untuk situs dan pemanggil ini dalam tujuh hari terakhir.

  • Daftar nol hingga tiga topik, yang mewakili minat pengguna ini. Setelah tujuh hari pengamatan, Anda akan menerima:

    • Satu topik, dipilih dari lima topik teratas untuk pengguna, dihitung dari nama host halaman tempat topik telah diamati oleh pemanggil selama minggu tersebut.

  • Respons API yang sama persis seperti pada semua panggilan Topics API sebelumnya. Untuk pemanggil, pengguna, dan situs tingkat atas yang sama, API akan menampilkan topik yang sama untuk keseluruhan epoch. Hal ini membantu menghindari pengungkapan terlalu banyak minat pengguna. Temukan detail selengkapnya di GitHub.

  • Topik baru menggantikan salah satu dari tiga topik lama jika Anda memanggil Topics setelah empat minggu pengamatan.

  • Jika Anda belum mengamati topik untuk pengguna selama tiga minggu sebelumnya, atau lebih lama, Topics API akan menampilkan array kosong [] lagi.

Kumpulkan metrik performa untuk menilai pengalaman pengguna Anda:

  • Waktu proses panggilan JavaScript ke Topics API di dalam iframe lintas origin harus diukur untuk digunakan dalam analisis performa di masa mendatang.
  • Waktu yang diperlukan untuk membuat iframe dan topik postMessage(), setelah topik diterima.

Untuk pemecahan masalah, lihat bagian dukungan.

Menskalakan ke produksi

Pada tahap ini, Anda seharusnya telah menguji Topics di lingkungan yang terkontrol (di beberapa situs milik Anda). Jika semuanya berfungsi seperti yang diharapkan, saatnya menskalakan penerapan ini. Men-deploy kode yang sama ke lebih banyak situs target. Dengan begitu, Anda dapat mengamati lebih banyak pengguna, mengumpulkan lebih banyak data topik, dan memperdalam pemahaman tentang audiens.

Berikut ringkasan langkah demi langkah tentang cara melakukan penskalaan ke produksi:

  1. Uji solusi berbasis topik Anda pada volume traffic yang lebih tinggi.
    • Tambahkan iframe Anda ke lebih banyak situs yang Anda miliki dengan jumlah kunjungan yang lebih besar dan ikuti petunjuk di bawah untuk melakukan pengujian beban.
  2. Deploy solusi Anda ke situs penayang.
    • Setelah solusi Anda berfungsi dengan benar di lingkungan pengujian Anda sendiri, berkolaborasilah dengan penayang untuk mengintegrasikan iframe Anda ke situs mereka. Misalnya, mereka mungkin perlu mengupdate library yang menyertakan iframe Anda.
  3. Memproses dan menggunakan data topik (estimasi waktu: sekitar empat minggu).
    • Menggabungkan data topik sebagai sinyal tambahan bersama dengan data lainnya.
    • Menemukan partner pengujian bidding real-time.
    • Jalankan pengujian utilitas dengan topik sebagai sinyal tambahan untuk data Anda yang lain.

Pengujian Beban

Untuk memastikan sistem Anda dapat menangani traffic, sebaiknya lakukan pengujian beban sebelum men-deploy solusi berbasis topik ke situs penayang.

  1. Deploy secara bertahap di lebih banyak situs target yang Anda miliki, terutama situs yang memiliki volume traffic lebih besar.
  2. Lakukan pengujian beban untuk data topik Anda, sesuai dengan traffic yang diharapkan.
    • Anda harus mengirim informasi topik dari iframe ke backend. Dengan begitu, Anda dapat memproses lebih lanjut hasil Topics API dan menggunakannya sebagai sinyal tambahan untuk membantu memilih iklan yang lebih relevan bagi pengguna. Seiring makin banyaknya situs yang menyertakan sematan Anda, jumlah panggilan ke backend Anda akan meningkat secara signifikan. Konfirmasi bahwa backend Anda dapat menangani panggilan dalam jumlah besar dari iframe.
    • Siapkan pengumpulan metrik dan log untuk analisis.
  3. Segera setelah men-deploy Topics API, periksa metrik Anda untuk mendeteksi masalah berat pengguna akhir. Terus periksa metrik Anda secara rutin.
  4. Jika terjadi gangguan atau perilaku yang tidak terduga, lakukan roll back deployment dan analisis log Anda untuk memahami dan memperbaiki masalah tersebut.

Lihat juga

Lihat referensi kami untuk lebih memahami Topics API di Web.