Введение в скрипты Google Ads

Настройка рекламы в Гугле совершенно точно напугает любого новичка, но и для опытного пользователя таит в себе немало трудностей. Одной из таких проблем являются java-cкрипты. Благодаря ним можно решить разные задачи по оптимизации рекламы и избавить себя от ручной работы. Для неподготовленного человека скрипты по понятным причинам совершенно непонятны, однако разобраться в них не так сложно. Сейчас сделаем первые шаги к их пониманию.

Область применения скриптов в Google Ads очень широкая, однако состоят они из однотипных элементов. К ним относятся:

• Функции
• сущности
• Переменные
• Итераторы
• Объекты
• Селекторы

Функции в скритпах Google Ads

Функция показывает задачу, которая будет решаться, либо действие, которое необходимо реализовать в рамках скрипта. Функция записывается следующим образом:

function main () {фрагмент кода}

Круглые скобки часто остаются пустыми, либо содержат определенный параметр. Код всегда записывается в фигурных скобках.

С функций начинается каждый скрипт.

Пример функций:

• function addAdGroup() {фрагмент кода} — добавить группу объявлений;
• function setCampaignBudget() {фрагмент кода} — установить бюджет кампании;
• function pauseKeywordInAdGroup() {фрагмент кода} — остановить работу ключевого слова в группе объявлений.

Переменные в скриптах Google Ads

Переменные  это контейнеры, в которых содержатся определенные значения данных, они обращаются к сущностям и объектам. Имя переменной можно дать любое, главное, чтобы оно не менялось в рамках одного скрипта.

Например, переменную, связанную с группой объявлений можно обозначить так:

var group

var — это обозначение переменной (от слова «variables»), как правило она следует сразу за функцией.

Объекты в скриптах Google Ads

Чтобы понять, что такое объекты, проще разобраться, какие основные четыре типа объектов существует:

• AdWordsApp
• MccApp
• SpeadsheetApp
• UrlFetchApp.

В подавляющем количестве скриптов будет использоваться объект AdWordsApp — это сигнал, что данные, к которым будем обращаться в скрипте, относятся к Google Ads. Три других типа объектов задействуют другие источники: MccApp работает на уровне центра клиентов, SpreadsheetApp обращается к Гугл.Таблицам. а UrlFetchApp — к сторонним приложениям и сервисам.

Сущности в скриптах Google Ads

Сущности — это более конкретизированные данные, которые входят в объект. Для объекта AdWordsApp существуют следующие сущности:

• аккаунт (Account);
• кампании (Campaigns);
• группы объявлений (Ad Groups);
• ключевые слова (Keywords);
• ярлыки (Labels);
• расписания показа объявлений (Ad schedules);
• бюджеты (Budgets);
• таргетинг (Targeting).

Выше мы написали о переменной для групп объявлений. Как видим, ей соответствует сущность Ad Groups. Соответственно, в скрипте мы их можем приравнять, написав строку такого вида:

var groups = AdWordsApp.Ad Groups()

Как видите, сначала мы указали объект, а затем, через точку, сущность, которая в него входит.

Селекторы в скриптах Google Ads

Так как сущности может соответствовать большой объем данных, из нее можно выбрать только то, с чем мы будем работать. Для этого существуют селекторы. Селекторы могут быть такого вида:

• withCondition() — сортировка с условием;
• forDateRange() — фильтрация за указанный период;
• orderBy() — сортировка по результатам;
• withLimit() — ограничивает количество возвращаемых объектов до указанного значения.

Например, у нас есть следующий код:

var campaignSelector = AdWordsApp.campaigns ()

    .withCondition(«CampaignStatus = ‘ENABLED'»)

.withCondition(“Clicks > 10”)

.withCondition(“Impressions > 100”)

   .forDateRange(“TODAY”);

С его помощью мы отбираем активные кампании, которые за сегодня получили не менее 10 кликов и 100 показов. В данном случае у нас есть три селектора .withCondition, и эти три условия должны выполняться одновременно, а не одно любое.

Итераторы в скриптах Google Ads

Благодаря итераторам поддерживается работа скрипта, то есть он будет выполнять необходимое действие до тех пор, пока не будет достигнут требуемый результат. Итератор располагается после селекторов и перебирают все данные, чтобы найти то, что соответствует целям функции.

Итератор содержит фрагмент next(), которые возвращает данные, показывающие, все ли требуемые значения найдены.

Пример скрипта Google Ads

Приведем пример простого скрипта.

• В первой строке скрипта открываем функцию.
• Во второй создаем переменную «keywords», которая в объекте AdWordsApp будет искать объекты keywords, то есть ключевые слова.
• Строки 3-7 — это селекторы. Они говорят, что нужно обратиться к неработающим кампаниям, отсортировать ключевые слова в порядке убывания, в качестве периода брать вчерашний день, и показать всего 10 слов.
• Строка 8 — это logger, благодаря которому результаты будут выводиться в панель предварительного просмотра. В комментариях к нему можно оставить примечания, чтобы лучше понимать, какие данные нам предоставит скрипт.
• Строки 9 и 10 — итераторы, благодаря ним скрипт продолжает искать ключевые слова до тех пор, пока такие есть.
• И в конце две фигурные скобки: одна закрывает итератор, другая — функцию.

Про работу скриптов можно рассказать еще многое и привести примеры, как они могут быть полезны в работе рекламы. Это будет в следующих статьях.