Benutzerdefinierte Zielgruppe

public final class CustomAudience
extends Object implements Parcelable

java.lang.Object
😎 android.adservices.customaudience.CustomAudience


Die Informationen, die für eine benutzerdefinierte Zielgruppe zur Anzeigenauswahl erforderlich sind.

Eine benutzerdefinierte Zielgruppe ist eine abstrakte Gruppe von Nutzern mit ähnlichen Interessen. Dieses Bei der Klasse handelt es sich um eine Sammlung einiger Daten, die auf einem Gerät gespeichert sind und die für die Schaltung von Werbung erforderlich sind. auf eine benutzerdefinierte Zielgruppe ausgerichtet sind.

Zusammenfassung

Verschachtelte Klassen

class CustomAudience.Builder

Builder für CustomAudience-Objekte. 

Übernommene Konstanten

Felder

public static final Creator<CustomAudience> CREATOR

Öffentliche Methoden

boolean equals(Object o)

Prüft, ob zwei CustomAudience-Objekte dieselben Informationen enthalten.

Instant getActivationTime()

Beim Erstellen des CustomAudience-Objekts kann eine optionale Aktivierungszeit festgelegt werden in um eine verzögerte Aktivierung zu ermöglichen.

List<AdData> getAds()

Diese Liste mit AdData Objekten ist eine vollständige Liste der Anzeigen, die in die von diesem CustomAudience bei der Anzeigenauswahl ausgeliefert werden.

Uri getBiddingLogicUri()

Gibt den Ziel-URI zurück, der zum Abrufen der Gebotslogik verwendet wird, wenn eine benutzerdefinierte Zielgruppe am Anzeigenauswahlprozess.

AdTechIdentifier getBuyer()

Ein Käufer wird durch eine Domain im Format „buyerbeispiel.de“ identifiziert.

Uri getDailyUpdateUri()

Dieser URI verweist auf einen vom Käufer betriebenen Server, auf dem aktualisierte Gebotsdaten und Anzeigenmetadaten gehostet werden. die bei der Anzeigenauswahl auf dem Gerät verwendet werden.

Instant getExpirationTime()

Nach Ablauf der Ablaufzeit kann eine benutzerdefinierte Zielgruppe nicht mehr täglich verwendet werden Aktualisierung der Anzeigen-/Gebotsdaten oder Teilnahme an der Anzeigenauswahl

String getName()

Der Name der benutzerdefinierten Zielgruppe ist ein beliebiger String, der vom Inhaber und Käufer bei der Erstellung angegeben wird des CustomAudience-Objekts.

TrustedBiddingData getTrustedBiddingData()

Daten zu vertrauenswürdigen Geboten bestehen aus einem URI, der auf einen vertrauenswürdigen Server für Käufer Gebotsdaten und eine Liste der Schlüssel zum Abfragen des Servers.

AdSelectionSignals getUserBiddingSignals()

Gebote für Nutzer werden optional von Käufern bereitgestellt und von den vom Käufer bereitgestellten Signalen genutzt. JavaScript bei der Anzeigenauswahl in einer isolierten Ausführungsumgebung

int hashCode()

Gibt den Hash der Daten des CustomAudience-Objekts zurück.

void writeToParcel(Parcel dest, int flags)

Dieses Objekt in einem Paket zusammenfassen.

Übernommene Methoden

Felder

CREATOR

In API-Level 34 hinzugefügt
Auch in Ad Services Extensions 4 hinzugefügt
public static final Creator<CustomAudience> CREATOR

Öffentliche Methoden

ist gleich

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

Prüft, ob zwei CustomAudience-Objekte dieselben Informationen enthalten.

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

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

getActivationTime (Zeit der Aktivierung)

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

Beim Erstellen des CustomAudience-Objekts kann eine optionale Aktivierungszeit festgelegt werden in um eine verzögerte Aktivierung zu ermöglichen. Wenn das Feld nicht festgelegt ist, wird CustomAudience zum Zeitpunkt des Beitritts aktiviert.

Eine benutzerdefinierte Zielgruppe für inaktive Nutzer wird beispielsweise erst aktiviert, wenn Inaktivität erreicht wird, sodass die Anzeigen der benutzerdefinierten Zielgruppe an der Anzeige teilnehmen. Auswahlprozess und möglicherweise werden inaktive Nutzer zur ursprünglichen Inhaberanwendung weitergeleitet.

Die maximale Verzögerung bei der Aktivierung beträgt 60 Tage ab Erstellung.

Wenn die Aktivierungszeit angegeben wird, muss sie vor der Ablaufzeit liegen.

Returns
Instant den Zeitstempel Instant, gekürzt auf Millisekunden, nach dem die benutzerdefinierte Zielgruppe ist aktiv Dieser Wert kann null sein.

getAds

In API-Level 34 hinzugefügt
Auch in Ad Services Extensions 4 hinzugefügt
public List<AdData> getAds ()

Diese Liste mit AdData Objekten ist eine vollständige Liste der Anzeigen, die in die von diesem CustomAudience bei der Anzeigenauswahl ausgeliefert werden.

