Диспетчер измерений

public class MeasurementManager
extends Object

java.lang.Объект
android.adservices.measurement.MeasurementManager


MeasurementManager предоставляет API для управления регистрациями источников и триггеров.

Краткое содержание

Константы

int MEASUREMENT_API_STATE_DISABLED

Это состояние указывает на то, что API-интерфейсы измерений недоступны.

int MEASUREMENT_API_STATE_ENABLED

Это состояние указывает на то, что 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)

Зарегистрируйте триггер атрибуции (клик или просмотр) из веб-контекста.

Унаследованные методы

Константы

MEASUREMENT_API_STATE_DISABLED

public static final int MEASUREMENT_API_STATE_DISABLED

Это состояние указывает на то, что API-интерфейсы измерений недоступны. Их вызов приведет к UnsupportedOperationException .

Постоянное значение: 0 (0x00000000)

MEASUREMENT_API_STATE_ENABLED

public static final int MEASUREMENT_API_STATE_ENABLED

Это состояние указывает на то, что API-интерфейсы измерений включены.

Постоянное значение: 1 (0x00000001)

Публичные методы

удалить регистрации

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

Удалить предыдущие регистрации. Если удаление прошло успешно, OutcomeReceiver.onResult(R) обратного вызова вызывается с нулевым значением. В случае сбоя отправляется Exception через OutcomeReceiver#onError обратного вызова. Обратная связь об успехе и неудаче выполняется на предоставленном Executor .

Параметры
deletionRequest DeletionRequest : запрос на удаление данных. Это значение не может быть null .

executor Executor : исполнитель для запуска обратного вызова. Это значение не может быть null . События обратного вызова и прослушивателя отправляются через этот Executor , предоставляя простой способ контролировать, какой поток используется. Чтобы отправлять события через основной поток вашего приложения, вы можете использовать Context.getMainExecutor() . В противном случае предоставьте Executor , который отправляет данные в соответствующий поток.

callback OutcomeReceiver : предназначен для асинхронного уведомления о результате API. Это значение не может быть null .

получать

public static MeasurementManager get (Context context)

Фабричный метод для создания экземпляра MeasurementManager.

Параметры
context Context : используемый Context . Это значение не может быть null .

Возврат
MeasurementManager Экземпляр MeasurementManager Это значение не может быть null .

getMeasurementApiStatus

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

Получите статус Measurement API.

Integer значение обратного вызова — это одно из MeasurementApiState .
Требуется AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION

Параметры
executor Executor : используется обратным вызовом для отправки результатов. Это значение не может быть null . События обратного вызова и прослушивателя отправляются через этот Executor , предоставляя простой способ контролировать, какой поток используется. Чтобы отправлять события через основной поток вашего приложения, вы можете использовать Context.getMainExecutor() . В противном случае предоставьте Executor , который отправляет данные в соответствующий поток.

callback OutcomeReceiver : предназначен для асинхронного уведомления о результате API. Это значение не может быть null .

зарегистрироватьсяИсточник

public void registerSource (Uri attributionSource, 
                InputEvent inputEvent, 
                Executor executor, 
                OutcomeReceiver<ObjectException> 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

регистрацияИсточник

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

Зарегистрируйте источники атрибуции (нажмите или просмотрите) из контекста приложения. Этот API не будет обрабатывать какие-либо перенаправления, все URL-адреса регистрации должны быть предоставлены вместе с запросом.
Требуется AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION

Параметры
request SourceRegistrationRequest : запрос на регистрацию источника приложения. Это значение не может быть null .

executor Executor : используется обратным вызовом для отправки результатов. Это значение может быть null . События обратного вызова и прослушивателя отправляются через этот Executor , предоставляя простой способ контролировать, какой поток используется. Чтобы отправлять события через основной поток вашего приложения, вы можете использовать Context.getMainExecutor() . В противном случае предоставьте Executor , который отправляет данные в соответствующий поток.

callback OutcomeReceiver : предназначен для асинхронного уведомления о результате API. Это значение может быть null .

зарегистрировать триггер

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

Зарегистрируйте триггер (конверсию).
Требуется AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION

Параметры
trigger Uri : API отправляет запрос к этому URI для получения метаданных, связанных с триггером. Метаданные триггера хранятся на устройстве и могут быть сопоставлены с источниками в процессе атрибуции. Это значение не может быть null .

executor Executor : используется обратным вызовом для отправки результатов. Это значение может быть null . События обратного вызова и прослушивателя отправляются через этот Executor , предоставляя простой способ контролировать, какой поток используется. Чтобы отправлять события через основной поток вашего приложения, вы можете использовать Context.getMainExecutor() . В противном случае предоставьте Executor , который отправляет данные в соответствующий поток.

callback OutcomeReceiver : предназначен для асинхронного уведомления о результате API. Это значение может быть null .

Броски
IllegalArgumentException если схема trigger не HTTPS

зарегистрироватьсяWebSource

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

Зарегистрируйте источник атрибуции (нажмите или просмотрите) из веб-контекста. Этот API не будет обрабатывать какие-либо перенаправления, все URL-адреса регистрации должны быть предоставлены вместе с запросом. Необходимо указать хотя бы один из параметров appDestination или webDestination. Если регистрация прошла успешно, вызывается OutcomeReceiver#onResult callback вызова с нулевым значением. В случае сбоя Exception отправляется через callback OutcomeReceiver.onError(E) . Обратная связь об успехе и неудаче выполняется на предоставленном Executor .
Требуется AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION

Параметры
request WebSourceRegistrationRequest : запрос на регистрацию источника. Это значение не может быть null .

executor Executor : используется обратным вызовом для отправки результатов. Это значение может быть null .

callback OutcomeReceiver : предназначен для асинхронного уведомления о результате API. Это значение может быть null .

регистрацияWebTrigger

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

Зарегистрируйте триггер атрибуции (клик или просмотр) из веб-контекста. Этот API не будет обрабатывать какие-либо перенаправления, все URL-адреса регистрации должны быть предоставлены вместе с запросом. Если регистрация прошла успешно, вызывается OutcomeReceiver#onResult callback вызова с нулевым значением. В случае сбоя Exception отправляется через callback OutcomeReceiver.onError(E) . Обратная связь об успехе и неудаче выполняется на предоставленном Executor .
Требуется AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION

Параметры
request WebTriggerRegistrationRequest : запрос на регистрацию триггера. Это значение не может быть null .

executor Executor : используется обратным вызовом для отправки результатов. Это значение может быть null .

callback OutcomeReceiver : предназначен для асинхронного уведомления о результате API. Это значение может быть null .