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 .

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

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

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 .