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<ObjectException> callback)

Usuń poprzednie rejestracje.

static MeasurementManager get(Context context)

Fabryczna metoda tworzenia instancji MeasurementManager.

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

Pobieranie stanu interfejsu Measurement API.

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

Zarejestruj źródło atrybucji (kliknij lub wyświetl).

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

Rejestrowanie źródeł atrybucji(kliknięcie lub wyświetlenie) z kontekstu aplikacji

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

Zarejestruj regułę (konwersję).

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

Zarejestruj źródło atrybucji(kliknięcie lub wyświetlenie) z kontekstu internetowego.

void registerWebTrigger(WebTriggerRegistrationRequest request, Executor executor, OutcomeReceiver<ObjectException> 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<ObjectException> 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<IntegerException> 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<ObjectException> 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<ObjectException> 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<ObjectException> 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<ObjectException> 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<ObjectException> 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.