FrequencyCapFilters

public final class FrequencyCapFilters
extends Object implements Parcelable

java.lang.Object.
   ↳ android.adservices.common.FrequencyCapFilters.


Es un contenedor para los filtros de anuncios que se basa en las limitaciones de frecuencia.

No se pueden asociar más de 20 filtros de limitación de frecuencia con un solo anuncio.

Los filtros de limitación de frecuencia combinan un tipo de evento con una lista de objetos KeyedFrequencyCap para definir una colección de filtros de anuncios. Si se supera alguna de estas limitaciones de frecuencia para un anuncio determinado, este se quitará del grupo de anuncios enviado a la función de ofertas de AdTech de un comprador.

Resumen

Clases anidadas

class FrequencyCapFilters.Builder

Es un compilador para crear objetos FrequencyCapFilters

Constantes

int AD_EVENT_TYPE_CLICK

int AD_EVENT_TYPE_IMPRESSION

int AD_EVENT_TYPE_VIEW

int AD_EVENT_TYPE_WIN

El tipo de evento de anuncio WIN se propaga automáticamente en el servicio de Protected Audience para cualquier anuncio ganador que se muestre desde la selección de anuncios de Protected Audience.

Constantes heredadas

Campos

public static final Creator<FrequencyCapFilters> CREATOR

Métodos públicos

boolean equals(Object o)

Comprueba si los objetos FrequencyCapFilters contienen la misma información.

List<KeyedFrequencyCap> getKeyedFrequencyCapsForClickEvents()

Obtiene la lista de objetos KeyedFrequencyCap que filtrarán el tipo de evento AD_EVENT_TYPE_CLICK.

List<KeyedFrequencyCap> getKeyedFrequencyCapsForImpressionEvents()

Obtiene la lista de objetos KeyedFrequencyCap que filtrarán el tipo de evento AD_EVENT_TYPE_IMPRESSION.

List<KeyedFrequencyCap> getKeyedFrequencyCapsForViewEvents()

Obtiene la lista de objetos KeyedFrequencyCap que filtrarán el tipo de evento AD_EVENT_TYPE_VIEW.

List<KeyedFrequencyCap> getKeyedFrequencyCapsForWinEvents()

Obtiene la lista de objetos KeyedFrequencyCap que filtrarán el tipo de evento AD_EVENT_TYPE_WIN.

int hashCode()

Muestra el hash de los datos del objeto FrequencyCapFilters.

String toString()

Muestra una representación de cadena del objeto.

void writeToParcel(Parcel dest, int flags)

Compacta este objeto en un Parcel.

Métodos heredados

Constantes

AD_EVENT_TYPE_CLIC

public static final int AD_EVENT_TYPE_CLICK

Valor constante: 3 (0x00000003)

AD_EVENT_TYPE_Impresión

public static final int AD_EVENT_TYPE_IMPRESSION

Valor constante: 1 (0x00000001)

AD_EVENT_TYPE_VIEW

public static final int AD_EVENT_TYPE_VIEW

Valor constante: 2 (0x00000002)

AD_EVENT_TYPE_GANA

public static final int AD_EVENT_TYPE_WIN

El tipo de evento de anuncio WIN se propaga automáticamente en el servicio de Protected Audience para cualquier anuncio ganador que se muestre desde la selección de anuncios de Protected Audience.

No debe usarse para actualizar manualmente un histograma de contador de anuncios.

Valor constante: 0 (0x00000000)

Campos

Métodos públicos

equals

public boolean equals (Object o)

Comprueba si los objetos FrequencyCapFilters 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.

getKeyedFrequencyCapsForClickEvents

public List<KeyedFrequencyCap> getKeyedFrequencyCapsForClickEvents ()

Obtiene la lista de objetos KeyedFrequencyCap que filtrarán el tipo de evento AD_EVENT_TYPE_CLICK.

Estas limitaciones de frecuencia se aplican a eventos que se correlacionan con un clic según lo interpreta una AdTech. Los eventos de clic se cuentan cuando se invoca la API de AdSelectionManager.updateAdCounterHistogram(UpdateAdCounterHistogramRequest, Executor, OutcomeReceiver) con el tipo de evento AD_EVENT_TYPE_CLICK.

Devuelve
List<KeyedFrequencyCap> Este valor no puede ser null.

getKeyedFrequencyCapsForImpressionEvents

public List<KeyedFrequencyCap> getKeyedFrequencyCapsForImpressionEvents ()

Obtiene la lista de objetos KeyedFrequencyCap que filtrarán el tipo de evento AD_EVENT_TYPE_IMPRESSION.

Estas limitaciones de frecuencia se aplican a eventos que se correlacionan con una impresión según la interpreta una AdTech.

Ten en cuenta que los eventos no se cuentan automáticamente cuando se llama a AdSelectionManager.reportImpression(ReportImpressionRequest, Executor, OutcomeReceiver). En su lugar, el tipo de evento AD_EVENT_TYPE_IMPRESSION debe actualizarse con la API de AdSelectionManager.updateAdCounterHistogram(UpdateAdCounterHistogramRequest, Executor, OutcomeReceiver).

Devuelve
List<KeyedFrequencyCap> Este valor no puede ser null.

getKeyedFrequencyCapsForViewEvents

public List<KeyedFrequencyCap> getKeyedFrequencyCapsForViewEvents ()

Obtiene la lista de objetos KeyedFrequencyCap que filtrarán el tipo de evento AD_EVENT_TYPE_VIEW.

Estas limitaciones de frecuencia se aplican a eventos que se correlacionan con una vista según la interpreta una AdTech. Los eventos de vista se cuentan cuando se invoca la API de AdSelectionManager.updateAdCounterHistogram(UpdateAdCounterHistogramRequest, Executor, OutcomeReceiver) con el tipo de evento AD_EVENT_TYPE_VIEW.

Devuelve
List<KeyedFrequencyCap> Este valor no puede ser null.

getKeyedFrequencyCapsForWinEvents

public List<KeyedFrequencyCap> getKeyedFrequencyCapsForWinEvents ()

Obtiene la lista de objetos KeyedFrequencyCap que filtrarán el tipo de evento AD_EVENT_TYPE_WIN.

Estas limitaciones de frecuencia se aplican a los eventos de anuncios que se seleccionaron como ganadores en la selección de anuncios. Los anuncios ganadores se usan para aumentar automáticamente las claves de contador asociadas en el tipo de evento ganador.

Ten en cuenta que el tipo de evento AD_EVENT_TYPE_WIN no se puede actualizar de forma manual con la API de AdSelectionManager.updateAdCounterHistogram(UpdateAdCounterHistogramRequest, Executor, OutcomeReceiver).

Devuelve
List<KeyedFrequencyCap> Este valor no puede ser null.

hashCode

public int hashCode ()

Muestra el hash de los datos del objeto FrequencyCapFilters.

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

toString

public String toString ()

Muestra una representación de cadena del objeto. En general, el método toString muestra una cadena que "representa de forma textual" a este objeto. El resultado debe ser una representación concisa pero informativa y fácil de leer. Se recomienda que todas las subclases anulen este método.

El método toString para la clase Object muestra una cadena que consiste en el nombre de la clase de la que el objeto es una instancia, el carácter arroba "@" y la representación hexadecimal sin firma del código hash del objeto. En otras palabras, este método muestra una cadena igual al siguiente valor:

 getClass().getName() + '@' + Integer.toHexString(hashCode())
 

Muestra
String una representación de cadena del 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.