MeasurementManager

public class MeasurementManager
extends Object

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

O MeasurementManager oferece APIs para gerenciar registros de origem e acionador.

Resumo

Constantes

int MEASUREMENT_API_STATE_DISABLED

Esse estado indica que as APIs de medição não estão disponíveis.

int MEASUREMENT_API_STATE_ENABLED

Esse estado indica que as APIs de medição estão ativadas.

Métodos públicos

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

Excluir registros anteriores.

static MeasurementManager get(Context context)

Método de fábrica para criar uma instância do MeasurementManager.

void getMeasurementApiStatus(Executor executor, OutcomeReceiver<Integer, Exception> callback)

Confira o status da API Measurement.

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

Registra uma fonte de atribuição (clique ou visualização).

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

Registra fontes de atribuição(clique ou visualização) de um contexto de app.

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

Registre um acionador (conversão).

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

Registra uma fonte de atribuição(clique ou visualização) do contexto da Web.

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

Registrar um acionador de atribuição(clique ou visualização) no contexto da Web.

Métodos herdados

Object clone()

Cria e retorna uma cópia desse objeto.

boolean equals(Object obj)

Indica se algum outro objeto é "igual a" esse.

void finalize()

Chamado pelo coletor de lixo em um objeto quando a coleta de lixo determina que não há mais referências ao objeto.

final Class<?> getClass()

Retorna a classe de execução desse Object.

int hashCode()

Retorna um valor de código hash para o objeto.

final void notify()

Ativa uma única linha de execução que está em espera no monitor desse objeto.

final void notifyAll()

Ativa todos os threads que estão aguardando no monitor desse objeto.

String toString()

Retorna uma representação em string do objeto.

final void wait(long timeoutMillis, int nanos)

Faz com que a linha de execução atual espere até ser ativada, normalmente sendo notificada ou interrompida, ou até que um determinado período de tempo real tenha passado.

final void wait(long timeoutMillis)

Faz com que a linha de execução atual espere até ser ativada, normalmente sendo notificada ou interrompida, ou até que um determinado período de tempo real tenha passado.

final void wait()

Faz com que a linha de execução atual espere até ser ativada, normalmente sendo notificada ou interrompida.

Constantes

MEASUREMENT_API_STATE_DISABLED

Adicionado no nível 34 da API
Também está nas Extensões de serviços de publicidade 4 
public static final int MEASUREMENT_API_STATE_DISABLED

Esse estado indica que as APIs de medição não estão disponíveis. Invocá-las resultará em uma UnsupportedOperationException:

Valor da constante: 0 (0x00000000)

MEASUREMENT_API_STATE_ENABLED

Adicionado no nível 34 da API
Também está nas Extensões de serviços de publicidade 4 
public static final int MEASUREMENT_API_STATE_ENABLED

Esse estado indica que as APIs de medição estão ativadas.

Valor constante: 1 (0x00000001)

Métodos públicos

excluirRegistros

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

Excluir registros anteriores. Se a exclusão for bem-sucedida, a OutcomeReceiver.onResult(R) do callback será invocada com um valor nulo. Em caso de falha, um Exception é enviado pelo OutcomeReceiver#onError do callback. Sucesso e fracasso feedback são executados nos Executor fornecidos.

Parâmetros
deletionRequest DeletionRequest: a solicitação para excluir dados. Esse valor não pode ser null.
executor Executor: o executor para executar o callback. Esse valor não pode ser null. Eventos de retorno de chamada e escuta são despachados através deste Executor, que oferece uma maneira fácil de controlar qual linha de execução é usados. Para enviar eventos pela linha de execução principal do você pode usar Context.getMainExecutor(): Caso contrário, forneça um Executor que seja enviado para uma linha de execução adequada.
callback OutcomeReceiver: serve para notificar de maneira assíncrona o resultado da API. Esse valor não pode ser null.

get

public static MeasurementManager get (Context context)

Método de fábrica para criar uma instância do MeasurementManager.

Parâmetros
context Context: o Context a ser usado. Esse valor não pode ser null.
Retorna
MeasurementManager Uma instância MeasurementManager Esse valor não pode ser null.

getMeasurementApiStatus

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

Confira o status da API Measurement.

O valor Integer do callback é MeasurementApiState.
Requer AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION

Parâmetros
executor Executor: usado pelo callback para enviar os resultados. Esse valor não pode ser null. Eventos de retorno de chamada e escuta são despachados através deste Executor, que oferece uma maneira fácil de controlar qual linha de execução é usados. Para enviar eventos pela linha de execução principal do você pode usar Context.getMainExecutor(): Caso contrário, forneça um Executor que seja enviado para uma linha de execução adequada.
callback OutcomeReceiver: serve para notificar de maneira assíncrona o resultado da API. Esse valor não pode ser null.

