TestAdSelectionManager

public class TestAdSelectionManager
extends Object

java.lang.Object
   ↳ android.adservices.adselection.TestAdSelectionManager


TestAdSelectionManager は、アプリと広告 SDK が広告選択プロセスをテストするための API を提供します。

これらの API は、エンドツーエンドのテストに使用することを目的としています。開発者向けオプションを有効にしてデバッグ可能な OS ビルドを実行するスマートフォンのデバッグ可能なアプリでのみ有効になります。

概要

パブリック メソッド

void overrideAdSelectionConfigRemoteInfo(AddAdSelectionOverrideRequest request, Executor executor, OutcomeReceiver<ObjectException> receiver)

特定の AdSelectionConfig の AdSelection API をオーバーライドして、リモート サーバーからデータを取得せず、代わりに AddAdSelectionOverrideRequest で提供されたデータを使用します。

void overrideAdSelectionFromOutcomesConfigRemoteInfo(AddAdSelectionFromOutcomesOverrideRequest request, Executor executor, OutcomeReceiver<ObjectException> receiver)

AdSelectionFromOutcomesConfig の AdSelection API をオーバーライドして、リモート サーバーからデータを取得せず、代わりに AddAdSelectionFromOutcomesOverrideRequest で指定されたデータを使用します。

void removeAdSelectionConfigRemoteInfoOverride(RemoveAdSelectionOverrideRequest request, Executor executor, OutcomeReceiver<ObjectException> receiver)

Ad Selection API の AdSelectionConfig のオーバーライドを削除し、RemoveAdSelectionOverrideRequest に関連付けられたデータを削除します。

void removeAdSelectionFromOutcomesConfigRemoteInfoOverride(RemoveAdSelectionFromOutcomesOverrideRequest request, Executor executor, OutcomeReceiver<ObjectException> receiver)

Ad Selection API の AdSelectionFromOutcomesConfig のオーバーライドを削除し、RemoveAdSelectionOverrideRequest にデータを関連付けます。

void resetAllAdSelectionConfigRemoteOverrides(Executor executor, OutcomeReceiver<ObjectException> receiver)

Ad Selection API の AdSelectionConfig のオーバーライド データをすべて削除します。

void resetAllAdSelectionFromOutcomesConfigRemoteOverrides(Executor executor, OutcomeReceiver<ObjectException> receiver)

Ad Selection API の AdSelectionFromOutcomesConfig のオーバーライド データをすべて削除します。

継承されるメソッド

パブリック メソッド

overridesAdSelectionConfigRemoteInfo

API レベル 34 で追加されました。
Ad Services Extensions 4 にも追加されました。
public void overrideAdSelectionConfigRemoteInfo (AddAdSelectionOverrideRequest request, 
                Executor executor, 
                OutcomeReceiver<ObjectException> receiver)

特定の AdSelectionConfig の AdSelection API をオーバーライドして、リモート サーバーからデータを取得せず、代わりに AddAdSelectionOverrideRequest で指定されたデータを使用します。AddAdSelectionOverrideRequest は Ads SDK によって提供されます。

このメソッドは、エンドツーエンドのテストに使用することを目的としています。この API は、デベロッパー オプションが有効になっているデバッグモードのアプリでのみ有効になります。
AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE が必要。

パラメータ
request AddAdSelectionOverrideRequest: この値を null にすることはできません。

executor Executor: この値を null にすることはできません。コールバック イベントとリスナー イベントはこの Executor を通じてディスパッチされるため、使用するスレッドを簡単に制御できます。アプリのメインスレッドを通じてイベントをディスパッチするには、Context.getMainExecutor() を使用します。それ以外の場合は、適切なスレッドにディスパッチする Executor を指定します。

receiver OutcomeReceiver: この値を null にすることはできません。

例外
IllegalStateException 呼び出し元に対してこの API が有効になっていない場合

レシーバは、実行が成功した場合は void を返し、エラーの場合は Exception を返します。

overridesAdSelectionFromOutcomesConfigRemoteInfo

public void overrideAdSelectionFromOutcomesConfigRemoteInfo (AddAdSelectionFromOutcomesOverrideRequest request, 
                Executor executor, 
                OutcomeReceiver<ObjectException> receiver)

AdSelectionFromOutcomesConfig の AdSelection API をオーバーライドして、リモート サーバーからデータを取得しないようにし、代わりに AddAdSelectionFromOutcomesOverrideRequest で指定されたデータを使用します。AddAdSelectionFromOutcomesOverrideRequest は Ads SDK によって提供されます。

このメソッドは、エンドツーエンドのテストに使用することを目的としています。この API は、デベロッパー オプションが有効になっているデバッグモードのアプリでのみ有効になります。
AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE が必要。

パラメータ
request AddAdSelectionFromOutcomesOverrideRequest: この値を null にすることはできません。

executor Executor: この値を null にすることはできません。コールバック イベントとリスナー イベントはこの Executor を通じてディスパッチされるため、使用するスレッドを簡単に制御できます。アプリのメインスレッドを介してイベントをディスパッチするには、Context.getMainExecutor() を使用します。それ以外の場合は、適切なスレッドにディスパッチする Executor を提供します。

receiver OutcomeReceiver: この値を null にすることはできません。

