Ringkasan Topics API for Mobile

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

Pelajari Topics API di Android, dan langkah-langkah yang diperlukan dalam menerapkannya. Anda juga dapat langsung menerapkan topik.

Cara kerja Topics API

Topics API dapat digunakan untuk mengamati dan memberikan akses ke topik yang tampaknya menarik bagi pengguna, berdasarkan aktivitas mereka. Topics API kemudian dapat memberi pemanggil API (seperti platform teknologi iklan) akses ke topik minat pengguna, tetapi tanpa mengungkapkan informasi tambahan tentang aktivitas pengguna.

Konsep utama

• Topik adalah topik minat yang dapat dibaca manusia untuk pengguna saat ini, dan merupakan bagian dari taksonomi Topics.
• Pemanggil adalah entitas, seperti aplikasi, SDK pihak ketiga, situs, atau layanan, yang membuat permintaan ke Topics API untuk mengamati atau mengakses minat pengguna.
• Topik diamati oleh pemanggil, jika pemanggil membuat permintaan Topics API dari halaman web atau aplikasi yang terkait dengan topik ini selama tiga epoch terakhir.
• Epoch adalah periode komputasi topik, yang secara default ditetapkan ke satu minggu.
• Taksonomi adalah daftar kategori hierarkis, yang mencakup, misalnya, kategori seperti /Arts & Entertainment/Music & Audio/Soul & R&B dan /Business & Industrial/Business Services/Corporate Events.
• Topik berasal dari model pengklasifikasi yang memetakan aktivitas pengguna ke nol atau beberapa topik.

Langkah inti alur Topics API

Siklus proses Topics API memiliki tiga langkah utama:

• Amati aktivitas pengguna, seperti saat mereka mengunjungi halaman web https://cats.example/tabby/index.html atau mendownload aplikasi cats.
• Mengambil topik dari aktivitas pengguna, misalnya /Pets & Animals/Pets/Cats.
• Topik akses yang sebelumnya diamati untuk pengguna, misalnya sebagai sinyal untuk memilih iklan yang relevan (seperti promosi makanan kucing).

Mengamati topik

Pemanggil hanya dapat mengakses topik minat yang telah mereka amati. Pemanggil mengamati topik saat mereka membuat permintaan Topics API dari konteks yang terkait dengan topik ini. Untuk mengilustrasikan konsep ini, pertimbangkan contoh sederhana berikut.

• Misalkan ada dua pemanggil Topics API: A dan B.
• Ada dua konteks:
  • Greenhouse, misalnya aplikasi bernama Greenhouse atau situs greenhouse.example, yang dikaitkan dengan topik Home & Garden.
  • Latihan tenis, misalnya aplikasi bernama Latihan Tenis atau situs tennis.example, yang dikaitkan dengan topik Sports/Tennis.
• Pemanggil A dan B ada dalam konteks Greenhouse.
• Hanya pemanggil B yang ada dalam konteks Latihan tenis.
• Asumsikan bahwa tidak ada topik yang diamati untuk pengguna sebelum epoch 1, demi penyederhanaan.
• Pengguna membuka aplikasi Greenhouse, dan pemanggil A dan B melakukan panggilan Topics API untuk mencatat kunjungan pengguna ke halaman atau aplikasi (lihat panduan penerapan yang disarankan di Langkah berikutnya untuk mengetahui cara memanggil Topics API). Data ini (nama host atau data aplikasi) nantinya digunakan untuk mendapatkan topik yang diminati. Topics API nantinya akan menandai topik Home & Garden seperti yang diamati oleh kedua pemanggil A dan B.
• Pengguna membuka aplikasi Latihan tenis. Hanya pemanggil B yang mengirimkan permintaan Topics API. Topics API nantinya akan menandai topik Sports/Tennis seperti yang diamati oleh pemanggil B.
• Pada akhir epoch, Topics API akan memuat ulang topik teratas pengguna dan menentukan pemanggil yang mengamati topik ini berdasarkan aktivitas pengguna.
• Kemudian, saat pemanggil B melakukan panggilan Topics API lain, pemanggil tersebut bisa mendapatkan topik Home & Garden atau Sports/Tennis (atau, dengan peluang 5%, topik acak) untuk pengguna ini dalam array respons.
• Pemanggil A hanya dapat mengakses topik Home & Garden, karena belum pernah mengamati topik Sports/Tennis. Artinya, pihak ketiga hanya akan mempelajari topik minat pengguna dalam konteks tertentu (aplikasi atau situs) tempat topik tersebut ada.

Menghasilkan topik

Topics memperoleh topik yang diminati dari aktivitas pengguna. Topik dipilih dari taksonomi open source yang telah ditetapkan. Satu kali per epoch, Topics akan memuat ulang lima topik teratas pengguna dan pemanggil yang mengamatinya selama epoch. Model pengklasifikasi Topics memperoleh topik dari aktivitas pengguna: nama host untuk kunjungan halaman web, informasi aplikasi di Android.

