Se agregó en el nivel de API 34.
También se agregó en Extensiones de servicios de anuncios 4.

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 al CustomAudience recuperado 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 que habiliten pruebas

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

Agrega el usuario a la CustomAudience especificada.

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

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

Métodos heredados

Métodos públicos

recuperarAndJoinCustomAudience

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

Agrega al usuario al CustomAudience recuperado de un fetchUri.

Un intento de registrar al usuario en un público personalizado con la misma combinación de ownerPackageName, buyer y name provocará la carga del información que se reemplazará, incluida la lista de datos de anuncios.

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

Esta 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 un IllegalArgumentException si

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

Esta llamada falla con LimitExceededException si el paquete que realiza la llamada excede el y los límites de frecuencia permitidos.

Esta llamada falla con IllegalStateException si se produce un error interno del servicio. que encuentran.
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 objeto de escucha se envían a través de esta Executor, lo que brinda una manera fácil de controlar qué subproceso se que se usan. 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 a un subproceso adecuado.

receiver OutcomeReceiver: Este valor no puede ser null.

get

Se agregó en el nivel de API 34.
También se agregó en Extensiones de servicios de anuncios 6.
public static CustomAudienceManager get (Context context)

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

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

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

getTestCustomAudienceManager

Se agregó en el nivel de API 34.
También se agregó en Extensiones de servicios de anuncios 4.
public TestCustomAudienceManager getTestCustomAudienceManager ()

Crea un servicio con APIs que habiliten pruebas

Muestra
TestCustomAudienceManager Este valor no puede ser null.

joinCustomAudience

Se agregó en el nivel de API 34.
También se agregó en Extensiones de servicios de anuncios 4.
public void joinCustomAudience (JoinCustomAudienceRequest joinCustomAudienceRequest, 
                Executor executor, 
                OutcomeReceiver<ObjectException> receiver)

Agrega el usuario a la CustomAudience especificada.

Un intento de registrar al usuario en un público personalizado con la misma combinación de ownerPackageName, buyer y name provocará la carga del información que se reemplazará, incluida la lista de datos de anuncios.

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

Esta 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 un IllegalArgumentException si

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

Esta llamada falla con LimitExceededException si el paquete que realiza la llamada excede el y los límites de frecuencia permitidos.

Esta llamada falla con IllegalStateException si se produce un error interno del servicio. que encuentran.
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 objeto de escucha se envían a través de esta Executor, lo que brinda una manera fácil de controlar qué subproceso se que se usan. 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 a un subproceso adecuado.

receiver OutcomeReceiver: Este valor no puede ser null.

dejarCustomAudience

Se agregó en el nivel de API 34.
También se agregó en Extensiones de servicios de anuncios 4.
public void leaveCustomAudience (LeaveCustomAudienceRequest leaveCustomAudienceRequest, 
                Executor executor, 
                OutcomeReceiver<ObjectException> receiver)

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

Esta llamada falla con un SecurityException si

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

Esta llamada falla con LimitExceededException si el paquete que realiza la llamada excede el y los límites de frecuencia permitidos.

Esta llamada no informa al llamador si el público personalizado especificado existía en de almacenamiento integrado en el dispositivo. En otras palabras, fallará silenciosamente cuando un comprador intente abandonar una 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 objeto de escucha se envían a través de esta Executor, lo que brinda una manera fácil de controlar qué subproceso se que se usan. 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 a un subproceso adecuado.

receiver OutcomeReceiver: Este valor no puede ser null.