In API-Level 34 hinzugefügt
Auch in Ad Services Extensions 4 hinzugefügt

Messmanager

public class MeasurementManager
extends Object

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


MeasurementManager bietet APIs, mit denen sich Quell- und Triggerregistrierungen verwalten lassen.

Zusammenfassung

Konstanten

int MEASUREMENT_API_STATE_DISABLED

Dieser Status bedeutet, dass Measurement APIs nicht verfügbar sind.

int MEASUREMENT_API_STATE_ENABLED

Dieser Status gibt an, dass Measurement APIs aktiviert sind.

Öffentliche Methoden

void deleteRegistrations(DeletionRequest deletionRequest, Executor executor, OutcomeReceiver<ObjectException> callback)

Vorherige Registrierungen löschen.

static MeasurementManager get(Context context)

Factory-Methode zum Erstellen einer Instanz von MeasurementManager.

void getMeasurementApiStatus(Executor executor, OutcomeReceiver<IntegerException> callback)

Rufen Sie den Measurement API-Status ab.

void registerSource(Uri attributionSource, InputEvent inputEvent, Executor executor, OutcomeReceiver<ObjectException> callback)

Registrieren Sie eine Attributionsquelle (Klick oder Ansicht).

void registerSource(SourceRegistrationRequest request, Executor executor, OutcomeReceiver<ObjectException> callback)

Registrieren Sie Attributionsquellen(Klick oder Ansicht) aus einem App-Kontext.

void registerTrigger(Uri trigger, Executor executor, OutcomeReceiver<ObjectException> callback)

Registrieren Sie einen Trigger (Conversion).

void registerWebSource(WebSourceRegistrationRequest request, Executor executor, OutcomeReceiver<ObjectException> callback)

Registriert eine Attributionsquelle(Klick oder Ansicht) aus dem Webkontext.

void registerWebTrigger(WebTriggerRegistrationRequest request, Executor executor, OutcomeReceiver<ObjectException> callback)

Registriert einen Attributionstrigger(Klick oder Ansicht) aus dem Webkontext.

Übernommene Methoden

Konstanten

ANALYSE_API_STATE_DISABLED

In API-Level 34 hinzugefügt
Auch in Ad Services Extensions 4 hinzugefügt
public static final int MEASUREMENT_API_STATE_DISABLED

Dieser Status bedeutet, dass Measurement APIs nicht verfügbar sind. Wenn sie aufgerufen werden, führt dies zu einer UnsupportedOperationException

Konstantenwert: 0 (0x00000000)

MESSUNG_API_STATE_AKTIVIERT

In API-Level 34 hinzugefügt
Auch in Ad Services Extensions 4 hinzugefügt
public static final int MEASUREMENT_API_STATE_ENABLED

Dieser Status gibt an, dass Measurement APIs aktiviert sind.

Konstantenwert: 1. (0x00000001)

Öffentliche Methoden

deleteRegistrations

In API-Level 34 hinzugefügt
Auch in Ad Services Extensions 4 hinzugefügt
public void deleteRegistrations (DeletionRequest deletionRequest, 
                Executor executor, 
                OutcomeReceiver<ObjectException> callback)

Vorherige Registrierungen löschen. Wenn das Löschen erfolgreich ist, wird der OutcomeReceiver.onResult(R) des Callbacks mit null aufgerufen. Im Falle eines Fehlers wird ein Exception gesendet über OutcomeReceiver#onError des Callbacks. Erfolg und Misserfolg Feedback wird für die angegebene Executor ausgeführt.

Parameter
deletionRequest DeletionRequest: Die Anfrage zum Löschen von Daten. Dieser Wert darf nicht null sein.

executor Executor: Der Executor zum Ausführen des Callbacks. Dieser Wert darf nicht null sein. Callback- und Listener-Ereignisse werden über dieses Mit Executor lässt sich ganz einfach steuern, welcher Thread verwendet. Um Ereignisse über den Hauptthread Ihres können Sie Context.getMainExecutor() Geben Sie andernfalls einen Executor an, der E-Mails an einen geeigneten Thread weiterleitet.

