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