Selektoren

Mit Selektoren kann der Programmierer die Abfrage erstellen, mit der die angeforderten 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. Wenn mehrere Bedingungen verwendet werden, werden sie mit UND verknüpft. Das heißt, 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 mit allen anderen Bedingungen durch „UND“ verknüpft.
forDateRange()
Ist erforderlich, wenn in einer Bedingungs- oder Sortierklausel auf ein Stats-Feld verwiesen wird, z. B. „Ctr“ oder „Impressions“. Wenn Sie alle Kampagnen mit mehr als 100 Impressionen anfordern, muss in Google Ads-Scripts der Zeitraum angegeben werden, der berücksichtigt werden soll.
orderBy()
Gibt die Reihenfolge der zurückgegebenen Entitäten an.
withLimit()
Beschränkt die Anzahl der zurückgegebenen Entitäten auf den angegebenen Wert. Sie ist besonders nützlich in Verbindung mit orderBy(), um beispielsweise „10 Keywords mit den meisten Impressionen gestern“ 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 festlegen.

Diese Methoden können in beliebiger Reihenfolge aufgerufen werden. Eine Ausnahme ist orderBy(), bei der die Reihenfolge der Aufrufe tatsächlich wichtig ist: Bei mehreren Aufrufen dieser Methode werden mehrere ORDER BY-Klauseln angegeben, die in der Reihenfolge angewendet werden. Sehen Sie sich das folgende Snippet an:

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 gleichen Werten für „Klicks“ 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");

Sobald der Selektor erstellt wurde, kann durch Aufrufen von selector.get() ein Iterator abgerufen werden.

In den Best Practices finden Sie Tipps und Tricks für die effiziente Verwendung von Selektoren.