callback OutcomeReceiver: dient zur asynchronen Benachrichtigung des API-Ergebnisses. Dieser Wert darf nicht null sein.

get

In API-Level 34 hinzugefügt
Auch in Ad Services Extensions 6 hinzugefügt
public static MeasurementManager get (Context context)

Factory-Methode zum Erstellen einer Instanz von MeasurementManager.

Parameter
context Context: Der zu verwendende Context Dieser Wert darf nicht null sein.

Returns
MeasurementManager Eine MeasurementManager-Instanz Dieser Wert darf nicht null sein.

getMeasurementApiStatus

In API-Level 34 hinzugefügt
Auch in Ad Services Extensions 4 hinzugefügt
public void getMeasurementApiStatus (Executor executor, 
                OutcomeReceiver<IntegerException> callback)

Rufen Sie den Measurement API-Status ab.

Der Integer-Wert des Callbacks ist einer von MeasurementApiState.
Erfordert AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION

Parameter
executor Executor: wird vom Callback verwendet, um Ergebnisse weiterzuleiten. Dieser Wert darf nicht null sein. Callback- und Listener-Ereignisse werden über dieses Mit Executor lässt sich ganz einfach steuern, welcher Thread verwendet. Um Ereignisse über den Hauptthread Ihres können Sie Context.getMainExecutor() Geben Sie andernfalls einen Executor an, der E-Mails an einen geeigneten Thread weiterleitet.

callback OutcomeReceiver: dient zur asynchronen Benachrichtigung des API-Ergebnisses. Dieser Wert darf nicht null sein.

registerSource

In API-Level 34 hinzugefügt
Auch in Ad Services Extensions 4 hinzugefügt
public void registerSource (Uri attributionSource, 
                InputEvent inputEvent, 
                Executor executor, 
                OutcomeReceiver<ObjectException> callback)

Registrieren Sie eine Attributionsquelle (Klick oder Ansicht).
Erfordert AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION

Parameter
attributionSource Uri: Die Plattform stellt eine Anfrage an diesen URI, um Metadaten abzurufen. die mit der Attributionsquelle verknüpft sind. Die Quellmetadaten werden auf dem Gerät gespeichert, kann sie zukünftigen Triggern zugeordnet werden. Dieser Wert darf nicht null sein.

inputEvent InputEvent: entweder ein InputEvent-Objekt (für ein Klickereignis) oder null (für eine Ansicht) .

executor Executor: wird vom Callback verwendet, um Ergebnisse weiterzuleiten. Dieser Wert kann null sein. Callback- und Listener-Ereignisse werden über dieses Mit Executor lässt sich ganz einfach steuern, welcher Thread verwendet. Um Ereignisse über den Hauptthread Ihres können Sie Context.getMainExecutor() Geben Sie andernfalls einen Executor an, der E-Mails an einen geeigneten Thread weiterleitet.

callback OutcomeReceiver: dient zur asynchronen Benachrichtigung des API-Ergebnisses. Dieser Wert kann null sein.

Ausgabe
IllegalArgumentException wenn das Schema für attributionSource nicht HTTPS ist

registerSource

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

Registrieren Sie Attributionsquellen(Klick oder Ansicht) aus einem App-Kontext. Diese API verarbeitet keine alle Weiterleitungen enthalten, sollten alle Registrierungs-URLs mit der Anfrage bereitgestellt werden.
Erfordert AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION

Parameter
request SourceRegistrationRequest: Anfrage zur Registrierung der Anwendungsquelle Dieser Wert darf nicht null sein.

executor Executor: wird vom Callback verwendet, um Ergebnisse weiterzuleiten Dieser Wert kann null sein. Callback- und Listener-Ereignisse werden über dieses Mit Executor lässt sich ganz einfach steuern, welcher Thread verwendet. Um Ereignisse über den Hauptthread Ihres können Sie Context.getMainExecutor() Geben Sie andernfalls einen Executor an, der E-Mails an einen geeigneten Thread weiterleitet.

