Ditambahkan di level API 34
Juga di Ekstensi Layanan Iklan 4

ID iklan

public class AdId
extends Object

java.lang.Object
   ↳ android.adservices.adid.AdId


ID unik untuk setiap profil yang dapat direset oleh pengguna di seluruh perangkat, untuk iklan.

Jaringan iklan dapat menggunakan AdId untuk memonetisasi Iklan Menurut Minat (IBA), yaitu penargetan khusus, dan iklan pemasaran ulang. Pengguna mungkin membatasi ketersediaan ID ini.

Ringkasan

Konstanta

String ZERO_OUT

ad id zero-out yang ditampilkan saat pengguna memiliki limited ad tracking.

Konstruktor publik

AdId(String adId, boolean limitAdTrackingEnabled)

Membuat instance AdId

Metode publik

boolean equals(Object o)

Menunjukkan apakah beberapa objek lain "sama dengan" objek ini atau tidak.

String getAdId()

ID iklan.

int hashCode()

Menampilkan nilai kode hash untuk objek.

boolean isLimitAdTrackingEnabled()

Mengambil setelan batasi pelacakan iklan yang diaktifkan.

String toString()

Menampilkan representasi string dari objek ini.

Metode turunan

Konstanta

TIDAK ADA KELUAR

Ditambahkan di level API 34
Juga di Ekstensi Layanan Iklan 4
public static final String ZERO_OUT

ad id zero-out yang ditampilkan saat pengguna memiliki limited ad tracking.

Nilai Konstanta: "00000000-0000-0000-0000-000000000000"

Konstruktor publik

ID iklan

Ditambahkan di level API 34
Juga di Ekstensi Layanan Iklan 4
public AdId (String adId, 
                boolean limitAdTrackingEnabled)

Membuat instance AdId

Parameter
adId String: diperoleh dari layanan penyedia. Nilai ini tidak boleh null.

limitAdTrackingEnabled boolean: nilai dari layanan penyedia yang menentukan nilai ID iklan,

Metode publik

equals

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

Menunjukkan apakah objek lain "sama dengan" objek ini atau tidak.

Metode equals mengimplementasikan hubungan kesetaraan pada referensi objek non-null:

  • Metode ini refleksif: untuk nilai referensi non-null x, x.equals(x) akan menampilkan true.
  • Metode ini simetris: untuk nilai referensi non-null x dan y, x.equals(y) akan menampilkan true jika dan hanya jika y.equals(x) menampilkan true.
  • Metode ini bersifat transitif: untuk nilai referensi non-null x, y, dan z, jika x.equals(y) menampilkan true dan y.equals(z) menampilkan true, maka x.equals(z) akan menampilkan true.
  • Metode ini konsisten: untuk semua nilai referensi non-null x dan y, beberapa pemanggilan x.equals(y) secara konsisten menampilkan true atau secara konsisten menampilkan false, asalkan tidak ada informasi yang digunakan dalam perbandingan equals pada objek yang diubah.
  • Untuk nilai referensi non-null x, x.equals(null) akan menampilkan false.

Metode equals untuk class Object mengimplementasikan hubungan kesetaraan yang paling diskriminatif pada objek; yaitu, untuk nilai referensi non-null x dan y, metode ini akan menampilkan true jika dan hanya jika x dan y merujuk ke objek yang sama (x == y memiliki nilai true).

Perhatikan bahwa secara umum Anda perlu mengganti metode hashCode setiap kali metode ini diabaikan, sehingga dapat mempertahankan kontrak umum untuk metode hashCode, yang menyatakan bahwa objek yang sama harus memiliki kode hash yang sama.

Parameter
o Object: objek referensi yang akan dibandingkan.

Hasil
boolean true jika objek ini sama dengan argumen obj; false sebaliknya.

getAdId

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

ID iklan.

Nilai ID iklan bergantung pada kombinasi isLimitAdTrackingEnabled() dan AdServicesPermissions.ACCESS_ADSERVICES_AD_ID.

Saat pengguna adalah limiting ad tracking, API akan menampilkan ZERO_OUT. Tindakan ini tidak akan mengizinkan pemanggil melacak pengguna untuk tujuan monetisasi.

Jika tidak, string unik untuk perangkat dan pengguna akan ditampilkan, yang dapat digunakan untuk melacak pengguna untuk beriklan.

Hasil
String Nilai ini tidak boleh null.

hashCode

Ditambahkan di level API 34
public int hashCode ()

Menampilkan nilai kode hash untuk objek. Metode ini didukung untuk memanfaatkan tabel hash seperti yang disediakan oleh HashMap.

Kontrak umum hashCode adalah:

  • Setiap kali dipanggil pada objek yang sama lebih dari sekali selama eksekusi aplikasi Java, metode hashCode harus secara konsisten menampilkan bilangan bulat yang sama, asalkan tidak ada informasi yang digunakan dalam perbandingan equals pada objek yang diubah. Bilangan bulat ini tidak perlu tetap konsisten dari satu eksekusi aplikasi ke eksekusi lainnya dari aplikasi yang sama.
  • Jika dua objek sama menurut metode equals(Object), memanggil metode hashCode pada setiap objek tersebut harus menghasilkan hasil bilangan bulat yang sama.
  • Jika dua objek tidak sama menurut metode equals(java.lang.Object), memanggil metode hashCode pada masing-masing objek tidak harus memberikan hasil bilangan bulat yang berbeda. Namun, programmer harus menyadari bahwa memberikan hasil bilangan bulat yang berbeda untuk objek yang tidak sama dapat meningkatkan performa tabel hash.

Meskipun cukup praktis, metode hashCode yang ditentukan oleh Object class memang menampilkan bilangan bulat yang berbeda untuk objek yang berbeda. (HashCode mungkin atau mungkin tidak diterapkan sebagai fungsi dari alamat memori objek pada waktu tertentu.)

Hasil
int nilai kode hash untuk objek ini.

isLimitAdTrackingEnabled

Ditambahkan di level API 34
Juga di Ekstensi Layanan Iklan 4
public boolean isLimitAdTrackingEnabled ()

Mengambil setelan batasi pelacakan iklan yang diaktifkan.

Nilai ini benar jika pengguna mengaktifkan pembatasan pelacakan iklan, false jika tidak.

Hasil
boolean

toString

Ditambahkan di level API 34
public String toString ()

Menampilkan representasi string dari objek ini. Umumnya, toString menampilkan string yang "secara tekstual mewakili" objek ini. Hasilnya harus merupakan representasi yang ringkas, tetapi informatif sehingga mudah dibaca pengguna. Sebaiknya semua subclass mengganti metode ini.

Metode toString untuk class Object menampilkan string yang terdiri dari nama class yang objeknya merupakan instance, karakter simbol at `@', dan representasi heksadesimal tanpa label dari kode hash objek itu. Dengan kata lain, metode ini menampilkan string yang sama dengan nilai:

 getClass().getName() + '@' + Integer.toHexString(hashCode())
 

Hasil
String representasi string dari objek.