Ditambahkan di API level 34
Juga di Ekstensi Layanan Iklan 4

Ringkasan: Metode | Metode Turunan

CustomAudienceManager

public class CustomAudienceManager
extends Object

java.lang.Object
↳	android.adservices.customaudience.CustomAudienceManager

---

CustomAudienceManager menyediakan API untuk SDK iklan dan aplikasi agar dapat bergabung/meninggalkan audiens kustom.

Ringkasan

Metode publik
void	fetchAndJoinCustomAudience(FetchAndJoinCustomAudienceRequest fetchAndJoinCustomAudienceRequest, Executor executor, OutcomeReceiver<Object, Exception> receiver) Menambahkan pengguna ke CustomAudience yang diambil dari fetchUri.
static CustomAudienceManager	get(Context context) Metode factory untuk membuat instance CustomAudienceManager.
TestCustomAudienceManager	getTestCustomAudienceManager() Membuat layanan dengan API yang mengaktifkan pengujian
void	joinCustomAudience(JoinCustomAudienceRequest joinCustomAudienceRequest, Executor executor, OutcomeReceiver<Object, Exception> receiver) Menambahkan pengguna ke CustomAudience yang ditentukan.
void	leaveCustomAudience(LeaveCustomAudienceRequest leaveCustomAudienceRequest, Executor executor, OutcomeReceiver<Object, Exception> receiver) Berupaya menghapus pengguna dari audiens kustom dengan menghapus data CustomAudience yang ada, yang diidentifikasi oleh ownerPackageName, buyer, dan name.

Metode turunan

Dari class java.lang.Object Object clone() Membuat dan menampilkan salinan objek ini. boolean equals(Object obj) Menunjukkan apakah beberapa objek lain "sama dengan" objek ini atau tidak. void finalize() Dipanggil oleh pembersih sampah memori pada sebuah objek saat pembersihan sampah memori menentukan bahwa tidak ada lagi referensi ke objek. final Class<?> getClass() Menampilkan class runtime dari Object ini. int hashCode() Menampilkan nilai kode hash untuk objek. final void notify() Mengaktifkan satu thread yang menunggu di monitor objek ini. final void notifyAll() Mengaktifkan semua thread yang menunggu di monitor objek ini. String toString() Menampilkan representasi string dari objek ini. final void wait(long timeoutMillis, int nanos) Menyebabkan thread saat ini menunggu hingga aktif, biasanya dengan menerima notifikasi atau terganggu, atau hingga sejumlah real time telah berlalu. final void wait(long timeoutMillis) Menyebabkan thread saat ini menunggu hingga aktif, biasanya dengan menerima notifikasi atau terganggu, atau hingga sejumlah real time telah berlalu. final void wait() Membuat thread saat ini menunggu hingga aktif, biasanya dengan menerima notifikasi atau terganggu.

Metode publik

fetchAndJoinCustomAudience

Ditambahkan di Android UpsideDownCakePrivacySandbox

public void fetchAndJoinCustomAudience (FetchAndJoinCustomAudienceRequest fetchAndJoinCustomAudienceRequest, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> receiver)

Menambahkan pengguna ke CustomAudience yang diambil dari fetchUri.

Upaya mendaftarkan pengguna untuk audiens kustom dengan kombinasi ownerPackageName, buyer, dan name yang sama akan menyebabkan informasi audiens kustom yang ada ditimpa, termasuk daftar data iklan.

Perhatikan bahwa daftar iklan dapat sepenuhnya ditimpa oleh tugas pengambilan latar belakang harian.

Panggilan ini gagal dengan SecurityException jika

1. ownerPackageName tidak memanggil nama paket aplikasi dan/atau
2. pembeli tidak diberi otorisasi untuk menggunakan API.

Panggilan ini gagal dengan IllegalArgumentException jika

1. batas penyimpanan telah terlampaui oleh aplikasi pemanggil dan/atau
2. parameter URI apa pun dalam CustomAudience yang diberikan tidak diautentikasi dengan pembeli CustomAudience.

Panggilan ini gagal dengan LimitExceededException jika paket panggilan melebihi batas kapasitas yang diizinkan dan dibatasi.

Panggilan ini gagal dengan IllegalStateException jika terjadi error layanan internal.
Memerlukan AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE

Parameter
fetchAndJoinCustomAudienceRequest	FetchAndJoinCustomAudienceRequest: Nilai ini tidak boleh null.
executor	Executor: Nilai ini tidak boleh null. Peristiwa callback dan pemroses dikirim melalui Executor ini, yang memberikan cara mudah untuk mengontrol thread mana yang digunakan. Untuk mengirim peristiwa melalui thread utama aplikasi, Anda dapat menggunakan Context.getMainExecutor(). Jika tidak, berikan Executor yang dikirimkan ke thread yang sesuai.
receiver	OutcomeReceiver: Nilai ini tidak boleh null.