Pemanggil mengakses topik yang diminati pengguna

API hanya menampilkan topik yang telah diamati oleh pemanggil dalam tiga epoch terbaru. Maksimal tiga topik dapat ditampilkan kepada pemanggil,satu topik untuk setiap tiga epoch terbaru (jika pemanggil mengamati topik untuk epoch tersebut). Topik yang ditampilkan dapat digunakan oleh pemanggil untuk melengkapi informasi kontekstual apa pun dan dapat digabungkan untuk membantu menemukan iklan yang lebih relevan bagi pengguna.

Epoch

Topics API harus memastikan bahwa topik minat yang disediakannya selalu diperbarui. Topik disimpulkan untuk pengguna berdasarkan aktivitasnya selama jangka waktu yang dikenal sebagai epoch, satu minggu secara default. Setiap pengguna memiliki epoch-nya sendiri (epoch adalah "per pengguna") dan waktu mulai awal diacak.

Sekali dalam setiap epoch, Topics API menghitung lima topik teratas pengguna dan menentukan pemanggil mana yang mengamati topik tersebut menggunakan informasi di perangkat. Topik yang dipilih untuk setiap epoch dipilih secara acak dari lima topik teratas pengguna selama jangka waktu tersebut. Untuk lebih meningkatkan privasi dan memastikan bahwa semua topik dapat diwakili, ada kemungkinan 5% bahwa topik dipilih secara acak dari semua kemungkinan topik dalam taksonomi minat.

Praktik topik di Android

Topics API di Android dirancang untuk mendukung SDK iklan pihak ketiga yang biasanya beroperasi di beberapa aplikasi. Topics menyediakan topik periklanan menurut minat secara terperinci kepada pemanggil berdasarkan penggunaan aplikasi pengguna, tanpa mengandalkan ID lintas aplikasi. Topik-topik ini dapat digunakan untuk melengkapi informasi kontekstual apa pun yang terkait dengan aplikasi yang ingin menampilkan iklan, dan dapat digabungkan untuk membantu memilih iklan yang sesuai bagi pengguna.

Dalam konteks Topics API, pembeli dan pengiklan bergantung pada sisi jual. Ini adalah sisi penjual yang memiliki kehadiran luas di aplikasi penayang dan mengamati topik pengguna, lalu membagikan topik kepada pembeli untuk membantu mereka memilih iklan yang lebih relevan. Untuk mendapatkan topik, aplikasi dan SDK sisi jual harus membuat jejak dengan menjadi pengamat Topics API setidaknya selama satu epoch.

Lihat Panduan penerapan Topics API ) untuk mengetahui contoh kode yang menunjukkan cara menyiapkan kemampuan mengambil topik guna periklanan menurut minat.

Integrasi topik menurut jenis bisnis

Aktifkan untuk IBA (periklanan menurut minat) dengan Topics API. Ikuti langkah-langkah berdasarkan jenis bisnis teknologi iklan Anda untuk mengintegrasikan Topics API dan bersiap untuk peluncuran.

Untuk semua teknologi iklan

• Meninjau Taksonomi topik dan memberikan masukan.
• Lakukan 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 teknologi iklan Anda dengan Privacy Sandbox.

Untuk teknologi iklan sisi jual

