AdSelectionConfig

public final class AdSelectionConfig
extends Object implements Parcelable

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

Enthält die Konfiguration des Anzeigenauswahlprozesses.

Instanzen dieser Klasse werden von SDKs erstellt, um als Argumente für die Methoden AdSelectionManager.selectAds(AdSelectionConfig, Executor, OutcomeReceiver) und AdSelectionManager#reportImpression in AdSelectionManager zur Verfügung gestellt zu werden.

Zusammenfassung

Verschachtelte Klassen

class AdSelectionConfig.Builder

Builder for AdSelectionConfig object. 

Übernommene Konstanten

int CONTENTS_FILE_DESCRIPTOR

Mit describeContents() verwendetes Deskriptor-Bit: Gibt an, dass die vereinfachte Darstellung des Parcelable-Objekts einen Dateideskriptor enthält.

int PARCELABLE_WRITE_RETURN_VALUE

Flag zur Verwendung mit writeToParcel(Parcel, int): Das zu schreibende Objekt ist ein Rückgabewert, der das Ergebnis einer Funktion wie „Parcelable someFunction()“, „void someFunction(out Parcelable)“ oder „void someFunction(inout Parcelable)“ ist.

Felder

public static final Creator<AdSelectionConfig> CREATOR

Öffentliche Methoden

int describeContents()

Beschreiben Sie die Arten von speziellen Objekten, die in der marshallierten Darstellung dieser Parcelable-Instanz enthalten sind.

boolean equals(Object o)

Gibt an, ob ein anderes Objekt mit diesem Objekt „identisch“ ist.

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

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

void writeToParcel(Parcel dest, int flags)

Dieses Objekt zu einem Parzel liegend zusammenführen.

Übernommene Methoden

Object clone()

Erstellt eine Kopie dieses Objekts und gibt sie zurück.

boolean equals(Object obj)

Gibt an, ob ein anderes Objekt mit diesem Objekt „identisch“ ist.

void finalize()

Wird vom Garbage Collector für ein Objekt aufgerufen, wenn die Garbage Collection feststellt, dass keine Verweise mehr auf das Objekt vorhanden sind.

final Class<?> getClass()

Gibt die Laufzeitklasse dieses Object-Objekts zurück.

int hashCode()

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

final void notify()

Weckt einen einzelnen Thread auf, der auf dem Monitor dieses Objekts wartet.

final void notifyAll()

Weckt alle Threads auf, die auf dem Monitor dieses Objekts warten.

String toString()

Gibt eine Stringdarstellung des Objekts zurück.

final void wait(long timeoutMillis, int nanos)

Der aktuelle Thread wartet, bis er geweckt wird, normalerweise durch Benachrichtigung oder Unterbrechung oder bis eine bestimmte Zeit in Echtzeit verstrichen ist.

final void wait(long timeoutMillis)

Veranlasst, dass der aktuelle Thread wartet, bis er erwacht ist, in der Regel durch eine Benachrichtigung oder Unterbrechung, oder bis eine bestimmte Zeit in Echtzeit verstrichen ist.

final void wait()

Der aktuelle Thread wartet, bis er geweckt wird, normalerweise durch Benachrichtigung oder Unterbrechung.

abstract int describeContents()

Beschreiben Sie die Arten von speziellen Objekten, die in der marshallierten Darstellung dieser Parcelable-Instanz enthalten sind.

abstract void writeToParcel(Parcel dest, int flags)

Dieses Objekt zu einem Parzel liegend zusammenführen.

Felder

CREATOR

Hinzugefügt in API-Ebene 34
Auch in Anzeigenserviceerweiterungen 4 
public static final Creator<AdSelectionConfig> CREATOR

Öffentliche Methoden

describeContents

Hinzugefügt in API-Level 34 
public int describeContents ()

Beschreiben Sie die Arten von speziellen Objekten, die in der marshallierten Darstellung dieser Parcelable-Instanz enthalten sind. Wenn das Objekt beispielsweise einen Dateideskriptor in der Ausgabe von writeToParcel(android.os.Parcel, int) enthält, muss der Rückgabewert dieser Methode das CONTENTS_FILE_DESCRIPTOR-Bit enthalten.

Returns
int Eine Bitmaske, die die speziellen Objekttypen angibt, die von dieser Parcelable-Objektinstanz marshaled werden. Der Wert ist entweder 0 oder CONTENTS_FILE_DESCRIPTOR.

ist gleich

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

Gibt an, ob ein anderes Objekt mit diesem Objekt „identisch“ ist.

Die Methode equals implementiert eine Äquivalenzrelation für Nicht-Null-Objektverweise:

  • Sie ist reflexiv: Für jeden nicht nullwertigen Referenzwert x sollte x.equals(x) den Wert true zurückgeben.
  • Sie ist symmetrisch: Für alle nicht nullwertigen Referenzwerte x und y sollte x.equals(y) true zurückgeben, wenn und nur wenn y.equals(x) true zurückgibt.
  • Sie ist transitiv: Wenn für alle nicht nullwertigen Referenzwerte x, y und z x.equals(y) den Wert true und y.equals(z) den Wert true zurückgibt, sollte x.equals(z) den Wert true zurückgeben.
  • Sie ist konsistent: Bei allen nicht nullwertigen Referenzwerten x und y geben mehrere Aufrufe von x.equals(y) immer true oder immer false zurück, sofern keine Informationen, die in equals-Vergleichen für die Objekte verwendet werden, geändert werden.
  • Für jeden nicht nullwertigen Referenzwert x sollte x.equals(null) false zurückgeben.

