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 |
对象的字符串表示形式。 |