Эта страница переведена с помощью Cloud Translation API.

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