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 |
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<Object, Exception> receiver)
Menambahkan pengguna ke |
void
|
leaveCustomAudience(LeaveCustomAudienceRequest leaveCustomAudienceRequest, Executor executor, OutcomeReceiver<Object, Exception> receiver)
Berupaya menghapus pengguna dari audiens kustom dengan menghapus data |
Metode turunan | |
---|---|
Metode publik
pengambilanAndJoinCustomAudience
public void fetchAndJoinCustomAudience (FetchAndJoinCustomAudienceRequest fetchAndJoinCustomAudienceRequest, Executor executor, OutcomeReceiver<Object, Exception> 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
ownerPackageName
tidak memanggil nama paket aplikasi dan/atau- pembeli tidak diberi otorisasi untuk menggunakan API.
Panggilan ini gagal dengan IllegalArgumentException
jika
- batas penyimpanan telah terlampaui oleh aplikasi panggilan dan/atau
- parameter URI apa pun dalam
CustomAudience
yang diberikan tidak diautentikasi denganCustomAudience
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
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
public TestCustomAudienceManager getTestCustomAudienceManager ()
Membuat layanan dengan API yang mendukung pengujian
Hasil | |
---|---|
TestCustomAudienceManager |
Nilai ini tidak boleh null . |
joinCustomAudience
public void joinCustomAudience (JoinCustomAudienceRequest joinCustomAudienceRequest, Executor executor, OutcomeReceiver<Object, Exception> 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
ownerPackageName
tidak memanggil nama paket aplikasi dan/atau- pembeli tidak diberi otorisasi untuk menggunakan API.
Panggilan ini gagal dengan IllegalArgumentException
jika
- batas penyimpanan telah terlampaui oleh aplikasi panggilan dan/atau
- parameter URI apa pun dalam
CustomAudience
yang diberikan tidak diautentikasi denganCustomAudience
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
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
ownerPackageName
tidak memanggil nama paket aplikasi; dan/atau- 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 . |