AdSelectionManager.ReportImpression 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
通知服务,为由标识 adSelectionId的广告选择运行选择的广告报告有新的印象。
[Android.Runtime.Register("reportImpression", "(Landroid/adservices/adselection/ReportImpressionRequest;Ljava/util/concurrent/Executor;Landroid/os/OutcomeReceiver;)V", "GetReportImpression_Landroid_adservices_adselection_ReportImpressionRequest_Ljava_util_concurrent_Executor_Landroid_os_OutcomeReceiver_Handler", ApiSince=34)]
public virtual void ReportImpression(Android.AdServices.AdSelection.ReportImpressionRequest request, Java.Util.Concurrent.IExecutor executor, Android.OS.IOutcomeReceiver receiver);
[<Android.Runtime.Register("reportImpression", "(Landroid/adservices/adselection/ReportImpressionRequest;Ljava/util/concurrent/Executor;Landroid/os/OutcomeReceiver;)V", "GetReportImpression_Landroid_adservices_adselection_ReportImpressionRequest_Ljava_util_concurrent_Executor_Landroid_os_OutcomeReceiver_Handler", ApiSince=34)>]
abstract member ReportImpression : Android.AdServices.AdSelection.ReportImpressionRequest * Java.Util.Concurrent.IExecutor * Android.OS.IOutcomeReceiver -> unit
override this.ReportImpression : Android.AdServices.AdSelection.ReportImpressionRequest * Java.Util.Concurrent.IExecutor * Android.OS.IOutcomeReceiver -> unit
参数
- request
- ReportImpressionRequest
要报告的广告选择标识符和配置。
- executor
- IExecutor
用于服务回调的执行程序。 服务访问期间的错误可以直接发送到接收方。
- receiver
- IOutcomeReceiver
操作的回调。 在 Android 16 AOSP 源中,它可以接收结果或异常。 在 Android 17 AOSP 源中,两个服务回调都报告了异常。
- 特性
注解
通知服务,为由标识 adSelectionId的广告选择运行选择的广告报告有新的印象。 无法保证何时报告印象。 印象报告可能会延迟,报表可以批处理。
为了计算获胜的卖家报告 URL,服务将从 AdSelectionConfig#getDecisionLogicUri() 找到 ReportImpressionRequest#getAdSelectionConfig()的 JavaScript 逻辑中提取卖方的 JavaScript 逻辑。 然后,该服务将执行在调用的卖方 JS reportResult中找到的其中一个函数,并提供设备上的信号以及 ReportImpressionRequest#getAdSelectionConfig() 输入参数。
函数定义 reportResult 为:
function reportResult(ad_selection_config, render_url, bid, contextual_signals) { return { 'status': status, 'results': {'signals_for_buyer': signals_for_buyer, 'reporting_url': reporting_url};}}
为了计算获胜的买家报告 URL,服务会提取通过买家 android.adservices.customaudience.CustomAudience#getBiddingLogicUri()提取的获胜买家的 JavaScript 逻辑。 然后,该服务执行在购买者 JS reportWin中找到的其中一个函数,提供设备信号, signals_for_buyer 由 reportResult特定字段 ReportImpressionRequest#getAdSelectionConfig() 作为输入参数计算。
函数定义 reportWin 为:
function reportWin(ad_selection_signals, per_buyer_signals, signals_for_buyer, contextual_signals, custom_audience_reporting_signals) { return {'status': 0, 'results': {'reporting_url': reporting_url};}}
此外,买家和卖家可以选择注册以接收有关特定广告事件的报表。 为此,他们可以分别调用内部和registerAdBeacon买家和卖家提供reportWin的平台功能reportResult。
函数定义 registerBeacon 为:
function registerAdBeacon(beacons),其中 beacons 字符串对的听写
对于每个广告事件,买家/卖家都对报表感兴趣,他们会向event_key听写添加一个 event_reporting_uri:beacons对,其中event_key是该特定事件的标识符。 当 SDK 调用event_key时,这ReportEventRequest#getKey()应该匹配#reportEvent。 此外,每个 event_reporting_uri 应正确分析为一个 android.net.Uri。 SDK 调用android.net.Uri时会#reportEvent报告此情况。
当买家/卖家添加他们想要接收事件的所有配对时,他们可以调用 registerAdBeacon(beacons),其中 beacons 是他们添加对的听写的名称。
registerAdBeacon 将引发 TypeError 以下情况:
<ol><li>registerAdBeacon被叫了不止一次。 如果在 reportWin/reportResult 中捕获此错误,则原始配对集将注册 <li>registerAdBeacon 没有完全 1 个听写参数。
<li>1 听写参数的内容不是所有 String: String 配对。
</ol>
输出由 receiver 传递,该输出为成功运行返回空 Object ,或者 Exception 包括引发的异常的类型和相应的错误消息。
如果引发, IllegalArgumentException 则由 API 收到的用于报告印象的输入参数无效导致的。
IllegalStateException如果引发错误消息“AdSelection 服务失败”。
如果引发, LimitExceededException 则当调用包超出允许的速率限制并受到限制时,会导致它。
如果引发, SecurityException 则当调用方未获得授权或未请求权限时,会导致该调用方。
印象将最多报告一次作为尽力尝试。
本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。