AdData

public final class AdData
extends Object implements Parcelable

java.lang.Object
   ↳ android.adservices.common.AdData

表示广告特有的数据，这些数据对于广告选择和渲染是必需的。

摘要

嵌套类

类 AdData.Builder

AdData 对象的 Builder。 

继承的常量

字段

public static final Creator<AdData> CREATOR

公共方法

boolean equals(Object o)

检查两个 AdData 对象是否包含相同的信息。
Set<Integer> getAdCounterKeys()

获取用于统计事件的键集。
AdFilters getAdFilters()

获取与广告关联的所有 AdFilters。
String getAdRenderId()

获取用于服务器竞价的广告渲染 ID。
String getMetadata()

获取在广告选择过程中使用的买家广告元数据。
Uri getRenderUri()

获取指向广告渲染资源的 URI。
int hashCode()

返回 AdData 对象数据的哈希值。
String toString()

返回对象的字符串表示形式。
void writeToParcel(Parcel dest, int flags)

将此对象展平到 Parcel 中。

继承的方法

字段

CREATOR

添加于 API 级别 34
也包含在 Ad Services Extensions 4 中
public static final Creator<AdData> CREATOR

公共方法

equals

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

检查两个 AdData 对象是否包含相同的信息。

参数
o Object：要比较的引用对象。
返回
boolean 如果此对象与 obj 参数相同，则为 true；否则为 false。

getAdCounterKeys

public Set<Integer> getAdCounterKeys ()

获取用于统计事件的键集。

每个广告最多可以关联 10 个广告计数器键。

在广告选择期间，键和每个键的计数用于频次上限过滤，以排除关联的广告参与竞价。

请注意，这些键可以与自定义受众群体的每日更新期间的广告及其他竞价数据一起被覆盖。

返回
Set<Integer> 此值不能为 null。

getAdFilters

public AdFilters getAdFilters ()

获取与广告关联的所有 AdFilters。

过滤器（如果达到或超出）会将关联的广告排除在广告选择之外。它们是可选的，如果为 null，则表示此广告没有适用的过滤器。

返回
AdFilters

getAdRenderId

public String getAdRenderId ()

获取用于服务器竞价的广告渲染 ID。

当收到服务器竞价请求时，会收集每个 AdData 的广告渲染 ID。

任何没有广告渲染 ID 的 AdData 都将不符合服务器端竞价的条件。

返回
String 此值可以为 null。

getMetadata

添加于 API 级别 34
也包含在 Ad Services Extensions 4 中
public String getMetadata ()

获取在广告选择过程中使用的买家广告元数据。

元数据应为有效 JSON 对象，并序列化为字符串。元数据表示广告特有的竞价信息，这些信息将在广告选择过程中作为竞价生成的一部分使用，并在买家 JavaScript 逻辑中使用，该逻辑在隔离的执行环境中执行。

如果元数据不是买家 JS 可以使用的有效 JSON 对象，则广告将不符合广告选择的条件。

返回
String 此值不能为 null。

getRenderUri

添加于 API 级别 34
也包含在 Ad Services Extensions 4 中
public Uri getRenderUri ()

获取指向广告渲染资源的 URI。URI 必须使用 HTTPS。

返回
Uri 此值不能为 null。

hashCode

添加于 API 级别 34
public int hashCode ()

返回 AdData 对象数据的哈希值。

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

toString

添加于 API 级别 34
public String toString ()

返回对象的字符串表示形式。一般来说，toString 方法返回一个“文本表示”此对象的字符串。结果应该是简洁但信息丰富、易于阅读的表示形式。建议所有子类都覆盖此方法。

类 Object 的 toString 方法返回一个包含以下内容的字符串：对象的类的名称、at 符号 @，以及对象哈希码的无符号十六进制表示。换句话说，此方法返回一个等于以下值的字符串：

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

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

writeToParcel

添加于 API 级别 34
public void writeToParcel (Parcel dest, 
                int flags)

将此对象展平到 Parcel 中。

参数
dest Parcel：此值不能为 null。
flags int：关于如何写入对象的附加标志。可以是 0 或 Parcelable.PARCELABLE_WRITE_RETURN_VALUE。值为 0 或 Parcelable.PARCELABLE_WRITE_RETURN_VALUE 和 android.os.Parcelable.PARCELABLE_ELIDE_DUPLICATES 的组合