Cette page a été traduite par l'API Cloud Translation.

Ajouté au niveau d'API 34
Également disponible dans Ad Services Extensions 4

Résumé: Classes imbriquées | Constantes héritées | Champs | Méthodes | Méthodes héritées

CustomAudience

public final class CustomAudience
extends Object implements Parcelable

java.lang.Object
↳	android.adservices.customaudience.CustomAudience

Représente les informations nécessaires pour qu'une audience personnalisée puisse participer à la sélection des annonces.

Une audience personnalisée est un groupe abstrait d'utilisateurs présentant des centres d'intérêt similaires. Cette classe est une collection de données stockées sur un appareil qui est nécessaire pour diffuser des publicités ciblant une seule audience personnalisée.

Résumé

Classes imbriquées
`class`	`CustomAudience.Builder` Compilateur pour les objets `CustomAudience`.

Constantes héritées

De l'interface android.os.Parcelable

`int`	`CONTENTS_FILE_DESCRIPTOR` Bit de descripteur utilisé avec `describeContents()` : indique que la représentation aplatie de l'objet Parcelable inclut un descripteur de fichier.
`int`	`PARCELABLE_WRITE_RETURN_VALUE` Indicateur à utiliser avec `writeToParcel(Parcel, int)` : l'objet en cours d'écriture est une valeur renvoyée, qui résulte d'une fonction telle que `Parcelable someFunction()`, `void someFunction(out Parcelable)` ou `void someFunction(inout Parcelable)`.

Champs
`public static final Creator<CustomAudience>`	`CREATOR`

Méthodes publiques
`boolean`	`equals(Object o)` Vérifie si deux objets `CustomAudience` contiennent les mêmes informations.
`Instant`	`getActivationTime()` Lors de la création de l'objet `CustomAudience`, un délai d'activation facultatif pourra être défini ultérieurement pour retarder l'activation.
`List<AdData>`	`getAds()` Cette liste d'objets `AdData` est une liste complète des annonces qui seront diffusées par cette `CustomAudience` lors de la sélection des annonces.
`Uri`	`getBiddingLogicUri()` Renvoie l'URI cible utilisée pour récupérer la logique d'enchères lorsqu'une audience personnalisée participe à la sélection des annonces.
`AdTechIdentifier`	`getBuyer()` Un acheteur est identifié par un domaine de la forme "buyerexample.com".
`Uri`	`getDailyUpdateUri()` Cet URI pointe vers un serveur géré par l'acheteur qui héberge les données d'enchères et les métadonnées des annonces mises à jour à utiliser dans le processus de sélection d'annonces sur l'appareil.
`Instant`	`getExpirationTime()` Une fois le délai d'expiration écoulé, une audience personnalisée ne peut plus bénéficier des mises à jour quotidiennes des données d'annonces et d'enchères ni participer à la sélection des annonces.
`String`	`getName()` Le nom de l'audience personnalisée est une chaîne arbitraire fournie par le propriétaire et l'acheteur lors de la création de l'objet `CustomAudience`.
`TrustedBiddingData`	`getTrustedBiddingData()` Les données d'enchères de confiance se composent d'un URI pointant vers un serveur de confiance pour les données d'enchères des acheteurs et d'une liste de clés avec lesquelles interroger le serveur.
`AdSelectionSignals`	`getUserBiddingSignals()` Les signaux d'enchères de l'utilisateur peuvent être fournis par les acheteurs et utilisés par le code JavaScript fourni par l'acheteur lors de la sélection des annonces dans un environnement d'exécution isolé.
`int`	`hashCode()` Renvoie le hachage des données de l'objet `CustomAudience`.
`void`	`writeToParcel(Parcel dest, int flags)` Aplatit cet objet dans un élément Parcel.

Méthodes héritées

De la classe


        
          java.lang.Object

