Селекторы помогают программисту составить запрос, который выбирает нужные сущности Google Ads. С помощью селекторов можно сузить список извлекаемых сущностей и упорядочить его. Большинство селекторов имеют следующие методы:
-
withCondition()
- Добавляет условие к селектору. Если используется несколько условий, они объединяются по оператору «И», то есть селектор вернёт только те сущности, которые удовлетворяют всем указанным условиям.
-
withIds()
- Добавляет коллекцию идентификаторов в качестве условия. Условие на основе идентификатора будет объединено с остальными по оператору AND.
-
forDateRange()
- Требуется, когда условие или условие упорядочивания ссылается на поле статистики , например, Ctr или Показы. Если вы запрашиваете все кампании с более чем 100 показами, скриптам Google Рекламы потребуется указать диапазон дат для анализа.
-
orderBy()
- Задает порядок возвращаемых сущностей.
-
withLimit()
- Ограничивает количество возвращаемых сущностей указанным значением. Это особенно полезно в сочетании с
orderBy()
для получения данных, например, «10 ключевых слов с наибольшим количеством показов вчера». По умолчанию все селекторы устанавливают ограничение в 50 000. Вы можете увеличить это ограничение, указав его вручную.
Эти методы можно вызывать в любом порядке. Исключением является orderBy()
, где порядок вызовов действительно имеет значение: несколько вызовов этого метода определят несколько условий упорядочивания, и они будут применяться по порядку. Рассмотрим следующий фрагмент:
selector = selector.forDateRange("LAST_14_DAYS")
.orderBy("metrics.clicks DESC")
.orderBy("metrics.ctr ASC");
Результаты будут отсортированы по количеству кликов в порядке убывания. Результаты с одинаковым количеством кликов будут отсортированы по значению Ctr в порядке возрастания.
Вызовы методов селектора можно объединять в цепочку. Следующий код:
var campaignSelector = AdsApp.campaigns();
campaignSelector.withCondition("metrics.clicks > 10");
campaignSelector.withCondition("metrics.impressions > 1000");
campaignSelector.orderBy("metrics.impressions DESC");
campaignSelector.forDateRange("YESTERDAY");
можно переписать в более компактном виде:
var campaignSelector = AdsApp.campaigns()
.withCondition("metrics.clicks > 10")
.withCondition("metrics.impressions > 1000")
.orderBy("metrics.impressions DESC")
.forDateRange("YESTERDAY");
После создания селектора из него можно получить итератор , вызвав selector.get()
.
Ознакомьтесь с рекомендациями по эффективному использованию селекторов.