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 Selektor eine Bedingung hinzu. Werden mehrere Bedingungen verwendet, werden diese durch UND verknüpft. Mit anderen Worten: Der Selektor gibt nur Entitäten zurück, die alle angegebenen Bedingungen erfüllen.
withIds()- Fügt eine Sammlung von IDs als Bedingung hinzu. Eine ID-basierte Bedingung wird durch eine UND-Verbindung mit allen anderen verknüpft.
forDateRange()- Ist erforderlich, wenn eine Bedingung oder eine Sortierungsklausel auf ein Statistikfeld wie CTR oder Impressionen verweist. Wenn Sie alle Kampagnen mit mehr als 100 Impressionen anfordern, muss den Google Ads-Skripts der zu untersuchende Zeitraum mitgeteilt werden.
orderBy()- Gibt die Reihenfolge der zurückgegebenen Entitäten an.
withLimit()- Begrenzt die Anzahl der zurückgegebenen Entitäten auf den angegebenen Wert. Diese Funktion ist besonders nützlich in Verbindung mit
orderBy(), um Daten wie die „10 Keywords, die gestern die meisten Impressionen erzielt haben“ abzurufen. Standardmäßig wird das Limit für alle Selektoren auf 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(), wobei die Reihenfolge der Aufrufe tatsächlich von Bedeutung ist: Mehrere Aufrufe dieser Methode geben mehrere Sortierklauseln an und gelten der Reihe nach. Sehen Sie sich das folgende Snippet an:
selector = selector.forDateRange("LAST_14_DAYS")
.orderBy("metrics.clicks DESC")
.orderBy("metrics.ctr ASC");
Hier werden die Ergebnisse in absteigender Reihenfolge nach Klicks sortiert. Ergebnisse mit identischen Klicks werden nach Klickrate (CTR) in aufsteigender Reihenfolge 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");
Sobald der Selektor erstellt ist, kann durch Aufrufen von selector.get() ein Iterator abgerufen werden.
In den Best Practices finden Sie Tipps und Tricks zur effizienten Verwendung von Selektoren.