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 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.

• AdGroupSelector
• AssetGroupSelector
• AdParamSelector
• AdSelector
• BingAdsAccountSelector
• BudgetSelector
• CampaignSelector
• ExcludedLocationSelector
• KeywordSelector
• NegativeKeywordListSelector
• ProductGroupSelector
• TargetedLocationSelector

Nächste Schritte