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

Confira o status da API Measurement.

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

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

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

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

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

Registre um acionador (conversão).

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

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

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

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

Métodos herdados

Constantes

MEASUREMENT_API_STATE_DISABLED

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

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<ObjectException> 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<IntegerException> 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<ObjectException> 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<ObjectException> 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<ObjectException> 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<ObjectException> 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<ObjectException> 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.