UserListSelector

Enthält die Methoden zum Filtern und Sortieren einer Liste von Benutzerlisten im Konto. Informationen zu Selektoren finden Sie unter Selektoren.

Methoden

Methodenname Rückgabetyp Beschreibung
get UserListIterator Ruft einen Iterator ab, der zum Durchlaufen der Liste der Benutzerlisten verwendet wird.
orderBy(string orderBy) UserListSelector Wendet die angegebene Reihenfolge auf die ausgewählten Benutzerlisten an.
withCondition(string condition) UserListSelector Wendet Filterkriterien auf die Benutzerlisten an.
withIds(string[] ids) UserListSelector Ruft Benutzerlisten mit den angegebenen IDs ab.
withLimit(int limit) UserListSelector Ruft die ersten n Benutzerlisten ab, die den Auswahlkriterien entsprechen.

Abrufen

Ruft einen Iterator ab, der zum Durchlaufen der Liste der Benutzerlisten verwendet wird.

Rückgabewerte

Typ Beschreibung
UserListIterator Ein Iterator, der zum Durchlaufen der ausgewählten Benutzerlisten verwendet wird.

orderBy(string orderBy)

Wendet die angegebene Reihenfolge auf die ausgewählten Benutzerlisten an.

Geben Sie den Parameter orderBy im Format "columnName orderDirection" an, wobei:

  • columnName is one of the [supported columns](#supported-user list-columns).
  • orderDirection ist die Reihenfolge, in der die Ergebnisse sortiert werden sollen. Legen Sie die Option auf ASC fest, um die Ergebnisse in aufsteigender Reihenfolge zu sortieren, oder auf DESC, um sie in absteigender Reihenfolge zu sortieren. Der Standardwert ist ASC.

Der folgende Aufruf gibt beispielsweise Ergebnisse in aufsteigender Reihenfolge nach dem Namen der Benutzerliste zurück.

selector = selector.orderBy("Name");

Selektoren unterstützen die Sortierung von Entitäten nach nur einem Feld. Sie dürfen die Liste der Entitäten nicht nach dem Feld x und innerhalb von x nach dem Feld y usw. ordnen. Wenn Sie mehr als einen orderBy() Aufruf in einer Kette oder in separaten Selektoraufrufen angeben, sortiert Scripts die Liste der Entitäten mithilfe des im letzten orderBy() Aufruf angegebenen Felds. 

Argumente

Name Typ Beschreibung
orderBy string Die anzuwendende Reihenfolge.

Rückgabewerte

Typ Beschreibung
UserListSelector Selektor mit angewendeter Reihenfolge.

withCondition(String condition)

Wendet Filterkriterien auf die Benutzerlisten an.

Geben Sie den Bedingungsparameter im Format "Wert des Operators columnName" an, wobei:

  • columnName is one of the [supported columns](#supported-user list-columns).
  • operator ist einer der unterstützten Operatoren.

Operatoren

Der Operator, den Sie verwenden, hängt vom Typ der Spalte ab. Bei Operatoren wird die Groß-/Kleinschreibung beachtet. Verwenden Sie beispielsweise STARTS_WITH anstelle von starts_with.

Operatoren für Spalten, die ganze Zahlen und lange Werte enthalten:

<
<=
>
>=
=
!=

Operatoren für Spalten, die doppelte Werte enthalten:

<
>

Operatoren für Spalten, die Zeichenfolgenwerte enthalten:

=
!=
STARTS_WITH
STARTS_WITH_IGNORE_CASE
CONTAINS
CONTAINS_IGNORE_CASE
DOES_NOT_CONTAIN
DOES_NOT_CONTAIN_IGNORE_CASE

Operatoren für Spalten, die Enumerationswerte enthalten:

=
!=
IN []
NOT_IN []

Operatoren für Spalten, die ein Array von Zeichenfolgen enthalten:

CONTAINS_ALL
CONTAINS_ANY
CONTAINS_NONE

Unterstützte Spalten für die Filterung von Benutzerlisten. Bei Spaltennamen wird die Groß-/Kleinschreibung beachtet.

Spalte Typ Beispiel
Beschreibung string Die Beschreibung der Benutzerliste.

withCondition("Description = 'foo'")
MitgliedschaftLifeSpan int Wie weit zurück (Anzahl von Tagen) Microsoft Advertising nach Aktionen suchen soll, die dieser Benutzerlistendefinition entsprechen.

withCondition("MembershipLifeSpan > 10")
Name string Der Name der Benutzerliste.

withCondition("Name = 'foo'")
SizeForAudienceNetwork long Die Größe der Benutzerliste im Zielgruppennetzwerk.

withCondition("SizeForAudienceNetwork > 1000")
SizeForSearch long Die Größe der Benutzerliste im Zielgruppennetzwerk.

withCondition("SizeForSearch > 1000")
Typ string Der abgeleitete Typ der Benutzerliste. Mögliche Werte für die Groß- und Kleinschreibung sind:
  • BENUTZERDEFINIERT
  • CUSTOMER_LIST
  • IN_MARKET
  • LOGISCH
  • PRODUKT
  • RULE_BASED
  • ÄHNLICH
In diesem Beispiel werden nur Kundenlisten zurückgegeben.

withCondition("Type = CUSTOMER_LIST")

Argumente

Name Typ Beschreibung
Bedingung string Die Bedingung, die dem Selektor hinzugefügt werden soll.

Rückgabewerte

Typ Beschreibung
UserListSelector Selector mit der angewendeten Bedingung.

withIds(string[] ids)

Ruft Benutzerlisten mit den angegebenen IDs ab.

Sie können eine oder mehrere Bedingungen auf einen Selektor anwenden. Eine Kette von Bedingungen wird als UND-Vorgang betrachtet. Beispielsweise wird das Objekt nur ausgewählt, wenn Bedingung A wahr UND Bedingung B wahr ist. Der folgende Aufruf wählt beispielsweise nur die Benutzerliste 33333 aus.

AdsApp.userLists()
    .withIds(['11111', '22222', '33333'])
    .withIds(['33333', '44444', '55555']);

Argumente

Name Typ Beschreibung
ids string[] Ein Array von Benutzerlisten-IDs. Informationen zu Grenzwerten finden Sie unter Skriptausführungslimits.

Rückgabewerte

Typ Beschreibung
UserListSelector Selector mit den angewendeten IDs.

withLimit(int limit)

Ruft die ersten n Benutzerlisten ab, die den Auswahlkriterien entsprechen.

Argumente

Name Typ Beschreibung
Begrenzung int Die Anzahl der Benutzerlisten, die zurückgegeben werden sollen. Die tatsächliche Anzahl kann geringer sein.

Rückgabewerte

Typ Beschreibung
UserListSelector Selektor mit angewendetem Grenzwert.

Siehe auch

  • Last updated on