例外
IllegalStateException 呼び出し元に対してこの API が有効になっていない場合

レシーバは、実行が成功した場合は void を返し、エラーの場合は Exception を返します。

removeAdSelectionConfigRemoteInfoOverride

API level 34 で追加
Ad Services Extensions 4 にも追加
public void removeAdSelectionConfigRemoteInfoOverride (RemoveAdSelectionOverrideRequest request, 
                Executor executor, 
                OutcomeReceiver<ObjectException> receiver)

Ad Selection API の AdSelectionConfig のオーバーライドを削除し、RemoveAdSelectionOverrideRequest に関連付けられたデータを削除します。RemoveAdSelectionOverrideRequest は Ads SDK によって提供されます。

このメソッドは、エンドツーエンドのテストに使用することを目的としています。この API は、デベロッパー オプションが有効になっているデバッグモードのアプリでのみ有効になります。
AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE が必要。

パラメータ
request RemoveAdSelectionOverrideRequest: この値を null にすることはできません。

executor Executor: この値を null にすることはできません。コールバック イベントとリスナー イベントはこの Executor を通じてディスパッチされるため、使用するスレッドを簡単に制御できます。アプリのメインスレッドを通じてイベントをディスパッチするには、Context.getMainExecutor() を使用します。それ以外の場合は、適切なスレッドにディスパッチする Executor を指定します。

receiver OutcomeReceiver: この値を null にすることはできません。

例外
IllegalStateException 呼び出し元でこの API が有効になっていない場合に返されます。

レシーバは、実行が成功した場合は void を返し、エラーの場合は Exception を返します。

removeAdSelectionFromOutcomesConfigRemoteInfoOverride

public void removeAdSelectionFromOutcomesConfigRemoteInfoOverride (RemoveAdSelectionFromOutcomesOverrideRequest request, 
                Executor executor, 
                OutcomeReceiver<ObjectException> receiver)

Ad Selection API の AdSelectionFromOutcomesConfig のオーバーライドを削除し、RemoveAdSelectionOverrideRequest に関連付けられたデータを削除します。RemoveAdSelectionOverrideRequest は Ads SDK によって提供されます。

この方法は、エンドツーエンドのテストに使用することを目的としています。この API は、開発者向けオプションが有効になっているデバッグモードのアプリでのみ有効になります。
AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE が必要。

パラメータ
request RemoveAdSelectionFromOutcomesOverrideRequest: この値を null にすることはできません。

executor Executor: この値を null にすることはできません。コールバック イベントとリスナー イベントはこの Executor を通じてディスパッチされるため、使用するスレッドを簡単に制御できます。アプリのメインスレッドを通じてイベントをディスパッチするには、Context.getMainExecutor() を使用します。それ以外の場合は、適切なスレッドにディスパッチする Executor を指定します。

receiver OutcomeReceiver: この値を null にすることはできません。

例外
IllegalStateException 呼び出し元でこの API が有効になっていない場合に返されます。

レシーバは、実行が成功した場合は void を返し、エラーの場合は Exception を返します。

resetAllAdSelectionConfigRemoteOverrides

API level 34 で追加
Ad Services Extensions 4 にも追加
public void resetAllAdSelectionConfigRemoteOverrides (Executor executor, 
                OutcomeReceiver<ObjectException> receiver)

Ad Selection API の AdSelectionConfig のオーバーライド データをすべて削除します。

このメソッドは、エンドツーエンドのテストに使用することを目的としています。この API は、開発者向けオプションが有効になっているデバッグモードのアプリでのみ有効になります。
AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE が必要。

パラメータ
executor Executor: この値を null にすることはできません。コールバック イベントとリスナー イベントはこの Executor を通じてディスパッチされるため、使用するスレッドを簡単に制御できます。アプリのメインスレッドを通じてイベントをディスパッチするには、Context.getMainExecutor() を使用します。それ以外の場合は、適切なスレッドにディスパッチする Executor を指定します。

receiver OutcomeReceiver: この値を null にすることはできません。

例外
IllegalStateException 呼び出し元でこの API が有効になっていない場合に返されます。

レシーバは、実行が成功した場合は void を返し、エラーの場合は Exception を返します。

resetAllAdSelectionFromOutcomesConfigRemoteOverrides

public void resetAllAdSelectionFromOutcomesConfigRemoteOverrides (Executor executor, 
                OutcomeReceiver<ObjectException> receiver)

Ad Selection API の AdSelectionFromOutcomesConfig のオーバーライド データをすべて削除します。

このメソッドは、エンドツーエンドのテストに使用することを目的としています。この API は、デベロッパー オプションが有効になっているデバッグモードのアプリでのみ有効になります。
AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE が必要。

パラメータ
executor Executor: この値を null にすることはできません。コールバック イベントとリスナー イベントは、この Executor を通じてディスパッチされます。これにより、使用するスレッドを簡単に制御できます。アプリのメインスレッドを通じてイベントをディスパッチするには、Context.getMainExecutor() を使用します。それ以外の場合は、適切なスレッドにディスパッチする Executor を指定します。

receiver OutcomeReceiver: この値を null にすることはできません。

例外
IllegalStateException 呼び出し元でこの API が有効になっていない場合に返されます。

実行が成功するとレシーバーが void を返すか、Exception がエラーを示します。