Wenn keine Angabe oder eine leere Liste vorhanden ist, wird für CustomAudience kein an der Anzeigenauswahl teilnehmen, bis eine gültige Liste von Anzeigen über die tägliche Aktualisierung für der benutzerdefinierten Zielgruppe.

Returns
List<AdData> ein List von AdData-Objekten, die Anzeigen darstellen, die derzeit vom benutzerdefinierte Zielgruppe Dieser Wert darf nicht null sein.

getBiddingLogicUri

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

Gibt den Ziel-URI zurück, der zum Abrufen der Gebotslogik verwendet wird, wenn eine benutzerdefinierte Zielgruppe am Anzeigenauswahlprozess. Für den URI muss HTTPS verwendet werden.

Returns
Uri URI zum Abrufen der Gebotslogik des Käufers Dieser Wert darf nicht null sein.

getBuyer

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

Ein Käufer wird durch eine Domain im Format „buyerbeispiel.de“ identifiziert.

Returns
AdTechIdentifier Eine AdTechIdentifier mit der Domain des Käufers der benutzerdefinierten Zielgruppe Dieser Wert darf nicht null sein.

getDailyUpdateUri

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

Dieser URI verweist auf einen vom Käufer betriebenen Server, auf dem aktualisierte Gebotsdaten und Anzeigenmetadaten gehostet werden. die bei der Anzeigenauswahl auf dem Gerät verwendet werden. Für den URI muss HTTPS verwendet werden.

Returns
Uri URI für tägliche Updates der benutzerdefinierten Zielgruppe Dieser Wert darf nicht null sein.

getExpirationTime (getExpirationTime)

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

Nach Ablauf der Ablaufzeit kann eine benutzerdefinierte Zielgruppe nicht mehr täglich verwendet werden Aktualisierung der Anzeigen-/Gebotsdaten oder Teilnahme an der Anzeigenauswahl Die benutzerdefinierte Zielgruppe werden bei der nächsten täglichen Aktualisierung aus dem Arbeitsspeicher gelöscht.

Wenn beim Erstellen von CustomAudience keine Ablaufzeit angegeben wird, gilt Folgendes: standardmäßig 60 Tage nach der Aktivierung.

Die maximale Gültigkeitsdauer beträgt 60 Tage ab der ersten Aktivierung.

Returns
Instant den Zeitstempel Instant, gekürzt auf Millisekunden, nach dem die benutzerdefinierte Zielgruppe entfernt werden sollte, Dieser Wert kann null sein.

getName

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

Der Name der benutzerdefinierten Zielgruppe ist ein beliebiger String, der vom Inhaber und Käufer bei der Erstellung angegeben wird des CustomAudience-Objekts.

Returns
String Stringname der benutzerdefinierten Zielgruppe Dieser Wert darf nicht null sein.

Vertrauenswürdige Gebotsdaten

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

Daten zu vertrauenswürdigen Geboten bestehen aus einem URI, der auf einen vertrauenswürdigen Server für Käufer Gebotsdaten und eine Liste der Schlüssel zum Abfragen des Servers. Die Schlüssel sind willkürliche Kennungen. der nur verwendet wird, um während der Anzeige die Gebotslogik eines Käufers vom vertrauenswürdigen Server abzufragen. Auswahl.

Wenn keine Angabe erfolgt, nimmt CustomAudience erst an der Anzeigenauswahl teil, wenn Trusted Bidding-Daten werden über die tägliche Aktualisierung für die benutzerdefinierte Zielgruppe bereitgestellt.

Returns
TrustedBiddingData Ein TrustedBiddingData-Objekt, das die vertrauenswürdigen Gebote der benutzerdefinierten Zielgruppe enthält Daten Dieser Wert kann null sein.

getUserBiddingSignals

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

Gebote für Nutzer werden optional von Käufern bereitgestellt und von den vom Käufer bereitgestellten Signalen genutzt. JavaScript bei der Anzeigenauswahl in einer isolierten Ausführungsumgebung

Wenn die Gebotssignale der Nutzer kein gültiges JSON-Objekt sind, das vom JS des Käufers verwenden, kommt die benutzerdefinierte Zielgruppe nicht für die Anzeigenauswahl infrage.

Wenn keine Angabe erfolgt, nimmt CustomAudience erst an der Anzeigenauswahl teil, wenn Gebotssignale für Nutzer werden über die tägliche Aktualisierung für die benutzerdefinierte Zielgruppe bereitgestellt.

Returns
AdSelectionSignals Ein AdSelectionSignals-Objekt, das die Gebotssignale des Nutzers für die benutzerdefinierte Zielgruppe Dieser Wert kann null sein.

hashCode

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

Gibt den Hash der Daten des CustomAudience-Objekts zurück.

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

writeToParcel

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

Dieses Objekt in einem Paket zusammenfassen.

Parameter
dest Parcel: Dieser Wert darf nicht null sein.

flags int: Zusätzliche Flags, die festlegen, 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