dapatkan

Ditambahkan di API level 34
Juga di Ekstensi Layanan Iklan 6

public static CustomAudienceManager get (Context context)

Metode factory untuk membuat instance CustomAudienceManager.

Parameter
context	Context: Context yang akan digunakan Nilai ini tidak boleh null.

Return
CustomAudienceManager	Instance CustomAudienceManager Nilai ini tidak boleh null.

getTestCustomAudienceManager

Ditambahkan di API level 34
Juga di Ekstensi Layanan Iklan 4

public TestCustomAudienceManager getTestCustomAudienceManager ()

Membuat layanan dengan API yang mengaktifkan pengujian

Return
TestCustomAudienceManager	Nilai ini tidak boleh null.

joinCustomAudience

Ditambahkan di API level 34
Juga di Ekstensi Layanan Iklan 4

public void joinCustomAudience (JoinCustomAudienceRequest joinCustomAudienceRequest, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> receiver)

Menambahkan pengguna ke CustomAudience yang ditentukan.

Upaya mendaftarkan pengguna untuk audiens kustom dengan kombinasi ownerPackageName, buyer, dan name yang sama akan menyebabkan informasi audiens kustom yang ada ditimpa, termasuk daftar data iklan.

Perhatikan bahwa daftar iklan dapat sepenuhnya ditimpa oleh tugas pengambilan latar belakang harian.

Panggilan ini gagal dengan SecurityException jika

1. ownerPackageName tidak memanggil nama paket aplikasi dan/atau
2. pembeli tidak diberi otorisasi untuk menggunakan API.

Panggilan ini gagal dengan IllegalArgumentException jika

1. batas penyimpanan telah terlampaui oleh aplikasi pemanggil dan/atau
2. parameter URI apa pun dalam CustomAudience yang diberikan tidak diautentikasi dengan pembeli CustomAudience.

Panggilan ini gagal dengan LimitExceededException jika paket panggilan melebihi batas kapasitas yang diizinkan dan dibatasi.

Panggilan ini gagal dengan IllegalStateException jika terjadi error layanan internal.
Memerlukan AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE

Parameter
joinCustomAudienceRequest	JoinCustomAudienceRequest: Nilai ini tidak boleh null.
executor	Executor: Nilai ini tidak boleh null. Peristiwa callback dan pemroses dikirim melalui Executor ini, yang memberikan cara mudah untuk mengontrol thread mana yang digunakan. Untuk mengirim peristiwa melalui thread utama aplikasi, Anda dapat menggunakan Context.getMainExecutor(). Jika tidak, berikan Executor yang dikirimkan ke thread yang sesuai.
receiver	OutcomeReceiver: Nilai ini tidak boleh null.

tinggalkanCustomAudience

Ditambahkan di API level 34
Juga di Ekstensi Layanan Iklan 4

public void leaveCustomAudience (LeaveCustomAudienceRequest leaveCustomAudienceRequest, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> receiver)

Berupaya menghapus pengguna dari audiens kustom dengan menghapus data CustomAudience yang ada, yang diidentifikasi oleh ownerPackageName, buyer, dan name.

Panggilan ini gagal dengan SecurityException jika

1. ownerPackageName tidak memanggil nama paket aplikasi; dan/atau
2. pembeli tidak diberi otorisasi untuk menggunakan API.

Panggilan ini gagal dengan LimitExceededException jika paket panggilan melebihi batas kapasitas yang diizinkan dan dibatasi.

Panggilan ini tidak memberi tahu pemanggil apakah audiens kustom yang ditentukan ada di penyimpanan di perangkat. Dengan kata lain, proses ini akan gagal tanpa ada peringatan saat pembeli mencoba meninggalkan audiens kustom yang tidak bergabung.
Memerlukan AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE

Parameter
leaveCustomAudienceRequest	LeaveCustomAudienceRequest: Nilai ini tidak boleh null.
executor	Executor: Nilai ini tidak boleh null. Peristiwa callback dan pemroses dikirim melalui Executor ini, yang memberikan cara mudah untuk mengontrol thread mana yang digunakan. Untuk mengirim peristiwa melalui thread utama aplikasi, Anda dapat menggunakan Context.getMainExecutor(). Jika tidak, berikan Executor yang dikirimkan ke thread yang sesuai.
receiver	OutcomeReceiver: Nilai ini tidak boleh null.