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 a la |
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<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 existentes de |
Métodos heredados | |
---|---|
Métodos públicos
recuperar yUnirseCustomAudience
public void fetchAndJoinCustomAudience (FetchAndJoinCustomAudienceRequest fetchAndJoinCustomAudienceRequest, Executor executor, OutcomeReceiver<Object, Exception> 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
ownerPackageName
no llama al nombre del paquete de la app.- el comprador no está autorizado a usar la API.
La llamada falla con un IllegalArgumentException
si
- la aplicación que realiza la llamada superó el límite de almacenamiento; o
- los parámetros de URI en la
CustomAudience
especificada no se autentican con el comprador deCustomAudience
.
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<Object, Exception> 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
ownerPackageName
no llama al nombre del paquete de la app.- el comprador no está autorizado a usar la API.
La llamada falla con un IllegalArgumentException
si
- la aplicación que realiza la llamada superó el límite de almacenamiento; o
- los parámetros de URI en la
CustomAudience
especificada no se autentican con el comprador deCustomAudience
.
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<Object, Exception> 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
ownerPackageName
no llama al nombre del paquete de la app.- 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 . |