Identifiant publicitaire

public class AdId
extends Object

java.lang.Object
   ↳ android.adservices.adid.AdId


ID unique, réinitialisable par l'utilisateur et au niveau de l'appareil, qui est défini pour chaque profil pour les annonces.

Les réseaux publicitaires peuvent utiliser AdId pour monétiser la publicité ciblée par centres d'intérêt (IBA), le ciblage et les annonces de remarketing. L'utilisateur peut limiter la disponibilité de cet identifiant.

Résumé

Constantes

String ZERO_OUT

ad id remis à zéro qui est renvoyé lorsque l'utilisateur dispose de limited ad tracking.

Constructeurs publics

AdId(String adId, boolean limitAdTrackingEnabled)

Crée une instance de AdId.

Méthodes publiques

boolean equals(Object o)

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

String getAdId()

Identifiant publicitaire.

int hashCode()

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

boolean isLimitAdTrackingEnabled()

Récupère le paramètre de limitation du suivi des annonces activé.

String toString()

Renvoie une représentation de l'objet sous forme de chaîne.

Méthodes héritées

Constantes

ZERO_OUT

Ajouté au niveau d'API 34
Également disponible dans Ad Services Extensions 4
public static final String ZERO_OUT

ad id remis à zéro qui est renvoyé lorsque l'utilisateur dispose de limited ad tracking.

Valeur constante: "00000000-0000-0000-0000-000000000000"

Constructeurs publics

Identifiant publicitaire

Ajouté au niveau d'API 34
Également disponible dans Ad Services Extensions 4
public AdId (String adId, 
                boolean limitAdTrackingEnabled)

Crée une instance de AdId.

Paramètres
adId String: obtenu auprès du service du fournisseur. Cette valeur ne peut pas être null.

limitAdTrackingEnabled boolean: valeur du service du fournisseur qui détermine la valeur de adId.

Méthodes publiques

égal à

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.

getAdId

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

Identifiant publicitaire.

La valeur de l'identifiant publicitaire dépend d'une combinaison de isLimitAdTrackingEnabled() et AdServicesPermissions.ACCESS_ADSERVICES_AD_ID.

Lorsque l'utilisateur est limiting ad tracking, l'API renvoie ZERO_OUT Cela empêche l'appelant de suivre l'utilisateur à des fins de monétisation.

Sinon, une chaîne propre à l'appareil et à l'utilisateur est renvoyée. Elle peut servir à suivre les utilisateurs à des fins publicitaires.

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

isLimitAdTrackingEnabled

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

Récupère le paramètre de limitation du suivi des annonces activé.

Cette valeur est "true" si l'utilisateur a activé le suivi limité des annonces. Sinon, false.

Renvoie
boolean

toString

Ajouté au niveau d'API 34
public String toString ()

Renvoie une représentation de l'objet sous forme de chaîne. En général, la méthode toString renvoie une chaîne qui "représente textuellement" cet objet. Le résultat doit être une représentation concise, mais informative, et facile à lire. Il est recommandé que toutes les sous-classes remplacent cette méthode.

La méthode toString pour la classe Object renvoie une chaîne composée du nom de la classe dont l'objet est une instance, du caractère arobase "@", ainsi que de la représentation hexadécimale non signée du code de hachage de l'objet. En d'autres termes, cette méthode renvoie une chaîne égale à la valeur de :

 getClass().getName() + '@' + Integer.toHexString(hashCode())
 

Valeur affichée
String une représentation de l'objet sous forme de chaîne.