Was sind Selektoren?

Mit Selektoren können Sie Filter- und Sortierkriterien anwenden, wenn Sie Microsoft Advertising-Entitäten wie Schlüsselwörter und Kampagnen abrufen. Selektoren stellen Funktionen bereit, die in etwa der von SQL WHERE und ORDER BY Klauseln entsprechen. Selektoren umfassen die folgenden Methoden:

  • withCondition() — Wird verwendet, um Bedingungen anzugeben, die Entitäten erfüllen müssen, um ausgewählt zu werden. Dies entspricht einer SQL-Klausel WHERE .

    Beispiel: withCondition('Name STARTS_WITH "Contoso"')

    Sie können eine oder mehrere Bedingungen auf einen Selektor anwenden. Das Angeben mehrerer Bedingungen wird als UND-Vorgang betrachtet. Beispielsweise wird das Objekt nur ausgewählt, wenn Bedingung A wahr UND Bedingung B wahr ist.

  • withIds() — Wird verwendet, um die IDs der auszuwählenden Entitäten anzugeben. Dies entspricht einer SQL-Klausel IN .

    Beispiel: withIds(["1","2","3","4"])

  • forDateRange() — Wird verwendet, um Entitäten mit Leistungsdaten zurückzugeben, die dem angegebenen Datumsbereich entsprechen. Wenn eine Bedingung eine Metrikspalte angibt, müssen Sie sie in die Kette des Selektors einschließen forDateRange .

    Beispiel: forDateRange("LAST_14_DAYS")

  • orderBy() — Wird verwendet, um die Entitäten, die der Selektor zurückgibt, nach einem angegebenen Feld zu sortieren. Dies entspricht einer SQL-Klausel ORDER BY .

    Beispiel: orderBy("Clicks DESC")

  • withLimit() — Wird verwendet, um höchstens die angegebene Anzahl von Entitäten zurückzugeben. Dies entspricht einer SQL-Klausel TOP .

    Beispiel: withLimit(50)

Da jede Methode den Selektor mit den angewendeten Filterkriterien zurückgibt, können Sie (unter Verwendung der Punktnotation) mehrere Bedingungen verketten, um die Filterkriterien zu verfeinern. Zum Beispiel:

var selector = AdsApp.campaigns()
    .withCondition("ClickConversionRate > 0.5")
    .withCondition("Cost > 4.0")
    .forDateRange("LAST_WEEK")
    .withLimit(10);

Um die Skriptleistung zu verbessern, verwenden Sie bestimmte Filterbedingungen, um sicherzustellen, dass Sie nur die gewünschten Entitäten abrufen. Nachdem Sie den Selektor erhalten haben, rufen Sie die get() Methode auf, um einen Iterator abzurufen, den Sie zum Durchlaufen der Liste der Entitäten verwenden.

var campaigns = selector.get();

Oder

var campaigns = AdsApp.campaigns()
    .withCondition("ClickConversionRate > 0.5")
    .withCondition("Cost > 4.0")
    .forDateRange("LAST_WEEK")
    .withLimit(10)
    .get();

Die folgende Liste enthält die Selektoren.

Nächste Schritte

Informationen zu Iteratoren

  • Last updated on