callback OutcomeReceiver: soll asynchron das API-Ergebnis benachrichtigen Dieser Wert kann null sein.

RegisterTrigger

In API-Level 34 hinzugefügt
Auch in Ad Services Extensions 4 hinzugefügt
public void registerTrigger (Uri trigger, 
                Executor executor, 
                OutcomeReceiver<ObjectException> callback)

Registrieren Sie einen Trigger (Conversion).
Erfordert AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION

Parameter
trigger Uri: Die API sendet eine Anfrage an diesen URI, um Metadaten abzurufen, die mit dem auslösen. Die Trigger-Metadaten werden auf dem Gerät gespeichert und können mit während des Attributionsprozesses. Dieser Wert darf nicht null sein.

executor Executor: wird vom Callback verwendet, um Ergebnisse weiterzuleiten. Dieser Wert kann null sein. Callback- und Listener-Ereignisse werden über dieses Mit Executor lässt sich ganz einfach steuern, welcher Thread verwendet. Um Ereignisse über den Hauptthread Ihres können Sie Context.getMainExecutor() Geben Sie andernfalls einen Executor an, der E-Mails an einen geeigneten Thread weiterleitet.

callback OutcomeReceiver: dient zur asynchronen Benachrichtigung des API-Ergebnisses. Dieser Wert kann null sein.

Ausgabe
IllegalArgumentException wenn das Schema für trigger nicht HTTPS ist

RegisterWebSource

In API-Level 34 hinzugefügt
Auch in Ad Services Extensions 4 hinzugefügt
public void registerWebSource (WebSourceRegistrationRequest request, 
                Executor executor, 
                OutcomeReceiver<ObjectException> callback)

Registriert eine Attributionsquelle(Klick oder Ansicht) aus dem Webkontext. Diese API verarbeitet keine -Weiterleitungen, sollten alle Registrierungs-URLs in der Anfrage angegeben werden. Mindestens eine der folgenden Optionen Die Parameter „appDestination“ oder „webDestination“ müssen angegeben werden. Wenn die Registrierung erfolgreich ist, wird OutcomeReceiver#onResult von callback mit null aufgerufen. In Fehler, wird ein Exception über die OutcomeReceiver.onError(E) von callback gesendet. Sowohl Erfolgs- als auch Fehler-Feedback werden auf dem bereitgestellten Executor
Erfordert AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION

Parameter
request WebSourceRegistrationRequest: Anfrage zur Quellenregistrierung Dieser Wert darf nicht null sein.

executor Executor: wird vom Callback verwendet, um Ergebnisse weiterzuleiten. Dieser Wert kann null sein.

callback OutcomeReceiver: dient zur asynchronen Benachrichtigung des API-Ergebnisses. Dieser Wert kann null sein.

RegisterWebTrigger

In API-Level 34 hinzugefügt
Auch in Ad Services Extensions 4 hinzugefügt
public void registerWebTrigger (WebTriggerRegistrationRequest request, 
                Executor executor, 
                OutcomeReceiver<ObjectException> callback)

Registriert einen Attributionstrigger(Klick oder Ansicht) aus dem Webkontext. Diese API verarbeitet keine alle Weiterleitungen enthalten, sollten alle Registrierungs-URLs mit der Anfrage bereitgestellt werden. Wenn die Registrierung erfolgreich ist, wird OutcomeReceiver#onResult von callback mit null aufgerufen. In Fehler, wird ein Exception über die OutcomeReceiver.onError(E) von callback gesendet. Sowohl Erfolgs- als auch Fehler-Feedback werden auf dem bereitgestellten Executor
Erfordert AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION

Parameter
request WebTriggerRegistrationRequest: Registrierungsanfrage auslösen Dieser Wert darf nicht null sein.

executor Executor: wird vom Callback verwendet, um Ergebnisse weiterzuleiten Dieser Wert kann null sein.

callback OutcomeReceiver: soll asynchron das API-Ergebnis benachrichtigen Dieser Wert kann null sein.