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