Пользовательская аудитория

public final class CustomAudience
extends Object implements Parcelable

java.lang.Объект
android.adservices.customaudience.CustomAudience


Представляет информацию, необходимую индивидуально настроенной аудитории для участия в выборе рекламы.

Пользовательская аудитория — это абстрактная группа пользователей со схожими интересами. Этот класс представляет собой набор некоторых данных, хранящихся на устройстве, которые необходимы для показа рекламы, ориентированной на одну пользовательскую аудиторию.

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

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

class CustomAudience.Builder

Построитель объектов CustomAudience .

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

int CONTENTS_FILE_DESCRIPTOR

Бит дескриптора, используемый с describeContents() : указывает, что плоское представление объекта Parcelable включает дескриптор файла.

int PARCELABLE_WRITE_RETURN_VALUE

Флаг для использования с writeToParcel(Parcel, int) : записываемый объект является возвращаемым значением, то есть результатом такой функции, как " Parcelable someFunction() ", " void someFunction(out Parcelable) " или " void someFunction(inout Parcelable) ".

Поля

public static final Creator < CustomAudience > CREATOR

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

boolean equals ( Object o)

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

Instant getActivationTime ()

При создании объекта CustomAudience в будущем можно установить дополнительное время активации, чтобы обеспечить отложенную активацию.

List < AdData > getAds ()

Этот список объектов AdData представляет собой полный список объявлений, которые будут обслуживаться этой CustomAudience во время процесса выбора рекламы.

Uri getBiddingLogicUri ()

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

AdTechIdentifier getBuyer ()

Покупатель идентифицируется по домену вида «buyerexample.com».

Uri getDailyUpdateUri ()

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

Instant getExpirationTime ()

По истечении срока действия пользовательская аудитория больше не имеет права на ежедневное обновление данных о рекламе/ставках или участие в процессе выбора рекламы.

String getName ()

Имя пользовательской аудитории — это произвольная строка, предоставленная владельцем и покупателем при создании объекта CustomAudience .

TrustedBiddingData getTrustedBiddingData ()

Доверенные данные о ставках состоят из URI, указывающего на доверенный сервер для данных о ставках покупателей, и списка ключей для запроса на сервер.

AdSelectionSignals getUserBiddingSignals ()

Сигналы пользовательских ставок по желанию предоставляются покупателями для использования предоставленным покупателем кодом JavaScript во время выбора объявления в изолированной среде выполнения.

int hashCode ()

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

void writeToParcel ( Parcel dest, int flags)

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

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

Object clone ()

Создает и возвращает копию этого объекта.

boolean equals ( Object obj)

Указывает, «равен» ли какой-либо другой объект этому объекту.

void finalize ()

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

final Class <?> getClass ()

Возвращает класс времени выполнения этого Object .

int hashCode ()

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

final void notify ()

Пробуждает одиночный поток, ожидающий монитора этого объекта.

final void notifyAll ()

Пробуждает все потоки, ожидающие на мониторе этого объекта.

String toString ()

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

final void wait (long timeoutMillis, int nanos)

Заставляет текущий поток ждать, пока он не будет пробужден, обычно путем получения уведомления или прерывания , или до тех пор, пока не истечет определенное количество реального времени.

final void wait (long timeoutMillis)

Заставляет текущий поток ждать, пока он не будет пробужден, обычно путем получения уведомления или прерывания , или до тех пор, пока не истечет определенное количество реального времени.

final void wait ()

Заставляет текущий поток ждать, пока он не будет пробужден, обычно путем получения уведомления или прерывания .

abstract int describeContents ()

Опишите типы специальных объектов, содержащихся в маршалированном представлении этого экземпляра Parcelable.

abstract void writeToParcel ( Parcel dest, int flags)

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

Поля

СОЗДАТЕЛЬ

public static final Creator<CustomAudience> CREATOR

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

равно

Добавлено на уровне API 34.
public boolean equals (Object o)

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

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

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

getActivationTime

public Instant getActivationTime ()

При создании объекта CustomAudience в будущем можно установить дополнительное время активации, чтобы обеспечить отложенную активацию. Если поле не задано, CustomAudience будет активирован во время присоединения.

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

Максимальная задержка активации составляет 60 дней с момента первоначального создания.

Если указано, время активации должно быть более ранним, чем время истечения срока действия.

Возврат
Instant временная метка Instant , усекаемая до миллисекунд, после которой пользовательская аудитория становится активной. Это значение может быть null .

получить рекламу

public List<AdData> getAds ()

Этот список объектов AdData представляет собой полный список объявлений, которые будут обслуживаться этой CustomAudience во время процесса выбора рекламы.

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

Возврат
List < AdData > List объектов AdData , представляющих рекламу, которая в настоящее время обслуживается пользовательской аудиторией. Это значение не может быть null .

getBiddingLogicUri

public Uri getBiddingLogicUri ()

Возвращает целевой URI, используемый для получения логики назначения ставок, когда особая аудитория участвует в процессе выбора объявления. URI должен использовать HTTPS.

Возврат
Uri URI для получения логики назначения ставок покупателя. Это значение не может быть null .

getBuyer

public AdTechIdentifier getBuyer ()

Покупатель идентифицируется по домену вида «buyerexample.com».

Возврат
AdTechIdentifier AdTechIdentifier содержащий домен покупателя индивидуальной аудитории. Это значение не может быть null .

getDailyUpdateUri

public Uri getDailyUpdateUri ()

Этот URI указывает на сервер, управляемый покупателем, на котором хранятся обновленные данные о ставках и метаданные рекламы, которые будут использоваться в процессе выбора рекламы на устройстве. URI должен использовать HTTPS.

Возврат
Uri URI ежедневного обновления пользовательской аудитории. Это значение не может быть null .

getExpirationTime

public Instant getExpirationTime ()

По истечении срока действия пользовательская аудитория больше не имеет права на ежедневное обновление данных о рекламе/ставках или участие в процессе выбора рекламы. Пользовательская аудитория будет удалена из памяти при следующем ежедневном обновлении.

Если при создании CustomAudience не указан срок действия, по умолчанию срок действия составит 60 дней с момента активации.

Максимальный срок действия составляет 60 дней с момента первоначальной активации.

Возврат
Instant временная метка Instant , усекаемая до миллисекунд, после чего пользовательская аудитория должна быть удалена. Это значение может быть null .

getName

public String getName ()

Имя пользовательской аудитории — это произвольная строка, предоставленная владельцем и покупателем при создании объекта CustomAudience .

Возврат
String Строковое имя пользовательской аудитории. Это значение не может быть null .

getTrustedBiddingData

public TrustedBiddingData getTrustedBiddingData ()

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

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

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

getUserBiddingSignals

public AdSelectionSignals getUserBiddingSignals ()

Сигналы пользовательских ставок по желанию предоставляются покупателями для использования предоставленным покупателем кодом JavaScript во время выбора объявления в изолированной среде выполнения.

Если сигналы назначения ставок пользователем не являются допустимым объектом JSON, который может быть использован JS покупателя, особая аудитория не сможет выбираться для рекламы.

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

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

хэш-код

Добавлено на уровне API 34.
public int hashCode ()

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

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

записьToParcel

Добавлено на уровне API 34.
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.