`Object`	`clone()` Crée et affiche une copie de cet objet.
`boolean`	`equals(Object obj)` Indique si un autre objet est "égal à" celui-ci.
`void`	`finalize()` Appelée par le récupérateur de mémoire sur un objet lorsque la récupération de mémoire détermine qu'il n'y a plus de référence à l'objet.
`final Class<?>`	`getClass()` Affiche la classe d'exécution de cet objet (`Object`).
`int`	`hashCode()` Affiche une valeur de code de hachage pour l'objet.
`final void`	`notify()` Active un seul thread en attente sur l'écran de cet objet.
`final void`	`notifyAll()` Active tous les threads en attente sur l'écran de cet objet.
`String`	`toString()` Renvoie une représentation de l'objet sous forme de chaîne.
`final void`	`wait(long timeoutMillis, int nanos)` Entraîne l'attente du thread actuel jusqu'à son activation, généralement via une notification ou une interruption, ou après qu'un certain délai s'est écoulé.
`final void`	`wait(long timeoutMillis)` Entraîne l'attente du thread actuel jusqu'à son activation, généralement via une notification ou une interruption, ou après qu'un certain délai s'est écoulé.
`final void`	`wait()` Entraîne l'attente du thread actuel jusqu'à son activation, généralement via une notification ou une interruption.

De l'interface


        
          android.os.Parcelable

`abstract int`	`describeContents()` Décrit les types d'objets spéciaux contenus dans la représentation marshalée de cette instance Parcelable.
`abstract void`	`writeToParcel(Parcel dest, int flags)` Aplatit cet objet dans un élément Parcel.

Champs

CREATOR

Ajouté au niveau d'API 34
Également disponible dans Ad Services Extensions 4

public static final Creator<CustomAudience> CREATOR

Méthodes publiques

égal à

Ajouté au niveau d'API 34

public boolean equals (Object o)

Vérifie si deux objets CustomAudience contiennent les mêmes informations.

Paramètres
`o`	`Object` : objet de référence à comparer.

Renvoie
`boolean`	`true` si cet objet est identique à l'argument obj ; `false` dans les autres cas.

getActivationTime

Ajouté au niveau d'API 34
Également disponible dans la section Extensions de services publicitaires 4

public Instant getActivationTime ()

Lors de la création de l'objet CustomAudience, un délai d'activation facultatif pourra être défini ultérieurement pour retarder l'activation. Si le champ n'est pas défini, la CustomAudience sera activée au moment où l'audience personnalisée rejoint le processus de sélection d'annonces.

Par exemple, une audience personnalisée pour les anciens utilisateurs ne peut pas être activée tant qu'un seuil d'inactivité n'a pas été atteint. L'audience personnalisée participe alors à la sélection des annonces, ce qui peut rediriger les anciens utilisateurs vers l'application du propriétaire d'origine.

Le délai maximal d'activation est de 60 jours après la création initiale.

Si elle est spécifiée, l'heure d'activation doit être antérieure à l'heure d'expiration.

Renvoie
`Instant`	Code temporel `Instant`, tronqué à la milliseconde, au terme duquel le code audience est active Cette valeur peut être `null`.

getAds

Ajouté au niveau d'API 34
Également disponible dans la section Extensions de services publicitaires 4

public List<AdData> getAds ()

Cette liste d'objets AdData est une liste complète des annonces qui seront diffusées par cette CustomAudience lors de la sélection des annonces.

Si elle n'est pas spécifiée ou si une liste vide est fournie, la CustomAudience ne participe pas à la sélection des annonces tant qu'une liste valide d'annonces n'a pas été fournie via la mise à jour quotidienne de l'audience personnalisée.

Renvoie
`List<AdData>`	`List` d'objets `AdData` représentant les annonces actuellement diffusées par audience personnalisée Cette valeur ne peut pas être `null`.

getBiddingLogicUri

Ajouté au niveau d'API 34
Également disponible dans la section Extensions de services publicitaires 4

public Uri getBiddingLogicUri ()

Renvoie l'URI cible utilisée pour récupérer la logique d'enchères lorsqu'une audience personnalisée participe à la sélection des annonces. L'URI doit utiliser le protocole HTTPS.

Renvoie
`Uri`	l'URI permettant d'extraire la logique d'enchères de l'acheteur. Cette valeur ne peut pas être `null`.

getBuyer

Ajouté au niveau d'API 34
Également disponible dans la section Extensions de services publicitaires 4

public AdTechIdentifier getBuyer ()

Un acheteur est identifié par un domaine de la forme "buyerexample.com".

Renvoie
`AdTechIdentifier`	Un élément `AdTechIdentifier` contenant le domaine de l'acheteur de l'audience personnalisée Cette valeur ne peut pas être `null`.

getDailyUpdateUri

Ajouté au niveau d'API 34
Également disponible dans la section Extensions de services publicitaires 4

public Uri getDailyUpdateUri ()

