语言

AdSelectionManager.SelectAds 方法

定义

重载

名称 说明
SelectAds(AdSelectionConfig, IExecutor, IOutcomeReceiver)

在设备上运行广告选择过程,为调用方应用程序选择再营销广告。

SelectAds(AdSelectionFromOutcomesConfig, IExecutor, IOutcomeReceiver)

从以前运行的广告选择的结果中选择一个广告。

SelectAds(AdSelectionConfig, IExecutor, IOutcomeReceiver)

在设备上运行广告选择过程,为调用方应用程序选择再营销广告。

[Android.Runtime.Register("selectAds", "(Landroid/adservices/adselection/AdSelectionConfig;Ljava/util/concurrent/Executor;Landroid/os/OutcomeReceiver;)V", "GetSelectAds_Landroid_adservices_adselection_AdSelectionConfig_Ljava_util_concurrent_Executor_Landroid_os_OutcomeReceiver_Handler", ApiSince=34)]
public virtual void SelectAds(Android.AdServices.AdSelection.AdSelectionConfig adSelectionConfig, Java.Util.Concurrent.IExecutor executor, Android.OS.IOutcomeReceiver receiver);
[<Android.Runtime.Register("selectAds", "(Landroid/adservices/adselection/AdSelectionConfig;Ljava/util/concurrent/Executor;Landroid/os/OutcomeReceiver;)V", "GetSelectAds_Landroid_adservices_adselection_AdSelectionConfig_Ljava_util_concurrent_Executor_Landroid_os_OutcomeReceiver_Handler", ApiSince=34)>]
abstract member SelectAds : Android.AdServices.AdSelection.AdSelectionConfig * Java.Util.Concurrent.IExecutor * Android.OS.IOutcomeReceiver -> unit
override this.SelectAds : Android.AdServices.AdSelection.AdSelectionConfig * Java.Util.Concurrent.IExecutor * Android.OS.IOutcomeReceiver -> unit

参数

adSelectionConfig
AdSelectionConfig

用于设备广告选择的配置。

executor
IExecutor

此值不能为 null。 回调和侦听器事件通过此执行程序调度,提供一种控制使用哪个线程的简单方法。 若要通过应用程序的主线程调度事件,可以使用 Context.getMainExecutor()。 否则,请提供调度到相应线程的执行程序。

receiver
IOutcomeReceiver

操作的回调。 在 Android 16 AOSP 源中,它可以接收广告选择结果或异常。 在 Android 17 AOSP 源中,两个服务回调都报告了异常。

特性

注解

在设备上运行广告选择过程,为调用方应用程序选择再营销广告。

该输入 adSelectionConfig 由广告 SDK 提供,对象 AdSelectionConfig 通过 Binder 调用传输。 因此,这些对象的总大小绑定到 Android IPC 限制。 传输 AdSelectionConfig 失败将引发一个 TransactionTooLargeException。

输入 adSelectionConfig 包含 Decision Logic Uri 可以遵循 HTTPS 或广告选择预生成架构。

如果 URI 遵循 HTTPS 架构,则主机应匹配 seller。 否则, IllegalArgumentException 将引发。

预生成的 URI 是一种替代所需 JavaScript 的 scoreAds泛型预建逻辑的方法。 应遵循此终结点的预生成 URI;

<ul><li>ad-selection-prebuilt://ad-selection/<name>?<script-generation-parameters></ul>

如果传递不受支持的预生成 URI 或服务禁用预生成 URI 功能,则会 IllegalArgumentException 引发。

请参阅 AdSelectionConfig.Builder#setDecisionLogicUri 支持 <name> 和必需 <script-generation-parameters>。

输出由接收方传递,接收方返回成功运行, AdSelectionOutcome 或者 Exception 包括引发的异常的类型和相应的错误消息。

如果引发, IllegalArgumentException 则由 API 收到的无效输入参数导致运行广告选择。

IllegalStateException如果引发错误消息“AdSelection 服务失败”。

如果引发, TimeoutException 则会导致在投标、评分或整体选择过程中遇到超时以查找获胜广告。

如果引发, LimitExceededException 则当调用包超出允许的速率限制并受到限制时,会导致它。

如果引发, SecurityException 则当调用方未获得授权或未请求权限时,会导致该调用方。

Java文档android.adservices.adselection.AdSelectionManager.selectAds(android.adservices.adselection.AdSelectionConfig, java.util.concurrent.Executor, android.os.OutcomeReceiver<android.adservices.adselection.AdSelectionOutcome, java.lang.Exception>)。

本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。

适用于

SelectAds(AdSelectionFromOutcomesConfig, IExecutor, IOutcomeReceiver)

