Mit Selektoren können Programmierer eine Abfrage erstellen, über die die gewünschten Google Ads-Entitäten abgerufen werden. Mit Selektoren kann die Liste der abgerufenen Entitäten eingegrenzt und sortiert werden. Bei den meisten Selektoren werden folgende Methoden verwendet:
withCondition()- Fügt einem Selector eine Bedingung hinzu. Wenn mehrere Bedingungen verwendet werden, werden sie mit AND verknüpft. Das heißt, der Selektor gibt nur Entitäten zurück, die alle angegebenen Bedingungen erfüllen.
withIds()- Fügen Sie eine Sammlung von IDs als Bedingung hinzu. Eine ID-basierte Bedingung wird mit allen anderen durch „UND“ verknüpft.
forDateRange()- Erforderlich, wenn eine Bedingung oder Sortierfeldanweisung auf ein Feld Statistiken verweist, z. B. „Ctr“ oder „Impressionen“. Wenn Sie alle Kampagnen mit mehr als 100 Impressionen anfordern, müssen Google Ads-Scripts den zu untersuchenden Zeitraum kennen.
orderBy()- Gibt die Reihenfolge der zurückgegebenen Entitäten an.
withLimit()- Begrenzt die Anzahl der zurückgegebenen Entitäten auf den angegebenen Wert. Es ist besonders nützlich in Kombination mit
orderBy(), um z. B. die „10 Keywords mit den meisten Impressionen gestern“ abzurufen. Standardmäßig wird für alle Auswahlen ein Limit von 50.000 festgelegt. Sie können das Limit erhöhen, indem Sie es manuell angeben.
Diese Methoden können in beliebiger Reihenfolge aufgerufen werden. Eine Ausnahme ist orderBy(), bei der die Aufrufreihenfolge tatsächlich wichtig ist: Bei mehreren Aufrufen dieser Methode werden mehrere Sortierklauseln angegeben, die nacheinander angewendet werden. Betrachten Sie das folgende Snippet:
selector = selector.forDateRange("LAST_14_DAYS")
.orderBy("metrics.clicks DESC")
.orderBy("metrics.ctr ASC");
Die Ergebnisse werden nach Klicks in absteigender Reihenfolge sortiert. Ergebnisse mit denselben Klicks-Werten werden in aufsteigender Reihenfolge nach CTR sortiert.
Aufrufe der Methoden eines Selektors können miteinander verkettet werden. Der folgende Code
var campaignSelector = AdsApp.campaigns();
campaignSelector.withCondition("metrics.clicks > 10");
campaignSelector.withCondition("metrics.impressions > 1000");
campaignSelector.orderBy("metrics.impressions DESC");
campaignSelector.forDateRange("YESTERDAY");
kann wie folgt kompakter gemacht werden:
var campaignSelector = AdsApp.campaigns()
.withCondition("metrics.clicks > 10")
.withCondition("metrics.impressions > 1000")
.orderBy("metrics.impressions DESC")
.forDateRange("YESTERDAY");
Nachdem die Auswahl erstellt wurde, kann durch Aufrufen von selector.get() ein Iterator daraus abgerufen werden.
In den Best Practices finden Sie Tipps und Tricks für die effiziente Verwendung von Auswahlelementen.