Селекторы

Селекторы помогают формировать запросы на извлечение определенных объектов AdWords. С их помощью вы можете ограничить список нужных объектов и упорядочить его. В большинстве селекторов используются следующие методы:

withCondition()
Добавляет условие к селектору. Если используется несколько условий, они объединяются с помощью оператора AND. При этом селектор будет возвращать объекты только при соблюдении всех указанных условий.
withIds()
Добавляет набор идентификаторов в качестве условия. Это условие будет объединено со всеми прочими оператором И.
forDateRange()
Используется, если условие или заказ ссылается на поле статистики (например, Stats). Оно может содержать количество кликов или показов. Если вы запросите все кампании, набравшие более 100 показов, скриптам AdWords потребуется диапазон дат.
orderBy()
Определяет порядок сортировки полученных объектов.
withLimit()
Ограничивает количество полученных объектов определенным значением. В частности, этот метод используется вместе с orderBy() для запросов вида "10 ключевых слов с наибольшим числом показов за вчерашний день".

Эти методы можно вызывать в любом порядке. Исключение – orderBy(), где порядок вызова важен для правильной работы. Пример:

selector = selector.forDateRange("LAST_14_DAYS")
    .orderBy("Clicks DESC")
    .orderBy("CTR ASC");

Результаты будут отсортированы по количеству кликов в порядке убывания. Результаты с равным количеством кликов будут отсортированы по CTR в порядке возрастания.

Вызовы методов селектора можно располагать друг за другом. Пример:

var campaignSelector = AdWordsApp.campaigns();
campaignSelector.withCondition("Clicks > 10");
campaignSelector.withCondition("Impressions > 1000");
campaignSelector.orderBy("Impressions DESC");
campaignSelector.forDateRange("YESTERDAY");

Приведенный выше код можно упростить следующим образом:

var campaignSelector = AdWordsApp.campaigns()
  .withCondition("Clicks > 10")
  .withCondition("Impressions > 1000")
  .orderBy("Impressions DESC")
  .forDateRange("YESTERDAY");

После создания селектора можно получить итератор путем вызова selector.get().

Некоторые селекторы, например AdParamSelector и LabelSelector, поддерживают не все перечисленные методы, поскольку работают с объектами, имеющими ограничения. Для таких объектов может отсутствовать статистика или данные для сортировки.

Рекомендуем также ознакомиться с рекомендациями по эффективному использованию селекторов.

Оставить отзыв о...

Текущей странице
Скрипты AdWords
Скрипты AdWords