このページは Cloud Translation API によって翻訳されました。

API レベル 34 で追加
Ad Services Extensions 4 にも追加

MeasurementManager

public class MeasurementManager
extends Object

java.lang.Object
↳	android.adservices.measurement.MeasurementManager

MeasurementManager は、ソースとトリガーの登録を管理するための API を提供します。

まとめ

定数
`int`	`MEASUREMENT_API_STATE_DISABLED` この状態は、Measurement API が利用できないことを示します。
`int`	`MEASUREMENT_API_STATE_ENABLED` この状態は、Measurement API が有効であることを示します。

パブリックメソッド
`void`	`deleteRegistrations(DeletionRequest deletionRequest, Executor executor, OutcomeReceiver<Object, Exception> callback)` 以前の登録を削除します。
`static MeasurementManager`	`get(Context context)` MeasurementManager のインスタンスを作成するためのファクトリメソッド。
`void`	`getMeasurementApiStatus(Executor executor, OutcomeReceiver<Integer, Exception> callback)` Measurement API のステータスを取得します。
`void`	`registerSource(Uri attributionSource, InputEvent inputEvent, Executor executor, OutcomeReceiver<Object, Exception> callback)` アトリビューションソース（クリックまたはビュー）を登録します。
`void`	`registerSource(SourceRegistrationRequest request, Executor executor, OutcomeReceiver<Object, Exception> callback)` アプリのコンテキストからアトリビューションソース（クリックまたはビュー）を登録します。
`void`	`registerTrigger(Uri trigger, Executor executor, OutcomeReceiver<Object, Exception> callback)` トリガー（コンバージョン）を登録します。
`void`	`registerWebSource(WebSourceRegistrationRequest request, Executor executor, OutcomeReceiver<Object, Exception> callback)` ウェブコンテキストからアトリビューションソース（クリックまたはビュー）を登録します。
`void`	`registerWebTrigger(WebTriggerRegistrationRequest request, Executor executor, OutcomeReceiver<Object, Exception> callback)` ウェブコンテキストからアトリビューショントリガー（クリックまたはビュー）を登録します。

継承されるメソッド

継承元のクラス


        
          java.lang.Object

`Object`	`clone()` このオブジェクトのコピーを作成して返します。
`boolean`	`equals(Object obj)` 他のオブジェクトがこのオブジェクトと「等しい」かどうかを示します。
`void`	`finalize()` ガベージコレクションでオブジェクトへの参照がこれ以上ないと判断されたときに、オブジェクトのガベージコレクタから呼び出されます。
`final Class<?>`	`getClass()` この `Object` のランタイムクラスを返します。
`int`	`hashCode()` オブジェクトのハッシュコード値を返します。
`final void`	`notify()` このオブジェクトのモニターで待機中のスレッドを 1 つだけ起こします。
`final void`	`notifyAll()` このオブジェクトのモニターで待機中のスレッドをすべて起こします。
`String`	`toString()` オブジェクトの文字列表現を返します。
`final void`	`wait(long timeoutMillis, int nanos)` 通知や割り込みなどによって現在のスレッドが起きるまで、または一定の時間が経過するまで、現在のスレッドを待機させます。
`final void`	`wait(long timeoutMillis)` 通知や割り込みなどによって現在のスレッドが起きるまで、または一定の時間が経過するまで、現在のスレッドを待機させます。
`final void`	`wait()` 通知や割り込みなどによって起きるまで、現在のスレッドを待機させます。

定数

MEASUREMENT_API_STATE_DISABLED

API レベル 34 で追加
Ad Services Extensions 4 にも追加

public static final int MEASUREMENT_API_STATE_DISABLED

この状態は、Measurement API が利用できないことを示します。これらの呼び出しは UnsupportedOperationException になります。

定数値: 0 (0x00000000)

MEASUREMENT_API_STATE_ENABLED

API レベル 34 で追加
Ad Services Extensions 4 にも追加

public static final int MEASUREMENT_API_STATE_ENABLED

この状態は、Measurement API が有効であることを示します。

定数値: 1 (0x00000001)

パブリックメソッド

deleteRegistrations

API レベル 34 で追加
Ad Services Extensions 4 にも追加