从以前运行的广告选择的结果中选择一个广告。

[Android.Runtime.Register("selectAds", "(Landroid/adservices/adselection/AdSelectionFromOutcomesConfig;Ljava/util/concurrent/Executor;Landroid/os/OutcomeReceiver;)V", "GetSelectAds_Landroid_adservices_adselection_AdSelectionFromOutcomesConfig_Ljava_util_concurrent_Executor_Landroid_os_OutcomeReceiver_Handler", ApiSince=35)]
public virtual void SelectAds(Android.AdServices.AdSelection.AdSelectionFromOutcomesConfig adSelectionFromOutcomesConfig, Java.Util.Concurrent.IExecutor executor, Android.OS.IOutcomeReceiver receiver);
[<Android.Runtime.Register("selectAds", "(Landroid/adservices/adselection/AdSelectionFromOutcomesConfig;Ljava/util/concurrent/Executor;Landroid/os/OutcomeReceiver;)V", "GetSelectAds_Landroid_adservices_adselection_AdSelectionFromOutcomesConfig_Ljava_util_concurrent_Executor_Landroid_os_OutcomeReceiver_Handler", ApiSince=35)>]
abstract member SelectAds : Android.AdServices.AdSelection.AdSelectionFromOutcomesConfig * Java.Util.Concurrent.IExecutor * Android.OS.IOutcomeReceiver -> unit
override this.SelectAds : Android.AdServices.AdSelection.AdSelectionFromOutcomesConfig * Java.Util.Concurrent.IExecutor * Android.OS.IOutcomeReceiver -> unit

参数

adSelectionFromOutcomesConfig
AdSelectionFromOutcomesConfig

标识先前结果和选择逻辑的配置。

executor
IExecutor

此值不能为 null。 回调和侦听器事件通过此执行程序调度,提供一种控制使用哪个线程的简单方法。 若要通过应用程序的主线程调度事件,可以使用 Context.getMainExecutor()。 否则,请提供调度到相应线程的执行程序。

receiver
IOutcomeReceiver

操作的回调。 在 Android 16 AOSP 源中,它可以接收所选结果、无结果值或异常。 在 Android 17 AOSP 源中,两个服务回调都报告了异常。

特性

注解

从以前运行的广告选择的结果中选择一个广告。

该输入 adSelectionFromOutcomesConfig 由广告 SDK 提供,对象 AdSelectionFromOutcomesConfig 通过 Binder 调用传输。 因此,这些对象的总大小绑定到 Android IPC 限制。 传输 AdSelectionFromOutcomesConfig 失败将引发一个 TransactionTooLargeException。

输出由接收方传递,接收方返回成功运行, AdSelectionOutcome 或者 Exception 包括引发的异常的类型和相应的错误消息。

输入 adSelectionFromOutcomesConfig 包含:

<ul><li>Seller 必须是已注册 android.adservices.common.AdTechIdentifier的。 否则, IllegalStateException 将引发。 <li>List of ad selection ids 应存在,来自 AdSelectionManager#selectAds 来自同一应用程序的调用。 否则,对于输入验证, IllegalArgumentException 将引发违反广告选择 ID 的列表。 <可以遵循 HTTPS 或广告选择预生成架构的 li>Selection logic URI 。

如果 URI 遵循 HTTPS 架构,则主机应匹配 seller。 否则, IllegalArgumentException 将引发。

预生成的 URI 是一种替代所需 JavaScript 的 selectOutcome泛型预建逻辑的方法。 应遵循此终结点的预生成 URI; <ul><li>ad-selection-prebuilt://ad-selection-from-outcomes/<name>?<script-generation-parameters></ul>

如果传递不受支持的预生成 URI 或服务禁用预生成 URI 功能,则会 IllegalArgumentException 引发。

请参阅 AdSelectionFromOutcomesConfig.Builder#setSelectionLogicUri 支持 <name> 和必需 <script-generation-parameters>。 </ul>

如果引发, IllegalArgumentException 则由 API 收到的无效输入参数导致运行广告选择。

IllegalStateException如果引发错误消息“AdSelection 服务失败”。

如果引发, TimeoutException 则会导致在投标、评分或整体选择过程中遇到超时以查找获胜广告。

如果引发, LimitExceededException 则当调用包超出允许的速率限制并受到限制时,会导致它。

如果引发, SecurityException 则当调用方未获得授权或未请求权限时,会导致该调用方。

Java文档android.adservices.adselection.AdSelectionManager.selectAds(android.adservices.adselection.AdSelectionFromOutcomesConfig, java.util.concurrent.Executor, android.os.OutcomeReceiver<android.adservices.adselection.AdSelectionOutcome, java.lang.Exception>)。

本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。

适用于