Filtry limitu wyświetleń na użytkownika

public final class FrequencyCapFilters
extends Object implements Parcelable

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

Kontener na filtry reklam oparte na limitach wyświetleń na użytkownika.

Z jedną reklamą można powiązać maksymalnie 20 filtrów limitu wyświetleń na użytkownika.

Filtry ograniczenia liczby wyświetleń łączą typ zdarzenia z listą KeyedFrequencyCap obiektów aby zdefiniować zbiór filtrów reklam. Jeśli któryś z tych limitów wyświetleń na użytkownika zostanie przekroczony w przypadku danej reklamy, reklama zostanie usunięta z grupy reklam przesłanych do funkcji ustalania stawek kupującego.

Podsumowanie

Zagnieżdżone klasy

class FrequencyCapFilters.Builder

Kreator do tworzenia obiektów FrequencyCapFilters. 

Stałe

int AD_EVENT_TYPE_CLICK

int AD_EVENT_TYPE_IMPRESSION

int AD_EVENT_TYPE_VIEW

int AD_EVENT_TYPE_WIN

Typ zdarzenia reklamowego WIN jest automatycznie wypełniany w usłudze Protected Audience API w przypadku: zwycięską reklamę w wynikach wyboru reklamy z Protected Audience API.

Stałe odziedziczone

Fieldsem

public static final Creator<FrequencyCapFilters> CREATOR

Metody publiczne

boolean equals(Object o)

Sprawdza, czy obiekty FrequencyCapFilters zawierają te same informacje.

List<KeyedFrequencyCap> getKeyedFrequencyCapsForClickEvents()

Pobiera listę obiektów KeyedFrequencyCap, które będą filtrowane według typu zdarzenia AD_EVENT_TYPE_CLICK.

List<KeyedFrequencyCap> getKeyedFrequencyCapsForImpressionEvents()

Pobiera listę obiektów KeyedFrequencyCap, które będą filtrowane według typu zdarzenia AD_EVENT_TYPE_IMPRESSION.

List<KeyedFrequencyCap> getKeyedFrequencyCapsForViewEvents()

Pobiera listę obiektów KeyedFrequencyCap, które będą filtrowane według typu zdarzenia AD_EVENT_TYPE_VIEW.

List<KeyedFrequencyCap> getKeyedFrequencyCapsForWinEvents()

Pobiera listę obiektów KeyedFrequencyCap, które będą filtrowane według typu zdarzenia AD_EVENT_TYPE_WIN.

int hashCode()

Zwraca hasz danych obiektu FrequencyCapFilters.

String toString()

Zwraca obiekt w postaci ciągu znaków.

void writeToParcel(Parcel dest, int flags)

Spłaszcz ten obiekt na działkę.

Metody dziedziczone

Stałe

AD_EVENT_TYPE_KLIKNIĘCIE

Dodano w przypadku Androida UpsideDownCakePrivacySandbox 
public static final int AD_EVENT_TYPE_CLICK

Wartość stała: 3 (0x00000003)

AD_EVENT_TYPE_IMPRESSION (WYŚWIETLANIE_ZDARZENIA)

Dodano w przypadku Androida UpsideDownCakePrivacySandbox 
public static final int AD_EVENT_TYPE_IMPRESSION

Wartość stała: 1 (0x00000001)

AD_EVENT_TYPE_VIEW

Dodano w przypadku Androida UpsideDownCakePrivacySandbox 
public static final int AD_EVENT_TYPE_VIEW

Wartość stała: 2. (0x00000002)

AD_EVENT_TYPE_WIN

Dodano w przypadku Androida UpsideDownCakePrivacySandbox 
public static final int AD_EVENT_TYPE_WIN

Typ zdarzenia reklamowego WIN jest automatycznie wypełniany w usłudze Protected Audience API w przypadku: zwycięską reklamę w wynikach wyboru reklamy z Protected Audience API.

Nie należy go używać do ręcznego aktualizowania histogramu licznika reklam.

Wartość stała: 0 (0x00000000)

Fieldsem

Metody publiczne

równa się

public boolean equals (Object o)

Sprawdza, czy obiekty FrequencyCapFilters zawierają te same informacje.

Parametry
o Object: obiekt referencyjny, z którym ma nastąpić porównanie.
Zwroty
boolean true, jeśli ten obiekt jest taki sam jak obiekt argument; W przeciwnym razie: false.

getKeyedfrequencyCapsForClickEvents

public List<KeyedFrequencyCap> getKeyedFrequencyCapsForClickEvents ()

Pobiera listę obiektów KeyedFrequencyCap, które będą filtrowane według typu zdarzenia AD_EVENT_TYPE_CLICK.