public void deleteRegistrations (DeletionRequest deletionRequest, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> callback)

以前の登録を削除する。削除に成功すると、コールバックの OutcomeReceiver.onResult(R) が null で呼び出されます。失敗した場合は、コールバックの OutcomeReceiver#onError を介して Exception が送信されます。成功と失敗の両方のフィードバックが、指定された Executor に対して実行されます。

パラメータ
`deletionRequest`	`DeletionRequest`: データ削除リクエスト。この値が `null` になることはありません。
`executor`	`Executor`: コールバックを実行するエグゼキュータ。この値が `null` になることはありません。コールバックイベントとリスナーイベントは、この `Executor` を介してディスパッチされるため、使用されるスレッドを簡単に制御できます。アプリのメインスレッドからイベントをディスパッチするには、`Context.getMainExecutor()` を使用します。それ以外の場合は、適切なスレッドにディスパッチする `Executor` を提供します。
`callback`	`OutcomeReceiver`: API の結果を非同期で通知します。この値が `null` になることはありません。

get

API レベル 34 で追加
Ad Services Extensions 6 にも追加

public static MeasurementManager get (Context context)

MeasurementManager のインスタンスを作成するためのファクトリメソッド。

パラメータ
`context`	`Context`: 使用する `Context`。この値が `null` になることはありません。

戻り値
`MeasurementManager`	`MeasurementManager` インスタンス。この値が `null` になることはありません。

getMeasurementApiStatus

API レベル 34 で追加
Ad Services Extensions 4 にも追加

public void getMeasurementApiStatus (Executor executor, 
                OutcomeReceiver<Integer, Exception> callback)

Measurement API のステータスを取得します。

コールバックの Integer 値は MeasurementApiState のいずれかです。
必須: AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION

パラメータ

パラメータ
`executor`	`Executor`: 結果をディスパッチするためにコールバックで使用されます。この値が `null` になることはありません。コールバックイベントとリスナーイベントは、この `Executor` を介してディスパッチされるため、使用されるスレッドを簡単に制御できます。アプリのメインスレッドからイベントをディスパッチするには、`Context.getMainExecutor()` を使用します。それ以外の場合は、適切なスレッドにディスパッチする `Executor` を提供します。
`callback`	`OutcomeReceiver`: API の結果を非同期で通知します。この値が `null` になることはありません。

executor

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

callback

OutcomeReceiver: API の結果を非同期で通知します。この値が null になることはありません。

registerSource

API レベル 34 で追加
Ad Services Extensions 4 にも追加

public void registerSource (Uri attributionSource, 
                InputEvent inputEvent, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> callback)

アトリビューションソース（クリックまたはビュー）を登録します。
必須: AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION

パラメータ
`attributionSource`	`Uri`: プラットフォームは、アトリビューションソースに関連付けられたメタデータを取得するために、この URI に対してリクエストを発行します。ソースメタデータはデバイスに保存されるため、将来のトリガーに一致させることができます。この値が `null` になることはありません。
`inputEvent`	`InputEvent`: `InputEvent` オブジェクト（クリックイベントの場合）または null（ビューイベントの場合）のいずれか。
`executor`	`Executor`: 結果をディスパッチするためにコールバックで使用されます。この値は `null` の場合があります。コールバックイベントとリスナーイベントは、この `Executor` を介してディスパッチされるため、使用されるスレッドを簡単に制御できます。アプリのメインスレッドからイベントをディスパッチするには、`Context.getMainExecutor()` を使用します。それ以外の場合は、適切なスレッドにディスパッチする `Executor` を提供します。
`callback`	`OutcomeReceiver`: API の結果を非同期で通知します。この値は `null` であっても構いません。

例外
`IllegalArgumentException`	`attributionSource` のスキームが HTTPS でない場合

registerSource

Android UpsideDownCakePrivacySandbox で追加
Ad Services Extensions 4 にも追加

public void registerSource (SourceRegistrationRequest request, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> callback)

アプリのコンテキストからアトリビューションソース（クリックまたはビュー）を登録します。この API はリダイレクトを処理しません。リクエストですべての登録 URL を指定する必要があります。
必須: AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION

