Filtri quota limite

public final class FrequencyCapFilters
extends Object implements Parcelable

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

Un contenitore per i filtri degli annunci basati sulle quote limite.

A un singolo annuncio non possono essere associati più di 20 filtri per la quota limite.

I filtri delle quote limite combinano un tipo di evento con un elenco di KeyedFrequencyCap oggetti per definire una raccolta di filtri degli annunci. Se una qualsiasi di queste quote limite viene superata per un determinato annuncio, l'annuncio verrà rimosso dal gruppo di annunci inviati alla funzione di offerta di un acquirente AdTech.

Riepilogo

Classi nidificate

class FrequencyCapFilters.Builder

Builder per la creazione di oggetti FrequencyCapFilters. 

Costanti

int AD_EVENT_TYPE_CLICK

int AD_EVENT_TYPE_IMPRESSION

int AD_EVENT_TYPE_VIEW

int AD_EVENT_TYPE_WIN

Il tipo di evento dell'annuncio WIN viene compilato automaticamente all'interno del servizio Protected Audience per Qualsiasi annuncio vincente restituito dalla selezione degli annunci Protected Audience.

Costanti ereditate

Campi

public static final Creator<FrequencyCapFilters> CREATOR

Metodi pubblici

boolean equals(Object o)

Controlla se gli oggetti FrequencyCapFilters contengono le stesse informazioni.

List<KeyedFrequencyCap> getKeyedFrequencyCapsForClickEvents()

Recupera l'elenco di oggetti KeyedFrequencyCap che filtreranno in base al tipo di evento AD_EVENT_TYPE_CLICK.

List<KeyedFrequencyCap> getKeyedFrequencyCapsForImpressionEvents()

Recupera l'elenco di oggetti KeyedFrequencyCap che filtreranno in base al tipo di evento AD_EVENT_TYPE_IMPRESSION.

List<KeyedFrequencyCap> getKeyedFrequencyCapsForViewEvents()

Recupera l'elenco di oggetti KeyedFrequencyCap che filtreranno in base al tipo di evento AD_EVENT_TYPE_VIEW.

List<KeyedFrequencyCap> getKeyedFrequencyCapsForWinEvents()

Recupera l'elenco di oggetti KeyedFrequencyCap che filtreranno in base al tipo di evento AD_EVENT_TYPE_WIN.

int hashCode()

Restituisce l'hash dei dati dell'oggetto FrequencyCapFilters.

String toString()

Restituisce una rappresentazione stringa dell'oggetto.

void writeToParcel(Parcel dest, int flags)

Appiattisci questo oggetto a un Parcel.

Metodi ereditati

Costanti

AD_EVENT_TYPE_CLICK

Aggiunto in UpsidedownCakePrivacySandbox di Android 
public static final int AD_EVENT_TYPE_CLICK

Valore costante: 3 (0x00000003)

AD_EVENT_TYPE_IMPRESSION

Aggiunto in UpsidedownCakePrivacySandbox di Android 
public static final int AD_EVENT_TYPE_IMPRESSION

Valore costante: 1 (0x00000001)

AD_EVENT_TYPE_VIEW

Aggiunto in UpsidedownCakePrivacySandbox di Android 
public static final int AD_EVENT_TYPE_VIEW

Valore costante: 2 (0x00000002)

AD_EVENT_TYPE_VINCITO

Aggiunto in UpsidedownCakePrivacySandbox di Android 
public static final int AD_EVENT_TYPE_WIN

Il tipo di evento dell'annuncio WIN viene compilato automaticamente all'interno del servizio Protected Audience per Qualsiasi annuncio vincente restituito dalla selezione degli annunci Protected Audience.

Non deve essere utilizzato per aggiornare manualmente un istogramma del contatore annunci.

Valore costante: 0 (0x00000000)

Campi

Metodi pubblici

uguale

public boolean equals (Object o)

Controlla se gli oggetti FrequencyCapFilters contengono le stesse informazioni.

Parametri
o Object: l'oggetto di riferimento con cui eseguire il confronto.
Ritorni
boolean true se questo oggetto è uguale all'oggetto argomento; false negli altri casi.

getKeyedFrequencyCapsForClickEvents

public List<KeyedFrequencyCap> getKeyedFrequencyCapsForClickEvents ()

Recupera l'elenco di oggetti KeyedFrequencyCap che filtreranno in base al tipo di evento AD_EVENT_TYPE_CLICK.

