CustomAudience

public final class CustomAudience
extends Object implements Parcelable

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

Menampilkan informasi yang diperlukan agar audiens kustom dapat berpartisipasi dalam pemilihan iklan.

Audiens kustom adalah pengelompokan abstrak terhadap pengguna yang memiliki minat serupa seperti yang ditunjukkan. Class ini adalah kumpulan beberapa data yang disimpan di perangkat dan diperlukan untuk menayangkan iklan yang menarget satu audiens kustom.

Ringkasan

Class bertingkat

class CustomAudience.Builder

Builder untuk objek CustomAudience. 

Konstanta turunan

Kolom

public static final Creator<CustomAudience> CREATOR

Metode publik

boolean equals(Object o)

Memastikan apakah dua objek CustomAudience berisi informasi yang sama atau tidak.

Instant getActivationTime()

Pada pembuatan objek CustomAudience, waktu aktivasi opsional dapat ditetapkan nanti untuk menayangkan aktivasi yang tertunda.

List<AdData> getAds()

Daftar objek AdData ini adalah daftar lengkap dan menyeluruh dari iklan yang akan ditayangkan oleh CustomAudience ini selama proses pemilihan iklan.

Uri getBiddingLogicUri()

Menampilkan URI target yang digunakan untuk mengambil logika bidding saat audiens kustom berpartisipasi dalam proses pemilihan iklan.

AdTechIdentifier getBuyer()

Pembeli diidentifikasi oleh domain dalam bentuk "buyerexample.com".

Uri getDailyUpdateUri()

URI ini mengarah ke server yang dioperasikan oleh pembeli yang menghosting data bidding dan metadata iklan yang diperbarui untuk digunakan dalam proses pemilihan iklan di perangkat.

Instant getExpirationTime()

Setelah masa berlaku habis, audiens kustom tidak lagi memenuhi syarat untuk mengikuti pembaruan data iklan/bidding harian atau berpartisipasi dalam proses pemilihan iklan.

String getName()

Nama audiens kustom adalah string arbitrer yang disediakan oleh pemilik dan pembeli saat membuat objek CustomAudience.

TrustedBiddingData getTrustedBiddingData()

Data bidding tepercaya terdiri atas URI yang mengarah ke server tepercaya untuk data bidding pembeli dan daftar kunci untuk membuat kueri server.

AdSelectionSignals getUserBiddingSignals()

Sinyal bidding pengguna disediakan secara opsional oleh pembeli untuk digunakan oleh JavaScript yang disediakan oleh pembeli selama pemilihan iklan di lingkungan eksekusi yang terisolasi.

int hashCode()

Menampilkan hash data objek CustomAudience.

void writeToParcel(Parcel dest, int flags)

Menyatukan objek ini ke dalam sebuah Parcel.

Metode turunan

Kolom

CREATOR

Ditambahkan di level API 34
Juga di Ekstensi Layanan Iklan 4 
public static final Creator<CustomAudience> CREATOR

Metode publik

equals

Ditambahkan di level API 34 
public boolean equals (Object o)

Memastikan apakah dua objek CustomAudience berisi informasi yang sama atau tidak.

Parameter
o Object: objek referensi yang akan dibandingkan.
Hasil
boolean true jika objek ini sama dengan argumen obj; false sebaliknya.

getActivationTime

Ditambahkan di level API 34
Juga di Ekstensi Layanan Iklan 4 
public Instant getActivationTime ()

Pada pembuatan objek CustomAudience, waktu aktivasi opsional dapat ditetapkan nanti untuk menayangkan aktivasi yang tertunda. Jika kolom tidak disetel, CustomAudience akan diaktifkan saat bergabung.

Misalnya, audiens kustom untuk pengguna lama mungkin tidak akan aktif hingga mencapai batas ketidakaktifan, yaitu saat iklan audiens kustom akan berpartisipasi dalam proses pemilihan iklan. Hal ini berpotensi mengalihkan pengguna yang tidak aktif ke aplikasi pemilik asli. .

Penundaan maksimum pada aktivasi adalah 60 hari sejak pembuatan awal.

Jika ditentukan, waktu aktivasi harus lebih cepat dari waktu habis masa berlaku.

Hasil
Instant stempel waktu Instant, dipotong menjadi milidetik, setelah itu audiens aktif Nilai ini dapat berupa null.

getAds

Ditambahkan di level API 34
Juga di Ekstensi Layanan Iklan 4 
public List<AdData> getAds ()

Daftar objek AdData ini adalah daftar lengkap dan menyeluruh dari iklan yang akan ditayangkan oleh CustomAudience ini selama proses pemilihan iklan.

Jika tidak ditentukan, atau jika daftar kosong diberikan, CustomAudience tidak akan berpartisipasi dalam pemilihan iklan sampai daftar iklan yang valid diberikan untuk audiens kustom melalui pembaruan harian.

Hasil
List<AdData> List objek AdData yang mewakili iklan yang saat ini ditayangkan oleh audiens kustom Nilai ini tidak boleh null.

getBiddingLogicUri

