UpdateAdCounterHistogramRequest

public class UpdateAdCounterHistogramRequest
extends Object

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

请求对象，包装了更新广告计数器直方图所需的参数。

广告计数器直方图是与广告计数器键和广告事件类型相关的历史事件日志，在使用 Protected Audience API 时，用于通知频率上限过滤。

摘要

嵌套类

类 UpdateAdCounterHistogramRequest.Builder

UpdateAdCounterHistogramRequest 对象的构建器。 

公共方法

布尔值 equals(Object o)

检查 UpdateAdCounterHistogramRequest 对象是否包含相同信息。
int getAdEventType()

获取广告事件类型，该类型与广告的计数器键一起，标识应更新哪个直方图。
long getAdSelectionId()

获取与渲染广告事件关联的广告选择 ID。
AdTechIdentifier getCallerAdTech()

获取调用方 adtech 实体的 AdTechIdentifier。
int hashCode()

返回 UpdateAdCounterHistogramRequest 对象数据的哈希值。
字符串 toString()

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

继承的方法

公共方法

equals

public boolean equals (Object o)

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

参数
o Object：用于比较的引用对象。
返回
布尔值 true 如果此对象与 obj 参数相同；否则 false。

getAdEventType

public int getAdEventType ()

获取广告事件类型，该类型与广告的计数器键一起，标识应更新哪个直方图。

返回
int 值为 android.adservices.common.FrequencyCapFilters.AD_EVENT_TYPE_INVALID, FrequencyCapFilters.AD_EVENT_TYPE_WIN, FrequencyCapFilters.AD_EVENT_TYPE_IMPRESSION, FrequencyCapFilters.AD_EVENT_TYPE_VIEW, FrequencyCapFilters.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 广告选择中选择，并且广告选择调用必须由与当前调用应用相同的应用启动。对于 getAdEventType() 中的广告事件类型，与广告选择 ID 指定的广告关联的所有广告计数器键的事件直方图将被更新，用于 Protected Audience 频率上限过滤。

返回
long

getCallerAdTech

public AdTechIdentifier getCallerAdTech ()

获取调用方 adtech 实体的 AdTechIdentifier。

使用此 UpdateAdCounterHistogramRequest 对象的 adtech 必须已注册 Privacy Sandbox 并被允许代表调用应用行事。指定的 adtech 不需要与拥有已渲染广告的买方或发起与 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 方法返回一个“文本表示”此对象的字符串。结果应该是简洁但信息丰富的表示形式，以便人们轻松阅读。建议所有子类都覆盖此方法。

类 Object 的 toString 方法返回一个字符串，该字符串由对象所属类的名称、符号字符“@”以及对象的哈希码的无符号十六进制表示组成。换句话说，此方法返回的字符串值等于

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

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