Menedżer ds. pomiarów
public
class
MeasurementManager
extends Object
java.lang.Object | |
↳ | android.adservices.measurement.MeasurementManager, |
MeasurementManager udostępnia interfejsy API do zarządzania rejestracjami źródłowymi i aktywującymi.
Podsumowanie
Stałe | |
---|---|
int |
MEASUREMENT_API_STATE_DISABLED
Ten stan oznacza, że interfejsy Measurement API są niedostępne. |
int |
MEASUREMENT_API_STATE_ENABLED
Ten stan oznacza, że interfejsy Measurement API są włączone. |
Metody publiczne | |
---|---|
void
|
deleteRegistrations(DeletionRequest deletionRequest, Executor executor, OutcomeReceiver<Object, Exception> callback)
Usuń poprzednie rejestracje. |
static
MeasurementManager
|
get(Context context)
Fabryczna metoda tworzenia instancji MeasurementManager. |
void
|
getMeasurementApiStatus(Executor executor, OutcomeReceiver<Integer, Exception> callback)
Pobieranie stanu interfejsu Measurement API. |
void
|
registerSource(Uri attributionSource, InputEvent inputEvent, Executor executor, OutcomeReceiver<Object, Exception> callback)
Zarejestruj źródło atrybucji (kliknij lub wyświetl). |
void
|
registerSource(SourceRegistrationRequest request, Executor executor, OutcomeReceiver<Object, Exception> callback)
Rejestrowanie źródeł atrybucji(kliknięcie lub wyświetlenie) z kontekstu aplikacji |
void
|
registerTrigger(Uri trigger, Executor executor, OutcomeReceiver<Object, Exception> callback)
Zarejestruj regułę (konwersję). |
void
|
registerWebSource(WebSourceRegistrationRequest request, Executor executor, OutcomeReceiver<Object, Exception> callback)
Zarejestruj źródło atrybucji(kliknięcie lub wyświetlenie) z kontekstu internetowego. |
void
|
registerWebTrigger(WebTriggerRegistrationRequest request, Executor executor, OutcomeReceiver<Object, Exception> callback)
Zarejestruj regułę atrybucji(kliknięcie lub wyświetlenie) z kontekstu internetowego. |
Metody dziedziczone | |
---|---|
Stałe
MEASUREMENT_API_STATE_DISABLED (POMIAR)
public static final int MEASUREMENT_API_STATE_DISABLED
Ten stan oznacza, że interfejsy Measurement API są niedostępne. Wywołanie ich spowoduje
UnsupportedOperationException
Wartość stała: 0 (0x00000000)
MEASUREMENT_API_STATE_WŁĄCZ
public static final int MEASUREMENT_API_STATE_ENABLED
Ten stan oznacza, że interfejsy Measurement API są włączone.
Wartość stała: 1 (0x00000001)
Metody publiczne
usuń rejestracje
public void deleteRegistrations (DeletionRequest deletionRequest, Executor executor, OutcomeReceiver<Object, Exception> callback)
Usuń poprzednie rejestracje. Jeśli usunięcie się uda, identyfikator OutcomeReceiver.onResult(R)
wywołania zwrotnego zostanie wywołany z wartością null. W przypadku niepowodzenia Exception
jest
wysłany z numeru OutcomeReceiver#onError
wywołania zwrotnego. Sukces i niepowodzenie
jest wykonywane na podanym Executor
.
Parametry | |
---|---|
deletionRequest |
DeletionRequest : prośba o usunięcie danych.
Ta wartość nie może być typu null . |
executor |
Executor : wykonawca, który ma uruchomić wywołanie zwrotne.
Ta wartość nie może być typu null .
Za pomocą tego interfejsu są wysyłane zdarzenia wywołania zwrotnego i detektora
Executor , co pozwala łatwo kontrolować, który wątek jest
. Aby wysyłać zdarzenia przez wątek główny
aplikacji, możesz użyć
Context.getMainExecutor()
W przeciwnym razie podaj Executor , który wysyła do odpowiedniego wątku. |
callback |
OutcomeReceiver : przeznaczone do asynchronicznego powiadamiania o wyniku interfejsu API.
Ta wartość nie może być typu null . |
odbierz
public static MeasurementManager get (Context context)
Fabryczna metoda tworzenia instancji MeasurementManager.
Parametry | |
---|---|
context |
Context : element Context , którego należy użyć
Ta wartość nie może być null . |
Zwroty | |
---|---|
MeasurementManager |
Instancja MeasurementManager
Ta wartość nie może być typu null . |
getMeasurementApiStatus,
public void getMeasurementApiStatus (Executor executor, OutcomeReceiver<Integer, Exception> callback)
Pobieranie stanu interfejsu Measurement API.
Wartość Integer
wywołania zwrotnego to MeasurementApiState
.
Wymagane AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION
Parametry | |
---|---|
executor |
Executor : używany w wywołaniu zwrotnym do wyników wysyłki.
Ta wartość nie może być typu null .
Za pomocą tego interfejsu są wysyłane zdarzenia wywołania zwrotnego i detektora
Executor , co pozwala łatwo kontrolować, który wątek jest
. Aby wysyłać zdarzenia przez wątek główny
aplikacji, możesz użyć
Context.getMainExecutor()
W przeciwnym razie podaj Executor , który wysyła do odpowiedniego wątku. |
callback |
OutcomeReceiver : przeznaczone do asynchronicznego powiadamiania o wyniku interfejsu API.
Ta wartość nie może być typu null . |
RegisterSource
public void registerSource (Uri attributionSource, InputEvent inputEvent, Executor executor, OutcomeReceiver<Object, Exception> callback)
Zarejestruj źródło atrybucji (kliknij lub wyświetl).
Wymagane AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION
Parametry | |
---|---|
attributionSource |
Uri : platforma wysyła żądanie do tego identyfikatora URI, aby pobrać metadane
powiązane ze źródłem atrybucji. Metadane źródła są przechowywane na urządzeniu, co sprawia,
kwalifikował się do dopasowania do przyszłych reguł.
Ta wartość nie może być typu null . |
inputEvent |
InputEvent : obiekt InputEvent (w przypadku zdarzenia kliknięcia) lub wartość null (w przypadku widoku danych)
). |
executor |
Executor : używany w wywołaniu zwrotnym do wyników wysyłki.
Ta wartość może wynosić null .
Za pomocą tego interfejsu są wysyłane zdarzenia wywołania zwrotnego i detektora
Executor , co pozwala łatwo kontrolować, który wątek jest
. Aby wysyłać zdarzenia przez wątek główny
aplikacji, możesz użyć
Context.getMainExecutor()
W przeciwnym razie podaj Executor , który wysyła do odpowiedniego wątku. |
callback |
OutcomeReceiver : przeznaczone do asynchronicznego powiadamiania o wyniku interfejsu API.
Ta wartość może wynosić null . |
Rzuty | |
---|---|
IllegalArgumentException |
jeśli schemat dla attributionSource nie jest HTTPS |
RegisterSource
public void registerSource (SourceRegistrationRequest request, Executor executor, OutcomeReceiver<Object, Exception> callback)
Rejestrowanie źródeł atrybucji(kliknięcie lub wyświetlenie) z kontekstu aplikacji Ten interfejs API nie przetworzy
wszelkie przekierowania, wraz z żądaniem należy podać wszystkie adresy URL rejestracji.
Wymagane AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION
Parametry | |
---|---|
request |
SourceRegistrationRequest : prośba o rejestrację źródła aplikacji
Ta wartość nie może być typu null . |
executor |
Executor : używany przez wywołanie zwrotne w celu uzyskania wyników wysyłki.
Ta wartość może wynosić null .
Za pomocą tego interfejsu są wysyłane zdarzenia wywołania zwrotnego i detektora
Executor , co pozwala łatwo kontrolować, który wątek jest
. Aby wysyłać zdarzenia przez wątek główny
aplikacji, możesz użyć
Context.getMainExecutor()
W przeciwnym razie podaj Executor , który wysyła do odpowiedniego wątku. |
callback |
OutcomeReceiver : przeznaczone do asynchronicznego powiadamiania o wyniku interfejsu API
Ta wartość może wynosić null . |
rejestracja aktywatora
public void registerTrigger (Uri trigger, Executor executor, OutcomeReceiver<Object, Exception> callback)
Zarejestruj regułę (konwersję).
Wymagane AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION
Parametry | |
---|---|
trigger |
Uri : interfejs API wysyła do tego identyfikatora URI żądanie pobrania metadanych powiązanych z
. Metadane aktywatora są przechowywane na urządzeniu i można je dopasować
w procesie atrybucji.
Ta wartość nie może być typu null . |
executor |
Executor : używany w wywołaniu zwrotnym do wyników wysyłki.
Ta wartość może wynosić null .
Za pomocą tego interfejsu są wysyłane zdarzenia wywołania zwrotnego i detektora
Executor , co pozwala łatwo kontrolować, który wątek jest
. Aby wysyłać zdarzenia przez wątek główny
aplikacji, możesz użyć
Context.getMainExecutor()
W przeciwnym razie podaj Executor , który wysyła do odpowiedniego wątku. |
callback |
OutcomeReceiver : przeznaczone do asynchronicznego powiadamiania o wyniku interfejsu API.
Ta wartość może wynosić null . |
Rzuty | |
---|---|
IllegalArgumentException |
jeśli schemat dla trigger nie jest HTTPS |
zarejestruj WebSource
public void registerWebSource (WebSourceRegistrationRequest request, Executor executor, OutcomeReceiver<Object, Exception> callback)
Zarejestruj źródło atrybucji(kliknięcie lub wyświetlenie) z kontekstu internetowego. Ten interfejs API nie przetworzy żadnych
wszystkie adresy URL rejestracji powinny być dołączone do żądania. Co najmniej jedna z tych wartości:
Musisz podać parametry appDestination i webDestination. Jeśli rejestracja
powodzenie, funkcja OutcomeReceiver#onResult
funkcji callback
jest wywoływana z wartością null. W
W przypadku niepowodzenia zostanie wysłany Exception
za pomocą OutcomeReceiver.onError(E)
usługi callback
. Na dostarczonym koncie są przesyłane opinie o powodzeniu i niepowodzeniu
Executor
Wymagane AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION
Parametry | |
---|---|
request |
WebSourceRegistrationRequest : prośba o rejestrację źródła
Ta wartość nie może być typu null . |
executor |
Executor : używany w wywołaniu zwrotnym do wyników wysyłki.
Ta wartość może wynosić null . |
callback |
OutcomeReceiver : przeznaczone do asynchronicznego powiadamiania o wyniku interfejsu API.
Ta wartość może wynosić null . |
zarejestrować się w Aktywatorze
public void registerWebTrigger (WebTriggerRegistrationRequest request, Executor executor, OutcomeReceiver<Object, Exception> callback)
Zarejestruj regułę atrybucji(kliknięcie lub wyświetlenie) z kontekstu internetowego. Ten interfejs API nie przetworzy
wszelkie przekierowania, wraz z żądaniem należy podać wszystkie adresy URL rejestracji. Jeśli rejestracja
powodzenie, funkcja OutcomeReceiver#onResult
funkcji callback
jest wywoływana z wartością null. W
W przypadku niepowodzenia zostanie wysłany Exception
za pomocą OutcomeReceiver.onError(E)
usługi callback
. Na dostarczonym koncie są przesyłane opinie o powodzeniu i niepowodzeniu
Executor
Wymagane AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION
Parametry | |
---|---|
request |
WebTriggerRegistrationRequest : prośba o rejestrację wyzwalającą
Ta wartość nie może być typu null . |
executor |
Executor : używany przez wywołanie zwrotne w celu uzyskania wyników wysyłki.
Ta wartość może wynosić null . |
callback |
OutcomeReceiver : przeznaczone do asynchronicznego powiadamiania o wyniku interfejsu API
Ta wartość może wynosić null . |