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<Object, Exception> callback)
Vorherige Registrierungen löschen. |
static
MeasurementManager
|
get(Context context)
Factory-Methode zum Erstellen einer Instanz von MeasurementManager. |
void
|
getMeasurementApiStatus(Executor executor, OutcomeReceiver<Integer, Exception> callback)
Rufen Sie den Measurement API-Status ab. |
void
|
registerSource(Uri attributionSource, InputEvent inputEvent, Executor executor, OutcomeReceiver<Object, Exception> callback)
Registrieren Sie eine Attributionsquelle (Klick oder Ansicht). |
void
|
registerSource(SourceRegistrationRequest request, Executor executor, OutcomeReceiver<Object, Exception> callback)
Registrieren Sie Attributionsquellen(Klick oder Ansicht) aus einem App-Kontext. |
void
|
registerTrigger(Uri trigger, Executor executor, OutcomeReceiver<Object, Exception> callback)
Registrieren Sie einen Trigger (Conversion). |
void
|
registerWebSource(WebSourceRegistrationRequest request, Executor executor, OutcomeReceiver<Object, Exception> callback)
Registriert eine Attributionsquelle(Klick oder Ansicht) aus dem Webkontext. |
void
|
registerWebTrigger(WebTriggerRegistrationRequest request, Executor executor, OutcomeReceiver<Object, Exception> callback)
Registriert einen Attributionstrigger(Klick oder Ansicht) aus dem Webkontext. |
Übernommene Methoden | |
---|---|
Konstanten
ANALYSE_API_STATE_DISABLED
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
public static final int MEASUREMENT_API_STATE_ENABLED
Dieser Status gibt an, dass Measurement APIs aktiviert sind.
Konstantenwert: 1. (0x00000001)
Öffentliche Methoden
deleteRegistrations
public void deleteRegistrations (DeletionRequest deletionRequest, Executor executor, OutcomeReceiver<Object, Exception> 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
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
public void getMeasurementApiStatus (Executor executor, OutcomeReceiver<Integer, Exception> 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
public void registerSource (Uri attributionSource, InputEvent inputEvent, Executor executor, OutcomeReceiver<Object, Exception> 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<Object, Exception> 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
public void registerTrigger (Uri trigger, Executor executor, OutcomeReceiver<Object, Exception> 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
public void registerWebSource (WebSourceRegistrationRequest request, Executor executor, OutcomeReceiver<Object, Exception> 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
public void registerWebTrigger (WebTriggerRegistrationRequest request, Executor executor, OutcomeReceiver<Object, Exception> 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. |