ЧастотаCapФильтры

public final class FrequencyCapFilters
extends Object implements Parcelable

java.lang.Объект
↳ android.adservices.common.FrequencyCapFilters

Контейнер для рекламных фильтров, основанных на ограничении частоты показов.

С одним объявлением можно связать не более 20 фильтров ограничения частоты показов.

Фильтры ограничения частоты объединяют тип события со списком объектов KeyedFrequencyCap для определения коллекции рекламных фильтров. Если какое-либо из этих ограничений частоты показов для данного объявления будет превышено, оно будет удалено из группы объявлений, переданных в функцию назначения ставок рекламной компании покупателя.

Краткое содержание

Вложенные классы

class FrequencyCapFilters.Builder

Построитель для создания объектов FrequencyCapFilters .

Константы

int AD_EVENT_TYPE_CLICK

int AD_EVENT_TYPE_IMPRESSION

int AD_EVENT_TYPE_VIEW

int AD_EVENT_TYPE_WIN

Тип события объявления WIN автоматически заполняется в службе Защищенной аудитории для любого объявления-победителя, возвращаемого из списка объявлений Защищенной аудитории.

Унаследованные константы

Поля

public static final Creator < FrequencyCapFilters > CREATOR

Публичные методы

boolean equals ( Object o)

Проверяет, содержат ли объекты FrequencyCapFilters ту же информацию.

List < KeyedFrequencyCap > getKeyedFrequencyCapsForClickEvents ()

Получает список объектов KeyedFrequencyCap , которые будут фильтроваться по типу событий AD_EVENT_TYPE_CLICK .

List < KeyedFrequencyCap > getKeyedFrequencyCapsForImpressionEvents ()

Получает список объектов KeyedFrequencyCap , которые будут фильтроваться по типу событий AD_EVENT_TYPE_IMPRESSION .

List < KeyedFrequencyCap > getKeyedFrequencyCapsForViewEvents ()

Получает список объектов KeyedFrequencyCap , которые будут фильтроваться по типу событий AD_EVENT_TYPE_VIEW .

List < KeyedFrequencyCap > getKeyedFrequencyCapsForWinEvents ()

Получает список объектов KeyedFrequencyCap , которые будут фильтроваться по типу событий AD_EVENT_TYPE_WIN .

int hashCode ()

Возвращает хеш данных объекта FrequencyCapFilters .

String toString ()

Возвращает строковое представление объекта.

void writeToParcel ( Parcel dest, int flags)

Сплющите этот объект в посылку.

Унаследованные методы

Константы

AD_EVENT_TYPE_CLICK

Добавлено в Android UpsideDownCakePrivacySandbox.
public static final int AD_EVENT_TYPE_CLICK

Постоянное значение: 3 (0x00000003)

AD_EVENT_TYPE_IMPRESSION

Добавлено в Android UpsideDownCakePrivacySandbox.
public static final int AD_EVENT_TYPE_IMPRESSION

Постоянное значение: 1 (0x00000001)

AD_EVENT_TYPE_VIEW

Добавлено в Android UpsideDownCakePrivacySandbox.
public static final int AD_EVENT_TYPE_VIEW

Постоянное значение: 2 (0x00000002)

AD_EVENT_TYPE_WIN

Добавлено в Android UpsideDownCakePrivacySandbox.
public static final int AD_EVENT_TYPE_WIN

Тип события объявления WIN автоматически заполняется в службе Защищенной аудитории для любого объявления-победителя, возвращаемого из списка объявлений Защищенной аудитории.

Его не следует использовать для ручного обновления гистограммы счетчика рекламы.

Постоянное значение: 0 (0x00000000)

Поля

Публичные методы

равно

public boolean equals (Object o)

Проверяет, содержат ли объекты FrequencyCapFilters ту же информацию.

Параметры
o Object : эталонный объект для сравнения.

Возврат
boolean true , если этот объект совпадает с аргументом obj; false в противном случае.

getKeyedFrequencyCapsForClickEvents

public List<KeyedFrequencyCap> getKeyedFrequencyCapsForClickEvents ()

