AdId

public class AdId
extends Object

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


用于广告的唯一、用户可重置的、设备范围的、每个配置文件的 ID。

广告网络可以使用 AdId 实现基于兴趣的广告 (IBA) 创收,即定向广告和再营销广告。用户可以限制此标识符的可用性。

摘要

常量

String ZERO_OUT

当用户限制广告跟踪时返回的归零的 广告 ID

公共构造函数

AdId(String adId, boolean limitAdTrackingEnabled)

创建一个 AdId 实例

公共方法

boolean equals(Object o)

指示其他某个对象是否“等于”此对象。

String getAdId()

广告 ID。

int hashCode()

返回对象的哈希码值。

boolean isLimitAdTrackingEnabled()

检索限制广告跟踪启用设置。

String toString()

返回对象的字符串表示形式。

继承的方法

常量

ZERO_OUT

public static final String ZERO_OUT

当用户限制广告跟踪时返回的归零的 广告 ID

常量值: "00000000-0000-0000-0000-000000000000"

公共构造函数

AdId

public AdId (String adId, 
                boolean limitAdTrackingEnabled)

创建一个 AdId 实例

参数
adId String:从提供者服务获取。此值不能为 null

limitAdTrackingEnabled boolean:来自提供者服务的值,用于确定 adId 的值。

公共方法

equals

添加于 API level 34
public boolean equals (Object o)

指示其他某个对象是否“等于”此对象。

equals 方法对非空对象引用实现等价关系

  • 它是自反的:对于任何非空引用值 xx.equals(x) 应该返回 true
  • 它是对称的:对于任何非空引用值 xyx.equals(y) 应该在且仅在 y.equals(x) 返回 true 时返回 true
  • 它是传递的:对于任何非空引用值 xyz,如果 x.equals(y) 返回 true 并且 y.equals(z) 返回 true,则 x.equals(z) 应该返回 true
  • 它是一致的:对于任何非空引用值 xy,多次调用 x.equals(y) 将始终返回 true 或始终返回 false,前提是对象上用于 equals 比较的信息未被修改。
  • 对于任何非空引用值 xx.equals(null) 应该返回 false

Objectequals 方法实现了对对象最精确的等价关系;也就是说,对于任何非空引用值 xy,当且仅当 xy 引用同一个对象时(x == y 的值为 true),此方法才返回 true

请注意,通常在重写此方法时需要重写 hashCode 方法,以保持 hashCode 方法的一般约定,即相等的对象必须具有相等的哈希码。

参数
o Object:用于比较的引用对象。

返回
boolean 如果此对象与 obj 参数相同,则返回 true;否则返回 false

getAdId

public String getAdId ()

广告 ID。

广告 ID 的值取决于 isLimitAdTrackingEnabled()AdServicesPermissions.ACCESS_ADSERVICES_AD_ID 的组合。

当用户限制广告跟踪时,API 返回 ZERO_OUT。这禁止调用者出于创收目的跟踪用户。

否则,将返回特定于设备和用户的唯一字符串,可用于跟踪用户以进行广告投放。

返回
String 此值不能为 null

hashCode

添加于 API level 34
public int hashCode ()

返回对象的哈希码值。此方法为哈希表(例如由 HashMap 提供的哈希表)提供支持。

hashCode 的一般约定如下:

  • 在 Java 应用的一次执行过程中,对同一个对象多次调用 hashCode 方法时,只要对象中用于 equals 比较的信息未被修改,该方法就必须始终返回同一个整数。该整数不必在同一应用的不同执行之间保持一致。
  • 如果两个对象根据 equals(Object) 方法相等,则在这两个对象上调用 hashCode 方法必须产生相同的整数结果。
  • 要求如果两个对象根据 equals(java.lang.Object) 方法不相等,则对这两个对象分别调用 hashCode 方法必须产生不同的整数结果。但是,程序员应该意识到,为不相等的对象产生不同的整数结果可能会提高哈希表的性能。

在合理可行的情况下,类 Object 定义的 hashCode 方法确实会为不同的对象返回不同的整数。(哈希码可能或可能不以对象在某个时间点的内存地址的函数实现。)

返回
int 此对象的哈希码值。

isLimitAdTrackingEnabled

public boolean isLimitAdTrackingEnabled ()

检索限制广告跟踪启用设置。

如果用户启用了限制广告跟踪,此值为 true;否则为 false

返回
boolean

toString

添加于 API level 34
public String toString ()

返回对象的字符串表示形式。一般来说,toString 方法返回一个“文本表示”此对象的字符串。结果应该是一个简洁但有信息量的表示,方便人们阅读。建议所有子类都重写此方法。

ObjecttoString 方法返回一个字符串,该字符串包含对象的类名、at 符号字符 `@' 以及对象的哈希码的无符号十六进制表示。换句话说,此方法返回一个等于以下值的字符串:

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

返回
String 对象的字符串表示形式。