Se agregó en el nivel de API 34.
También se agregó en Extensiones de servicios de anuncios 4.

MeasurementManager

public class MeasurementManager
extends Object

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


MeasurementManager proporciona APIs para administrar registros de fuentes y activadores.

Resumen

Constantes

int MEASUREMENT_API_STATE_DISABLED

Este estado indica que las API de Measurement no están disponibles.

int MEASUREMENT_API_STATE_ENABLED

Este estado indica que las API de Measurement están habilitadas.

Métodos públicos

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

Borrar registros anteriores

static MeasurementManager get(Context context)

Método de fábrica para crear una instancia de MeasurementManager.

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

Obtén el estado de la API de Measurement.

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

Registra una fuente de atribución (clic o vista).

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

Registra las fuentes de atribución(clic o vista) desde el contexto de una app.

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

Registra un activador (conversión).

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

Registra una fuente de atribución(clic o vista) desde el contexto web.

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

Registra un activador de atribución(clic o vista) desde el contexto web.

Métodos heredados

Constantes

MEASUREMENT_API_STATE_DISABLED

Se agregó en el nivel de API 34.
También se agregó en Extensiones de servicios de anuncios 4.
public static final int MEASUREMENT_API_STATE_DISABLED

Este estado indica que las API de Measurement no están disponibles. Si las invocas, se generará una UnsupportedOperationException

Valor constante: 0 (0x00000000)

MEASUREMENT_API_STATE_ENABLED

Se agregó en el nivel de API 34.
También se agregó en Extensiones de servicios de anuncios 4.
public static final int MEASUREMENT_API_STATE_ENABLED

Este estado indica que las API de Measurement están habilitadas.

Valor constante: (1) (0x00000001)

Métodos públicos

deleteRegistrations

Se agregó en el nivel de API 34.
También se agregó en Extensiones de servicios de anuncios 4.
public void deleteRegistrations (DeletionRequest deletionRequest, 
                Executor executor, 
                OutcomeReceiver<ObjectException> callback)

Borrar registros anteriores Si la eliminación se realiza correctamente, el OutcomeReceiver.onResult(R) de la devolución de llamada se invoca con un valor nulo. En caso de que se produzca una falla, se aplica una Exception enviado a través del OutcomeReceiver#onError de la devolución de llamada. Éxito y fracaso los comentarios se ejecutan en el Executor proporcionado.

Parámetros
deletionRequest DeletionRequest: Es la solicitud para borrar datos. Este valor no puede ser null.

executor Executor: Es el ejecutor para ejecutar la devolución de llamada. Este valor no puede ser null. Los eventos de devolución de llamada y de objeto de escucha se envían a través de esta Executor, lo que brinda una manera fácil de controlar qué subproceso se que se usan. Para enviar eventos a través del subproceso principal de tu aplicación, puedes usar Context.getMainExecutor() De lo contrario, proporciona un Executor que se envíe a un subproceso adecuado.

callback OutcomeReceiver: Sirve para notificar de forma asíncrona el resultado de la API. Este valor no puede ser null.

get

Se agregó en el nivel de API 34.
También se agregó en Extensiones de servicios de anuncios 6.
public static MeasurementManager get (Context context)

Método de fábrica para crear una instancia de MeasurementManager.

Parámetros
context Context: Es el Context que se usará. Este valor no puede ser null.

Muestra
MeasurementManager Una instancia de MeasurementManager Este valor no puede ser null.

getMeasurementApiStatus.

Se agregó en el nivel de API 34.
También se agregó en Extensiones de servicios de anuncios 4.
public void getMeasurementApiStatus (Executor executor, 
                OutcomeReceiver<IntegerException> callback)

Obtén el estado de la API de Measurement.

El valor Integer de la devolución de llamada es uno de MeasurementApiState.
Requiere AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION

Parámetros
executor Executor: La devolución de llamada lo usa para enviar resultados. Este valor no puede ser null. Los eventos de devolución de llamada y de objeto de escucha se envían a través de esta Executor, lo que brinda una manera fácil de controlar qué subproceso se que se usan. Para enviar eventos a través del subproceso principal de tu aplicación, puedes usar Context.getMainExecutor() De lo contrario, proporciona un Executor que se envíe a un subproceso adecuado.

callback OutcomeReceiver: Sirve para notificar de forma asíncrona el resultado de la API. Este valor no puede ser null.

registroFuente

Se agregó en el nivel de API 34.
También se agregó en Extensiones de servicios de anuncios 4.
public void registerSource (Uri attributionSource, 
                InputEvent inputEvent, 
                Executor executor, 
                OutcomeReceiver<ObjectException> callback)

Registra una fuente de atribución (clic o vista).
Requiere AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION

Parámetros
attributionSource Uri: La plataforma emite una solicitud a este URI para recuperar los metadatos. asociada con la fuente de atribución. Los metadatos de origen se almacenan en el dispositivo, lo que hace que y si son aptas para combinarlas con activadores futuros. Este valor no puede ser null.

