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

public final class CustomAudience
extends Object implements Parcelable

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


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

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

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

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

class CustomAudience.Builder

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

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

Поля

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)

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

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

Поля

СОЗДАТЕЛЬ

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.