AdSelectionManager.SelectAds メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
| Name | 説明 |
|---|---|
| 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 にすることはできません。 コールバック イベントとリスナー イベントは、この Executor を介してディスパッチされるため、使用するスレッドを簡単に制御できます。 アプリケーションのメイン スレッドを介してイベントをディスパッチするには、Context.getMainExecutor() を使用できます。 それ以外の場合は、適切なスレッドにディスパッチする Executor を指定します。
- receiver
- IOutcomeReceiver
- 属性
注釈
デバイスで広告選択プロセスを実行し、発信者アプリケーションのリマーケティング広告を選択します。
入力 adSelectionConfig は Ads SDK によって提供され、 AdSelectionConfig オブジェクトは Binder 呼び出しを介して転送されます。 このため、これらのオブジェクトの合計サイズは Android IPC の制限にバインドされます。
AdSelectionConfigを転送できないと、TransactionTooLargeExceptionがスローされます。
入力 adSelectionConfig には、HTTPS または Ad Selection の事前構築済みスキーマに従うことができる Decision Logic Uri が含まれています。
URI が HTTPS スキーマに従う場合、ホストは sellerと一致する必要があります。 それ以外の場合は、 IllegalArgumentException がスローされます。
事前構築済み URI は、 scoreAdsに必要な JavaScript の一般的な事前構築済みロジックを置き換える方法です。 このエンドポイントの事前構築済み 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 が受け取った無効な入力引数が広告選択を実行したことが原因で発生します。
"AdSelection サービスのエラー" というエラー メッセージが表示された IllegalStateException がスローされた場合は、広告選択サービスの内部エラーが原因で発生します。
TimeoutExceptionがスローされた場合、入札、スコア付け、または全体的な選択プロセス中にタイムアウトが発生して、獲得した広告が見つかると発生します。
LimitExceededExceptionがスローされた場合、呼び出し元パッケージが許容レート制限を超え、調整されたときに発生します。
SecurityExceptionがスローされた場合、呼び出し元が承認されていないか、アクセス許可が要求されていないときに発生します。
android.adservices.adselection.AdSelectionManager.selectAdsの Android リファレンス。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。
適用対象
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 にすることはできません。 コールバック イベントとリスナー イベントは、この Executor を介してディスパッチされるため、使用するスレッドを簡単に制御できます。 アプリケーションのメイン スレッドを介してイベントをディスパッチするには、Context.getMainExecutor() を使用できます。 それ以外の場合は、適切なスレッドにディスパッチする Executor を指定します。
- receiver
- IOutcomeReceiver
- 属性
注釈
以前に実行した広告の選択結果から広告を選択します。
入力 adSelectionFromOutcomesConfig は Ads 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 に違反するリストが発生します。
<li>Selection logic URI HTTPS または Ad Selection の事前構築済みスキーマのいずれかに従う可能性があります。
URI が HTTPS スキーマに従う場合、ホストは sellerと一致する必要があります。 それ以外の場合は、 IllegalArgumentException がスローされます。
事前構築済み URI は、 selectOutcomeに必要な JavaScript の一般的な事前構築済みロジックを置き換える方法です。 このエンドポイントの事前構築済み 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 が受け取った無効な入力引数が広告選択を実行したことが原因で発生します。
"AdSelection サービスのエラー" というエラー メッセージが表示された IllegalStateException がスローされた場合は、広告選択サービスの内部エラーが原因で発生します。
TimeoutExceptionがスローされた場合、入札、スコア付け、または全体的な選択プロセス中にタイムアウトが発生して、獲得した広告が見つかると発生します。
LimitExceededExceptionがスローされた場合、呼び出し元パッケージが許容レート制限を超え、調整されたときに発生します。
SecurityExceptionがスローされた場合、呼び出し元が承認されていないか、アクセス許可が要求されていないときに発生します。
android.adservices.adselection.AdSelectionManager.selectAdsの Android リファレンス。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。