BingAdsAccountSelector

Enthält die Methoden zum Filtern und Sortieren der Liste der Konten, auf die der Benutzer Zugriff hat. Informationen zu Selektoren finden Sie unter Selektoren.

Anwendungsbeispiel:

    var accounts = AccountsApp.accounts()
        .withCondition("Name CONTAINS_IGNORE_CASE 'PARTIAL ACCOUNT NAME GOES HERE'")
        .get();

    while (accounts.hasNext()) {
        var account = accounts.next();
    }

Methoden

Methodenname Rückgabetyp Beschreibung
executeInParallel(string functionName, string optionalCallbackFunctionName) void Führt die Funktion für jedes Konto aus, das vom Selektor zurückgegeben wird.
executeInParallel(string functionName, string optionalCallbackFunctionName, string optionalInput) void Führt die Funktion für jedes Konto aus, das vom Selektor zurückgegeben wird.
forDateRange(Object dateFrom, Object dateTo) BingAdsAccountSelector Wendet das Start- und Enddatum für die Auswahl von Performance-Kennzahlen an.
forDateRange(string dateRange) BingAdsAccountSelector Wendet den vordefinierten Datumsbereich für die Auswahl von Performance-Kennzahlen an.
get BingAdsAccountIterator Ruft einen Iterator ab, der zum Durchlaufen der Liste der Konten verwendet wird.
orderBy(string orderBy) BingAdsAccountSelector Wendet die angegebene Reihenfolge auf die ausgewählten Konten an.
withAccountNumbers(string[] accountNumbers) BingAdsAccountSelector Ruft Konten mit den angegebenen Kontonummern ab.
withCondition(string condition) BingAdsAccountSelector Wendet Filterkriterien auf die Konten an.
withIds(string[] ids) BingAdsAccountSelector Ruft Konten mit den angegebenen IDs ab.
withLimit(int limit) BingAdsAccountSelector Ruft die ersten n Konten ab, die den Auswahlkriterien entsprechen.

executeInParallel(string functionName, string optionalCallbackFunctionName)

Führt die Funktion für jedes Konto aus, das vom Selektor zurückgegeben wird. Nachdem die Funktion für alle ausgewählten Konten ausgeführt wurde, ruft Scripts die optionale Rückruffunktion auf.

Hinweis

Das Skript kann bei jeder Ausführung des Skripts maximal 50 Konten parallel ausführen. Sie können diese Methode einmal oder mehrmals aufrufen, aber die Gesamtzahl der Konten, die alle Aufrufe verarbeiten, darf 50 nicht überschreiten. Wenn ein Aufruf das Maximum von 50 Konten für das Skript überschreitet, wird keines der Konten im Aufruf ausgeführt. Um die Anzahl der Konten zu begrenzen, die der Selektor zurückgibt, können Sie die withLimit ODER-Methode withIds verwenden.

Die Funktion functionName kann einen Wert als Zeichenfolge zurückgeben. Um ein komplexes Objekt zurückzugeben, verwenden Sie die JSON.stringify-Methode, um das Objekt in eine Zeichenfolge zu konvertieren. Anschließend können Sie die Methode JSON.parse verwenden, um die Zeichenfolge wieder in ein Objekt zu konvertieren. Wenn Ihre Funktion einen Wert zurückgibt, müssen Sie eine Rückruffunktion angeben, um die Rückgabewerte zu erfassen. Im Folgenden wird die Signatur der Rückruffunktion gezeigt. Die zurückgegebenen Werte werden als Array von ExecutionResult-Objekten übergeben.

function myCallback(ExecutionResult[] results)

Im folgenden Beispiel wird gezeigt, wie die zurückgegebenen Werte in der Rückruffunktion verarbeitet werden.

function myCallback(results) {
    for (var result of results) {
        var object = JSON.parse(result.getReturnValue());
    }
}

Da diese Methode kein BingAdsAccountSelector-Objekt zurückgibt, stellen Sie sicher, dass dies die letzte Selektormethode in der Aufrufkette ist.

Ein Beispiel hierzu finden Sie unter Ermitteln abgelehnter Anzeigen.

Argumente

Name Typ Beschreibung
functionName string Der Name der Funktion, die für jedes Konto ausgeführt werden soll, das vom Selektor zurückgegeben wird. Die currentAccount-Methode identifiziert das Konto, das von der Funktion verarbeitet wird.
optionalCallbackFunctionName string Optional. Der Name der Funktion, die ausgeführt werden soll, nachdem alle Konten die Ausführung der Funktion functionName abgeschlossen haben. Diese Funktion wird nur einmal ausgeführt.

Rückgabewerte

Typ Beschreibung
void Gibt Nothing zurück.

