Добавлено на уровне API 34.
Также в расширениях рекламных служб 4.

Резюме: Вложенные классы | Унаследованные константы | Поля | Методы | Унаследованные методы

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

public final class CustomAudience
extends Object implements Parcelable

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

---

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

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

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

Вложенные классы
class	CustomAudience.Builder Построитель объектов CustomAudience .

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

Из интерфейса android.os.Parcelable 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) Сплющите этот объект в посылку.

Унаследованные методы
Из класса java.lang.Object 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 () Заставляет текущий поток ждать, пока он не будет пробужден, обычно путем получения уведомления или прерывания .
Из интерфейса android.os.Parcelable abstract int describeContents () Опишите типы специальных объектов, содержащихся в маршалированном представлении этого экземпляра Parcelable. abstract void writeToParcel ( Parcel dest, int flags) Сплющите этот объект в посылку.

Поля

СОЗДАТЕЛЬ

Добавлено на уровне API 34.
Также в расширениях рекламных служб 4.

public static final Creator<CustomAudience> CREATOR

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

равно

Добавлено на уровне API 34.

public boolean equals (Object o)

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

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

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

getActivationTime

Добавлено на уровне API 34.
Также в расширениях рекламных служб 4.

public Instant getActivationTime ()

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

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

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

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

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

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

Добавлено на уровне API 34.
Также в расширениях рекламных служб 4.

public List<AdData> getAds ()

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

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

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

getBiddingLogicUri

Добавлено на уровне API 34.
Также в расширениях рекламных служб 4.

public Uri getBiddingLogicUri ()

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

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

getBuyer

Добавлено на уровне API 34.
Также в расширениях рекламных служб 4.

public AdTechIdentifier getBuyer ()

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

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

getDailyUpdateUri

Добавлено на уровне API 34.
Также в расширениях рекламных служб 4.

public Uri getDailyUpdateUri ()

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

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

getExpirationTime

Добавлено на уровне API 34.
Также в расширениях рекламных служб 4.

public Instant getExpirationTime ()

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

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

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

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

getName

Добавлено на уровне API 34.
Также в расширениях рекламных служб 4.

public String getName ()

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

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

getTrustedBiddingData

Добавлено на уровне API 34.
Также в расширениях рекламных служб 4.

public TrustedBiddingData getTrustedBiddingData ()

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

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

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

getUserBiddingSignals

Добавлено на уровне API 34.
Также в расширениях рекламных служб 4.

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.