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 einem logischen „UND“ verknüpft. Das bedeutet, dass der Selektor nur Entitäten zurückgibt, die alle angegebenen Bedingungen erfüllen.
withIds()
Fügt eine Sammlung von IDs als eine Bedingung hinzu. Eine ID-basierte Bedingung wird mit allen anderen Bedingungen mit einem logischen „UND“ verknüpft.
forDateRange()
Ist erforderlich, wenn eine Bedingung oder eine Sortierklausel auf ein Statistik feld verweist, z. B. „CTR“ oder „Impressions“. Wenn Sie alle Kampagnen mit mehr als 100 Impressionen anfordern, müssen Google Ads-Skripts den Zeitraum kennen, in dem gesucht werden soll.
orderBy()
Gibt die Sortierung der zurückgegebenen Entitäten an.
withLimit()
Beschränkt die Anzahl der zurückgegebenen Entitäten auf den angegebenen Wert. Diese Methode ist besonders nützlich in Verbindung mit orderBy(), um beispielsweise die 10 Keywords mit den meisten Impressionen vom Vortag abzurufen. Standardmäßig wird für alle Selektoren ein Limit von 50.000 festgelegt. Sie können das Limit erhöhen, indem Sie manuell ein Limit angeben.

Diese Methoden können in beliebiger Reihenfolge aufgerufen werden. Eine Ausnahme ist orderBy(), bei der die Reihenfolge der Aufrufe wichtig ist: Bei mehreren Aufrufen dieser Methode werden mehrere Sortierklauseln angegeben, die in der Reihenfolge der Aufrufe angewendet werden. Betrachten Sie das folgende Snippet:

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 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, können Sie einen Iterator daraus abrufen, indem Sie selector.get().

Unter Best Practices finden Sie Tipps und Tricks zur effizienten Verwendung von Selektoren.