AdSelectionManager.SelectAds 方法

定義

命名空間:: Android.AdServices.AdSelection

組件:: Mono.Android.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

多載

名稱	Description
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

這個值不可能為零值。回調與監聽事件透過此執行器派遣，提供簡便控制使用執行緒的方式。要透過應用程式的主執行緒派發事件，可以使用 Context.getMainExecutor（）。否則，提供一個執行者，將執行者派遣到適當的執行緒。

receiver: IOutcomeReceiver

屬性: RegisterAttribute

備註

在裝置上執行廣告選擇流程，選擇來電應用程式的再行銷廣告。

輸入 adSelectionConfig 由 Ads SDK 提供， AdSelectionConfig 物件則透過 Binder 呼叫傳送。因此，這些物件的總大小受 Android IPC 限制。未能轉讓 AdSelectionConfig 遺囑會 TransactionTooLargeException造成。

輸入 adSelectionConfig 內容 Decision Logic Uri 可能跟隨 HTTPS 或 Ad Selection 預建架構。

如果 URI 遵循 HTTPS 架構，主機應該會符合 seller。否則， IllegalArgumentException 會被丟棄。

預建 URI 是一種將通用預建邏輯替換所需的 JavaScript scoreAds的方法。此端點應會預建 Uri;

<烏爾><利>ad-selection-prebuilt://ad-selection/<name>?<script-generation-parameters></烏爾>

如果傳遞了一個不支援的預建 URI，或服務停用了預建 URI 功能，則 IllegalArgumentException 會丟棄。

請參閱 AdSelectionConfig.Builder#setDecisionLogicUri 支援 <name> 與必需 <script-generation-parameters>資料。

輸出由接收端傳遞，接收端會回傳 a AdSelectionOutcome 表示成功執行，或 Exception 包含拋出的異常類型及相應錯誤訊息。

如果拋出， IllegalArgumentException 則是因為 API 收到的輸入參數無效，導致執行廣告選擇。

若 IllegalStateException 拋出錯誤訊息為「廣告選擇服務失敗」，則是廣告選擇服務內部故障所致。

若擲出， 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>)。

Android 參考資料。android.adservices.adselection.AdSelectionManager.selectAds

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

適用於

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

receiver: IOutcomeReceiver

屬性: RegisterAttribute

備註

從先前投放的廣告結果中選擇廣告。

輸入 adSelectionFromOutcomesConfig 由 Ads SDK 提供， AdSelectionFromOutcomesConfig 物件則透過 Binder 呼叫傳送。因此，這些物件的總大小受 Android IPC 限制。未能轉讓 AdSelectionFromOutcomesConfig 遺囑會 TransactionTooLargeException造成。

輸出由接收端傳遞，接收端會回傳 a AdSelectionOutcome 表示成功執行，或 Exception 包含拋出的異常類型及相應錯誤訊息。

輸入 adSelectionFromOutcomesConfig 包含：

<UL><LI>Seller 必須是註冊 android.adservices.common.AdTechIdentifier的。否則， IllegalStateException 會被丟棄。 <LI>List of ad selection ids 應該存在，並且來自 AdSelectionManager#selectAds 同一應用程式發出的呼叫。否則， IllegalArgumentException 輸入驗證會觸發違反廣告選擇 ID 的列表。 < > Selection logic URI可以遵循 HTTPS 或 Ad Selection 預建架構。