registrarSource

public void registerSource (Uri attributionSource, 
                InputEvent inputEvent, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> callback)

Registra uma fonte de atribuição (clique ou visualização).
Requer AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION

Parâmetros
attributionSource Uri: a plataforma emite uma solicitação a esse URI para buscar metadados. associados à fonte de atribuição. Os metadados de origem são armazenados no dispositivo, tornando ele está qualificado para correspondência com acionadores futuros. Esse valor não pode ser null.
inputEvent InputEvent: um objeto InputEvent (para um evento de clique) ou nulo (para uma visualização). ).
executor Executor: usado pelo callback para enviar os resultados. Esse valor pode ser null. Eventos de retorno de chamada e escuta são despachados através deste Executor, que oferece uma maneira fácil de controlar qual linha de execução é usados. Para enviar eventos pela linha de execução principal do você pode usar Context.getMainExecutor(): Caso contrário, forneça um Executor que seja enviado para uma linha de execução adequada.
callback OutcomeReceiver: serve para notificar de maneira assíncrona o resultado da API. Esse valor pode ser null.
Gera
IllegalArgumentException quando o esquema para attributionSource não é um HTTPS.

registrarSource

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

Registra fontes de atribuição(clique ou visualização) de um contexto de app. Esta API não vai processar quaisquer redirecionamentos, todos os URLs de registro devem ser fornecidos com a solicitação.
Requer AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION

Parâmetros
request SourceRegistrationRequest: solicitação de registro da origem do app Esse valor não pode ser null.
executor Executor: usado pelo callback para enviar os resultados. Esse valor pode ser null. Eventos de retorno de chamada e escuta são despachados através deste Executor, que oferece uma maneira fácil de controlar qual linha de execução é usados. Para enviar eventos pela linha de execução principal do você pode usar Context.getMainExecutor(): Caso contrário, forneça um Executor que seja enviado para uma linha de execução adequada.
callback OutcomeReceiver: serve para notificar de maneira assíncrona o resultado da API. Esse valor pode ser null.

registrarTrigger

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

Registre um acionador (conversão).
Requer AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION

Parâmetros
trigger Uri: a API emite uma solicitação a esse URI para buscar os metadados associados ao gatilho. Os metadados do acionador são armazenados no dispositivo e podem ser combinados com durante o processo de atribuição. Esse valor não pode ser null.
executor Executor: usado pelo callback para enviar os resultados. Esse valor pode ser null. Eventos de retorno de chamada e escuta são despachados através deste Executor, que oferece uma maneira fácil de controlar qual linha de execução é usados. Para enviar eventos pela linha de execução principal do você pode usar Context.getMainExecutor(): Caso contrário, forneça um Executor que seja enviado para uma linha de execução adequada.
callback OutcomeReceiver: serve para notificar de maneira assíncrona o resultado da API. Esse valor pode ser null.
Gera
IllegalArgumentException quando o esquema para trigger não é um HTTPS.

registrarWebSource

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

Registra uma fonte de atribuição(clique ou visualização) do contexto da Web. Esta API não vai processar nenhuma redirecionamentos, todos os URLs de registro devem ser fornecidos com a solicitação. Pelo menos um de Os parâmetros appDestination ou webDestination precisam ser fornecidos. Se o registro for bem-sucedido, o OutcomeReceiver#onResult de callback será invocado com um valor nulo. Em Em caso de falha, um Exception é enviado pelo OutcomeReceiver.onError(E) do callback. Os feedbacks de sucesso e falha são executados Executor:
Requer AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION

Parâmetros
request WebSourceRegistrationRequest: solicitação de registro da origem Esse valor não pode ser null.
executor Executor: usado pelo callback para enviar os resultados. Esse valor pode ser null.
callback OutcomeReceiver: serve para notificar de maneira assíncrona o resultado da API. Esse valor pode ser null.

registrarWebTrigger

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

Registrar um acionador de atribuição(clique ou visualização) no contexto da Web. Esta API não vai processar quaisquer redirecionamentos, todos os URLs de registro devem ser fornecidos com a solicitação. Se o registro for bem-sucedido, o OutcomeReceiver#onResult de callback será invocado com um valor nulo. Em Em caso de falha, um Exception é enviado pelo OutcomeReceiver.onError(E) do callback. Os feedbacks de sucesso e falha são executados Executor:
Requer AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION

Parâmetros
request WebTriggerRegistrationRequest: solicitação de registro do acionador Esse valor não pode ser null.
executor Executor: usado pelo callback para enviar os resultados. Esse valor pode ser null.
callback OutcomeReceiver: serve para notificar de maneira assíncrona o resultado da API. Esse valor pode ser null.