Ditambahkan di level API 34
Juga di Ekstensi Layanan Iklan 4 
public Uri getBiddingLogicUri ()

Menampilkan URI target yang digunakan untuk mengambil logika bidding saat audiens kustom berpartisipasi dalam proses pemilihan iklan. URI harus menggunakan HTTPS.

Hasil
Uri URI untuk mengambil logika bidding pembeli Nilai ini tidak boleh null.

getBuyer

Ditambahkan di level API 34
Juga di Ekstensi Layanan Iklan 4 
public AdTechIdentifier getBuyer ()

Pembeli diidentifikasi oleh domain dalam bentuk "buyerexample.com".

Hasil
AdTechIdentifier AdTechIdentifier yang berisi domain pembeli kustom Nilai ini tidak boleh null.

getDailyUpdateUri

Ditambahkan di level API 34
Juga di Ekstensi Layanan Iklan 4 
public Uri getDailyUpdateUri ()

URI ini mengarah ke server yang dioperasikan oleh pembeli yang menghosting data bidding dan metadata iklan yang diperbarui untuk digunakan dalam proses pemilihan iklan di perangkat. URI harus menggunakan HTTPS.

Hasil
Uri URI pembaruan harian audiens kustom Nilai ini tidak boleh null.

getExpirationTime

Ditambahkan di level API 34
Juga di Ekstensi Layanan Iklan 4 
public Instant getExpirationTime ()

Setelah masa berlaku habis, audiens kustom tidak lagi memenuhi syarat untuk mengikuti pembaruan data iklan/bidding harian atau berpartisipasi dalam proses pemilihan iklan. Kemudian, audiens kustom tersebut akan dihapus dari memori pada pembaruan harian berikutnya.

Jika tidak ada waktu habis masa berlaku yang ditentukan saat pembuatan CustomAudience, masa berlaku akan ditetapkan secara default ke 60 hari sejak aktivasi.

Masa berlaku maksimum adalah 60 hari sejak aktivasi awal.

Hasil
Instant stempel waktu Instant, dipotong menjadi milidetik, setelah itu audiens harus dihapus Nilai ini dapat berupa null.

getName

Ditambahkan di level API 34
Juga di Ekstensi Layanan Iklan 4 
public String getName ()

Nama audiens kustom adalah string arbitrer yang disediakan oleh pemilik dan pembeli saat membuat objek CustomAudience.

Hasil
String Nama String audiens kustom Nilai ini tidak boleh null.

getTrustedBiddingData

Ditambahkan di level API 34
Juga di Ekstensi Layanan Iklan 4 
public TrustedBiddingData getTrustedBiddingData ()

Data bidding tepercaya terdiri atas URI yang mengarah ke server tepercaya untuk data bidding pembeli dan daftar kunci untuk membuat kueri server. Perlu diketahui bahwa kunci merupakan ID arbitrer yang hanya akan digunakan untuk membuat kueri ke server tepercaya untuk logika bidding pembeli selama pemilihan iklan.

Jika tidak ditentukan, CustomAudience tidak akan berpartisipasi dalam pemilihan iklan sampai data bidding tepercaya diberikan untuk audiens kustom melalui pembaruan harian.

Hasil
TrustedBiddingData objek TrustedBiddingData yang berisi bidding tepercaya audiens kustom data Nilai ini dapat berupa null.

getUserBiddingSignals

Ditambahkan di level API 34
Juga di Ekstensi Layanan Iklan 4 
public AdSelectionSignals getUserBiddingSignals ()

Sinyal bidding pengguna disediakan secara opsional oleh pembeli untuk digunakan oleh JavaScript yang disediakan pembeli selama pemilihan iklan di lingkungan eksekusi yang terisolasi.

Jika sinyal bidding pengguna bukan merupakan objek JSON valid yang dapat digunakan oleh JS pembeli, audiens kustom tidak akan memenuhi syarat untuk pemilihan iklan.

Jika tidak ditentukan, CustomAudience tidak akan berpartisipasi dalam pemilihan iklan sampai sinyal bidding pengguna disediakan untuk audiens kustom melalui pembaruan harian.

Hasil
AdSelectionSignals objek AdSelectionSignals yang mewakili sinyal bidding pengguna untuk audiens kustom Nilai ini dapat berupa null.

hashCode

Ditambahkan di level API 34 
public int hashCode ()

Menampilkan hash data objek CustomAudience.

Hasil
int nilai kode hash untuk objek ini.

writeToParcel

Ditambahkan di level API 34 
public void writeToParcel (Parcel dest, 
                int flags)

Menyatukan objek ini ke dalam sebuah Parcel.

Parameter
dest Parcel: Nilai ini tidak boleh null.
flags int: Flag tambahan tentang saran penulisan objek yang baik. Mungkin 0 atau Parcelable.PARCELABLE_WRITE_RETURN_VALUE. Nilainya adalah 0 atau kombinasi dari Parcelable.PARCELABLE_WRITE_RETURN_VALUE, dan android.os.Parcelable.PARCELABLE_ELIDE_DUPLICATES