Ditambahkan di level API 34
Juga di Ekstensi Layanan Iklan 4

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<ObjectException> 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 mendukung pengujian

void joinCustomAudience(JoinCustomAudienceRequest joinCustomAudienceRequest, Executor executor, OutcomeReceiver<ObjectException> receiver)

Menambahkan pengguna ke CustomAudience yang ditentukan.

void leaveCustomAudience(LeaveCustomAudienceRequest leaveCustomAudienceRequest, Executor executor, OutcomeReceiver<ObjectException> receiver)

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

Metode turunan

Metode publik

pengambilanAndJoinCustomAudience

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

Menambahkan pengguna ke CustomAudience yang diambil dari fetchUri.

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

Perhatikan bahwa daftar iklan dapat ditimpa sepenuhnya 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 panggilan dan/atau
  2. parameter URI apa pun dalam CustomAudience yang diberikan tidak diautentikasi dengan CustomAudience pembeli.

Panggilan ini gagal dengan LimitExceededException jika paket panggilan melebihi dan dibatasi kapasitasnya.

Panggilan ini gagal dengan IllegalStateException jika error layanan internal temui.
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 ini Executor, yang menyediakan cara mudah untuk mengontrol thread mana data Untuk mengirim peristiwa melalui thread utama metode Anda dapat menggunakan Context.getMainExecutor(). Jika tidak, sediakan Executor yang melakukan pengiriman ke thread yang sesuai.

receiver OutcomeReceiver: Nilai ini tidak boleh null.

get

Ditambahkan di level API 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.

Hasil
CustomAudienceManager Instance CustomAudienceManager Nilai ini tidak boleh null.

getTestCustomAudienceManager

Ditambahkan di level API 34
Juga di Ekstensi Layanan Iklan 4
public TestCustomAudienceManager getTestCustomAudienceManager ()

Membuat layanan dengan API yang mendukung pengujian

Hasil
TestCustomAudienceManager Nilai ini tidak boleh null.

joinCustomAudience

Ditambahkan di level API 34
Juga di Ekstensi Layanan Iklan 4
public void joinCustomAudience (JoinCustomAudienceRequest joinCustomAudienceRequest, 
                Executor executor, 
                OutcomeReceiver<ObjectException> receiver)

Menambahkan pengguna ke CustomAudience yang ditentukan.

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

Perhatikan bahwa daftar iklan dapat ditimpa sepenuhnya 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 panggilan dan/atau
  2. parameter URI apa pun dalam CustomAudience yang diberikan tidak diautentikasi dengan CustomAudience pembeli.

Panggilan ini gagal dengan LimitExceededException jika paket panggilan melebihi dan dibatasi kapasitasnya.

Panggilan ini gagal dengan IllegalStateException jika error layanan internal temui.
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 ini Executor, yang menyediakan cara mudah untuk mengontrol thread mana data Untuk mengirim peristiwa melalui thread utama metode Anda dapat menggunakan Context.getMainExecutor(). Jika tidak, sediakan Executor yang melakukan pengiriman ke thread yang sesuai.

receiver OutcomeReceiver: Nilai ini tidak boleh null.

tinggalkanCustomAudience

Ditambahkan di level API 34
Juga di Ekstensi Layanan Iklan 4
public void leaveCustomAudience (LeaveCustomAudienceRequest leaveCustomAudienceRequest, 
                Executor executor, 
                OutcomeReceiver<ObjectException> 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 dan dibatasi kapasitasnya.

Panggilan ini tidak memberi tahu penelepon apakah audiens kustom yang ditentukan ada di dalam penyimpanan di perangkat. Dengan kata lain, Smart Bidding 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 ini Executor, yang menyediakan cara mudah untuk mengontrol thread mana data Untuk mengirim peristiwa melalui thread utama metode Anda dapat menggunakan Context.getMainExecutor(). Jika tidak, sediakan Executor yang melakukan pengiriman ke thread yang sesuai.

receiver OutcomeReceiver: Nilai ini tidak boleh null.