executeInParallel(string functionName, string optionalCallbackFunctionName, string optionalInput)

Führt die Funktion für jedes Konto aus, das vom Selektor zurückgegeben wird. Nachdem die Funktion für alle ausgewählten Konten ausgeführt wurde, ruft Scripts die optionale Rückruffunktion auf.

Hinweis

Das Skript kann bei jeder Ausführung des Skripts maximal 50 Konten parallel ausführen. Sie können diese Methode einmal oder mehrmals aufrufen, aber die Gesamtzahl der Konten, die alle Aufrufe verarbeiten, darf 50 nicht überschreiten. Wenn ein Aufruf das Maximum von 50 Konten für das Skript überschreitet, wird keines der Konten im Aufruf ausgeführt. Um die Anzahl der Konten zu begrenzen, die der Selektor zurückgibt, können Sie die withLimit ODER-Methode withIds verwenden.

Die Funktion functionName kann einen Wert als Zeichenfolge zurückgeben. Um ein komplexes Objekt zurückzugeben, verwenden Sie die JSON.stringify-Methode, um das Objekt in eine Zeichenfolge zu konvertieren. Anschließend können Sie die Methode JSON.parse verwenden, um die Zeichenfolge wieder in ein Objekt zu konvertieren. Wenn Ihre Funktion einen Wert zurückgibt, müssen Sie eine Rückruffunktion angeben, um die Rückgabewerte zu erfassen. Im Folgenden wird die Signatur der Rückruffunktion gezeigt. Die zurückgegebenen Werte werden als Array von ExecutionResult-Objekten übergeben.

function myCallback(ExecutionResult[] results)

Im folgenden Beispiel wird gezeigt, wie die zurückgegebenen Werte in der Rückruffunktion verarbeitet werden.

function myCallback(results) {
    for (var result of results) {
        var object = JSON.parse(result.getReturnValue());
    }
}

Wenn Sie den optionalen Eingabeparameter übergeben, wird die Signatur der Funktion functionName im Folgenden angezeigt.

function myFunction(string optionalInput)

Da diese Methode kein BingAdsAccountSelector-Objekt zurückgibt, stellen Sie sicher, dass dies die letzte Selektormethode in der Aufrufkette ist.

Ein Beispiel hierzu finden Sie unter Ermitteln abgelehnter Anzeigen.

Argumente

Name Typ Beschreibung
functionName string Der Name der Funktion, die für jedes Konto ausgeführt werden soll, das vom Selektor zurückgegeben wird. Die currentAccount-Methode identifiziert das Konto, das von der Funktion verarbeitet wird.
optionalCallbackFunctionName string Optional. Der Name der Funktion, die ausgeführt werden soll, nachdem alle Konten die Ausführung der Funktion functionName abgeschlossen haben. Diese Funktion wird nur einmal ausgeführt.
optionalInput string Optional. Eingabe, die an die Funktion functionName übergeben werden soll.

Rückgabewerte

Typ Beschreibung
void Gibt Nothing zurück.

forDateRange(Object dateFrom, Object dateTo)

Wendet das Start- und Enddatum für die Auswahl von Performance-Kennzahlen an.

Geben Sie nur einen Datumsbereich an, wenn:

  • Sie wenden Bedingungen oder Reihenfolgen an, die auf Felder für Performance-Kennzahlen verweisen.
  • Sie möchten Leistungsdaten für die Objekte abrufen, die Sie auswählen. Beispielsweise, wenn Sie die getStats() Methode aufrufen möchten.

Sie können die Datumsparameter mithilfe von Zeichenfolgen oder Objekten angeben. Um Zeichenfolgen zu verwenden, geben Sie das Datum im Formular JJJJMMTT an. Wenn Sie Objekte verwenden, erstellen Sie ein Objekt mit den folgenden Feldern:

  • Jahr
  • Monat
  • Tag

Zum Beispiel:

var date = {year: 2018, month: 5, day: 13};

Es handelt sich um einen Monat, wobei 1 für Januar und 12 für Dezember steht.

Der Datumsbereich ist einschließlich Datum. Wenn Sie mehrere Datumsbereiche angeben, wird nur der letzte Datumsbereich verwendet.

Argumente

Name Typ Beschreibung
dateFrom Objekt Das Startdatum des Datumsbereichs, der die Leistungsdaten angibt, die in den Selektor aufgenommen werden sollen.
dateTo Objekt Das Enddatum des Datumsbereichs, der die Leistungsdaten angibt, die in den Selektor aufgenommen werden sollen.

Rückgabewerte

Typ Beschreibung
BingAdsAccountSelector Selektor mit angewendetem Datumsbereich.

