Gestionnaire d'audience personnalisée
public
class
CustomAudienceManager
extends Object
java.lang.Object | |
↳ | android.adservices.customaudience.CustomAudienceManager |
CustomAudienceManager fournit des API permettant aux SDK publicitaires et d'applications de rejoindre / quitter des audiences personnalisées.
Résumé
Méthodes publiques | |
---|---|
void
|
fetchAndJoinCustomAudience(FetchAndJoinCustomAudienceRequest fetchAndJoinCustomAudienceRequest, Executor executor, OutcomeReceiver<Object, Exception> receiver)
Ajoute l'utilisateur au |
static
CustomAudienceManager
|
get(Context context)
Méthode par défaut permettant de créer une instance de CustomAudienceManager |
TestCustomAudienceManager
|
getTestCustomAudienceManager()
Créer un service avec des API d'activation des tests |
void
|
joinCustomAudience(JoinCustomAudienceRequest joinCustomAudienceRequest, Executor executor, OutcomeReceiver<Object, Exception> receiver)
Ajoute l'utilisateur à l'élément |
void
|
leaveCustomAudience(LeaveCustomAudienceRequest leaveCustomAudienceRequest, Executor executor, OutcomeReceiver<Object, Exception> receiver)
Tente de supprimer un utilisateur d'une audience personnalisée en supprimant les données |
Méthodes héritées | |
---|---|
Méthodes publiques
extraire et joindreCustomAudience
public void fetchAndJoinCustomAudience (FetchAndJoinCustomAudienceRequest fetchAndJoinCustomAudienceRequest, Executor executor, OutcomeReceiver<Object, Exception> receiver)
Ajoute l'utilisateur au CustomAudience
récupéré à partir d'un fetchUri
.
Si vous tentez d'enregistrer l'utilisateur pour une audience personnalisée avec la même combinaison de ownerPackageName
, buyer
et name
, l'audience personnalisée existante
à remplacer, y compris la liste des données relatives aux annonces.
Notez que la liste des annonces peut être complètement remplacée par le job quotidien de récupération en arrière-plan.
Cet appel échoue avec une erreur SecurityException
si
ownerPackageName
n'appelle pas le nom de package de l'application et/ou- l'acheteur n'est pas autorisé à utiliser l'API.
Cet appel échoue avec une erreur IllegalArgumentException
si
- la limite de stockage a été dépassée par l'application appelante et/ou
- tous les paramètres d'URI dans l'élément
CustomAudience
indiqué ne sont pas authentifiés avec la AcheteurCustomAudience
.
Cet appel échoue avec LimitExceededException
si le package à l'origine de l'appel dépasse la
et est limité.
Cet appel échoue et affiche le message IllegalStateException
si une erreur de service interne est
rencontrés.
Nécessite AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE
Paramètres | |
---|---|
fetchAndJoinCustomAudienceRequest |
FetchAndJoinCustomAudienceRequest : cette valeur ne peut pas être null . |
executor |
Executor : cette valeur ne peut pas être null .
Les événements de rappel et d'écouteur sont envoyés via
Executor , ce qui permet de contrôler facilement le thread qui est
utilisé. Pour envoyer des événements via le thread principal de votre
vous pouvez utiliser
Context.getMainExecutor()
Sinon, fournissez un Executor qui sera envoyé à un thread approprié. |
receiver |
OutcomeReceiver : cette valeur ne peut pas être null . |
get
Également disponible dans la section Extensions de services publicitaires 6
public static CustomAudienceManager get (Context context)
Méthode par défaut permettant de créer une instance de CustomAudienceManager
Paramètres | |
---|---|
context |
Context : Context à utiliser
Cette valeur ne peut pas être null . |
Renvoie | |
---|---|
CustomAudienceManager |
Une instance CustomAudienceManager
Cette valeur ne peut pas être null . |
Gestionnaire d'audience personnalisée getTest
public TestCustomAudienceManager getTestCustomAudienceManager ()
Créer un service avec des API d'activation des tests
Renvoie | |
---|---|
TestCustomAudienceManager |
Cette valeur ne peut pas être null . |
joinCustomAudience
public void joinCustomAudience (JoinCustomAudienceRequest joinCustomAudienceRequest, Executor executor, OutcomeReceiver<Object, Exception> receiver)
Ajoute l'utilisateur à l'élément CustomAudience
donné.
Si vous tentez d'enregistrer l'utilisateur pour une audience personnalisée avec la même combinaison de ownerPackageName
, buyer
et name
, l'audience personnalisée existante
à remplacer, y compris la liste des données relatives aux annonces.
Notez que la liste des annonces peut être complètement remplacée par le job quotidien de récupération en arrière-plan.
Cet appel échoue avec une erreur SecurityException
si
ownerPackageName
n'appelle pas le nom de package de l'application et/ou- l'acheteur n'est pas autorisé à utiliser l'API.
Cet appel échoue avec une erreur IllegalArgumentException
si
- la limite de stockage a été dépassée par l'application appelante et/ou
- tous les paramètres d'URI dans l'élément
CustomAudience
indiqué ne sont pas authentifiés avec la AcheteurCustomAudience
.
Cet appel échoue avec LimitExceededException
si le package à l'origine de l'appel dépasse la
et est limité.
Cet appel échoue et affiche le message IllegalStateException
si une erreur de service interne est
rencontrés.
Nécessite AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE
Paramètres | |
---|---|
joinCustomAudienceRequest |
JoinCustomAudienceRequest : cette valeur ne peut pas être null . |
executor |
Executor : cette valeur ne peut pas être null .
Les événements de rappel et d'écouteur sont envoyés via
Executor , ce qui permet de contrôler facilement le thread qui est
utilisé. Pour envoyer des événements via le thread principal de votre
vous pouvez utiliser
Context.getMainExecutor()
Sinon, fournissez un Executor qui sera envoyé à un thread approprié. |
receiver |
OutcomeReceiver : cette valeur ne peut pas être null . |
QuitterCustomAudience
public void leaveCustomAudience (LeaveCustomAudienceRequest leaveCustomAudienceRequest, Executor executor, OutcomeReceiver<Object, Exception> receiver)
Tente de supprimer un utilisateur d'une audience personnalisée en supprimant les données CustomAudience
existantes, identifiées par ownerPackageName
, buyer
et name
.
Cet appel échoue avec une erreur SecurityException
si
ownerPackageName
n'appelle pas le nom de package de l'application. et/ou- l'acheteur n'est pas autorisé à utiliser l'API.
Cet appel échoue avec LimitExceededException
si le package à l'origine de l'appel dépasse la
et est limité.
Cet appel n'informe pas l'appelant si l'audience personnalisée spécifiée existe dans
stockage sur l'appareil. En d'autres termes, il échoue en mode silencieux lorsqu'un acheteur tente de laisser
audience personnalisée qui n'a pas été rejointe.
Nécessite AdServicesPermissions.ACCESS_ADSERVICES_CUSTOM_AUDIENCE
Paramètres | |
---|---|
leaveCustomAudienceRequest |
LeaveCustomAudienceRequest : cette valeur ne peut pas être null . |
executor |
Executor : cette valeur ne peut pas être null .
Les événements de rappel et d'écouteur sont envoyés via
Executor , ce qui permet de contrôler facilement le thread qui est
utilisé. Pour envoyer des événements via le thread principal de votre
vous pouvez utiliser
Context.getMainExecutor()
Sinon, fournissez un Executor qui sera envoyé à un thread approprié. |
receiver |
OutcomeReceiver : cette valeur ne peut pas être null . |