Cet URI pointe vers un serveur géré par l'acheteur qui héberge les données d'enchères et les métadonnées des annonces mises à jour à utiliser dans le processus de sélection d'annonces sur l'appareil. L'URI doit utiliser le protocole HTTPS.

Renvoie
`Uri`	l'URI de mise à jour quotidienne de l'audience personnalisée Cette valeur ne peut pas être `null`.

getExpirationTime

Ajouté au niveau d'API 34
Également disponible dans la section Extensions de services publicitaires 4

public Instant getExpirationTime ()

Une fois le délai d'expiration écoulé, une audience personnalisée ne peut plus bénéficier des mises à jour quotidiennes des données d'annonces et d'enchères ni participer à la sélection des annonces. L'audience personnalisée sera alors supprimée de la mémoire lors de la mise à jour quotidienne suivante.

Si aucun délai d'expiration n'est spécifié lors de la création de la CustomAudience, le délai d'expiration est défini par défaut sur 60 jours à compter de l'activation.

Le délai d'expiration maximal est de 60 jours à compter de l'activation initiale.

Renvoie
`Instant`	Code temporel `Instant`, tronqué à la milliseconde, au terme duquel le code audience doit être supprimée Cette valeur peut être `null`.

getName

Ajouté au niveau d'API 34
Également disponible dans la section Extensions de services publicitaires 4

public String getName ()

Le nom de l'audience personnalisée est une chaîne arbitraire fournie par le propriétaire et l'acheteur lors de la création de l'objet CustomAudience.

Renvoie
`String`	Nom de chaîne de l'audience personnalisée Cette valeur ne peut pas être `null`.

getTrustedBiddingData

Ajouté au niveau d'API 34
Également disponible dans la section Extensions de services publicitaires 4

public TrustedBiddingData getTrustedBiddingData ()

Les données d'enchères de confiance se composent d'un URI pointant vers un serveur de confiance pour les données d'enchères des acheteurs et d'une liste de clés avec lesquelles interroger le serveur. Notez que les clés sont des identifiants arbitraires qui ne seront utilisés que pour interroger le serveur de confiance sur la logique d'enchères de l'acheteur lors de la sélection des annonces.

Si cet objet n'est pas spécifié, la CustomAudience ne participera pas à la sélection des annonces tant que les données d'enchères de confiance n'auront pas été fournies via la mise à jour quotidienne de l'audience personnalisée.

Renvoie
`TrustedBiddingData`	Un objet `TrustedBiddingData` contenant les enchères de confiance de l'audience personnalisée données Cette valeur peut être `null`.

getUserBiddingSignals

Ajouté au niveau d'API 34
Également disponible dans la section Extensions de services publicitaires 4

public AdSelectionSignals getUserBiddingSignals ()

Les signaux d'enchères de l'utilisateur peuvent être fournis par les acheteurs et utilisés par le code JavaScript fourni par l'acheteur lors de la sélection des annonces dans un environnement d'exécution isolé.

Si ces signaux ne sont pas des objets JSON valides utilisables par le code JavaScript de l'acheteur, l'audience personnalisée ne sera pas éligible pour la sélection des annonces.

Si cet objet n'est pas spécifié, la CustomAudience ne participera pas à la sélection des annonces tant que les signaux d'enchères utilisateur n'auront pas été fournis via la mise à jour quotidienne de l'audience personnalisée.

Renvoie
`AdSelectionSignals`	Un objet `AdSelectionSignals` représentant les signaux d'enchères de l'utilisateur pour le audience personnalisée Cette valeur peut être `null`.

hashCode

Ajouté au niveau d'API 34

public int hashCode ()

Renvoie le hachage des données de l'objet CustomAudience.

Valeur affichée
`int`	une valeur de code de hachage pour cet objet.

writeToParcel

Ajouté au niveau d'API 34

public void writeToParcel (Parcel dest, 
                int flags)

Aplatit cet objet dans un élément Parcel.

Paramètres
`dest`	`Parcel` : cette valeur ne peut pas être `null`.
`flags`	`int` : indicateurs supplémentaires concernant la manière dont l'objet doit être écrit. Peut prendre la valeur 0 ou `Parcelable.PARCELABLE_WRITE_RETURN_VALUE`. La valeur est `0` ou une combinaison de `Parcelable.PARCELABLE_WRITE_RETURN_VALUE` et android.os.Parcelable.PARCELABLE_ELIDE_DUPLICATES.