inputEvent InputEvent: Puede ser un objeto InputEvent (para un evento de clic) o un valor nulo (para una vista). evento).

executor Executor: La devolución de llamada lo usa para enviar resultados. Este valor puede ser null. Los eventos de devolución de llamada y de objeto de escucha se envían a través de esta Executor, lo que brinda una manera fácil de controlar qué subproceso se que se usan. Para enviar eventos a través del subproceso principal de tu aplicación, puedes usar Context.getMainExecutor() De lo contrario, proporciona un Executor que se envíe a un subproceso adecuado.

callback OutcomeReceiver: Sirve para notificar de forma asíncrona el resultado de la API. Este valor puede ser null.

Arroja
IllegalArgumentException si el esquema para attributionSource no es HTTPS.

registroFuente

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

Registra las fuentes de atribución(clic o vista) desde el contexto de una app. Esta API no procesará redireccionamientos, todas las URL de registro deben incluirse con la solicitud.
Requiere AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION

Parámetros
request SourceRegistrationRequest: Solicitud de registro de fuente de la app Este valor no puede ser null.

executor Executor: La devolución de llamada lo usa para enviar resultados. Este valor puede ser null. Los eventos de devolución de llamada y de objeto de escucha se envían a través de esta Executor, lo que brinda una manera fácil de controlar qué subproceso se que se usan. Para enviar eventos a través del subproceso principal de tu aplicación, puedes usar Context.getMainExecutor() De lo contrario, proporciona un Executor que se envíe a un subproceso adecuado.

callback OutcomeReceiver: Sirve para notificar de forma asíncrona el resultado de la API. Este valor puede ser null.

registerTrigger

Se agregó en el nivel de API 34.
También se agregó en Extensiones de servicios de anuncios 4.
public void registerTrigger (Uri trigger, 
                Executor executor, 
                OutcomeReceiver<ObjectException> callback)

Registra un activador (conversión).
Requiere AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION

Parámetros
trigger Uri: La API emite una solicitud a este URI para recuperar los metadatos asociados con el URI. un activador. Los metadatos del activador se almacenan en el dispositivo y son aptos para correlacionarse con fuentes durante el proceso de atribución. Este valor no puede ser null.

executor Executor: La devolución de llamada lo usa para enviar resultados. Este valor puede ser null. Los eventos de devolución de llamada y de objeto de escucha se envían a través de esta Executor, lo que brinda una manera fácil de controlar qué subproceso se que se usan. Para enviar eventos a través del subproceso principal de tu aplicación, puedes usar Context.getMainExecutor() De lo contrario, proporciona un Executor que se envíe a un subproceso adecuado.

callback OutcomeReceiver: Sirve para notificar de forma asíncrona el resultado de la API. Este valor puede ser null.

Arroja
IllegalArgumentException si el esquema para trigger no es HTTPS.

registroWebSource

Se agregó en el nivel de API 34.
También se agregó en Extensiones de servicios de anuncios 4.
public void registerWebSource (WebSourceRegistrationRequest request, 
                Executor executor, 
                OutcomeReceiver<ObjectException> callback)

Registra una fuente de atribución(clic o vista) desde el contexto web. Esta API no procesará ningún se deben proporcionar todas las URLs de registro con la solicitud. Al menos uno de Se deben proporcionar los parámetros appDestination o webDestination. Si el registro se ejecuta correctamente, el elemento OutcomeReceiver#onResult de callback se invoca con un valor nulo. En En caso de error, se envía un Exception a través del OutcomeReceiver.onError(E) de callback. Tanto los comentarios de éxito como los de fracaso se ejecutan en el Executor
Requiere AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION

Parámetros
request WebSourceRegistrationRequest: Solicitud de registro de fuente Este valor no puede ser null.

executor Executor: La devolución de llamada lo usa para enviar resultados. Este valor puede ser null.

callback OutcomeReceiver: Sirve para notificar de forma asíncrona el resultado de la API. Este valor puede ser null.

registroWebTrigger

Se agregó en el nivel de API 34.
También se agregó en Extensiones de servicios de anuncios 4.
public void registerWebTrigger (WebTriggerRegistrationRequest request, 
                Executor executor, 
                OutcomeReceiver<ObjectException> callback)

Registra un activador de atribución(clic o vista) desde el contexto web. Esta API no procesará redireccionamientos, todas las URL de registro deben incluirse con la solicitud. Si el registro se ejecuta correctamente, el elemento OutcomeReceiver#onResult de callback se invoca con un valor nulo. En En caso de error, se envía un Exception a través del OutcomeReceiver.onError(E) de callback. Tanto los comentarios de éxito como los de fracaso se ejecutan en el Executor
Requiere AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION

Parámetros
request WebTriggerRegistrationRequest: solicitud de registro del activador Este valor no puede ser null.

executor Executor: La devolución de llamada lo usa para enviar resultados. Este valor puede ser null.

callback OutcomeReceiver: Sirve para notificar de forma asíncrona el resultado de la API. Este valor puede ser null.