Esta página foi traduzida pela API Cloud Translation.

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

Resumo: Classes aninhadas | Constantes herdadas | Campos | Métodos | Métodos herdados

CustomAudience

public final class CustomAudience
extends Object implements Parcelable

java.lang.Object
↳	android.adservices.customaudience.CustomAudience

Representa as informações necessárias para que um público-alvo personalizado participe da seleção de anúncios.

Um público-alvo personalizado é um agrupamento abstrato de usuários que demonstram interesses semelhantes. Esta classe é uma coleção de alguns dados armazenados em um dispositivo necessários para veicular anúncios voltados a um único público-alvo personalizado.

Resumo

Classes aninhadas
`class`	`CustomAudience.Builder` Builder para objetos `CustomAudience`.

Constantes herdadas

Da interface android.os.Parcelable

`int`	`CONTENTS_FILE_DESCRIPTOR` Bit descritor usado com `describeContents()`: indica que a representação nivelada do objeto Parcelable inclui um descritor de arquivo.
`int`	`PARCELABLE_WRITE_RETURN_VALUE` Sinalização para uso com `writeToParcel(Parcel, int)`: o objeto escrito é um valor de retorno, que é o resultado de uma função como "`Parcelable someFunction()`", "`void someFunction(out Parcelable)`" ou "`void someFunction(inout Parcelable)`".

Campos
`public static final Creator<CustomAudience>`	`CREATOR`

Métodos públicos
`boolean`	`equals(Object o)` Confere se dois objetos `CustomAudience` contêm as mesmas informações.
`Instant`	`getActivationTime()` Na criação do objeto `CustomAudience`, o tempo de ativação opcional pode ser definido no futuro para atender a uma ativação atrasada.
`List<AdData>`	`getAds()` Esta lista de objetos `AdData` funciona como uma lista completa dos anúncios que serão veiculados por esse `CustomAudience` durante o processo de seleção de anúncios.
`Uri`	`getBiddingLogicUri()` Retorna o URI de destino usado para buscar a lógica de lances quando um público-alvo personalizado participa do processo de seleção de anúncios.
`AdTechIdentifier`	`getBuyer()` Um comprador é identificado por um domínio no formato "buyerexample.com".
`Uri`	`getDailyUpdateUri()` Esse URI aponta para um servidor operado pelo comprador que hospeda dados de lances e metadados de anúncios atualizados para serem usados no processo de seleção de anúncios no dispositivo.
`Instant`	`getExpirationTime()` Passado o prazo de validade, um público-alvo personalizado não vai estar mais qualificado para receber atualizações diárias de dados de anúncios/lances ou participar do processo de seleção de anúncios.
`String`	`getName()` O nome do público-alvo personalizado é uma string arbitrária fornecida pelo proprietário e pelo comprador na criação do objeto `CustomAudience`.
`TrustedBiddingData`	`getTrustedBiddingData()` Os dados de lances confiáveis consistem em um URI que aponta para um servidor confiável dos dados de lances dos compradores e uma lista de chaves para consultar o servidor.
`AdSelectionSignals`	`getUserBiddingSignals()` Os indicadores de lances do usuário são fornecidos opcionalmente pelos compradores para consumo do JavaScript fornecido pelo comprador durante a seleção do anúncio em um ambiente de execução isolado.
`int`	`hashCode()` Retorna o hash dos dados do objeto `CustomAudience`.
`void`	`writeToParcel(Parcel dest, int flags)` Nivela esse objeto em um Parcel.

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.

Da interface


        
          android.os.Parcelable

`abstract int`	`describeContents()` Descreve os tipos de objetos especiais contidos na representação empacotada dessa instância de Parcelable.
`abstract void`	`writeToParcel(Parcel dest, int flags)` Nivela esse objeto em um Parcel.

Campos

CREATOR

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

public static final Creator<CustomAudience> CREATOR

Métodos públicos

equals

Adicionado no nível 34 da API

public boolean equals (Object o)

Confere se dois objetos CustomAudience contêm as mesmas informações.

Parâmetros
`o`	`Object`: o objeto de referência para comparação.

Retorna
`boolean`	`true`, se esse objeto for o mesmo que o argumento obj. Caso contrário, `false`.

getActivationTime

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

public Instant getActivationTime ()

Na criação do objeto CustomAudience, o tempo de ativação opcional pode ser definido no futuro para atender a uma ativação atrasada. Se o campo não for definido, o CustomAudience será ativado no momento do agrupamento.

Por exemplo, um público-alvo personalizado para usuários inativos pode não ser ativado até que um limite de inatividade seja atingido. Nesse momento, os anúncios do público-alvo personalizado vão participar do processo de seleção de anúncios, possivelmente redirecionando os usuários inativos para a solicitação original do proprietário.

O atraso máximo de ativação é de 60 dias a partir da criação inicial.

Se especificado, o tempo de ativação vai precisar ser um momento anterior ao prazo de validade.

Retorna
`Instant`	o carimbo de data/hora `Instant`, truncado para milissegundos. Depois disso, o valor o público-alvo está ativo Esse valor pode ser `null`.

