CustomAudienceManager

public class CustomAudienceManager
extends Object

java.lang.Object.
   ↳ android.adservices.customaudience.CustomAudienceManager


CustomAudienceManager proporciona APIs para SDK de anuncios y de apps a fin de unirse a públicos personalizados o abandonarlos.

Resumen

Métodos públicos

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

Agrega al usuario a la CustomAudience recuperada de un fetchUri.

static CustomAudienceManager get(Context context)

Método de fábrica para crear una instancia de CustomAudienceManager.

TestCustomAudienceManager getTestCustomAudienceManager()

Crea un servicio con APIs de habilitación de pruebas

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

Agrega el usuario a la CustomAudience determinada.

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

Intenta quitar un usuario de un público personalizado borrando los datos existentes de CustomAudience, identificados por ownerPackageName, buyer y name.

Métodos heredados

Métodos públicos

recuperar yUnirseCustomAudience

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

Agrega al usuario a la CustomAudience recuperada de un fetchUri.

Si se intenta registrar al usuario para un público personalizado con la misma combinación de ownerPackageName, buyer y name, se reemplazará la información del público personalizado existente, incluida la lista de datos de anuncios.

Ten en cuenta que la lista de anuncios se puede reemplazar por completo con el trabajo diario de recuperación en segundo plano.

La llamada falla con un SecurityException si

  1. ownerPackageName no llama al nombre del paquete de la app.
  2. el comprador no está autorizado a usar la API.

La llamada falla con un IllegalArgumentException si

  1. la aplicación que realiza la llamada superó el límite de almacenamiento; o
  2. los parámetros de URI en la CustomAudience especificada no se autentican con el comprador de CustomAudience.

Esta llamada falla con LimitExceededException si el paquete de llamada supera los límites de frecuencia permitidos y se limita.

Esta llamada falla con una IllegalStateException si se encuentra un error interno del servicio.
Requiere AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE

Parámetros
fetchAndJoinCustomAudienceRequest FetchAndJoinCustomAudienceRequest: Este valor no puede ser null.

executor Executor: Este valor no puede ser null. Los eventos de devolución de llamada y de objetos de escucha se envían a través de este Executor, lo que proporciona una manera fácil de controlar qué subproceso se usa. Para enviar eventos a través del subproceso principal de tu aplicación, puedes usar Context.getMainExecutor(). De lo contrario, proporciona un Executor que se envíe al subproceso correspondiente.

receiver OutcomeReceiver: Este valor no puede ser null.

get

public static CustomAudienceManager get (Context context)

Método de fábrica para crear una instancia de CustomAudienceManager.

Parámetros
context Context: El Context que se usará. Este valor no puede ser null.

Devuelve
CustomAudienceManager Una instancia de CustomAudienceManager. Este valor no puede ser null.

getTestCustomAudienceManager

public TestCustomAudienceManager getTestCustomAudienceManager ()

Crea un servicio con APIs de habilitación de pruebas

Devuelve
TestCustomAudienceManager Este valor no puede ser null.

JoinCustomAudience

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

Agrega el usuario a la CustomAudience determinada.

Si se intenta registrar al usuario para un público personalizado con la misma combinación de ownerPackageName, buyer y name, se reemplazará la información del público personalizado existente, incluida la lista de datos de anuncios.

Ten en cuenta que la lista de anuncios se puede reemplazar por completo con el trabajo diario de recuperación en segundo plano.

La llamada falla con un SecurityException si

  1. ownerPackageName no llama al nombre del paquete de la app.
  2. el comprador no está autorizado a usar la API.

La llamada falla con un IllegalArgumentException si

  1. la aplicación que realiza la llamada superó el límite de almacenamiento; o
  2. los parámetros de URI en la CustomAudience especificada no se autentican con el comprador de CustomAudience.

Esta llamada falla con LimitExceededException si el paquete de llamada supera los límites de frecuencia permitidos y se limita.

Esta llamada falla con una IllegalStateException si se encuentra un error interno del servicio.
Requiere AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE

Parámetros
joinCustomAudienceRequest JoinCustomAudienceRequest: Este valor no puede ser null.

executor Executor: Este valor no puede ser null. Los eventos de devolución de llamada y de objetos de escucha se envían a través de este Executor, lo que proporciona una manera fácil de controlar qué subproceso se usa. Para enviar eventos a través del subproceso principal de tu aplicación, puedes usar Context.getMainExecutor(). De lo contrario, proporciona un Executor que se envíe al subproceso correspondiente.

receiver OutcomeReceiver: Este valor no puede ser null.

abandonarPúblicoPersonalizado

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

Intenta quitar un usuario de un público personalizado borrando los datos existentes de CustomAudience, identificados por ownerPackageName, buyer y name.

La llamada falla con un SecurityException si

  1. ownerPackageName no llama al nombre del paquete de la app.
  2. el comprador no está autorizado a usar la API.

Esta llamada falla con LimitExceededException si el paquete de llamada supera los límites de frecuencia permitidos y se limita.

Esta llamada no informa al emisor si el público personalizado especificado existía en el almacenamiento del dispositivo. En otras palabras, fallará silenciosamente cuando un comprador intente abandonar un público personalizado al que no se unió.
Requiere AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE

Parámetros
leaveCustomAudienceRequest LeaveCustomAudienceRequest: Este valor no puede ser null.

executor Executor: Este valor no puede ser null. Los eventos de devolución de llamada y de objetos de escucha se envían a través de este Executor, lo que proporciona una manera fácil de controlar qué subproceso se usa. Para enviar eventos a través del subproceso principal de tu aplicación, puedes usar Context.getMainExecutor(). De lo contrario, proporciona un Executor que se envíe al subproceso correspondiente.

receiver OutcomeReceiver: Este valor no puede ser null.