Mã quảng cáo

public class AdId
extends Object

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


Một mã nhận dạng duy nhất cho từng hồ sơ, được dùng trên toàn thiết bị để quảng cáo. Người dùng có thể đặt lại mã này.

Các mạng quảng cáo có thể sử dụng AdId để kiếm tiền từ Quảng cáo dựa trên mối quan tâm (IBA), tức là quảng cáo nhắm mục tiêu và quảng cáo tái tiếp thị. Người dùng có thể giới hạn phạm vi cung cấp của giá trị nhận dạng này.

Tóm tắt

Hằng số

String ZERO_OUT

Một ad id được chuyển thành 0 và được trả về khi người dùng có limited ad tracking.

Hàm khởi tạo công khai

AdId(String adId, boolean limitAdTrackingEnabled)

Tạo một thực thể của AdId

Phương thức công khai

boolean equals(Object o)

Cho biết liệu một số đối tượng khác có "bằng" đối tượng này hay không.

String getAdId()

Mã nhận dạng cho quảng cáo.

int hashCode()

Trả về một giá trị mã băm cho đối tượng.

boolean isLimitAdTrackingEnabled()

Truy xuất chế độ cài đặt giới hạn đã bật tính năng theo dõi quảng cáo.

String toString()

Trả về một chuỗi đại diện của đối tượng.

Các phương thức kế thừa

Hằng số

ZERO_OUT

Đã thêm vào API cấp 34
Cũng có trong Tiện ích Dịch vụ quảng cáo 4
public static final String ZERO_OUT

Một ad id được chuyển thành 0 và được trả về khi người dùng có limited ad tracking.

Giá trị không đổi: "00000000-0000-0000-0000-000000000000"

Hàm khởi tạo công khai

Mã nhận dạng cho quảng cáo

Đã thêm vào API cấp 34
Cũng có trong Tiện ích Dịch vụ quảng cáo 4
public AdId (String adId, 
                boolean limitAdTrackingEnabled)

Tạo một thực thể của AdId

Tham số
adId String: lấy từ dịch vụ của nhà cung cấp. Giá trị này không được là null.

limitAdTrackingEnabled boolean: giá trị từ dịch vụ của nhà cung cấp, xác định giá trị của mã nhận dạng cho quảng cáo.

Phương thức công khai

equals

Đã thêm vào API cấp 34
public boolean equals (Object o)

Cho biết liệu một số đối tượng khác có "bằng" đối tượng này hay không.

Phương thức equals triển khai mối quan hệ tương đương trên các tệp tham chiếu đối tượng không có giá trị null:

  • Phản hồi: đối với mọi giá trị tham chiếu không có giá trị null x, x.equals(x) sẽ trả về true.
  • Đó là đối xứng: đối với mọi giá trị tham chiếu không có giá trị null xy, x.equals(y) sẽ trả về true nếu và chỉ khi y.equals(x) trả về true .
  • Giá trị này là tạm thời: đối với mọi giá trị tham chiếu không có giá trị null x, y, và z, nếu x.equals(y) trả về truey.equals(z) trả về true, sau đó x.equals(z) sẽ trả về true.
  • Giá trị này nhất quán: đối với mọi giá trị tham chiếu không có giá trị null xy, nhiều lệnh gọi x.equals(y) sẽ trả về một cách nhất quán true hoặc trả về nhất quán false, miễn là không có thông tin nào được sử dụng trong thông tin so sánh equals trên các đối tượng được sửa đổi.
  • Đối với mọi giá trị tham chiếu không có giá trị null x, x.equals(null) sẽ trả về false.

Phương thức equals cho loại Object triển khai mối quan hệ tương đương có thể phân biệt nhiều nhất trên các đối tượng; tức là đối với mọi giá trị tham chiếu không có giá trị null xy, phương thức này trả về true nếu và chỉ khi xy tham chiếu đến cùng một đối tượng (x == y có giá trị true).

Xin lưu ý rằng thông thường, bạn cần phải ghi đè phương thức hashCode bất cứ khi nào phương thức này bị ghi đè, để duy trì hợp đồng chung cho phương thức hashCode, trong đó nêu rõ rằng các đối tượng bằng nhau phải có mã băm bằng nhau.

