Ajouté au niveau d'API 34
Également disponible dans Ad Services Extensions 4
Résumé : Méthodes | Méthodes héritées

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 CustomAudience récupéré à partir d'un fetchUri.

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 CustomAudience donné.

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.

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

  1. ownerPackageName n'appelle pas le nom de package de l'application et/ou
  2. l'acheteur n'est pas autorisé à utiliser l'API.

Cet appel échoue avec une erreur IllegalArgumentException si

  1. la limite de stockage a été dépassée par l'application appelante et/ou
  2. tous les paramètres d'URI dans l'élément CustomAudience indiqué ne sont pas authentifiés avec la Acheteur CustomAudience.

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

Ajouté au niveau d'API 34
É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

Ajouté au niveau d'API 34
Également disponible dans Ad Services Extensions 4 
public TestCustomAudienceManager getTestCustomAudienceManager ()

Créer un service avec des API d'activation des tests

Renvoie
TestCustomAudienceManager Cette valeur ne peut pas être null.

joinCustomAudience

Ajouté au niveau d'API 34
Également disponible dans Ad Services Extensions 4 
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

  1. ownerPackageName n'appelle pas le nom de package de l'application et/ou
  2. l'acheteur n'est pas autorisé à utiliser l'API.

Cet appel échoue avec une erreur IllegalArgumentException si

  1. la limite de stockage a été dépassée par l'application appelante et/ou
  2. tous les paramètres d'URI dans l'élément CustomAudience indiqué ne sont pas authentifiés avec la Acheteur CustomAudience.

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

Ajouté au niveau d'API 34
Également disponible dans Ad Services Extensions 4 
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

  1. ownerPackageName n'appelle pas le nom de package de l'application. et/ou
  2. 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.