Queste quote limite si applicano agli eventi correlati a un clic come interpretati da una adTech. Gli eventi di clic vengono conteggiati quando l'API AdSelectionManager.updateAdCounterHistogram(UpdateAdCounterHistogramRequest, Executor, OutcomeReceiver) viene richiamata con il tipo di evento AD_EVENT_TYPE_CLICK.

Ritorni
List<KeyedFrequencyCap> Questo valore non può essere null.

getKeyedFrequencyCapsForImpressionEvents

public List<KeyedFrequencyCap> getKeyedFrequencyCapsForImpressionEvents ()

Recupera l'elenco di oggetti KeyedFrequencyCap che filtreranno in base al tipo di evento AD_EVENT_TYPE_IMPRESSION.

Queste quote limite si applicano agli eventi correlati a un'impressione come interpretati da un adTech.

Tieni presente che gli eventi non vengono conteggiati automaticamente quando chiami AdSelectionManager.reportImpression(ReportImpressionRequest, Executor, OutcomeReceiver). Al contrario, il tipo di evento AD_EVENT_TYPE_IMPRESSION deve possono essere aggiornate usando l'API AdSelectionManager.updateAdCounterHistogram(UpdateAdCounterHistogramRequest, Executor, OutcomeReceiver).

Ritorni
List<KeyedFrequencyCap> Questo valore non può essere null.

getKeyedFrequencyCapsForViewEvents

public List<KeyedFrequencyCap> getKeyedFrequencyCapsForViewEvents ()

Recupera l'elenco di oggetti KeyedFrequencyCap che filtreranno in base al tipo di evento AD_EVENT_TYPE_VIEW.

Queste quote limite si applicano agli eventi correlati a una vista come interpretati da una adTech. Gli eventi di visualizzazione vengono conteggiati quando l'API AdSelectionManager.updateAdCounterHistogram(UpdateAdCounterHistogramRequest, Executor, OutcomeReceiver) viene richiamata con il tipo di evento AD_EVENT_TYPE_VIEW.

Ritorni
List<KeyedFrequencyCap> Questo valore non può essere null.

getKeyedFrequencyCapsForWinEvents

public List<KeyedFrequencyCap> getKeyedFrequencyCapsForWinEvents ()

Recupera l'elenco di oggetti KeyedFrequencyCap che filtreranno in base al tipo di evento AD_EVENT_TYPE_WIN.

Queste quote limite si applicano agli eventi per gli annunci selezionati come vincitori nell'annuncio selezione. Gli annunci vincenti vengono utilizzati per incrementare automaticamente le chiavi contatore associate nella un tipo di evento vincitrice.

Tieni presente che il tipo di evento AD_EVENT_TYPE_WIN non può essere aggiornato manualmente utilizzando il metodo API AdSelectionManager.updateAdCounterHistogram(UpdateAdCounterHistogramRequest, Executor, OutcomeReceiver).

Ritorni
List<KeyedFrequencyCap> Questo valore non può essere null.

codice hash

public int hashCode ()

Restituisce l'hash dei dati dell'oggetto FrequencyCapFilters.

Ritorni
int un valore di codice hash per l'oggetto.

ToString

public String toString ()

Restituisce una rappresentazione stringa dell'oggetto. In generale, Il metodo toString restituisce una stringa "rappresenta testuale" dell'oggetto. Il risultato dovrebbe essere una rappresentazione concisa ma informativa che sia facile per a leggere. È consigliabile che tutte le sottoclassi eseguano l'override di questo metodo.

Il metodo toString per la classe Object restituisce una stringa composta dal nome della classe di cui è un'istanza, il carattere del segno chiocciola "@" la rappresentazione esadecimale non firmata del codice hash del . In altre parole, questo metodo restituisce una stringa uguale al valore di: 

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

Ritorni
String una rappresentazione in formato stringa dell'oggetto.

ScriviToParcel

public void writeToParcel (Parcel dest, 
                int flags)

Appiattisci questo oggetto a un Parcel.

Parametri
dest Parcel: questo valore non può essere null.
flags int: flag aggiuntivi su come deve essere scritto l'oggetto. Può essere 0 o Parcelable.PARCELABLE_WRITE_RETURN_VALUE. Il valore è 0 o una combinazione di Parcelable.PARCELABLE_WRITE_RETURN_VALUE e android.os.Parcelable.PARCELABLE_ELIDE_DUPLICATES