Topics API: panduan integrasi

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Topics API untuk Android dirancang guna mendukung pengiklanan menurut minat tanpa perlu mengandalkan ID lintas aplikasi.

Pengiklan berupaya menayangkan iklan yang relevan dan berkaitan dengan minat pengguna. Misalnya, jika tertarik dengan informasi seputar memasak, pengguna mungkin merasa iklan yang berkaitan dengan memasak lebih relevan bagi mereka daripada iklan yang tidak berkaitan dengan minat mereka.

Pengiklanan menurut minat (PMM) adalah bentuk iklan yang dipersonalisasi dan iklan dipilih berdasarkan minat pengguna. Dengan Privacy Sandbox di Android, minat ini diperoleh dari aplikasi yang digunakan oleh pengguna. PMM berbeda dengan pengiklanan kontekstual yang hanya didasarkan pada minat yang terlihat dari konten yang dilihat saat ini. Dengan PMM, aplikasi dapat menampilkan iklan yang lebih relevan dan menarik daripada iklan kontekstual.

PMM biasanya melibatkan komunikasi antara aplikasi, penjual, dan pembeli. Panduan ini ditujukan untuk semua pihak, seperti jaringan dan adtech yang beroperasi sebagai pembeli dan penjual.

Topics API menyimpulkan secara terperinci sinyal minat di perangkat berdasarkan penggunaan aplikasi pengguna. Sinyal ini, yang disebut topics, dibagikan kepada pengiklan untuk mendukung PMM tanpa harus melacak setiap pengguna di seluruh aplikasi.

Ada pertimbangan tingkat tinggi yang penting saat menerapkan pengiklanan menurut minat dengan Topics API:

  • Inferensi minat pengguna diproses di perangkat: Informasi pengguna tentang aplikasi yang diinstal di perangkat pengguna tetap ada di perangkat, dan privasi dilindungi. Model ini berbeda dengan model yang biasa digunakan saat ini, yaitu meminta data lintas aplikasi pengguna dikirim dan diproses di luar perangkat, di server adtech. Jenis pemrosesan tertentu akan terus ada di server adtech, seperti penggunaan sinyal yang diberikan oleh Topics API dalam model personalisasi dan pengoptimalan untuk pemilihan iklan.

  • Pembeli dan pengiklan bergantung pada sisi jual: Untuk mendapatkan topik, aplikasi dan SDK sisi jual harus membuat jejak dengan menjadi pengamat Topics API setidaknya selama 1 epoch.

Terminologi

  • Pengiklan: Perusahaan yang berinteraksi dengan pengguna melalui pembelian inventaris iklan
  • Penayang: Perusahaan yang menjual inventaris iklan yang tersedia bersama kontennya
  • Pembeli (atau sisi beli): Perusahaan adtech yang memfasilitasi pengiklan dalam membeli inventaris iklan
  • Penjual (atau sisi jual): Perusahaan adtech yang memfasilitasi penayang dalam menjual inventaris iklan
  • Jaringan: Perusahaan adtech yang bertindak sebagai pembeli dan penjual
  • Dimiliki dan dikelola sendiri: Perusahaan yang bertindak sebagai penayang, penjual, dan pembeli

Sasaran

Jika peran PMM penting bagi bisnis Anda, kami ingin Anda memiliki versi Topics API yang berjalan dalam konteks kasus bisnis aplikasi agar kami dapat memperoleh masukan dan memungkinkan Anda membuat API. Kami ingin memastikan bahwa Anda dapat berhenti memblokir desain dan pengembangan sehingga Anda bisa mendapatkan topik ketika versi beta diluncurkan.

Saat ini, sasaran perencanaan integrasi untuk Privacy Sandbox di Pratinjau Developer Android telah mencakup kemampuan untuk melakukan hal berikut:

