Selektory pomagają programistom stworzyć zapytanie, które pobiera odpowiednie elementów Google Ads. Dzięki selektorom można zawęzić listę wyodrębnionych elementów i je uporządkować. Większość selektorów ma te elementy metody:
withCondition()- Dodaje warunek do selektora. Jeśli użyjesz kilku warunków, będą one ORAZ, oznacza to, że selektor zwraca tylko te elementy, które spełniają wszystkie określone warunki.
withIds()- Dodaje zbiór identyfikatorów jako . Warunek oparty na identyfikatorze będzie połączony z każdym operatorem ORAZ.
forDateRange()- Jest wymagany, gdy warunek lub klauzula sortowania odwołuje się do pola Statystyki, np. CTR lub Wyświetlenia. Jeśli wyślesz żądanie wszystkich kampanii, które mają ponad 100 wyświetleń, Skrypty Google Ads będą musiały znać zakres dat, który ma być analizowany.
orderBy()- Określa kolejność zwracanych elementów.
withLimit()- Ogranicza liczbę zwracanych elementów do określonej wartości. Jest to szczególnie przydatne w połączeniu z opcją
orderBy(), aby pobierać dane takie jak „10 słów kluczowych z największą liczbą wyświetleń w ubiegłym dniu”. Domyślnie wszystkie selektory ustawimy limit na 50 000. Możesz zwiększyć limit, ręcznie określając i określić limit.
Te metody można wywoływać w dowolnej kolejności. Jedynym wyjątkiem jest orderBy(), gdzie:
kolejność wywołań rzeczywiście ma znaczenie: wielokrotne wywołania tej metody określają,
na wiele klauzul porządkujących, które będą stosowane w odpowiedniej kolejności. Rozważ ten fragment kodu:
selector = selector.forDateRange("LAST_14_DAYS")
.orderBy("metrics.clicks DESC")
.orderBy("metrics.ctr ASC");
Wyniki zostaną uporządkowane według kliknięć w kolejności malejącej. Wyniki z równymi Wartości kliknięć będą uporządkowane według współczynnika klikalności (CTR) w kolejności rosnącej.
Wywołania metod selektora można ze sobą łączyć. Ten kod
var campaignSelector = AdsApp.campaigns();
campaignSelector.withCondition("metrics.clicks > 10");
campaignSelector.withCondition("metrics.impressions > 1000");
campaignSelector.orderBy("metrics.impressions DESC");
campaignSelector.forDateRange("YESTERDAY");
można napisać od nowa w bardziej zwięzły sposób:
var campaignSelector = AdsApp.campaigns()
.withCondition("metrics.clicks > 10")
.withCondition("metrics.impressions > 1000")
.orderBy("metrics.impressions DESC")
.forDateRange("YESTERDAY");
Po utworzeniu selektora można z niego uzyskać Iterator, wywołując selector.get().
Zapoznaj się ze sprawdzonymi metodami, aby dowiedzieć się, jak efektywnie korzystać z selektorów.