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<Object, Exception> receiver)
Agrega al usuario al |
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<Object, Exception> receiver)
Agrega el usuario a la |
void
|
leaveCustomAudience(LeaveCustomAudienceRequest leaveCustomAudienceRequest, Executor executor, OutcomeReceiver<Object, Exception> receiver)
Intenta quitar un usuario de un público personalizado borrando los datos de |
Métodos heredados | |
---|---|
Métodos públicos
recuperarAndJoinCustomAudience
public void fetchAndJoinCustomAudience (FetchAndJoinCustomAudienceRequest fetchAndJoinCustomAudienceRequest, Executor executor, OutcomeReceiver<Object, Exception> 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
ownerPackageName
no llama al nombre del paquete de la app.- el comprador no está autorizado a usar la API.
Esta llamada falla con un IllegalArgumentException
si
- La aplicación que realiza la llamada superó el límite de almacenamiento.
- Los parámetros de URI en el
CustomAudience
especificado no se autentican con elCustomAudience
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
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
public TestCustomAudienceManager getTestCustomAudienceManager ()
Crea un servicio con APIs que habiliten pruebas
Muestra | |
---|---|
TestCustomAudienceManager |
Este valor no puede ser null . |
joinCustomAudience
public void joinCustomAudience (JoinCustomAudienceRequest joinCustomAudienceRequest, Executor executor, OutcomeReceiver<Object, Exception> 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
ownerPackageName
no llama al nombre del paquete de la app.- el comprador no está autorizado a usar la API.
Esta llamada falla con un IllegalArgumentException
si
- La aplicación que realiza la llamada superó el límite de almacenamiento.
- Los parámetros de URI en el
CustomAudience
especificado no se autentican con elCustomAudience
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
public void leaveCustomAudience (LeaveCustomAudienceRequest leaveCustomAudienceRequest, Executor executor, OutcomeReceiver<Object, Exception> 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
ownerPackageName
no llama al nombre del paquete de la app. y/o- 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 . |