Die Methode equals für die Klasse Object implementiert die unterschiedlichste mögliche Äquivalenzbeziehung für Objekte. Das bedeutet, dass diese Methode für alle Nicht-Null-Referenzwerte x und y nur dann true zurückgibt, wenn x und y auf dasselbe Objekt verweisen (x == y hat den Wert true).

Beachten Sie, dass die hashCode-Methode in der Regel überschrieben werden muss, wenn diese Methode überschrieben wird, um den allgemeinen Vertrag für die hashCode-Methode einzuhalten, 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 Argument „obj“ identisch ist, andernfalls false.

getAdSelectionSignals

public AdSelectionSignals getAdSelectionSignals ()

Returns
AdSelectionSignals JSON in einem AdSelectionSignals-Objekt, das aus der AdSelectionConfig abgerufen und von der JS-Logik aus der DSP verwendet wird, stellt Signale dar, die den teilnehmenden Käufern bei der Anzeigenauswahl und Berichterstellung gegeben werden. Dieser Wert darf nicht null sein.

getCustomAudienceBuyers

public List<AdTechIdentifier> getCustomAudienceBuyers ()

Returns
List<AdTechIdentifier> Eine Liste der Käufer von benutzerdefinierten Zielgruppen, die von der SSP an der Anzeigenauswahl teilnehmen dürfen. Dieser Wert darf nicht null sein.

getDecisionLogicUri

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

Returns
Uri Der URI, über den der JS-Code mit der Funktion „scoreAd“ des Verkäufers/SSP abgerufen wird, die bei der Anzeigenauswahl und bei der Berichterstellung verwendet wird. Dieser Wert darf nicht null sein.

getPerBuyerSignales (GetPerBuyerSignals)

public Map<AdTechIdentifier, AdSelectionSignals> getPerBuyerSignals ()

Returns
Map<AdTechIdentifier, AdSelectionSignals> Eine Zuordnung von Käufern und Anzeigenauswahlsignalen, die aus der Anzeigenauswahlkonfiguration abgerufen und von der JS-Logik aus der DSP verwendet wird. Sie enthält alle Informationen, die die einzelnen Käufer bei der Anzeigenauswahl an die Teilnehmer weitergeben würden (z. B. Gebotsuntergrenze, Anzeigenauswahltyp usw.). Dieser Wert darf nicht null sein.

getSeller

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

Returns
AdTechIdentifier eine AdTechIdentifier des Verkäufers, z. B. „www.beispiel-ssp.com“ Dieser Wert darf nicht null sein.

GetSellerSignals

public AdSelectionSignals getSellerSignals ()

Returns
AdSelectionSignals JSON in einem AdSelectionSignals-Objekt, das von der SSP bereitgestellt und von der JS-Logik verwendet wird, die von der SSP abgerufen wird, stellt alle Informationen dar, die die SSP beim Bewerten von Anzeigen verwendet hat, um die Ergebnisse des Anzeigenauswahlprozesses anzupassen (z.B. Markensicherheitsüberprüfungen, ausgeschlossene kontextbezogene Anzeigen). Dieser Wert darf nicht null sein.

getTrustedScoringSignalsUri

public Uri getTrustedScoringSignalsUri ()

Returns
Uri URI-Endpunkt eines vertrauenswürdigen Signals auf Verkäuferseite, von dem Creative-spezifische Echtzeitinformationen abgerufen werden können. Dieser Wert darf nicht null sein.

hashCode

Hinzugefügt in API-Level 34 
public int hashCode ()

Gibt einen Hash-Codewert für das Objekt zurück. Diese Methode wird für Hashtabellen wie die von HashMap unterstützt.

Der allgemeine Vertrag von hashCode ist:

  • Wenn die hashCode-Methode während der Ausführung einer Java-Anwendung mehrmals auf dasselbe Objekt aufgerufen wird, muss sie jedes Mal dieselbe Ganzzahl zurückgeben, sofern keine Informationen, die in equals-Vergleichen für das Objekt verwendet werden, geändert werden. Diese Ganzzahl muss nicht bei jeder Ausführung einer Anwendung gleich bleiben.
  • Wenn zwei Objekte gemäß der Methode equals(Object) gleich sind, muss das Aufrufen der Methode hashCode für jedes der beiden Objekte dasselbe ganzzahlige Ergebnis erzeugen.
  • Wenn zwei Objekte gemäß der equals(java.lang.Object)-Methode nicht gleich sind, ist es nicht erforderlich, dass der Aufruf der hashCode-Methode für jedes der beiden Objekte unterschiedliche Ganzzahlergebnisse liefert. Der Programmierer sollte sich jedoch bewusst sein, dass die Leistung von Hash-Tabellen verbessert werden kann, wenn für ungleiche Objekte unterschiedliche Ganzzahlergebnisse ausgegeben werden.

Die von der Klasse Object definierte hashCode-Methode gibt nach Möglichkeit unterschiedliche Ganzzahlen für unterschiedliche Objekte zurück. (Der hashCode kann zu einem bestimmten Zeitpunkt als Funktion der Arbeitsspeicheradresse eines Objekts implementiert werden oder nicht.)

Returns
int einen Hash-Codewert für dieses Objekt.

writeToParcel

Hinzugefügt in API-Level 34 
public void writeToParcel (Parcel dest, 
                int flags)

Dieses Objekt zu einem Parzel liegend zusammenführen.

Parameter
dest Parcel: Dieser Wert darf nicht null sein.
flags int: Zusätzliche Flags, die angeben, wie das Objekt geschrieben werden soll. Kann 0 oder Parcelable.PARCELABLE_WRITE_RETURN_VALUE sein. Der Wert ist entweder 0 oder eine Kombination aus Parcelable.PARCELABLE_WRITE_RETURN_VALUE und android.os.Parcelable.PARCELABLE_ELIDE_DUPLICATES