Menguji, men-deploy, dan menskalakan solusi berbasis Topics

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

Penerapan backend Topics

Penerapan backend Anda bergantung pada cara Anda ingin menggunakan topik yang dihitung di browser. Sebaiknya solusi teknologi iklan menggunakan Topics 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 Topik 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 di Maksimalkan relevansi iklan setelah cookie pihak ketiga, ada beberapa pendekatan untuk memanfaatkan Topics guna menayangkan iklan yang relevan. Beberapa di antaranya melibatkan penggunaan Topics untuk membuat audiens, dan pendekatan lainnya menyarankan penggunaan Topics 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.
    • Build 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. Sebaiknya Anda menguji penerapan di situs Anda sendiri yang memiliki sedikit kunjungan bulanan terlebih dahulu. Pada tahap ini, sebaiknya sematkan solusi berbasis topik baru Anda di setidaknya lima situs.
    • Pada tahap ini, diharapkan API menampilkan array kosong. Hal ini karena belum ada topik yang diamati untuk pengguna. Diperlukan waktu hingga tiga minggu untuk mulai mendapatkan topik pengguna.
    • Lakukan pengujian dan validasi fungsi. Anda dapat menguji solusi secara manual atau otomatis. Contoh:
      • Buka browser dengan tanda dan tetapkan epoch ke 15 detik, agar browser menghitung ulang Topics 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 seharusnya telah mengamati topik. Pada tahap ini, Anda seharusnya dapat menggunakan data Topics 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 mengintegrasikan panggilan Topics ke dalam skrip, pastikan panggilan tersebut disematkan di beberapa situs produksi untuk pengujian pertama. Pastikan penerapan Anda berfungsi seperti yang diharapkan:

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

Pilih situs target

Sebelum men-deploy solusi Anda ke kami menyarankan Anda mengujinya di lingkungan yang terkendali, di situs web yang Anda miliki. Sebaiknya Anda memilih situs target sebagai berikut:

  • Situs mendapatkan sedikit 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 bagi bisnis: Mulailah dengan situs target berisiko rendah.
  • Total tidak lebih dari lima situs: Anda tidak akan memerlukan traffic atau eksposur sebanyak itu untuk saat ini.
  • Situs target mewakili tema yang berbeda: Pilih situs yang mewakili berbagai kategori (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 kosong topik [], jika ini adalah panggilan pertama perangkat ini, untuk situs dan penelepon ini dalam tujuh hari terakhir.

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

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

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

  • Topik baru yang 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.

Skalakan ke produksi

Pada tahap ini, Anda seharusnya sudah menguji Topics dalam lingkungan terkontrol (di beberapa situs yang Anda miliki). Jika semuanya berfungsi seperti yang diharapkan, inilah saatnya untuk menskalakan implementasi ini. Deploy kode yang sama ke situs target lainnya. Hal ini akan memungkinkan Anda mengamati lebih banyak pengguna, mengumpulkan lebih banyak data topik, dan memperdalam pemahaman tentang audiens Anda.

Berikut adalah ringkasan langkah demi langkah cara meningkatkan skala ke produksi:

  1. Uji solusi berbasis topik Anda pada volume traffic yang lebih tinggi.
    • Tambahkan iframe ke lebih banyak situs milik Anda dengan jumlah kunjungan yang lebih besar dan ikuti petunjuk di bawah untuk melakukan pengujian beban.
  2. Men-deploy solusi Anda ke di situs Anda.
    • Setelah solusi Anda berfungsi dengan baik di lingkungan pengujian Anda sendiri, berkolaborasilah dengan penerbit untuk mengintegrasikan iframe Anda ke dalam 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 data lainnya.
    • Mencari 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 di situs Anda.

  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, sesuai dengan traffic yang Anda harapkan.
    • Anda harus mengirim informasi topik dari iframe ke backend Anda. Hal ini memungkinkan Anda memproses hasil Topics API lebih lanjut dan menggunakannya sebagai sinyal tambahan untuk membantu memilih iklan yang lebih relevan bagi pengguna. Semakin banyak situs yang menyertakan sematan Anda, jumlah panggilan ke backend Anda akan meningkat secara signifikan. Pastikan backend Anda dapat menangani panggilan dalam volume yang besar dari iframe.
    • Siapkan pengumpulan metrik dan log untuk analisis.
  3. Segera setelah men-deploy Topics API, periksa metrik Anda untuk mendeteksi masalah pengguna akhir yang parah. Terus periksa metrik Anda secara rutin.
  4. Jika terjadi gangguan atau perilaku tak terduga, roll back deployment dan analisis log Anda untuk memahami dan memperbaiki masalahnya.

Lihat juga

Lihat referensi kami untuk lebih memahami Topics API di Web.