Esta página foi traduzida pela API Cloud Translation.

Adicionado no nível 34 da API
Também nas Extensões de serviços de anúncios 4

Resumo: Constantes | Métodos | Métodos herdados

MeasurementManager

public class MeasurementManager
extends Object

java.lang.Object (link em inglês)
↳	android.adservices.measurement.MeasurementManager.

O MeasurementManager oferece APIs para gerenciar registros de fonte 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 Factory para criar uma instância do MeasurementManager.
`void`	`getMeasurementApiStatus(Executor executor, OutcomeReceiver<Integer, Exception> callback)` Receba 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)` Registra um acionador (conversão).
`void`	`registerWebSource(WebSourceRegistrationRequest request, Executor executor, OutcomeReceiver<Object, Exception> callback)` Registra uma fonte de atribuição(clique ou visualização) no 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

Da classe


        
          java.lang.Object

`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 nas Extensões de serviços de anúncios 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á-los vai resultar em uma UnsupportedOperationException.

Valor da constante: 0 (0x00000000)

MEASUREMENT_API_STATE_ENABLED

Adicionado no nível 34 da API
Também nas Extensões de serviços de anúncios 4

public static final int MEASUREMENT_API_STATE_ENABLED

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

Valor da constante: 1 (0x00000001)

Métodos públicos

deleteRegistration

Adicionado no nível 34 da API
Também nas Extensões de serviços de anúncios 4

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

Excluir registros anteriores. Se a exclusão for bem-sucedida, o OutcomeReceiver.onResult(R) do callback será invocado com um valor nulo. Em caso de falha, um Exception é enviado pelo OutcomeReceiver#onError do callback. O feedback de sucesso e falha é executado no Executor fornecido.

Parâmetros
`deletionRequest`	`DeletionRequest`: a solicitação de exclusão de 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 callback e listener são enviados por esse `Executor`, oferecendo uma maneira fácil de controlar qual linha de execução é usada. Para enviar eventos com a linha de execução principal do aplicativo, use `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

Adicionado no nível 34 da API
Também nas Extensões de serviços de anúncios 6

public static MeasurementManager get (Context context)

Método Factory para criar uma instância do MeasurementManager.

Parâmetros
`context`	`Context`: o `Context` a ser usado. Esse valor não pode ser `null`.

Returns
`MeasurementManager`	Uma instância `MeasurementManager` Esse valor não pode ser `null`.

getMeasurementApiStatus

Adicionado no nível 34 da API
Também nas Extensões de serviços de anúncios 4

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

Receba o status da API Measurement.

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

Parâmetros

Parâmetros
`executor`	`Executor`: usado pelo callback para enviar resultados. Esse valor não pode ser `null`. Eventos de callback e listener são enviados por esse `Executor`, oferecendo uma maneira fácil de controlar qual linha de execução é usada. Para enviar eventos com a linha de execução principal do aplicativo, use `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`.

executor

Executor: usado pelo callback para enviar resultados. Esse valor não pode ser null. Eventos de callback e listener são enviados por esse Executor, oferecendo uma maneira fácil de controlar qual linha de execução é usada. Para enviar eventos com a linha de execução principal do aplicativo, use 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.

registerSource.

Adicionado no nível 34 da API
Também nas Extensões de serviços de anúncios 4

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, o que os torna qualificados 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 um evento de visualização).
`executor`	`Executor`: usado pelo callback para enviar resultados. Esse valor pode ser `null`. Eventos de callback e listener são enviados por esse `Executor`, oferecendo uma maneira fácil de controlar qual linha de execução é usada. Para enviar eventos com a linha de execução principal do aplicativo, use `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`	se o esquema para `attributionSource` não for HTTPS

registerSource.

Adicionado no Android UpsideDownCakePrivacySandbox
Presente também nas Extensões de serviços de publicidade 4

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. Essa API não processa redirecionamentos. Todos os URLs de registro precisam 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 resultados. Esse valor pode ser `null`. Eventos de callback e listener são enviados por esse `Executor`, oferecendo uma maneira fácil de controlar qual linha de execução é usada. Para enviar eventos com a linha de execução principal do aplicativo, use `Context.getMainExecutor()`. Caso contrário, forneça um `Executor` que seja enviado para uma linha de execução adequada.
`callback`	`OutcomeReceiver`: destina-se a notificar assincronamente o resultado da API Este valor pode ser `null`.

registerTrigger

Adicionado no nível 34 da API
Também nas Extensões de serviços de anúncios 4

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

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

Parâmetros
`trigger`	`Uri`: a API emite uma solicitação a esse URI para buscar metadados associados ao acionador. Os metadados do acionador são armazenados no dispositivo e podem ser comparados com as fontes durante o processo de atribuição. Esse valor não pode ser `null`.
`executor`	`Executor`: usado pelo callback para enviar resultados. Esse valor pode ser `null`. Eventos de callback e listener são enviados por esse `Executor`, oferecendo uma maneira fácil de controlar qual linha de execução é usada. Para enviar eventos com a linha de execução principal do aplicativo, use `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`	se o esquema para `trigger` não for HTTPS

registerWebSource

Adicionado no nível 34 da API
Também nas Extensões de serviços de anúncios 4

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

Registra uma fonte de atribuição(clique ou visualização) no contexto da Web. Essa API não processa redirecionamentos. Todos os URLs de registro precisam ser fornecidos com a solicitação. É necessário fornecer pelo menos um dos parâmetros appDestination ou webDestination. Se o registro for bem-sucedido, o OutcomeReceiver#onResult do callback será invocado com um valor nulo. Em caso de falha, um Exception é enviado por OutcomeReceiver.onError(E) do callback. Tanto o feedback de sucesso quanto o de falha são executados no Executor fornecido.
Requer AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION

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

registerWebTrigger

Adicionado no nível 34 da API
Também nas Extensões de serviços de anúncios 4

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. Essa API não processa redirecionamentos. Todos os URLs de registro precisam ser fornecidos com a solicitação. Se o registro for bem-sucedido, o OutcomeReceiver#onResult do callback será invocado com um valor nulo. Em caso de falha, um Exception é enviado por OutcomeReceiver.onError(E) do callback. Tanto o feedback de sucesso quanto o de falha são executados no Executor fornecido.
Requer AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION

Parâmetros
`request`	`WebTriggerRegistrationRequest`: solicitação de registro de acionador Esse valor não pode ser `null`.
`executor`	`Executor`: usado pelo callback para enviar resultados. Esse valor pode ser `null`.
`callback`	`OutcomeReceiver`: destina-se a notificar assincronamente o resultado da API Este valor pode ser `null`.