CustomAudience

public final class CustomAudience
extends Object implements Parcelable

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


Representa la información necesaria para que un público personalizado participe en la selección de anuncios.

Un público personalizado es una agrupación abstracta de usuarios con intereses similares demostrados. Esta clase es un conjunto de algunos datos almacenados en un dispositivo que se necesita para publicar anuncios que apuntan a un solo público personalizado.

Resumen

Clases anidadas

class CustomAudience.Builder

Compilador para objetos CustomAudience

Constantes heredadas

Campos

public static final Creator<CustomAudience> CREATOR

Métodos públicos

boolean equals(Object o)

Comprueba si dos objetos CustomAudience contienen la misma información.

Instant getActivationTime()

Cuando se crea el objeto CustomAudience, se puede establecer un tiempo de activación opcional en el futuro para publicar una activación retrasada.

List<AdData> getAds()

Esta lista de objetos AdData es una lista completa de los anuncios que publicará CustomAudience durante el proceso de selección.

Uri getBiddingLogicUri()

Muestra la URI de destino que se usa para recuperar la lógica de ofertas cuando un público personalizado participa en el proceso de selección de anuncios.

AdTechIdentifier getBuyer()

Un comprador es identificado por un dominio con el formato "buyerexample.com".

Uri getDailyUpdateUri()

Esta URI dirige a un servidor operado por el comprador que aloja datos de ofertas y metadatos de anuncios actualizados para usarse en el proceso de selección de anuncios integrados en el dispositivo.

Instant getExpirationTime()

Una vez que transcurre el tiempo de vencimiento, un público personalizado deja de ser apto para las actualizaciones diarias de los datos de ofertas y anuncios o la participación en el proceso de selección de anuncios.

String getName()

El nombre del público personalizado es una string arbitraria proporcionada por el propietario y el comprador cuando se crea el objeto CustomAudience.

TrustedBiddingData getTrustedBiddingData()

Los datos de ofertas de confianza consisten en una URI que dirige a un servidor de confianza para los datos de ofertas de los compradores y una lista de claves con las que consultar al servidor.

AdSelectionSignals getUserBiddingSignals()

Los compradores proporcionan de manera opcional indicadores de ofertas del usuario para que los consuma el JavaScript que brindan los compradores durante la selección de anuncios en un entorno de ejecución aislado.

int hashCode()

Muestra el hash de los datos del objeto CustomAudience.

void writeToParcel(Parcel dest, int flags)

Compacta este objeto en un Parcel.

Métodos heredados

Campos

CREATOR

public static final Creator<CustomAudience> CREATOR

Métodos públicos

equals

Se agregó en el nivel de API 34.
public boolean equals (Object o)

Comprueba si dos objetos CustomAudience contienen la misma información.

Parámetros
o Object: Es el objeto de referencia con el que se debe comparar.

Muestra
boolean true si este objeto es el mismo que el argumento obj; de lo contrario, false.

getActivationTime

public Instant getActivationTime ()

Cuando se crea el objeto CustomAudience, se puede establecer un tiempo de activación opcional en el futuro para publicar una activación retrasada. Si no estableces el campo, se activará CustomAudience al momento de unirse.

Por ejemplo, un público personalizado para usuarios inactivos no podrá activarse hasta que se alcance un umbral de inactividad, momento en el cual los anuncios del público personalizado participarán en el proceso de selección de anuncios, lo que podría redireccionar a los usuarios inactivos a la aplicación de propietario original.

El retraso máximo en la activación es de 60 días desde la creación inicial.

Si se especifica, la hora de activación debe ser anterior a la fecha de vencimiento.

Devuelve
Instant La marca de tiempo Instant, truncada en milisegundos, después de la cual se activa el público personalizado. Este valor puede ser null.

getAds

public List<AdData> getAds ()

Esta lista de objetos AdData es una lista completa de los anuncios que publicará CustomAudience durante el proceso de selección.

Si no se especifica, o si se proporciona una lista vacía, CustomAudience no participará en la selección de anuncios hasta que se proporcione una lista válida de anuncios a través de la actualización diaria del público personalizado.

Devuelve
List<AdData> una List de objetos AdData que representan anuncios publicados actualmente por el público personalizado. Este valor no puede ser null.

