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. Wenn mehrere Bedingungen verwendet werden, Das heißt, die Auswahl gibt nur Entitäten zurück, alle angegebenen Bedingungen erfüllen.
withIds()
- Fügt eine Sammlung von IDs als ein . 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, Google Ads-Skripts müssen den Zeitraum kennen, der geprüft werden soll.
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 Verbindung mit
orderBy()
, um Informationen z. B. „10 Keywords mit den meisten Impressionen gestern“. Standardmäßig wird für alle Auswahlen ein Limit von 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 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 gleich Die Klickwerte 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");
Nachdem die Auswahl erstellt wurde, kann durch Aufrufen von selector.get()
ein Iterator abgerufen werden.
Best Practices und Tricks zur effizienten Verwendung von Selektoren.