• Menjadi pengamat untuk membuat jejak Topics API. Topics API memberikan sinyal baru, sehingga Anda harus mengupdate SDK agar dapat mulai memanggil Topics API. Untuk mengambil topik secara konsisten, SDK Anda harus memanggil API dari aplikasi penayang setidaknya sekali per epoch. Perlu waktu hingga empat epoch untuk mendapatkan jumlah maksimum topik (tiga 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 kepada partner sisi beli. Topics API berencana untuk 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 data Topics API dibagikan.

Untuk teknologi iklan sisi beli

• Terhubung dengan partner sisi jual untuk mengonfirmasi rencana mereka agar dapat mengamati topik dan membangun 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 adalah sinyal baru yang akan dibagikan oleh partner sisi jual sebagai bagian dari permintaan iklan. Konsumen sisi beli perlu memastikan bahwa mereka bekerja sama dengan partner upstream mereka dalam menyampaikan topik.
• Menyertakan topik dalam model bidding dan pengoptimalan. Topics API diharapkan dapat melengkapi sinyal lain seperti kontekstual untuk membantu menemukan iklan yang sesuai dengan pengunjung.

Cara API menyimpulkan topik untuk aplikasi

Di Android, Topics API menyimpulkan topik untuk aplikasi berdasarkan informasi aplikasi, menggunakan model pengklasifikasi. Dalam implementasi saat ini, Topics menggunakan nama aplikasi dan paket untuk menetapkan topik minat ke aplikasi, tetapi nantinya dapat diperluas untuk menyertakan informasi lain seperti deskripsi aplikasi.

Pengklasifikasi topik

Topik minat berasal dari model pengklasifikasi yang dilatih pada informasi aplikasi yang tersedia untuk publik.

• Saat model pengklasifikasi digunakan untuk inferensi dalam menghitung topik untuk epoch tertentu, rangkaian sinyal yang digunakan tetap berada di perangkat. Rangkaian sinyal ini dapat mencakup aplikasi yang diinstal atau yang baru saja digunakan, dan nantinya dapat diperluas untuk menyertakan sinyal lain.
• Model V5 dilatih oleh Google dengan 540.000 informasi aplikasi berlabel manusia dan 17 juta informasi aplikasi berlabel ML yang tersedia untuk publik dari app store seperti Google Play Store. Model ini menggunakan nama aplikasi dan nama paket sebagai sinyal input dan tersedia secara bebas bagi developer aplikasi untuk menguji dan melihat topik yang diklasifikasikan aplikasi mereka.
• Ada kemungkinan bahwa aplikasi dipetakan ke lebih dari satu topik, atau tanpa topik apa pun, atau tidak ditambahkan ke histori topik pengguna. Jika aplikasi dipetakan ke lebih dari satu topik dalam taksonomi, jumlah topik yang dipilih untuk aplikasi ini akan dibatasi pada tiga topik teratas.

Untuk mendapatkan pemahaman yang lebih baik tentang cara kerja model pengklasifikasi, Anda dapat menguji pengaruh berbagai data aplikasi terhadap klasifikasi menggunakan Android Topics Classifier Colab

Taksonomi

Topik dipilih dari taksonomi open source standar. Taksonomi tersedia untuk publik, dan dapat berubah sewaktu-waktu. Saran dapat diajukan menggunakan tombol masukan di bagian atas halaman ini. Taksonomi ini diseleksi oleh manusia sehingga topik yang sensitif bukan merupakan bagian dari taksonomi. Taksonomi ini akan disesuaikan dengan kategori iklan yang dapat ditampilkan di aplikasi seluler di Android.

Praktik topik di Android

Misalkan pengguna memiliki tujuh aplikasi yang terinstal di perangkat: A, B, C, D, E, F, dan G. Anggaplah klasifikasi topik untuk aplikasi dan SDK teknologi iklan di aplikasi ini adalah sebagai berikut:

Akhir minggu pertama: Topics API menghasilkan 5 topik teratas pengguna untuk epoch ini.

Pada minggu kedua, jika pemanggil di aplikasi apa pun memanggil API, daftar topik yang ditampilkan hanya akan menyertakan topik yang pemanggilnya berada di bagian "Pemanggil yang dapat mempelajari topik" kolom untuk topik itu bagi aplikasi itu untuk epoch tersebut.

• Periode histori yang disertakan dalam penghitungan topik yang tersedia untuk setiap penelepon adalah tiga epoch (atau tiga minggu).
• Hanya topik yang terkait dengan aplikasi yang memanggil Topics API melalui SDK iklan yang digunakan. Artinya, jika aplikasi tidak menyertakan SDK iklan apa pun yang memanggil Topics API, topik yang terkait dengan aplikasi tersebut tidak berkontribusi pada kumpulan topik yang dapat diakses oleh SDK iklan.
• Aplikasi juga dapat memilih tidak ikut Topics API secara deklaratif. Topik yang terkait dengan aplikasi yang memilih tidak ikut tidak akan berkontribusi pada komputasi topik mingguan. Dokumen ini akan diperbarui untuk menyertakan detail implementasi terkait.

Jika penggunaan aplikasi tidak cukup bagi platform untuk menyimpulkan lima topik, platform dapat mempertimbangkan opsi seperti membuat topik yang tersisa secara acak.

Enkripsi topik yang ditampilkan

Platform teknologi iklan terdaftar yang memanggil Topics API juga diwajibkan untuk memberikan kunci enkripsi guna memastikan bahwa topik yang ditampilkan hanya dapat dibaca oleh pemanggil.

Privacy Sandbox akan mengambil kunci ini dari endpoint yang disediakan oleh teknologi iklan . Rab sebagai praktik terbaik, kunci diperbarui secara teratur, tetapi tidak setidaknya setiap enam bulan.

Privacy Sandbox akan meminta teknologi iklan untuk mengonfirmasi ketersediaan endpoint yang mereka berikan selama proses pendaftaran. Untuk rincian selengkapnya tentang tindakan yang diperlukan oleh teknologi iklan yang masih aktif dan yang baru didaftarkan, lihat panduan pendaftaran

Langkah berikutnya

Lihat juga

Lihat referensi kami untuk lebih memahami Topics API di Android.

• Lihat aplikasi contoh, video kolaborasi, dan panduan di Topics.
• Lihat cara pengguna dan developer dapat mengontrol API.
• Lihat referensi dukungan untuk mengajukan pertanyaan, berinteraksi, dan memberikan masukan.