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 |
Constantes heredadas |
---|
Campos | |
---|---|
public
static
final
Creator<CustomAudience> |
CREATOR
|
Métodos públicos | |
---|---|
boolean
|
equals(Object o)
Comprueba si dos objetos |
Instant
|
getActivationTime()
Cuando se crea el objeto |
List<AdData>
|
getAds()
Esta lista de objetos |
Uri
|
getBiddingLogicUri()
Devuelve 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. |
AdTechIdentifier
|
getBuyer()
Un comprador es identificado por un dominio con el formato "buyerexample.com". |
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. |
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 cadena arbitraria proporcionada por el propietario y el comprador cuando se crea el objeto |
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. |
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()
Devuelve el hash de los datos del objeto |
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
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. |
Devuelve | |
---|---|
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 que 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.
Muestra | |
---|---|
Instant |
la marca de tiempo Instant , truncada a milisegundos, después de la cual
público está activo
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.
Muestra | |
---|---|
List<AdData> |
un objeto List de AdData que representa los anuncios publicados actualmente por el
público personalizado
Este valor no puede ser null . |
getBiddingLogicUri
public Uri getBiddingLogicUri ()
Devuelve 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.
Muestra | |
---|---|
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".
Muestra | |
---|---|
AdTechIdentifier |
un elemento 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.
Muestra | |
---|---|
Uri |
el 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.
Muestra | |
---|---|
Instant |
la marca de tiempo Instant , truncada a milisegundos, después de la cual
se debe quitar el público
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
.
Muestra | |
---|---|
String |
el nombre de cadena 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.
Muestra | |
---|---|
TrustedBiddingData |
Un objeto TrustedBiddingData que contiene las ofertas de confianza del público personalizado
datos
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.
Muestra | |
---|---|
AdSelectionSignals |
Un objeto AdSelectionSignals que representa los indicadores de ofertas del usuario para el
público personalizado
Este valor puede ser null . |
hashCode
public int hashCode ()
Devuelve el hash de los datos del objeto CustomAudience
.
Devuelve | |
---|---|
int |
un valor de código hash para este objeto. |
writeToParcel
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. |