getBiddingLogicUri

public Uri getBiddingLogicUri ()

Muestra el URI de destino que se usa para recuperar la lógica de ofertas cuando un público personalizado participa en el proceso de selección de anuncios. El URI debe usar HTTPS.

Devuelve
Uri El URI para recuperar la lógica de ofertas del comprador. Este valor no puede ser null.

getBuyer

public AdTechIdentifier getBuyer ()

Un comprador es identificado por un dominio con el formato "buyerexample.com".

Devuelve
AdTechIdentifier Un AdTechIdentifier que contiene el dominio del comprador del público personalizado. Este valor no puede ser null.

getDailyUpdateUri

public Uri getDailyUpdateUri ()

Este URI dirige a un servidor operado por el comprador que aloja datos de ofertas y metadatos de anuncios actualizados para usarse en el proceso de selección de anuncios integrados en el dispositivo. El URI debe usar HTTPS.

Devuelve
Uri La URI de actualización diaria del público personalizado. Este valor no puede ser null.

getExpirationTime

public Instant getExpirationTime ()

Una vez que transcurre el tiempo de vencimiento, un público personalizado deja de ser apto para las actualizaciones diarias de los datos de ofertas y anuncios o la participación en el proceso de selección de anuncios. El público personalizado se borrará de la memoria en la próxima actualización diaria.

Si no se proporciona un tiempo de vencimiento en la creación de CustomAudience, el vencimiento se establecerá de forma predeterminada 60 días a partir de la activación.

El vencimiento máximo es de 60 días desde la activación inicial.

Devuelve
Instant La marca de tiempo Instant, truncada en milisegundos, después de la cual se debe quitar el público personalizado. Este valor puede ser null.

getName

public String getName ()

El nombre del público personalizado es una cadena arbitraria proporcionada por el propietario y el comprador cuando se crea el objeto CustomAudience.

Devuelve
String El nombre de string del público personalizado. Este valor no puede ser null.

getTrustedBiddingData

public TrustedBiddingData getTrustedBiddingData ()

Los datos de ofertas de confianza consisten en un URI que dirige a un servidor de confianza para los datos de ofertas de los compradores y una lista de claves con las que consultar al servidor. Ten en cuenta que las claves son identificadores arbitrarios que solo se usarán para consultar al servidor de confianza acerca de la lógica de ofertas de un comprador durante la selección del anuncio.

Si no se especifica, CustomAudience no participará en la selección de anuncios hasta que se proporcionen datos de ofertas confiables a través de la actualización diaria del público personalizado.

Devuelve
TrustedBiddingData Un objeto TrustedBiddingData que contiene los datos de ofertas de confianza del público personalizado. Este valor puede ser null.

getUserBiddingSignals

public AdSelectionSignals getUserBiddingSignals ()

Los compradores proporcionan de manera opcional indicadores de ofertas del usuario para que los consuma el JavaScript que brindan los compradores durante la selección de anuncios en un entorno de ejecución aislado.

Si los indicadores de ofertas de los usuarios no son un objeto JSON válido que puede consumir el JS del comprador, el público personalizado no será apto para la selección de anuncios.

Si no se especifica, CustomAudience no participará en la selección de anuncios hasta que los indicadores de ofertas del usuario se proporcionen a través de la actualización diaria del público personalizado.

Devuelve
AdSelectionSignals Un objeto AdSelectionSignals, que representa los indicadores de ofertas del usuario para el público personalizado. Este valor puede ser null.

hashCode

Se agregó en el nivel de API 34.
public int hashCode ()

Muestra el hash de los datos del objeto CustomAudience.

Muestra
int un valor de código hash para este objeto.

writeToParcel

Se agregó en el nivel de API 34.
public void writeToParcel (Parcel dest, 
                int flags)

Compacta este objeto en un Parcel.

Parámetros
dest Parcel: Este valor no puede ser null.

flags int: Marcas adicionales sobre cómo se debe escribir el objeto. Puede ser 0 o Parcelable.PARCELABLE_WRITE_RETURN_VALUE. El valor es 0 o una combinación de Parcelable.PARCELABLE_WRITE_RETURN_VALUE y android.os.Parcelable.PARCELABLE_ELIDE_DUPLICATES.