Пользовательская аудитория
public final class CustomAudience
extends Object
implements Parcelable
java.lang.Объект | |
↳ | android.adservices.customaudience.CustomAudience |
Представляет информацию, необходимую индивидуально настроенной аудитории для участия в выборе рекламы.
Пользовательская аудитория — это абстрактная группа пользователей со схожими интересами. Этот класс представляет собой набор некоторых данных, хранящихся на устройстве, которые необходимы для показа рекламы, ориентированной на одну пользовательскую аудиторию.
Краткое содержание
Вложенные классы | |
---|---|
class | CustomAudience.Builder Построитель объектов |
Унаследованные константы |
---|
Поля | |
---|---|
public static final Creator < CustomAudience > | CREATOR
|
Публичные методы | |
---|---|
boolean | equals ( Object o) Проверяет, содержат ли два объекта |
Instant | getActivationTime () При создании объекта |
List < AdData > | getAds () Этот список объектов |
Uri | getBiddingLogicUri () Возвращает целевой URI, используемый для получения логики назначения ставок, когда особая аудитория участвует в процессе выбора объявлений. |
AdTechIdentifier | getBuyer () Покупатель идентифицируется по домену вида «buyerexample.com». |
Uri | getDailyUpdateUri () Этот URI указывает на сервер, управляемый покупателем, на котором хранятся обновленные данные о ставках и метаданные рекламы, которые будут использоваться в процессе выбора рекламы на устройстве. |
Instant | getExpirationTime () По истечении срока действия пользовательская аудитория больше не имеет права на ежедневное обновление данных о рекламе/ставках или участие в процессе выбора рекламы. |
String | getName () Имя пользовательской аудитории — это произвольная строка, предоставленная владельцем и покупателем при создании объекта |
TrustedBiddingData | getTrustedBiddingData () Доверенные данные о ставках состоят из URI, указывающего на доверенный сервер для данных о ставках покупателей, и списка ключей для запроса на сервер. |
AdSelectionSignals | getUserBiddingSignals () Сигналы пользовательских ставок по желанию предоставляются покупателями для использования предоставленным покупателем кодом JavaScript во время выбора объявления в изолированной среде выполнения. |
int | hashCode () Возвращает хеш данных объекта |
void | writeToParcel ( Parcel dest, int flags) Сплющите этот объект в посылку. |
Унаследованные методы | |
---|---|
Поля
СОЗДАТЕЛЬ
public static final Creator<CustomAudience> CREATOR
Публичные методы
равно
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 . |
хэш-код
public int hashCode ()
Возвращает хеш данных объекта CustomAudience
.
Возврат | |
---|---|
int | значение хэш-кода для этого объекта. |
запись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. |
Контент и образцы кода на этой странице предоставлены по лицензиям. Java и OpenJDK – это зарегистрированные товарные знаки корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2024-08-22 UTC.