Te limity wyświetleń mają zastosowanie do zdarzeń, które są powiązane z kliknięciem interpretowanym przez technologii reklamowych. Zdarzenia kliknięcia są liczone po wywołaniu interfejsu API AdSelectionManager.updateAdCounterHistogram(UpdateAdCounterHistogramRequest, Executor, OutcomeReceiver) za pomocą zdarzenia AD_EVENT_TYPE_CLICK.

Zwroty
List<KeyedFrequencyCap> Ta wartość nie może być typu null.

getKeyedfrequencyCapsForWyświetleniaZdarzenia

public List<KeyedFrequencyCap> getKeyedFrequencyCapsForImpressionEvents ()

Pobiera listę obiektów KeyedFrequencyCap, które będą filtrowane według typu zdarzenia AD_EVENT_TYPE_IMPRESSION.

Te limity wyświetleń mają zastosowanie do zdarzeń, które są powiązane z wyświetleniem zinterpretowanym przez technologii reklamowych.

Pamiętaj, że zdarzenia nie są automatycznie liczone podczas wywoływania funkcji AdSelectionManager.reportImpression(ReportImpressionRequest, Executor, OutcomeReceiver). Zamiast tego typ zdarzenia AD_EVENT_TYPE_IMPRESSION musi: być aktualizowane za pomocą interfejsu API AdSelectionManager.updateAdCounterHistogram(UpdateAdCounterHistogramRequest, Executor, OutcomeReceiver).

Zwroty
List<KeyedFrequencyCap> Ta wartość nie może być typu null.

getKeyedCzęstotliwośćCapsForViewEvents

public List<KeyedFrequencyCap> getKeyedFrequencyCapsForViewEvents ()

Pobiera listę obiektów KeyedFrequencyCap, które będą filtrowane według typu zdarzenia AD_EVENT_TYPE_VIEW.

Te limity wyświetleń mają zastosowanie do zdarzeń skorelowanych z obejrzeniem, które są interpretowane przez technologii reklamowych. Zdarzenia związane z wyświetleniami są zliczane po wywołaniu interfejsu API AdSelectionManager.updateAdCounterHistogram(UpdateAdCounterHistogramRequest, Executor, OutcomeReceiver) za pomocą typu zdarzenia AD_EVENT_TYPE_VIEW.

Zwroty
List<KeyedFrequencyCap> Ta wartość nie może być typu null.

getKeyedfrequencyCapsForWinEvents

public List<KeyedFrequencyCap> getKeyedFrequencyCapsForWinEvents ()

Pobiera listę obiektów KeyedFrequencyCap, które będą filtrowane według typu zdarzenia AD_EVENT_TYPE_WIN.

Te limity wyświetleń na użytkownika dotyczą zdarzeń związanych z reklamami, które zostały wybrane jako zwycięskie wyboru. Zwycięskie reklamy są używane do automatycznego zwiększania liczby powiązanych kluczy licznika w typu „wygrana”.

Pamiętaj, że typu zdarzenia AD_EVENT_TYPE_WIN nie można zaktualizować ręcznie za pomocą Interfejs API AdSelectionManager.updateAdCounterHistogram(UpdateAdCounterHistogramRequest, Executor, OutcomeReceiver).

Zwroty
List<KeyedFrequencyCap> Ta wartość nie może być typu null.

kod skrótu

public int hashCode ()

Zwraca hasz danych obiektu FrequencyCapFilters.

Zwroty
int wartość kodu skrótu dla tego obiektu.

Ciąg

public String toString ()

Zwraca obiekt w postaci ciągu znaków. Ogólnie rzecz biorąc, Metoda toString zwraca ciąg znaków, który „reprezentuje tekstowo” ten obiekt. Wynik powinien to zwięzła, ale treściwa prezentacja, która będzie łatwa do przeczytania. Zaleca się, aby wszystkie podklasy zastępowały tę metodę.

Metoda toString klasy Object zwraca ciąg znaków składający się z nazwy klasy, której obiekt jest instancją, znak małpy „@” oraz nieoznaczona szesnastkowa reprezentacja kodu skrótu obiektu. Innymi słowy, ta metoda zwraca ciąg znaków równy wartości: 

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

Zwroty
String reprezentująca obiekt w postaci ciągu znaków.

zapisToParcel

public void writeToParcel (Parcel dest, 
                int flags)

Spłaszcz ten obiekt na działkę.

Parametry
dest Parcel: ta wartość nie może być typu null.
flags int: dodatkowe flagi informujące o sposobie zapisywania obiektu. Może wynosić 0 lub Parcelable.PARCELABLE_WRITE_RETURN_VALUE. Wartość to 0 lub kombinacja Parcelable.PARCELABLE_WRITE_RETURN_VALUE i android.os.Parcelable.PARCELABLE_ELIDE_DUPLICATES