CustomAudience

public final class CustomAudience
extends Object implements Parcelable

java.lang.Object (link em inglês)
   ↳ 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

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

Campos

CREATOR

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

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 inscriçã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.

Returns
Instant o carimbo de data/hora Instant, truncado para milissegundos, ativando o público-alvo personalizado em seguida Esse valor pode ser null.

getAds

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.

Returns
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

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.

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

getBuyer

public AdTechIdentifier getBuyer ()

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

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

getDailyUpdateUri

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.

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

getExpirationTime

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.

Returns
Instant o carimbo de data/hora Instant, truncado para milissegundos, removendo o público-alvo personalizado em seguida. Esse valor pode ser null.

getName

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.

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

getTrustedBiddingData

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.

Returns
TrustedBiddingData um objeto TrustedBiddingData que contém os dados de lances confiáveis do público-alvo personalizado. Esse valor pode ser null.

getUserBiddingSignals

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.

Returns
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