Получает список объектов KeyedFrequencyCap , которые будут фильтроваться по типу событий AD_EVENT_TYPE_CLICK .

Эти ограничения частоты применяются к событиям, которые связаны с кликом, как его интерпретирует рекламная технология. События кликов подсчитываются при вызове API AdSelectionManager.updateAdCounterHistogram(UpdateAdCounterHistogramRequest, Executor, OutcomeReceiver) с типом события AD_EVENT_TYPE_CLICK .

Возврат
List < KeyedFrequencyCap > Это значение не может быть null .

getKeyedFrequencyCapsForImpressionEvents

public List<KeyedFrequencyCap> getKeyedFrequencyCapsForImpressionEvents ()

Получает список объектов KeyedFrequencyCap , которые будут фильтроваться по типу событий AD_EVENT_TYPE_IMPRESSION .

Эти ограничения частоты применяются к событиям, которые коррелируют с показом в интерпретации рекламных технологий.

Обратите внимание, что события не учитываются автоматически при вызове AdSelectionManager.reportImpression(ReportImpressionRequest, Executor, OutcomeReceiver) . Вместо этого тип события AD_EVENT_TYPE_IMPRESSION необходимо обновить с помощью API AdSelectionManager.updateAdCounterHistogram(UpdateAdCounterHistogramRequest, Executor, OutcomeReceiver) .

Возврат
List < KeyedFrequencyCap > Это значение не может быть null .

getKeyedFrequencyCapsForViewEvents

public List<KeyedFrequencyCap> getKeyedFrequencyCapsForViewEvents ()

Получает список объектов KeyedFrequencyCap , которые будут фильтроваться по типу событий AD_EVENT_TYPE_VIEW .

Эти ограничения частоты применяются к событиям, которые соответствуют представлению, интерпретируемому рекламной технологией. События просмотра учитываются при вызове API AdSelectionManager.updateAdCounterHistogram(UpdateAdCounterHistogramRequest, Executor, OutcomeReceiver) с типом события AD_EVENT_TYPE_VIEW .

Возврат
List < KeyedFrequencyCap > Это значение не может быть null .

getKeyedFrequencyCapsForWinEvents

public List<KeyedFrequencyCap> getKeyedFrequencyCapsForWinEvents ()

Получает список объектов KeyedFrequencyCap , которые будут фильтроваться по типу событий AD_EVENT_TYPE_WIN .

Эти ограничения частоты применяются к событиям для объявлений, которые были выбраны победителями при выборе объявлений. Выигрышные объявления используются для автоматического увеличения соответствующих ключей счетчиков для типа выигрышного события.

Обратите внимание, что тип события AD_EVENT_TYPE_WIN нельзя обновить вручную с помощью API AdSelectionManager.updateAdCounterHistogram(UpdateAdCounterHistogramRequest, Executor, OutcomeReceiver) .

Возврат
List < KeyedFrequencyCap > Это значение не может быть null .

хэш-код

public int hashCode ()

Возвращает хеш данных объекта FrequencyCapFilters .

Возврат
int значение хэш-кода для этого объекта.

нанизывать

public String toString ()

Возвращает строковое представление объекта. Обычно метод toString возвращает строку, которая «текстово представляет» этот объект. В результате должно получиться краткое, но информативное представление, которое будет легко прочитать человеку. Рекомендуется, чтобы все подклассы переопределяли этот метод.

Метод toString для класса Object возвращает строку, состоящую из имени класса, экземпляром которого является объект, символа @ и беззнакового шестнадцатеричного представления хеш-кода объекта. Другими словами, этот метод возвращает строку, равную значению:

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

Возврат
String строковое представление объекта.

записьToParcel

public void writeToParcel (Parcel dest, 
                int flags)

Сплющите этот объект в посылку.

Параметры
dest Parcel : это значение не может быть null .

flags int : Дополнительные флаги о том, как должен быть написан объект. Может быть 0 или Parcelable.PARCELABLE_WRITE_RETURN_VALUE . Значение – 0 или комбинация Parcelable.PARCELABLE_WRITE_RETURN_VALUE и android.os.Parcelable.PARCELABLE_ELIDE_DUPLICATES.