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 |
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 |
List<KeyedFrequencyCap>
|
getKeyedFrequencyCapsForClickEvents()
Restituisce l'elenco di |
List<KeyedFrequencyCap>
|
getKeyedFrequencyCapsForImpressionEvents()
Restituisce l'elenco di |
List<KeyedFrequencyCap>
|
getKeyedFrequencyCapsForViewEvents()
Restituisce l'elenco di |
List<KeyedFrequencyCap>
|
getKeyedFrequencyCapsForWinEvents()
Restituisce l'elenco di |
int
|
hashCode()
Restituisce l'hash dei dati dell'oggetto |
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
public static final int AD_EVENT_TYPE_CLICK
Valore costante: 3 (0x00000003)
AD_EVENT_TYPE_IMPRESSION
public static final int AD_EVENT_TYPE_IMPRESSION
Valore costante: 1 (0x00000001)
AD_EVENT_TYPE_VIEW
public static final int AD_EVENT_TYPE_VIEW
Valore costante: 2 (0x00000002)
AD_EVENT_TYPE_WIN
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
CREATOR
public static final Creator<FrequencyCapFilters> CREATOR
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 |