ID annuncio

public class AdId
extends Object

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


Un ID univoco, reimpostabile dall'utente, a livello di dispositivo e per profilo per la pubblicità.

Le reti pubblicitarie possono utilizzare AdId per monetizzare la pubblicità basata sugli interessi (IBA), ovvero il targeting e gli annunci di remarketing. L'utente può limitare la disponibilità di questo identificatore.

Riepilogo

Costanti

String ZERO_OUT

Un valore ad id azzerato che viene restituito quando l'utente ha limited ad tracking.

Costruttori pubblici

AdId(String adId, boolean limitAdTrackingEnabled)

Crea un'istanza di AdId

Metodi pubblici

boolean equals(Object o)

Indica se qualche altro oggetto è "uguale a" questo.

String getAdId()

L'ID pubblicità.

int hashCode()

Restituisce un valore di codice hash per l'oggetto.

boolean isLimitAdTrackingEnabled()

Recupera l'impostazione per limitare il monitoraggio degli annunci attivato.

String toString()

Restituisce una rappresentazione stringa dell'oggetto.

Metodi ereditati

Costanti

ZERO_OUT

public static final String ZERO_OUT

Un valore ad id azzerato che viene restituito quando l'utente ha limited ad tracking.

Valore costante: "00000000-0000-0000-0000-000000000000"

Costruttori pubblici

ID annuncio

public AdId (String adId, 
                boolean limitAdTrackingEnabled)

Crea un'istanza di AdId

Parametri
adId String: ottenuto dal servizio del fornitore. Questo valore non può essere null.

limitAdTrackingEnabled boolean: valore del servizio provider che determina il valore di adId.

Metodi pubblici

uguale a

Aggiunto al livello API 34
public boolean equals (Object o)

Indica se qualche altro oggetto è "uguale a" questo.

Il metodo equals implementa una relazione di equivalenza sui riferimenti a oggetti non null:

  • È riflesso: per qualsiasi valore di riferimento non null x, x.equals(x) deve restituire true.
  • È simmetrico: per qualsiasi valore di riferimento non nullo x e y, x.equals(y) deve restituire true se e solo se y.equals(x) restituisce true.
  • È transitivo: per qualsiasi valore di riferimento non nullo x, y e z, se x.equals(y) restituisce true e y.equals(z) restituisce true, x.equals(z) deve restituire true.
  • È coerente: per tutti i valori di riferimento non null x e y, più chiamate di x.equals(y) restituiscono costantemente true o restituiscono costantemente false, a condizione che nessuna informazione utilizzata nei confronti di equals sugli oggetti venga modificata.
  • Per qualsiasi valore di riferimento non null x, x.equals(null) deve restituire false.

Il metodo equals per la classe Object implementa la relazione di equivalenza più discriminante possibile sugli oggetti; ovvero, per qualsiasi valore di riferimento non nullo x e y, questo metodo restituisce true se e solo se x e y fanno riferimento allo stesso oggetto (x == y ha il valore true).

Tieni presente che, in genere, è necessario sostituire il metodo hashCode ogni volta che questo metodo viene sostituito, in modo da mantenere il contratto generale per il metodo hashCode, in cui si afferma che oggetti uguali devono avere codici hash uguali.

Parametri
o Object: l'oggetto di riferimento con cui effettuare il confronto.

Ritorni
boolean true se questo oggetto è uguale all'argomento obj; in caso contrario false.

getAdId

public String getAdId ()

L'ID pubblicità.

Il valore dell'ID pubblicità dipende da una combinazione di isLimitAdTrackingEnabled() e AdServicesPermissions.ACCESS_ADSERVICES_AD_ID.

Quando l'utente è limiting ad tracking, l'API restituisce ZERO_OUT. In questo modo il chiamante non può tracciare l'utente a fini di monetizzazione.

In caso contrario, viene restituita una stringa univoca per il dispositivo e l'utente, che può essere utilizzata per monitorare gli utenti per la pubblicità.

Ritorni
String Questo valore non può essere null.

Codice hash

Aggiunto al livello API 34
public int hashCode ()

Restituisce un valore di codice hash per l'oggetto. Questo metodo è supportato a vantaggio delle tabelle hash come quelle fornite da HashMap.

Il contratto generale di hashCode è:

  • Ogni volta che viene richiamato sullo stesso oggetto più di una volta durante l'esecuzione di un'applicazione Java, il metodo hashCode deve restituire in modo coerente lo stesso numero intero, a condizione che non venga modificata alcuna informazione utilizzata nei confronti di equals sull'oggetto. Questo numero intero non deve rimanere coerente da un'esecuzione a un'altra della stessa applicazione.
  • Se due oggetti sono uguali in base al metodo equals(Object), la chiamata del metodo hashCode su ciascuno dei due oggetti deve produrre lo stesso risultato intero.
  • Non è necessario che se due oggetti non sono uguali in base al metodo equals(java.lang.Object), la chiamata del metodo hashCode su ciascuno dei due oggetti deve produrre risultati interi distinti. Tuttavia, il programmatore deve sapere che produrre risultati interi distinti per oggetti disuguali può migliorare le prestazioni delle tabelle hash.

Per quanto ragionevolmente pratico, il metodo hashCode definito dalla classe Object restituisce numeri interi distinti per oggetti distinti. (l'hashCode può o meno essere implementato come funzione dell'indirizzo di memoria di un oggetto in un determinato momento).

Ritorni
int un valore di codice hash per l'oggetto.

Rilevamento feed annuncio limitato

public boolean isLimitAdTrackingEnabled ()

Recupera l'impostazione per limitare il monitoraggio degli annunci attivato.

Questo valore è true se l'utente ha attivato il monitoraggio degli annunci limitato, altrimenti false.

Ritorni
boolean

ToString

Aggiunto al livello API 34
public String toString ()

Restituisce una rappresentazione stringa dell'oggetto. In generale, il metodo toString restituisce una stringa che "rappresenta testualmente" l'oggetto. Il risultato dovrebbe essere una rappresentazione concisa, ma informativa, facile da leggere. È consigliabile che tutte le sottoclassi sostituiscano questo metodo.

Il metodo toString per la classe Object restituisce una stringa composta dal nome della classe di cui l'oggetto è un'istanza, dal carattere del simbolo @ "@" e dalla rappresentazione esadecimale senza segno del codice hash dell'oggetto. In altre parole, questo metodo restituisce una stringa uguale al valore di:

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

Ritorni
String una rappresentazione stringa dell'oggetto.