Topics API untuk perangkat seluler: ringkasan

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

How the Topics API works

The Topics API can be used to observe and provide access to topics that appear to be of interest to the user, based on their activity. The Topics API can then give API callers (such as ad tech platforms) access to a user's topics of interest, but without revealing additional information about the user's activity.

Key concepts

• A topic is a human-readable topic of interest for the current user and is part of the Topics taxonomy.
• A caller is an entity, such as an app, a third-party SDK, a website, or service, that makes a request to the Topics API to observe or access a user's interests.
• A topic is observed by a caller, if the caller made a Topics API request from a web page or app associated with this topic during the past three epochs.
• An epoch is a period of topic computation, which defaults to one week.
• A taxonomy is a hierarchical list of categories, which includes, for example, such categories as /Arts & Entertainment/Music & Audio/Soul & R&B and /Business & Industrial/Business Services/Corporate Events.
• Topics are derived using a classifier model that maps user activity to zero or more topics.

Topics API flow core steps

The Topics API lifecycle has three main steps:

• Observe user activity, such as when they visit the web page https://cats.example/tabby/index.html or download the app cats.
• Derive topics from user activity, for example /Pets & Animals/Pets/Cats.
• Access topics previously observed for the user, for example as a signal to select relevant advertising (such as a cat food promotion).

Observe topics

Callers can only access topics of interest that they've observed. A caller observes a topic when they make a Topics API request from a context associated with this topic. To illustrate this concept, consider the following simplified example.

• Suppose there are two Topics API callers: A and B.
• There are two contexts:
  • Greenhouse, for example an app named Greenhouse or a website greenhouse.example, associated with the topic Home & Garden.
  • Tennis exercises, for example an app named Tennis Exercises or a website tennis.example, associated with the topic Sports/Tennis.
• Both caller A and B are present in the context of Greenhouse.
• Only the caller B is present in the context of Tennis exercises.
• Assume that no topics were observed for the user before epoch 1, for the sake of simplification.
• The user visits the Greenhouse app, and callers A and B make a Topics API call to record the user visit to the page or app (see the implementation guide suggested in Next steps to find out how to call the Topics API). This record (a hostname or app data) is later used to derive topics of interest. The Topics API will later mark the topic Home & Garden as observed by both callers A and B.
• The user visits the Tennis exercises app. Only the caller B sends a Topics API request. The Topics API will later mark the topic Sports/Tennis as observed by the caller B.
• By the end of the epoch, the Topics API refreshes the user's top topics and determines the callers that observed these topics based on user activity.
• Later, when the caller B makes another Topics API call, it can get either Home & Garden or Sports/Tennis topic (or, with a 5% chance, a random topic) for this user in the response array.
• Caller A can only access the topic Home & Garden, as it has never observed the topic Sports/Tennis. This means that a third-party will only learn about a user's topic of interest within the specific context (app or website) where it is present.

Derive topics

Topics derives topics of interest from user activity. The topics are selected from a predefined open-source taxonomy. Once per epoch, Topics refreshes the user's top five topics and the callers that observed them during the epoch. The Topics classifier model derives topics from user activity: hostname for a web page visit, app information on Android.

Caller accesses user's topics of interest

The API returns only topics that have been observed by the caller within the most recent three epochs. A maximum of three topics may be returned to a caller,one topic for each of the three recent epochs (if the caller observed topics for that epoch). The returned topics can be used by the caller to supplement any contextual information and can be combined to help find a more relevant ad for the user.

Epochs

The Topics API must ensure that the topics of interest it provides are kept up to date. The topics are inferred for a user based on their activity during a period of time known as an epoch, one week by default. Each user has their own epochs (epochs are "per user") and the initial start time is randomized.

Once each epoch, the Topics API computes the user's top five topics and determines which callers observed those topics using on-device information. The topic selected for each epoch is randomly selected from the user's top five topics for that time period. To further enhance privacy and ensure that all topics may be represented, there is a 5% chance the topic is randomly selected from all possible topics in the taxonomy of interests.

Penerapan topik di Android

Topics API di Android dirancang untuk mendukung SDK iklan pihak ketiga yang biasanya beroperasi di beberapa aplikasi. Topics memberi pemanggil topik periklanan menurut minat secara terperinci berdasarkan penggunaan aplikasi pengguna, tanpa mengandalkan ID lintas aplikasi. 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. Sisi penjual memiliki kehadiran yang luas di aplikasi penayang dan mengamati topik pengguna, lalu membagikan topik tersebut 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 bersiaplah untuk peluncuran.

Untuk semua teknologi iklan

• Tinjau Taksonomi topik dan berikan 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 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 teknologi iklan 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 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 menggunakan 540.000 informasi aplikasi yang tersedia untuk publik dan diberi label oleh manusia serta 17 juta informasi aplikasi yang tersedia untuk publik dan diberi label ML 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 Colab Android Topics Classifier

Taksonomi

Topik dipilih dari taksonomi open source yang telah ditetapkan. Taksonomi tersedia secara 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 tidak menjadi bagian dari taksonomi. Taksonomi ini akan disesuaikan dengan kategori iklan yang dapat ditampilkan di aplikasi seluler di Android.

Penerapan 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:

Aplikasi	Klasifikasi topik	SDK teknologi iklan
A	T1, T5	ad-sdk1, ad-sdk2
B	T2	ad-sdk2
C	T3, T6	ad-sdk3, ad-sdk4
D	T1, T4	ad-sdk1
E	T5	ad-sdk4, ad-sdk5
F	T6	ad-sdk2, ad-sdk3, ad-sdk4
G	T7	ad-sdk2

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

Topik Terpopuler	Pemanggil yang dapat mempelajari topik tersebut
T1	ad-sdk1, ad-sdk2
T2	ad-sdk2
T3	ad-sdk3, ad-sdk4
T4	ad-sdk1
T5	ad-sdk1, ad-sdk2, ad-sdk4, ad-sdk5

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

• Periode histori yang disertakan dalam penghitungan topik yang tersedia untuk setiap pemanggil 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 tidak diikutsertakan tidak akan berkontribusi pada penghitungan topik mingguan. Dokumen ini akan diperbarui untuk menyertakan detail implementasi terkait.

Jika tidak ada penggunaan aplikasi yang 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 . Sebagai praktik terbaik, sebaiknya kunci diperbarui secara rutin, tetapi tidak kurang dari setiap enam bulan.

Privacy Sandbox akan meminta teknologi iklan untuk mengonfirmasi ketersediaan endpoint yang mereka berikan selama proses pendaftaran. Untuk mengetahui detail selengkapnya tentang tindakan yang diperlukan oleh teknologi iklan saat ini 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.