AdId
public class AdId
extends Object
java.lang.Object | |
↳ | android.adservices.adid.AdId |
用于广告的唯一、用户可重置的、设备范围的、每个配置文件的 ID。
广告网络可以使用 AdId
实现基于兴趣的广告 (IBA) 创收,即定向广告和再营销广告。用户可以限制此标识符的可用性。
摘要
常量 | |
---|---|
String |
ZERO_OUT
|
公共构造函数 | |
---|---|
AdId(String adId, boolean limitAdTrackingEnabled)
创建一个 |
公共方法 | |
---|---|
boolean
|
equals(Object o)
指示其他某个对象是否“等于”此对象。 |
String
|
getAdId()
广告 ID。 |
int
|
hashCode()
返回对象的哈希码值。 |
boolean
|
isLimitAdTrackingEnabled()
检索限制广告跟踪启用设置。 |
String
|
toString()
返回对象的字符串表示形式。 |
继承的方法 | |
---|---|
常量
公共构造函数
AdId
public AdId (String adId, boolean limitAdTrackingEnabled)
创建一个 AdId
实例
参数 | |
---|---|
adId |
String :从提供者服务获取。此值不能为 null 。 |
limitAdTrackingEnabled |
boolean :来自提供者服务的值,用于确定 adId 的值。 |
公共方法
equals
public boolean equals (Object o)
指示其他某个对象是否“等于”此对象。
equals
方法对非空对象引用实现等价关系
- 它是自反的:对于任何非空引用值
x
,x.equals(x)
应该返回true
。 - 它是对称的:对于任何非空引用值
x
和y
,x.equals(y)
应该在且仅在y.equals(x)
返回true
时返回true
。 - 它是传递的:对于任何非空引用值
x
、y
和z
,如果x.equals(y)
返回true
并且y.equals(z)
返回true
,则x.equals(z)
应该返回true
。 - 它是一致的:对于任何非空引用值
x
和y
,多次调用x.equals(y)
将始终返回true
或始终返回false
,前提是对象上用于equals
比较的信息未被修改。 - 对于任何非空引用值
x
,x.equals(null)
应该返回false
。
类 Object
的 equals
方法实现了对对象最精确的等价关系;也就是说,对于任何非空引用值 x
和 y
,当且仅当 x
和 y
引用同一个对象时(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
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
public String toString ()
返回对象的字符串表示形式。一般来说,toString
方法返回一个“文本表示”此对象的字符串。结果应该是一个简洁但有信息量的表示,方便人们阅读。建议所有子类都重写此方法。
类 Object
的 toString
方法返回一个字符串,该字符串包含对象的类名、at 符号字符 `@
' 以及对象的哈希码的无符号十六进制表示。换句话说,此方法返回一个等于以下值的字符串:
getClass().getName() + '@' + Integer.toHexString(hashCode())
返回 | |
---|---|
String |
对象的字符串表示形式。 |