forDateRange(String dateRange)

Wendet den vordefinierten Datumsbereich für die Auswahl von Performance-Kennzahlen an.

Unterstützte Datumsbereichswerte:

  • TODAY
  • GESTERN
  • LAST_WEEK
  • LAST_BUSINESS_WEEK
  • LAST_7_DAYS
  • THIS_WEEK_SUN_TODAY
  • LAST_14_DAYS
  • LAST_30_DAYS
  • LAST_WEEK_SUN_SAT
  • THIS_MONTH
  • LAST_MONTH
  • ALL_TIME

Geben Sie nur einen Datumsbereich an, wenn:

  • Sie wenden Bedingungen oder Reihenfolgen an, die auf Felder für Performance-Kennzahlen verweisen.
  • Sie möchten Leistungsdaten für die Objekte abrufen, die Sie auswählen. Beispielsweise, wenn Sie die getStats() Methode aufrufen möchten.

Wenn Sie mehrere Datumsbereiche angeben, wird nur der letzte Datumsbereich verwendet.

Argumente

Name Typ Beschreibung
dateRange Zeichenfolge Die vordefinierte Zeichenfolge für den Datumsbereich, die die Leistungsdaten angibt, die in den Selektor aufgenommen werden sollen. Bei der vordefinierten Datumsbereichszeichenfolge wird zwischen Groß- und Kleinschreibung unterschieden.

Rückgabewerte

Typ Beschreibung
BingAdsAccountSelector Selektor mit angewendetem Datumsbereich.

Abrufen

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

Rückgabewerte

Typ Beschreibung
BingAdsAccount Ein Iterator, der zum Durchlaufen der ausgewählten Konten verwendet wird.

orderBy(string orderBy)

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

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

  • columnName ist eine der unterstützten Spalten.
  • 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 Klicks zurück.

selector = selector.orderBy("Clicks");

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
BingAdsAccountSelector Selektor mit angewendeter Reihenfolge.

withAccountNumbers(string[] accountNumbers)

Ruft Konten mit den angegebenen Kontonummern ab.

Argumente

Name Typ Beschreibung
accountNumbers string[] Ein Array von Kontonummern. Informationen zu Grenzwerten finden Sie unter Skriptausführungslimits.

Rückgabewerte

Typ Beschreibung
BingAdsAccountSelector Auswählen mit angewendeten Kontonummern.

withCondition(String condition)

Wendet Filterkriterien auf die Konten an.

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

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 Kontofilterung. Bei Spaltennamen wird die Groß-/Kleinschreibung beachtet.

Im Folgenden finden Sie die Spalten für Performance-Kennzahlen, die Sie angeben können.

Spalte Typ Beispiel Microsoft Advertising-Webbenutzeroberflächenfilter
ClickConversionRate double withCondition("ClickConversionRate > 0.25") Conv. Rate
Klicks long withCondition("Clicks >= 33") Klicks
ConvertedClicks long withCondition("ConvertedClicks >= 10") Konv.
Kosten double withCondition("Cost > 3.25")

Die Kosten werden in der Währung des Kontos angegeben.		 Kosten
STR double withCondition("Ctr > 0.05")

Die CTR liegt im Bereich von 0..1. Verwenden Sie also 0,05 für eine CTR von 5 %.		 Klickrate
Eindrücke long withCondition("Impressions > 10") Impr.

Im Folgenden finden Sie die Kontoeigenschaften, die Sie angeben können.

Spalte Typ Beispiel Microsoft Advertising-Webbenutzeroberflächenfilter
CurrencyCode string Der Währungscode der vom Konto verwendeten Währung. Beispiel: USD für USA-Dollar.

withCondition("CurrencyCode = USD")
ManagerCustomerId string Die Kunden-ID des Benutzers, der die Konten verwaltet.

withCondition("ManagerCustomerId = '123456789'")
Name string Der Name eines verwalteten Kontos.

withCondition("Name CONTAINS_IGNORE_CASE 'foo'")

Argumente

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

Rückgabewerte

Typ Beschreibung
BingAdsAccountSelector Selector mit der angewendeten Bedingung.

withIds(string[] ids)

Ruft Konten 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 das Konto 33333 aus.

AccountsApp.accounts()
    .withIds(['11111', '22222', '33333'])
    .withIds(['33333', '44444', '55555']);
    .get();

Argumente

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

Rückgabewerte

Typ Beschreibung
BingAdsAccountSelector Selector mit den angewendeten IDs.

withLimit(int limit)

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

Argumente

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

Rückgabewerte

Typ Beschreibung
BingAdsAccountSelector Selektor mit angewendetem Grenzwert.

Siehe auch

  • Last updated on