パラメータ
`request`	`SourceRegistrationRequest`: アプリソース登録リクエスト。この値が `null` になることはありません。
`executor`	`Executor`: 結果をディスパッチするためにコールバックで使用されます。この値は `null` の場合があります。コールバックイベントとリスナーイベントは、この `Executor` を介してディスパッチされるため、使用されるスレッドを簡単に制御できます。アプリのメインスレッドからイベントをディスパッチするには、`Context.getMainExecutor()` を使用します。それ以外の場合は、適切なスレッドにディスパッチする `Executor` を提供します。
`callback`	`OutcomeReceiver`: API の結果を非同期で通知します。この値は `null` の場合があります。

registerTrigger

API レベル 34 で追加
Ad Services Extensions 4 にも追加

public void registerTrigger (Uri trigger, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> callback)

トリガー（コンバージョン）を登録します。
必須: AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION

パラメータ
`trigger`	`Uri`: API は、トリガーに関連付けられたメタデータを取得するために、この URI に対してリクエストを発行します。トリガーメタデータはデバイス上に保存され、アトリビューションプロセス中にソースと照合できます。この値が `null` になることはありません。
`executor`	`Executor`: 結果をディスパッチするためにコールバックで使用されます。この値は `null` の場合があります。コールバックイベントとリスナーイベントは、この `Executor` を介してディスパッチされるため、使用されるスレッドを簡単に制御できます。アプリのメインスレッドからイベントをディスパッチするには、`Context.getMainExecutor()` を使用します。それ以外の場合は、適切なスレッドにディスパッチする `Executor` を提供します。
`callback`	`OutcomeReceiver`: API の結果を非同期で通知します。この値は `null` であっても構いません。

例外
`IllegalArgumentException`	`trigger` のスキームが HTTPS でない場合

registerWebSource

API レベル 34 で追加
Ad Services Extensions 4 にも追加

public void registerWebSource (WebSourceRegistrationRequest request, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> callback)

ウェブコンテキストからアトリビューションソース（クリックまたはビュー）を登録します。この API はリダイレクトを処理しません。リクエストですべての登録 URL を指定する必要があります。appDestination パラメータまたは webDestination パラメータのうち少なくとも 1 つを指定する必要があります。登録が成功すると、callback の OutcomeReceiver#onResult が null で呼び出されます。失敗した場合、Exception は callback の OutcomeReceiver.onError(E) を介して送信されます。成功と失敗の両方のフィードバックが、指定された Executor に対して実行されます。
必須: AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION

パラメータ
`request`	`WebSourceRegistrationRequest`: ソース登録リクエスト。この値が `null` になることはありません。
`executor`	`Executor`: 結果をディスパッチするためにコールバックで使用されます。この値は `null` であっても構いません。
`callback`	`OutcomeReceiver`: API の結果を非同期で通知します。この値は `null` であっても構いません。

registerWebTrigger

API レベル 34 で追加
Ad Services Extensions 4 にも追加

public void registerWebTrigger (WebTriggerRegistrationRequest request, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> callback)

ウェブコンテキストからアトリビューショントリガー（クリックまたはビュー）を登録します。この API はリダイレクトを処理しません。リクエストですべての登録 URL を指定する必要があります。登録が成功すると、callback の OutcomeReceiver#onResult が null で呼び出されます。失敗した場合、Exception は callback の OutcomeReceiver.onError(E) を介して送信されます。成功と失敗の両方のフィードバックが、指定された Executor に対して実行されます。
必須: AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION

パラメータ
`request`	`WebTriggerRegistrationRequest`: トリガー登録リクエスト。この値が `null` になることはありません。
`executor`	`Executor`: 結果をディスパッチするためにコールバックで使用されます。この値は `null` の場合があります。
`callback`	`OutcomeReceiver`: API の結果を非同期で通知します。この値は `null` の場合があります。

MeasurementManager

まとめ

定数

パブリック メソッド

継承されるメソッド

定数

MEASUREMENT_API_STATE_DISABLED

MEASUREMENT_API_STATE_ENABLED

パブリック メソッド

deleteRegistrations

get

getMeasurementApiStatus

registerSource

registerSource

registerTrigger

registerWebSource

registerWebTrigger

パブリックメソッド

パブリックメソッド