Teilen über

Was sind Selektoren?

  • Artikel

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

  • withCondition() – Dient zum Angeben von Bedingungen, 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 AND-Vorgang betrachtet. Beispielsweise wird die Entität nur ausgewählt, wenn Bedingung A true ist UND Bedingung B wahr ist.

  • withIds() – Verwenden Sie , um die IDs der auszuwählenden Entitäten anzugeben. Dies entspricht einer SQL-Klausel IN .

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

  • forDateRange() – Dient zum Zurückgeben von Entitäten mit Leistungsdaten, die dem angegebenen Datumsbereich entsprechen. Wenn eine Bedingung eine Metrikspalte angibt, müssen Sie in die Selektorkette einschließen forDateRange .

    Beispiel: forDateRange("LAST_14_DAYS")

  • orderBy() – Verwenden Sie , 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() – Verwenden Sie , 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 mehrere Bedingungen (mithilfe von Punktnotation) 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. Rufen Sie nach dem Abrufen des Selektors die get() -Methode auf, um einen Iterator abzurufen, mit dem Sie die Liste der Entitäten durchlaufen.

var campaigns = selector.get();

Oder

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

Im Folgenden ist die Liste der Selektoren aufgeführt.

Nächste Schritte

Weitere Informationen zu Iteratoren