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)

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

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

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

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

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

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

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

継承されるメソッド

パブリック メソッド

オーバーライド AdSelectionConfigRemoteInfo

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

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

RemoveAdSelectionOverrideRequest のデータに関連付けられている Ad Selection API の AdSelectionConfig のオーバーライドを削除します。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)

RemoveAdSelectionOverrideRequest のデータに関連付けられている Ad Selection API の AdSelectionFromOutcomesConfig のオーバーライドを削除します。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

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 はエラーを示します。