CustomAudienceManager

public class CustomAudienceManager
extends Object

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

CustomAudienceManager предоставляет API-интерфейсы для приложений и рекламных SDK, позволяющие присоединяться к пользовательским аудиториям и покидать их.

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

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

void fetchAndJoinCustomAudience ( FetchAndJoinCustomAudienceRequest fetchAndJoinCustomAudienceRequest, Executor executor, OutcomeReceiver < Object , Exception > receiver)

Добавляет пользователя в CustomAudience , полученный из fetchUri .

static CustomAudienceManager get ( Context context)

Фабричный метод для создания экземпляра CustomAudienceManager.

TestCustomAudienceManager getTestCustomAudienceManager ()

Создайте сервис с API-интерфейсами, поддерживающими тестирование.

void joinCustomAudience ( JoinCustomAudienceRequest joinCustomAudienceRequest, Executor executor, OutcomeReceiver < Object , Exception > receiver)

Добавляет пользователя в заданный CustomAudience .

void leaveCustomAudience ( LeaveCustomAudienceRequest leaveCustomAudienceRequest, Executor executor, OutcomeReceiver < Object , Exception > receiver)

Пытается удалить пользователя из пользовательской аудитории, удалив все существующие данные CustomAudience , идентифицированные по значениям ownerPackageName , buyer и name .

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

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 ()

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

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

fetchAndJoinCustomAudience

public void fetchAndJoinCustomAudience (FetchAndJoinCustomAudienceRequest fetchAndJoinCustomAudienceRequest, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> receiver)

Добавляет пользователя в CustomAudience , полученный из fetchUri .

Попытка зарегистрировать пользователя для пользовательской аудитории с той же комбинацией ownerPackageName , buyer и name приведет к перезаписи существующей информации о пользовательской аудитории, включая список данных рекламы.

Обратите внимание, что список объявлений может быть полностью перезаписан при ежедневной фоновой выборке.

Этот вызов завершается с ошибкой SecurityException , если

  1. ownerPackageName не вызывает имя пакета приложения и/или
  2. покупатель не имеет права использовать API.

Этот вызов завершается с ошибкой IllegalArgumentException , если

  1. лимит хранилища превышен вызывающим приложением и/или
  2. любые параметры URI в указанном CustomAudience не аутентифицируются покупателем CustomAudience .

Этот вызов завершается с ошибкой LimitExceededException если вызывающий пакет превышает допустимые пределы скорости и регулируется.

Этот вызов завершается с ошибкой IllegalStateException , если возникает внутренняя ошибка службы.
Требуется AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE .

Параметры
fetchAndJoinCustomAudienceRequest FetchAndJoinCustomAudienceRequest : это значение не может быть null .

executor Executor : Это значение не может быть null . События обратного вызова и прослушивателя отправляются через этот Executor , предоставляя простой способ контролировать, какой поток используется. Чтобы отправлять события через основной поток вашего приложения, вы можете использовать Context.getMainExecutor() . В противном случае предоставьте Executor , который отправляет данные в соответствующий поток.

receiver OutcomeReceiver : это значение не может быть null .

получать

public static CustomAudienceManager get (Context context)

Фабричный метод для создания экземпляра CustomAudienceManager.

Параметры
context Context : используемый Context . Это значение не может быть null .

Возврат
CustomAudienceManager Экземпляр CustomAudienceManager . Это значение не может быть null .

getTestCustomAudienceManager

public TestCustomAudienceManager getTestCustomAudienceManager ()

Создайте сервис с API-интерфейсами, поддерживающими тестирование.

Возврат
TestCustomAudienceManager Это значение не может быть null .

присоединиться к пользовательской аудитории

public void joinCustomAudience (JoinCustomAudienceRequest joinCustomAudienceRequest, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> receiver)

Добавляет пользователя в заданный CustomAudience .

Попытка зарегистрировать пользователя для пользовательской аудитории с той же комбинацией ownerPackageName , buyer и name приведет к перезаписи существующей информации о пользовательской аудитории, включая список данных рекламы.

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

Этот вызов завершается с ошибкой SecurityException , если

  1. ownerPackageName не вызывает имя пакета приложения и/или
  2. покупатель не имеет права использовать API.

Этот вызов завершается с ошибкой IllegalArgumentException , если

  1. лимит хранилища превышен вызывающим приложением и/или
  2. любые параметры URI в указанном CustomAudience не аутентифицируются покупателем CustomAudience .

Этот вызов завершается с ошибкой LimitExceededException если вызывающий пакет превышает допустимые пределы скорости и регулируется.

Этот вызов завершается с ошибкой IllegalStateException , если возникает внутренняя ошибка службы.
Требуется AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE .

Параметры
joinCustomAudienceRequest JoinCustomAudienceRequest : это значение не может быть null .

executor Executor : Это значение не может быть null . События обратного вызова и прослушивателя отправляются через этот Executor , предоставляя простой способ контролировать, какой поток используется. Чтобы отправлять события через основной поток вашего приложения, вы можете использовать Context.getMainExecutor() . В противном случае предоставьте Executor , который отправляет данные в соответствующий поток.

receiver OutcomeReceiver : это значение не может быть null .

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

public void leaveCustomAudience (LeaveCustomAudienceRequest leaveCustomAudienceRequest, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> receiver)

Пытается удалить пользователя из пользовательской аудитории, удалив все существующие данные CustomAudience , идентифицированные по значениям ownerPackageName , buyer и name .

Этот вызов завершается с ошибкой SecurityException , если

  1. ownerPackageName не вызывает имя пакета приложения; и/или
  2. покупатель не имеет права использовать API.

Этот вызов завершается с ошибкой LimitExceededException если вызывающий пакет превышает допустимые пределы скорости и регулируется.

Этот вызов не сообщает вызывающему абоненту, существует ли указанная специально настроенная аудитория в хранилище на устройстве. Другими словами, он автоматически потерпит неудачу, когда покупатель попытается покинуть пользовательскую аудиторию, к которой он еще не присоединился.
Требуется AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE .

Параметры
leaveCustomAudienceRequest LeaveCustomAudienceRequest : это значение не может быть null .

executor Executor : Это значение не может быть null . События обратного вызова и прослушивателя отправляются через этот Executor , предоставляя простой способ контролировать, какой поток используется. Чтобы отправлять события через основной поток вашего приложения, вы можете использовать Context.getMainExecutor() . В противном случае предоставьте Executor , который отправляет данные в соответствующий поток.

receiver OutcomeReceiver : это значение не может быть null .