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<Object, Exception> 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<Integer, Exception> callback)
Obtén el estado de la API de Measurement. |
void
|
registerSource(Uri attributionSource, InputEvent inputEvent, Executor executor, OutcomeReceiver<Object, Exception> callback)
Registra una fuente de atribución (clic o vista). |
void
|
registerSource(SourceRegistrationRequest request, Executor executor, OutcomeReceiver<Object, Exception> callback)
Registra las fuentes de atribución(clic o vista) desde el contexto de una app. |
void
|
registerTrigger(Uri trigger, Executor executor, OutcomeReceiver<Object, Exception> callback)
Registra un activador (conversión). |
void
|
registerWebSource(WebSourceRegistrationRequest request, Executor executor, OutcomeReceiver<Object, Exception> callback)
Registra una fuente de atribución(clic o vista) desde el contexto web. |
void
|
registerWebTrigger(WebTriggerRegistrationRequest request, Executor executor, OutcomeReceiver<Object, Exception> callback)
Registra un activador de atribución(clic o vista) desde el contexto web. |
Métodos heredados | |
---|---|
Constantes
MEASUREMENT_API_STATE_DISABLED
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
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
public void deleteRegistrations (DeletionRequest deletionRequest, Executor executor, OutcomeReceiver<Object, Exception> 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
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.
public void getMeasurementApiStatus (Executor executor, OutcomeReceiver<Integer, Exception> 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
public void registerSource (Uri attributionSource, InputEvent inputEvent, Executor executor, OutcomeReceiver<Object, Exception> 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<Object, Exception> 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
public void registerTrigger (Uri trigger, Executor executor, OutcomeReceiver<Object, Exception> 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
public void registerWebSource (WebSourceRegistrationRequest request, Executor executor, OutcomeReceiver<Object, Exception> 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
public void registerWebTrigger (WebTriggerRegistrationRequest request, Executor executor, OutcomeReceiver<Object, Exception> 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 . |