AdSelectionManager.GetAdSelectionData 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
从设备收集自定义受众数据。
[Android.Runtime.Register("getAdSelectionData", "(Landroid/adservices/adselection/GetAdSelectionDataRequest;Ljava/util/concurrent/Executor;Landroid/os/OutcomeReceiver;)V", "GetGetAdSelectionData_Landroid_adservices_adselection_GetAdSelectionDataRequest_Ljava_util_concurrent_Executor_Landroid_os_OutcomeReceiver_Handler", ApiSince=35)]
public virtual void GetAdSelectionData(Android.AdServices.AdSelection.GetAdSelectionDataRequest request, Java.Util.Concurrent.IExecutor executor, Android.OS.IOutcomeReceiver receiver);
[<Android.Runtime.Register("getAdSelectionData", "(Landroid/adservices/adselection/GetAdSelectionDataRequest;Ljava/util/concurrent/Executor;Landroid/os/OutcomeReceiver;)V", "GetGetAdSelectionData_Landroid_adservices_adselection_GetAdSelectionDataRequest_Ljava_util_concurrent_Executor_Landroid_os_OutcomeReceiver_Handler", ApiSince=35)>]
abstract member GetAdSelectionData : Android.AdServices.AdSelection.GetAdSelectionDataRequest * Java.Util.Concurrent.IExecutor * Android.OS.IOutcomeReceiver -> unit
override this.GetAdSelectionData : Android.AdServices.AdSelection.GetAdSelectionDataRequest * Java.Util.Concurrent.IExecutor * Android.OS.IOutcomeReceiver -> unit
参数
- request
- GetAdSelectionDataRequest
包含数据收集的卖家和协调器信息的请求。
- executor
- IExecutor
此值不能为 null。 回调和侦听器事件通过此执行程序调度,提供一种控制使用哪个线程的简单方法。 若要通过应用程序的主线程调度事件,可以使用 Context.getMainExecutor()。 否则,请提供调度到相应线程的执行程序。
- receiver
- IOutcomeReceiver
操作的回调。 在 Android 16 AOSP 源中,它可以接收数据结果或异常。 在 Android 17 AOSP 源中,两个服务回调都报告了异常。
- 特性
注解
从设备收集自定义受众数据。 返回一个压缩和加密的 Blob,以发送到拍卖服务器进行广告选择。 有关更多详细信息,请访问 投标和拍卖服务解释器。
自定义受众广告必须 ad_render_id 符合收集条件。
请参阅 AdSelectionManager#persistAdSelectionResult 如何使用此 API 生成的 Blob 在服务器端处理广告选择运行的结果。
输出由接收方传递,接收方返回成功运行, GetAdSelectionDataOutcome 或者 Exception 包括引发的异常的类型和相应的错误消息。
如果引发, IllegalArgumentException 则由 API 收到的无效输入参数导致运行广告选择。
IllegalStateException如果引发错误消息“AdSelection 服务失败”。
如果引发, TimeoutException 则会导致在投标、评分或整体选择过程中遇到超时以查找获胜广告。
如果引发, LimitExceededException 则当调用包超出允许的速率限制并受到限制时,会导致它。
如果引发, SecurityException 则当调用方未获得授权或未请求权限时,会导致该调用方。
本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。