Configuration de sélection d'annonces

public final class AdSelectionConfig
extends Object implements Parcelable

java.lang.Object
   ↳ android.adservices.adselection.AdSelectionConfig


Contient la configuration du processus de sélection des annonces.

Les instances de cette classe sont créées par des SDK à fournir en tant qu'arguments aux méthodes AdSelectionManager.selectAds(AdSelectionConfig, Executor, OutcomeReceiver) et AdSelectionManager#reportImpression dans AdSelectionManager.

Résumé

Classes imbriquées

class AdSelectionConfig.Builder

Compilateur pour l'objet AdSelectionConfig

Constantes héritées

Champs

public static final Creator<AdSelectionConfig> CREATOR

Méthodes publiques

int describeContents()

Décrit les types d'objets spéciaux contenus dans la représentation marshalée de cette instance Parcelable.

boolean equals(Object o)

Indique si un autre objet est "égal à" celui-ci.

AdSelectionSignals getAdSelectionSignals()
List<AdTechIdentifier> getCustomAudienceBuyers()
Uri getDecisionLogicUri()
Map<AdTechIdentifierAdSelectionSignals> getPerBuyerSignals()
AdTechIdentifier getSeller()
AdSelectionSignals getSellerSignals()
Uri getTrustedScoringSignalsUri()
int hashCode()

Renvoie une valeur de code de hachage pour l'objet.

void writeToParcel(Parcel dest, int flags)

Aplatit cet objet dans un élément Parcel.

Méthodes héritées

Champs

CREATOR

Ajouté au niveau d'API 34
Également disponible dans Ad Services Extensions 4
public static final Creator<AdSelectionConfig> CREATOR

Méthodes publiques

describeContents

Ajouté au niveau d'API 34
public int describeContents ()

Décrit les types d'objets spéciaux contenus dans la représentation marshalée de cette instance Parcelable. Par exemple, si l'objet inclut un descripteur de fichier dans la sortie de writeToParcel(android.os.Parcel, int), la valeur renvoyée par cette méthode doit inclure le bit CONTENTS_FILE_DESCRIPTOR.

Renvoie
int Un masque de bits indiquant l'ensemble des types d'objets spéciaux marshalés par cette instance d'objet Parcelable. La valeur est 0 ou CONTENTS_FILE_DESCRIPTOR.

equals

Ajouté au niveau d'API 34
public boolean equals (Object o)

Indique si un autre objet est "égal à" celui-ci.

La méthode equals implémente une relation d'équivalence sur les références d'objets non nulles :

  • Elle est réfléchie : pour toute valeur de référence non nulle x, x.equals(x) doit renvoyer true.
  • Elle est symétrique : pour toutes les valeurs de référence non nulles x et y, x.equals(y) doit renvoyer true si et seulement si y.equals(x) renvoie true.
  • Elle est transitive : pour toutes les valeurs de référence non nulles x, y et z, si x.equals(y) renvoie true et y.equals(z) renvoie true, alors x.equals(z) doit renvoyer true.
  • Elle est cohérente : pour toutes les valeurs de référence non nulles x et y, plusieurs invocations de x.equals(y) renvoient systématiquement true ou false, à condition qu'aucune information utilisée dans les comparaisons equals sur les objets ne soit modifiée.
  • Pour toute valeur de référence non nulle x, x.equals(null) doit renvoyer false.

La méthode equals pour la classe Object (objet) implémente la relation d'équivalence la plus discriminatoire possible sur les objets, c'est-à-dire que pour toute valeur de référence non nulle x et y, cette méthode renvoie true si et seulement si x et y font référence au même objet (x == y a la valeur true).

Notez qu'il est généralement nécessaire de remplacer la méthode hashCode chaque fois que cette méthode est ignorée, afin de conserver le contrat général pour la méthode hashCode, qui stipule que les objets égaux doivent avoir le même code de hachage.

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.

getAdSelectionSignals

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

Renvoie
AdSelectionSignals JSON dans un objet AdSelectionSignals, extrait de AdSelectionConfig et consommé par la logique JS récupérée par la DSP, représente les signaux transmis au lors des processus de sélection des annonces et de création de rapports. Cette valeur ne peut pas être null.

getCustomAudienceBuyers

Ajouté au niveau d'API 34
Également disponible dans Ad Services Extensions 4
public List<AdTechIdentifier> getCustomAudienceBuyers ()

Renvoie
List<AdTechIdentifier> Une liste d'acheteurs d'audiences personnalisées autorisés par la SSP à participer à l'annonce processus de sélection Cette valeur ne peut pas être null.

getDecisionLogicUri

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

Renvoie
Uri URI utilisé pour récupérer le code JS contenant la fonction scoreAd du vendeur/SSP utilisée lors des processus de sélection des annonces et de création de rapports. Cette valeur ne peut pas être null.

getPerBuyerSignals

Ajouté au niveau d'API 34
Également disponible dans Ad Services Extensions 4
public Map<AdTechIdentifierAdSelectionSignals> getPerBuyerSignals ()

Renvoie
Map<AdTechIdentifierAdSelectionSignals> une carte des acheteurs et des signaux AdSelectionSignals, extraite de AdSelectionConfig et consommées par la logique JS récupérée par la DSP, représentant toute information que chaque que l'acheteur fournirait aux participants lors de la sélection des annonces (ex. : plancher d'enchères, sélection des annonces, type, etc.) Cette valeur ne peut pas être null.

getSeller

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

Renvoie
AdTechIdentifier Un AdTechIdentifier du vendeur, par exemple "www.example-ssp.com" Cette valeur ne peut pas être null.

getSellerSignals

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

Renvoie
AdSelectionSignals JSON dans un objet AdSelectionSignals, fourni par la SSP et utilisé par le langage JS récupérée à partir de la SSP, représente toute information utilisée par la SSP dans l'annonce d'évaluation afin d'ajuster les résultats du processus de sélection des annonces (par exemple, brand safety les vérifications, les annonces contextuelles exclues). Cette valeur ne peut pas être null.

getTrustedScoringSignalsUri

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

Renvoie
Uri Point de terminaison de l'URI du signal de confiance côté vente à partir duquel la création en temps réel spécifique à partir duquel les informations peuvent être extraites. Cette valeur ne peut pas être null.

hashCode

Ajouté au niveau d'API 34
public int hashCode ()

Renvoie une valeur de code de hachage pour l'objet. Cette méthode est compatible avec les tables de hachage, telles que celles fournies par HashMap.

Le contrat général de hashCode est le suivant :

  • Chaque fois qu'elle est appelée plusieurs fois sur le même objet lors de l'exécution d'une application Java, la méthode hashCode doit toujours renvoyer le même entier, à condition qu'aucune information utilisée dans les comparaisons equals de l'objet ne soit modifiée. Cet entier n'a pas besoin de rester cohérent d'une exécution de l'application à une autre.
  • Si deux objets sont égaux selon la méthode equals(Object), alors l'appel de la méthode hashCode sur chacun des deux objets doit produire le même résultat entier.
  • Si deux objets ne sont pas égaux selon la méthode equals(java.lang.Object), il n'est pas nécessaire que l'appel de la méthode hashCode sur chacun des deux objets produise des résultats entiers distincts. Toutefois, le programmeur doit savoir que la génération de résultats entiers distincts pour les objets inégaux peut améliorer les performances des tables de hachage.

Dans la mesure du possible, la méthode hashCode définie par la classe Object affiche des entiers distincts pour des objets distincts. Notez que le hachage hashCode peut être implémenté ou non en tant que fonction de l'adresse mémoire d'un objet à un moment donné.

Renvoie
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.