UpdateAdCounterHistogramRequest

public class UpdateAdCounterHistogramRequest
extends Object

java.lang.Object
   ↳ android.adservices.adselection.UpdateAdCounterHistogramRequest


用于更新广告计数器直方图所需实参的请求对象。

广告计数器直方图是与广告计数器键和广告事件类型相关联的事件的历史日志,用于在使用 Protected Audience API 时为频次上限过滤提供依据。

总结

嵌套类

class UpdateAdCounterHistogramRequest.Builder

UpdateAdCounterHistogramRequest 对象的构建器。 

公共方法

boolean equals(Object o)

检查 UpdateAdCounterHistogramRequest 对象是否包含相同的信息。

int getAdEventType()

获取广告事件类型,与广告的计数器键一起用于确定应更新哪个直方图。

long getAdSelectionId()

获取与所呈现广告的事件相关联的广告选择 ID。

AdTechIdentifier getCallerAdTech()

获取调用方广告技术实体的 AdTechIdentifier

int hashCode()

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

String toString()

返回对象的字符串表示。

继承的方法

公共方法

equals

public boolean equals (Object o)

检查 UpdateAdCounterHistogramRequest 对象是否包含相同的信息。

参数
o Object:用来进行比较的参照对象。

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

getAdEventType

public int getAdEventType ()

获取广告事件类型,与广告的计数器键一起用于确定应更新哪个直方图。

开球回攻次数
int 值为 android.adservices.common.FrequencyCapFilters.AD_EVENT_TYPE_INVALID、FrequencyCapFilters.AD_EVENT_TYPE_WINFrequencyCapFilters.AD_EVENT_TYPE_IMPRESSIONFrequencyCapFilters.AD_EVENT_TYPE_VIEWFrequencyCapFilters.AD_EVENT_TYPE_CLICK、android.adservices.common.FrequencyCapFilters.AD_EVENT_TYPE_MIN 或 android.adservices.common.FrequencyCapFilters.AD_EVENT_TYPE_MAX

getAdSelectionId

public long getAdSelectionId ()

获取与所呈现广告的事件相关联的广告选择 ID。

如需详细了解广告选择 ID,请参阅 AdSelectionOutcome

广告必须在过去 24 小时内从 Protected Audience 广告选择中选定,并且广告选择调用必须从当前发起调用的应用所在的应用发起。与广告选择 ID 指定的广告关联的所有广告计数器键的事件直方图将针对 getAdEventType() 中的广告事件类型进行更新,以用于 Protected Audience 频次上限过滤。

开球回攻次数
long

getCallerAdTech

public AdTechIdentifier getCallerAdTech ()

获取调用方广告技术实体的 AdTechIdentifier

使用此 UpdateAdCounterHistogramRequest 对象的广告技术平台必须已注册 Privacy Sandbox,并且能够代表发起调用的应用执行操作。指定的广告技术平台不必与拥有所呈现广告的买方或发起与 getAdSelectionId() 返回的 ID 相关联的广告选择的卖方使用同一广告技术平台。

如需详细了解 API 要求和例外情况,请参阅 AdSelectionManager.updateAdCounterHistogram(android.adservices.adselection.UpdateAdCounterHistogramRequest, java.util.concurrent.Executor, android.os.OutcomeReceiver)

开球回攻次数
AdTechIdentifier 此值不能为 null

hashCode

public int hashCode ()

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

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

toString

public String toString ()

返回对象的字符串表示。通常,toString 方法会返回一个“以文本形式表示”此对象的字符串。结果应该是一个简洁但信息丰富,并且便于阅读的字符串表示。建议所有子类都覆盖此方法。

ObjecttoString 方法会返回一个字符串,其中包含类的名称(相应对象是此类的实例)、字符“@”,以及此对象哈希代码的无符号十六进制表示。也就是说,此方法所返回的字符串等于以下公式的值:

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

开球回攻次数
String 对象的字符串表示法。