getAds

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

public List<AdData> getAds ()

Esta lista de objetos AdData funciona como uma lista completa dos anúncios que serão veiculados por esse CustomAudience durante o processo de seleção de anúncios.

Se não for especificado, ou se uma lista vazia for fornecida, o CustomAudience não vai participar da seleção de anúncios até que uma lista válida seja fornecida pela atualização diária do público-alvo personalizado.

Retorna
`List<AdData>`	uma `List` de objetos `AdData` que representam anúncios veiculados pelo público-alvo personalizado Esse valor não pode ser `null`.

getBiddingLogicUri

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

public Uri getBiddingLogicUri ()

Retorna o URI de destino usado para buscar a lógica de lances quando um público-alvo personalizado participa do processo de seleção de anúncios. O URI precisa usar HTTPS.

Retorna
`Uri`	o URI para buscar a lógica de lances do comprador Esse valor não pode ser `null`.

getBuyer

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

public AdTechIdentifier getBuyer ()

Um comprador é identificado por um domínio no formato "buyerexample.com".

Retorna
`AdTechIdentifier`	um `AdTechIdentifier` contendo o domínio do comprador do público-alvo personalizado Esse valor não pode ser `null`.

getDailyUpdateUri

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

public Uri getDailyUpdateUri ()

Esse URI aponta para um servidor operado pelo comprador que hospeda dados de lances e metadados de anúncios atualizados para serem usados no processo de seleção de anúncios no dispositivo. O URI precisa usar HTTPS.

Retorna
`Uri`	o URI de atualização diária do público-alvo personalizado Esse valor não pode ser `null`.

getExpirationTime

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

public Instant getExpirationTime ()

Passado o prazo de validade, um público-alvo personalizado não vai estar mais qualificado para receber atualizações diárias de dados de anúncios/lances ou participar do processo de seleção de anúncios. Em seguida, o público-alvo personalizado vai ser excluído da memória até a próxima atualização diária.

Se nenhum prazo de validade for informado na criação do CustomAudience, o padrão é de 60 dias após a ativação.

A expiração máxima é de 60 dias a partir da ativação inicial.

Retorna
`Instant`	o carimbo de data/hora `Instant`, truncado para milissegundos. Depois disso, o valor o público-alvo precisa ser removido Esse valor pode ser `null`.

getName

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

public String getName ()

O nome do público-alvo personalizado é uma string arbitrária fornecida pelo proprietário e pelo comprador na criação do objeto CustomAudience.

Retorna
`String`	o nome da string do público-alvo personalizado. Esse valor não pode ser `null`.

getTrustedBiddingData

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

public TrustedBiddingData getTrustedBiddingData ()

Os dados de lances confiáveis consistem em um URI que aponta para um servidor confiável dos dados de lances dos compradores e uma lista de chaves para consultar o servidor. As chaves são identificadores arbitrários que somente serão usados para consultar o servidor confiável sobre a lógica de lances de um comprador durante a seleção de anúncios.

Se não for especificado, o CustomAudience não participará da seleção de anúncios até que os dados de lances confiáveis sejam fornecidos pela atualização diária do público-alvo personalizado.

Retorna
`TrustedBiddingData`	um objeto `TrustedBiddingData` contendo os lances confiáveis do público-alvo personalizado dados Esse valor pode ser `null`.

getUserBiddingSignals

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

public AdSelectionSignals getUserBiddingSignals ()

Os indicadores de lances do usuário são fornecidos opcionalmente pelos compradores para consumo do JavaScript fornecido pelo comprador durante a seleção do anúncio em um ambiente de execução isolado.

Se os indicadores de lances do usuário não forem um objeto JSON válido que possa ser consumido pelo JavaScript do comprador, o público-alvo personalizado não vai estar qualificado para a seleção de anúncios.

Se não for especificado, o CustomAudience não vai participar da seleção de anúncios até que os indicadores de lances do usuário sejam fornecidos por atualizações diárias para o público-alvo personalizado.

Retorna
`AdSelectionSignals`	um objeto `AdSelectionSignals` que representa os indicadores de lances do usuário para o público-alvo personalizado Esse valor pode ser `null`.

hashCode

Adicionado no nível 34 da API

public int hashCode ()

Retorna o hash dos dados do objeto CustomAudience.

Retorna
`int`	Um valor de código hash para esse objeto.

writeToParcel

Adicionado no nível 34 da API

public void writeToParcel (Parcel dest, 
                int flags)

Nivela esse objeto em um Parcel.

Parâmetros
`dest`	`Parcel`: este valor não pode ser `null`.
`flags`	`int`: outras sinalizações sobre como o objeto precisa ser criado. Pode ser 0 ou `Parcelable.PARCELABLE_WRITE_RETURN_VALUE`. O valor é `0` ou uma combinação de `Parcelable.PARCELABLE_WRITE_RETURN_VALUE` e android.os.Parcelable.PARCELABLE_ELIDE_DUPLICATES