In API-Level 34 hinzugefügt
Auch in Ad Services Extensions 4 hinzugefügt

Anzeigen-ID

public class AdId
extends Object

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


Eine eindeutige ID für Werbeprofile, die vom Nutzer zurückgesetzt werden kann und für das gesamte Gerät gilt.

Werbenetzwerke können AdId zur Monetarisierung für interessenbezogene Werbung verwenden, d.h. Ausrichtung und Remarketing-Anzeigen. Der Nutzer kann die Verfügbarkeit dieser ID einschränken.

Zusammenfassung

Konstanten

String ZERO_OUT

Ein auf null gesetztes ad id, das zurückgegeben wird, wenn der Nutzer limited ad tracking hat.

Öffentliche Konstruktoren

AdId(String adId, boolean limitAdTrackingEnabled)

Erstellt eine Instanz von AdId

Öffentliche Methoden

boolean equals(Object o)

Gibt an, ob ein anderes Objekt „gleich“ ist dieses.

String getAdId()

Die Werbe-ID.

int hashCode()

Gibt einen Hash-Code-Wert für das Objekt zurück.

boolean isLimitAdTrackingEnabled()

Ruft die Einstellung "Limit für Anzeigen-Tracking aktiviert" ab

String toString()

Gibt eine Stringdarstellung des Objekts zurück.

Übernommene Methoden

Konstanten

NULL_OUT

In API-Level 34 hinzugefügt
Auch in Ad Services Extensions 4 hinzugefügt
public static final String ZERO_OUT

Ein auf null gesetztes ad id, das zurückgegeben wird, wenn der Nutzer limited ad tracking hat.

Konstantenwert: „00000000-0000-0000-0000-000000000000“

Öffentliche Konstruktoren

Anzeigen-ID

In API-Level 34 hinzugefügt
Auch in Ad Services Extensions 4 hinzugefügt
public AdId (String adId, 
                boolean limitAdTrackingEnabled)

Erstellt eine Instanz von AdId

Parameter
adId String: wird vom Anbieterdienst abgerufen. Dieser Wert darf nicht null sein.

limitAdTrackingEnabled boolean: Wert des Anbieterdienstes, der den Wert von adId enthält.

Öffentliche Methoden

ist gleich

In API-Level 34 hinzugefügt
public boolean equals (Object o)

Gibt an, ob ein anderes Objekt „gleich“ ist dieses.

Die Methode equals implementiert eine Äquivalenzrelation bei Objektverweisen, die nicht null sind:

  • Der Wert ist reflexiv: für jeden Referenzwert, der nicht null ist. x, x.equals(x) sollte Folgendes zurückgeben: true
  • Sie ist symmetrisch: für alle Nicht-Null-Referenzwerte. x und y, x.equals(y) sollte true nur dann zurückgeben, wenn y.equals(x) gibt true zurück.
  • Sie ist transitiv: für alle Referenzwerte, die nicht Null sind. x, y und z, wenn x.equals(y) gibt true und y.equals(z) gibt true zurück, dann x.equals(z) sollte true zurückgeben.
  • Es ist Consistency: für alle Referenzwerte, die nicht null sind. x und y, mehrere Aufrufe von „x.equals(y)“ gibt regelmäßig true zurück oder regelmäßig false zurückgeben, sofern keine Informationen, die in equals Vergleichen auf der -Objekte geändert.
  • Für jeden Nicht-Null-Referenzwert x x.equals(null) sollte false zurückgeben.

Die Methode equals für die Klasse Object implementiert die differenzierteste Äquivalenzbeziehung für Objekte; d. h. für alle Referenzwerte, die nicht Null sind, x und y, gibt diese Methode nur dann true zurück, wenn sich x und y auf dasselbe Objekt beziehen (x == y hat den Wert true).

Beachten Sie, dass es im Allgemeinen erforderlich ist, hashCode , wenn diese Methode überschrieben wird, damit die allgemeinen Vertrag für die hashCode-Methode, der besagt, dass gleiche Objekte dieselben Hash-Codes haben müssen.

