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