Filtri quota limite

public final class FrequencyCapFilters
extends Object implements Parcelable

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

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

Non è possibile associare più di 20 filtri di quota limite a un singolo annuncio.

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

Riepilogo

Classi nidificate

class FrequencyCapFilters.Builder

Builder per la creazione di FrequencyCapFilters oggetti. 

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)

Verifica se gli oggetti FrequencyCapFilters contengono le stesse informazioni.

List<KeyedFrequencyCap> getKeyedFrequencyCapsForClickEvents()

Restituisce l'elenco di KeyedFrequencyCap oggetti che verranno filtrati in base al tipo di evento AD_EVENT_TYPE_CLICK.

List<KeyedFrequencyCap> getKeyedFrequencyCapsForImpressionEvents()

Restituisce l'elenco di KeyedFrequencyCap oggetti che verranno filtrati in base al tipo di evento AD_EVENT_TYPE_IMPRESSION.

List<KeyedFrequencyCap> getKeyedFrequencyCapsForViewEvents()

Restituisce l'elenco di KeyedFrequencyCap oggetti che verranno filtrati in base al tipo di evento AD_EVENT_TYPE_VIEW.

List<KeyedFrequencyCap> getKeyedFrequencyCapsForWinEvents()

Restituisce l'elenco di KeyedFrequencyCap oggetti che verranno filtrati 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 in un particolato.

Metodi ereditati

Costanti

AD_EVENT_TYPE_CLICK

Aggiunta in UpsideDownCakePrivacySandbox per Android 
public static final int AD_EVENT_TYPE_CLICK

Valore costante: 3 (0x00000003)

AD_EVENT_TYPE_IMPRESSION

Aggiunta in UpsideDownCakePrivacySandbox per Android 
public static final int AD_EVENT_TYPE_IMPRESSION

Valore costante: 1 (0x00000001)

AD_EVENT_TYPE_VIEW

Aggiunta in UpsideDownCakePrivacySandbox per Android 
public static final int AD_EVENT_TYPE_VIEW

Valore costante: 2 (0x00000002)

AD_EVENT_TYPE_WIN

Aggiunta in UpsideDownCakePrivacySandbox per 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 l'istogramma di un contatore annunci.

Valore costante: 0 (0x00000000)

Campi

Metodi pubblici

uguale a

public boolean equals (Object o)

Verifica se gli oggetti FrequencyCapFilters contengono le stesse informazioni.

Parametri
o Object: l'oggetto di riferimento con cui effettuare il confronto.
Ritorni
boolean true se questo oggetto è uguale all'argomento obj; in caso contrario false.

getKeyedFrequenzaCapsForClickEvents

public List<KeyedFrequencyCap> getKeyedFrequencyCapsForClickEvents ()

Restituisce l'elenco di KeyedFrequencyCap oggetti che verranno filtrati in base al tipo di evento AD_EVENT_TYPE_CLICK.

Queste quote limite vengono applicate agli eventi correlati a un clic interpretato da una tecnologia pubblicitaria. 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 ()

Restituisce l'elenco di KeyedFrequencyCap oggetti che verranno filtrati in base al tipo di evento AD_EVENT_TYPE_IMPRESSION.

Queste quote limite vengono applicate agli eventi correlati a un'impressione interpretata da una tecnologia pubblicitaria.

Tieni presente che gli eventi non vengono conteggiati automaticamente quando chiami AdSelectionManager.reportImpression(ReportImpressionRequest, Executor, OutcomeReceiver). Il tipo di evento AD_EVENT_TYPE_IMPRESSION deve invece essere aggiornato utilizzando l'API AdSelectionManager.updateAdCounterHistogram(UpdateAdCounterHistogramRequest, Executor, OutcomeReceiver).

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

getKeyedFrequenzaCapsForViewEvents

public List<KeyedFrequencyCap> getKeyedFrequencyCapsForViewEvents ()

Restituisce l'elenco di KeyedFrequencyCap oggetti che verranno filtrati in base al tipo di evento AD_EVENT_TYPE_VIEW.

Queste quote limite vengono applicate agli eventi correlati a una vista interpretata da una tecnologia pubblicitaria. 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.

getKeyedFrequenzaCapsForWinEvents

public List<KeyedFrequencyCap> getKeyedFrequencyCapsForWinEvents ()

Restituisce l'elenco di KeyedFrequencyCap oggetti che verranno filtrati in base al tipo di evento AD_EVENT_TYPE_WIN.

Queste quote limite vengono applicate agli eventi per gli annunci selezionati come vincitori nella selezione degli annunci. Gli annunci vincenti vengono utilizzati per incrementare automaticamente le chiavi del contatore associate nel tipo di evento vincitore.

Tieni presente che il tipo di evento AD_EVENT_TYPE_WIN non può essere aggiornato manualmente mediante l'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 che "rappresenta testualmente" l'oggetto. Il risultato dovrebbe essere una rappresentazione concisa, ma informativa, facile da leggere. È consigliabile che tutte le sottoclassi sostituiscano questo metodo.

Il metodo toString per la classe Object restituisce una stringa composta dal nome della classe di cui l'oggetto è un'istanza, dal carattere del simbolo @ "@" e dalla rappresentazione esadecimale senza segno del codice hash dell'oggetto. In altre parole, questo metodo restituisce una stringa uguale al valore di: 

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

Ritorni
String una rappresentazione stringa dell'oggetto.

writeToParcel

public void writeToParcel (Parcel dest, 
                int flags)

Appiattisci questo oggetto in un particolato.

Parametri
dest Parcel: questo valore non può essere null.
flags int: flag aggiuntivi su come scrivere 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