Parameter
o Object: das Referenzobjekt, mit dem verglichen werden soll.

Returns
boolean true, wenn dieses Objekt mit dem Objekt identisch ist Argument; Andernfalls false.

getAdId (GetAdId)

In API-Level 34 hinzugefügt
Auch in Ad Services Extensions 4 hinzugefügt
public String getAdId ()

Die Werbe-ID.

Der Wert der Werbe-ID hängt von einer Kombination aus isLimitAdTrackingEnabled() und AdServicesPermissions.ACCESS_ADSERVICES_AD_ID ab.

Ist der Nutzer limiting ad tracking, gibt die API ZERO_OUT. So ist es einem Aufrufer nicht möglich, den Nutzer zu Monetarisierungszwecken zu beobachten.

Andernfalls wird eine eindeutige Zeichenfolge für das Gerät und den Nutzer zurückgegeben, die für das Tracking zu Werbezwecken nutzen.

Returns
String Dieser Wert darf nicht null sein.

hashCode

In API-Level 34 hinzugefügt
public int hashCode ()

Gibt einen Hash-Code-Wert für das Objekt zurück. Diese Methode ist werden zugunsten von Hash-Tabellen unterstützt, z. B. den von HashMap

Der allgemeine Vertrag von hashCode lautet:

  • Wenn es während eines bestimmten Zeitraums mehrmals für dasselbe Objekt aufgerufen wird eine Ausführung einer Java-Anwendung, die Methode hashCode muss konsistent dieselbe Ganzzahl zurückgeben, sofern keine Informationen vorhanden sind. die in equals-Vergleichen für das Objekt verwendet werden, wird geändert. Diese Ganzzahl muss bei einer Ausführung eines Anwendung auf eine andere Ausführung derselben Anwendung anwenden.
  • Wenn zwei Objekte gemäß equals(Object) gleich sind und dann die Methode hashCode für jede der müssen die beiden Objekte dasselbe ganzzahlige Ergebnis liefern.
  • Wenn zwei Objekte ungleich sind, ist es nicht erforderlich, laut equals(java.lang.Object) und dann die Methode hashCode für jede der müssen eindeutige, ganzzahlige Ergebnisse liefern. Die Programmierer sollten sich bewusst sein, dass eindeutige ganzzahlige Ergebnisse für ungleiche Objekte kann die Leistung von Hash-Tabellen verbessern.

So weit es vernünftigerweise praktisch ist, wurde die hashCode-Methode nach der Klasse Object gibt eindeutige Ganzzahlen für unterschiedliche Objekte erstellen. (Der hashCode kann, muss aber nicht als Funktion der Speicheradresse eines Objekts rechtzeitig erkennen.)

Returns
int einen Hash-Code-Wert für dieses Objekt.

isLimitAdTrackingEnabled

In API-Level 34 hinzugefügt
Auch in Ad Services Extensions 4 hinzugefügt
public boolean isLimitAdTrackingEnabled ()

Ruft die Einstellung "Limit für Anzeigen-Tracking aktiviert" ab

Dieser Wert ist „true“, wenn der Nutzer das Limit für Anzeigen-Tracking aktiviert hat, andernfalls false.

Returns
boolean

toString

In API-Level 34 hinzugefügt
public String toString ()

Gibt eine Stringdarstellung des Objekts zurück. Im Allgemeinen Die Methode toString gibt einen String zurück, „textuell dargestellt“ für dieses Objekt. Das Ergebnis sollte eine prägnante, aber informative Darstellung zu sein, Person zu lesen. Es wird empfohlen, diese Methode von allen abgeleiteten Klassen zu überschreiben.

Die Methode toString für die Klasse Object gibt eine Zeichenfolge zurück, die aus dem Namen der Klasse besteht, von der das -Objekt eine Instanz ist, das At-Zeichen "@" und Die vorzeichenlose hexadezimale Darstellung des Hash-Codes des -Objekt enthält. Mit anderen Worten, diese Methode gibt einen String zurück, der dem Wert von:

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

Returns
String Entspricht einer Zeichenfolgendarstellung des Objekts.