Tham số
o Object: đối tượng tham chiếu cần so sánh.

Giá trị trả về
boolean true nếu đối tượng này giống với đối số obj; nếu không thì false.

getAdId

Đã thêm vào API cấp 34
Cũng có trong Tiện ích Dịch vụ quảng cáo 4
public String getAdId ()

Mã nhận dạng cho quảng cáo.

Giá trị của mã nhận dạng cho quảng cáo phụ thuộc vào sự kết hợp giữa isLimitAdTrackingEnabled()AdServicesPermissions.ACCESS_ADSERVICES_AD_ID.

Khi người dùng là limiting ad tracking, API sẽ trả về ZERO_OUT Điều này không cho phép phương thức gọi theo dõi người dùng vì mục đích kiếm tiền.

Nếu không, một chuỗi duy nhất cho thiết bị và người dùng sẽ được trả về. Chuỗi này có thể được dùng để theo dõi cho quảng cáo.

Giá trị trả về
String Giá trị này không được là null.

hashCode

Đã thêm vào API cấp 34
public int hashCode ()

Trả về một giá trị mã băm cho đối tượng. Phương thức này được hỗ trợ vì lợi ích của bảng băm, chẳng hạn như các bảng do HashMap cung cấp.

Hợp đồng chung của hashCode là:

  • Bất cứ khi nào được gọi trên cùng một đối tượng nhiều lần trong quá trình thực thi một ứng dụng Java, phương thức hashCode phải luôn trả về cùng một số nguyên, miễn là không sử dụng thông tin nào trong equals các phép so sánh trên đối tượng được sửa đổi. Số nguyên này không nhất thiết phải từ một lần thực thi của một ứng dụng đến lần thực thi khác của cùng một ứng dụng.
  • Nếu có hai đối tượng bằng nhau theo phương thức equals(Object), thì việc gọi phương thức hashCode trên một trong hai đối tượng phải tạo ra một kết quả số nguyên.
  • Điều đó là không bắt buộc nếu phương thức equals(java.lang.Object) không giống nhau đối với hai đối tượng, khi đó phương thức hashCode sẽ được gọi trên một trong hai đối tượng phải tạo ra kết quả số nguyên riêng biệt. Tuy nhiên, người lập trình cần lưu ý rằng việc tạo kết quả số nguyên riêng biệt cho các đối tượng không bằng nhau có thể cải thiện hiệu suất của bảng băm.

Thực tế, phương thức hashCode mà loại Object xác định cũng trả về số nguyên riêng cho các đối tượng riêng biệt. (hashCode có thể được hoặc không được triển khai dưới dạng một hàm nào đó về địa chỉ bộ nhớ của đối tượng tại thời điểm cụ thể.)

Giá trị trả về
int một giá trị mã băm cho đối tượng này.

isLimitAdTrackingEnabled

Đã thêm vào API cấp 34
Cũng có trong Tiện ích Dịch vụ quảng cáo 4
public boolean isLimitAdTrackingEnabled ()

Truy xuất chế độ cài đặt giới hạn đã bật tính năng theo dõi quảng cáo.

Giá trị này đúng nếu người dùng đã bật tính năng theo dõi quảng cáo giới hạn, nếu không thì là false.

Giá trị trả về
boolean

toString

Đã thêm vào API cấp 34
public String toString ()

Trả về một chuỗi đại diện của đối tượng. Nhìn chung, phương thức toString sẽ trả về một chuỗi "đại diện bằng văn bản" cho đối tượng này. Kết quả trình bày phải ngắn gọn nhưng đầy đủ thông tin để người đọc dễ đọc. Tất cả các lớp con đều nên ghi đè phương thức này.

Phương thức toString dành cho lớp Object trả về một chuỗi bao gồm tên của lớp mà trong đó đối tượng là một thực thể, ký tự ký hiệu '@' và giá trị biểu thị mã băm của đối tượng ở dạng thập lục phân chưa ký. Nói cách khác, phương thức này sẽ trả về một chuỗi bằng giá trị của:

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

Giá trị trả về
String biểu thị chuỗi của đối tượng.