Untuk semua adtech

  • Meninjau Taksonomi topik dan memberikan masukan tentang topik yang disertakan.
  • Melakukan eksperimen dengan aplikasi contoh Topics API untuk melihat data topik yang ditampilkan dari pengklasifikasi di perangkat.
  • Mengupdate alur aplikasi dan SDK untuk mulai memanggil Topics API.
  • Mengupdate protokol untuk mulai mengirim topik dalam permintaan iklan.
  • Mendaftarkan adtech Anda dengan Privacy Sandbox.

Untuk adtech sisi jual

  • Menjadi pengamat untuk membangun jejak Topics API. Topics API merupakan sinyal baru. Oleh karena itu, Anda harus mengupdate SDK agar dapat mulai memanggil Topics API. Untuk mengambil topik secara konsisten, aplikasi harus memanggil API setidaknya sekali per epoch. Perlu waktu hingga 4 epoch untuk mendapatkan jumlah maksimum topik (3 topik) agar dapat dikirim dengan permintaan iklan Anda.
  • Menyertakan informasi Topics API dalam permintaan iklan Anda. Untuk setiap permintaan iklan, mulai bagikan data Topics API Anda dengan partner sisi beli. Topics API bermaksud melengkapi sinyal lain (seperti sinyal kontekstual) untuk membantu menemukan iklan yang sesuai untuk pengunjung tertentu.
  • Berkolaborasi pada protokol untuk berbagi topik dengan partner sisi beli Anda. Topics API mengharuskan setiap SDK bekerja sama dengan partner downstream untuk menyetujui cara pembagian data Topics API.

Untuk adtech sisi beli

  • Terhubung dengan partner sisi jual untuk mengonfirmasi rencana mereka agar dapat mengamati topik dan membuat jejak. Untuk menerima topik, penyedia sisi jual harus memanggil Topics API setidaknya sekali per epoch.
  • Berkolaborasi pada protokol untuk menerima topik dari partner sisi jual Anda. Topik merupakan sinyal baru yang akan dibagikan oleh partner sisi jual sebagai bagian dari permintaan iklan. Konsumen sisi beli harus memastikan bahwa mereka bekerja sama dengan partner upstream mereka tentang cara pembagian topik.
  • Menyertakan topik dalam model bidding dan pengoptimalan. Topics API dimaksudkan untuk melengkapi sinyal lain seperti kontekstual agar dapat membantu menemukan iklan yang sesuai dengan pengunjung.

Prasyarat dan penyiapan

Developer, penjual, dan pembeli aplikasi harus mengikuti langkah-langkah ini untuk menyiapkan penggunaan Topics API.

Memahami API

  1. Mulailah dengan membaca proposal desain untuk memahami Topics API beserta kemampuannya.
  2. Baca panduan developer untuk mempelajari cara menggabungkan kode dan panggilan API yang diperlukan untuk kasus penggunaan Anda.
  3. Tinjau taksonomi dan berikan masukan terkait topik yang disertakan dalam daftar.
  4. Kirim masukan untuk proposal atau dokumentasi desain.
  5. Daftar untuk menerima info terbaru tentang Topics API. Langkah ini akan membantu Anda terus mendapatkan informasi terbaru seputar fitur baru yang diperkenalkan dalam rilis mendatang.

Menyiapkan dan menguji aplikasi contoh

  1. Ikuti petunjuk di halaman ini untuk menyiapkan Privacy Sandbox di Android SDK di Android Studio.
  2. Lakukan fork dan jalankan kode dalam versi Java atau Kotlin dari aplikasi contoh agar Anda memahami cara mengambil topik di perangkat.
  3. Saat menguji, lakukan eksperimen dengan informasi aplikasi untuk nama dan deskripsi agar dapat mengubah topik yang akan ditampilkan dari pengklasifikasi di perangkat.
  4. Setelah Anda memahami cara kerja API klien dan klasifikasi di perangkat, gunakan aplikasi contoh sebagai contoh untuk memandu integrasi Anda sendiri.

Tips: Tinjau dengan cermat kegunaan data topik yang ditampilkan untuk aplikasi Anda. Identifikasi cara untuk meningkatkan klasifikasi atau taksonomi, dan kirim masukan jika Anda memiliki rekomendasi tentang cara meningkatkan taksonomi.