Скриптология Penguin-team: как скрипты Google Ads делают работу продуктивнее и что нужно для их внедрения

9205

Привет! Мы — Penguin-team, агентство контекстной рекламы, а это — наш блог по бизнесу, маркетингу и РРС. Каждый месяц мы выпускаем гайды, статьи и инструкции о том, как работать с eCommerce, брендировать, настраивать Google Рекламу и другие каналы трафика.

Наш блог читают маркетологи, SEM-специалисты и предприниматели; его рекомендуют на SEMConf и других конференциях.

Еще больше уникальных материалов — в рассылке 👇 Подписывайтесь!

Получать еще больше уникальных материалов 👉🏻

Спасибо за подписку!

Содержание

9205

Скрипты в контекстной рекламе — тема, которую все обходят стороной. С одной стороны это понятно: работа с кодом выглядит пугающе сложно для не-разработчиков. С другой стороны, скрипты способны в 2, в 3, в 5 раз сокращать затраты времени на рутинные задачи; они очень сильно расширяют возможности РРС-специалиста; с ними продуктивность вырастает просто мгновенно. Так почему бы не разобраться в этой теме раз и навсегда?

Перед вами абсолютно новый гайд — скриптология от Penguin-team. Он поможет разобраться:

Этот гайд поможет тем, кто никогда раньше не сталкивался с кодом или разбирается в нем только минимально. Без зауми, без сложной терминологии, без Википедии — все максимально просто и для всех.

Прокачивайтесь и будьте продуктивнее вместе с нами!

Почему стоит внедрять скрипты в Google Ads

Внедрение скриптов Google Ads в аккаунт — это важный аспект работы специалиста по контекстной рекламе. Чем больше развивается рынок, тем острее стоит вопрос автоматизации и оптимизации процессов. Тут и помогут скрипты Google Ads.

Правда, есть несколько нюансов, которые мешают их системному внедрению:

Скрипты из свободного доступа требуют кастомизации под каждый частный случай — а это очень неудобно, если нет бюджета на программиста или сам РРС-специалист не разбирается в JavaScript.
Мануалы в сети пишутся программистами для программистов, поэтому РРС-специалисту в них разобраться непросто. Понятные справочники для не-программистов в основном написаны на английском языке.
Многие скрипты по Google Ads, которые можно найти на freeadwordsscripts.com или других сайтах, очень устарели: в обновленном интерфейсе Ads большинство функции можно реализовать и без них.
Скрипты, написанные в 2008 году и раньше, обращаются к переменным, которых с 2016 года не существует.

Все это приводит к тому, что РРС-специалист, который хочет сам разобраться в скриптах, находит много противоречивой информации, один раз ставит не срабатывающий скрипт… А потом забрасывает это направление полностью, «потому что сложно».

Мы в Penguin-team давно используем скрипты в своей работе. А несколько последних месяцев мы искали, отрабатывали, кастомизировали и описывали всевозможные скрипты для РРС-специалистов, чтобы подготовить «Скриптологию Penguin-team» для вас.

К подборке прилагается этот гайд с описанием основ JavaScript и принципов организации работы со скриптами в целом ↓. Этого будет достаточно для чтения кода и, если нужно, даже для его изменения.

Зачем разбираться в скриптах

Представьте: вы обнаружили, что в alpha-кампании вы получаете высокий коэффициент конверсии по приемлемой цене при средней позиции 1,5. Чтобы удержать эту позицию, нужно вручную менять ставки каждый день по определенному алгоритму, чтобы не завышать и не занижать их. Это довольно времязатратно… Особенно если в работе 5+ аккаунтов. А уж если их больше 10, то на такое ручное управление ставками времени не останется вообще! Решить этот вопрос помогает скрипт Position Control, который будет поднимать и снижать ставки, чтобы быть на нужной позиции. При этом он, конечно, учитывает максимальный предел ставки и имеет динамический шаг (% увеличения и уменьшения ставки): чем дальше положение от целевой позиции, тем больше % изменения ставки.

В первом блоке есть спецификации скрипта:

«tcc1.5» означает, что скрипт должен держать позицию 1,5 по РК;
«tcb10» — что верхний предел ставки не должен превышать 10 у.е.

Во втором блоке можно увидеть результат достижения позиции на 9 день работы скрипта. Из трех кампаний целевая позиция была достигнута в двух.

Только внедрение этого скрипта может увеличить продуктивность и точность специалиста по контекстной рекламе и сделать его более конкурентоспособным на рынке. А ведь полезных скриптов намного больше!

Где использовать скрипты

Все скрипты можно разделить на несколько категории. На наш взгляд, наиболее значимые:

Bidding — оптимизируют ставки;
Reports — предоставляют полезные отчеты для оптимизации аккаунта;
Managing — вносят изменения в РК, например, добавляют минус-площадки в Display.

Ну а теперь давайте перейдем к более практической части о том, как организовать свою работу, чтобы скрипты приносили максимальную пользу аккаунту.

Как организовать аккаунт Ads для работы со скриптами

Усредненный алгоритм внедрения скрипта в аккаунт Google Ads выглядит следующим образом:

Определить рутинные процессы: понять, какой процесс является монотонной работой, которая регулярно повторяется.
Определить альтернативы. Постараться решить вопрос без скрипта: автоматизированными правилами, возможно, платным софтом.
Отыскать скрипт, способный выполнить поставленную задачу.
Разобраться в работе скрипта. Для этого пригодится техническая инструкция, написанная ниже.
Кастомизировать скрипт, в случае необходимости.
Поставить скрипт в аккаунт Google Ads.
Проверить работу скрипта.
Запустить скрипт.
Проверить результаты, в случае необходимости — откорректировать скрипт.

Шаги 1-3 у каждого специалиста/компании будут свои. С шагами 4 и 5 поможет разобраться техническая часть. Поэтому сейчас начнем с шага 6.

Поставить скрипт в аккаунт

В зависимости от доступа к аккаунту, существует 2 способа установки скрипта:

Загрузка скрипта напрямую в аккаунт по прямым доступам. Подойдет для частных клиентов или для тех, кто дал прямой доступ (логин и пароль) к своему аккаунту.
Загрузка через MCC. Подойдет для агентств и outoffice-специалистов.

Первый способ самый простой, в нем нет подводных камней.

Во втором способе — загрузке через МСС — важно соблюдать некоторые правила:

1. Доступ к аккаунту должен быть установлен на уровне администратора.

2. Если речь идет о агентстве, то желательно, чтобы у каждой команды (или специалиста) был свой MCC, в который будут загружаться скрипты. Т.е. структура следующая:

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

#1 На вкладке «Инструменты» переходим в раздел «Скрипты».

Здесь есть 3 основных блока:

Блок 1. Добавление скриптов и название уже добавленных.

Блок 2. Автор скрипта и частота отработки. Каждый скрипт должен отрабатывать в аккаунте с определенной частотой (обычно рекомендуемую частоту пишут в спецификации к скриптам).

Блок 3. Дата добавления/изменения, статус и активность (редактирование/удаление).

#2 Добавление скрипта.

четко и внятно называем скрипт, чтобы было понятно всем, кто будет работать с аккаунтом;
удаляем строку «function main() {}» — в шаблонах скрипта уже есть эта строка;
авторизируемся.

#3 Проверка скрипта и внесение своих переменных.

Для этой задачи рекомендуем использовать www.sublimetext.com — этот софт, который удобно читает JS-код.

в первой части скрипта обычно указывают автора и кратко описывают суть работы;
во второй части нужно вводить свои переменные, ссылки на Google Таблицы с данными, ID кампаний и так далее;
в третьей части указывают, в каком формате нужно вводить значения.

После изменения и загрузки скрипта переходим к проверке работы.

Проверить работу скрипта

Каждый скрипт перед запуском стоит проверить. Если все хорошо, то в разделе изменений можно будет увидеть, что сделал скрипт в аккаунте. Если будут какие-то ошибки в скрипте, они будут отнесены в раздел «Логи», где будет указана причина, почему он не сработал и что стоит изменить.

Если все хорошо, то дальше нужно запустить скрипт и получать пользу от его работы.

Чтобы работа со скриптами удалась, рекомендуем следовать правилам:

правильно организовывать свой аккаунт MCC;
получить административный уровень доступа к аккаунту;
внимательно изучить спецификацию (описание) скрипта;
внимательно вносить переменные в скрипт;
перед запуском скрипта обязательно делать проверку через «Просмотр»;
запускать скрипт (установить частоту отработки);
по истечении времени анализировать эффективность работы;
принимать решение о дальнейшей работе скрипта в аккаунте.

Введение в JavaScript

Современный JavaScript — язык программирования, который используется для автоматизации действий в браузере. К примеру, он позволяет добавлять на сайт интерактивность: отклик при нажатии на кнопки, анимацию, динамические стили и так далее. Все это делается при помощи скриптов — сценариев для автоматизации задач, которые пользователь мог бы делать вручную.

Вот примеры использования JavaScript в браузере:

создание новых HTML-тегов или удаление существующих, изменение стилей элементов, скрытие и показ элементов;
реагирование на действия посетителя, обработка клики мыши, перемещения курсора, нажатия на клавиатуру;
отправка запросов на сервер и загрузка данных без перезагрузки страницы (эта технология называется «AJAX»);
получение cookie, запрашивание данных, выведение сообщений…

Основа любого кода — это синтаксис, то есть правила построения кода. Вам не обязательно заучивать все-все нюансы синтаксиса, а вот знать базовые вещи стоит: это поможет понимать скрипты, особенно когда вы находите их в интернете и копируете себе в аккаунт.

#1 Переменные

Когда мы работаем со скриптом, мы в любом случае работаем с какими-то данными. Где они хранятся? Как раз таки в переменных. Переменная — это своего рода контейнер для кусочков данных, которые вы обрабатываете при помощи скрипта. Если взять любой скрипт, то он будет состоять на 95% из переменных.

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

К примеру:

function main() {
  var keywords = AdWordsApp.keywords()
      .orderBy("Impressions DESC")
      .forDateRange("YESTERDAY")
      .withLimit(10)
      .get();

  Logger.log("10 keywords with most impressions yesterday");
  while (keywords.hasNext()) {
    var keyword = keywords.next();
    Logger.log(keyword.getText() + ": " +
        keyword.getStatsFor("YESTERDAY").getImpressions());
  }
}

Во строке 2 и 10 есть слово var — это и есть обозначение переменной, то есть контейнера, в котором будут храниться данные. Сами переменные стоят после var — это переменные keywords и keyword. После «=» стоит значение переменной — собственно, сами данные, которые мы используем.

Правила составления имени переменной:

имя может состоять из букв, цифр и символов «$» и «_»;
первый символ не должен быть цифрой;
регистр букв имеет значение: apple и AppLE — две разные переменные. Например, если вы сохранили данные в переменную apple, а ниже в коде пытаетесь получить их оттуда при помощи запроса к AppLE, то вместо значения вы получите undefined (значения нет).

Важно! Среди переменных вы можете встретить константу — это величина, которая не изменяется на протяжении всего скрипта и, как правило, именуется только большими буквами. Пример того, как она обычно обозначается:

var COLOR_RED = "#F00";
var COLOR_GREEN = "#0F0";
var COLOR_BLUE = "#00F";
var COLOR_ORANGE = "#FF7F00";

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

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

#2 Типы данных

Есть 5 «примитивных» типов: number, string, boolean, null, undefined. Плюс 6-й тип — объекты object.

Число «number».

var number = 100500; // Единый тип «число» используется как для целых, так и для дробных чисел.

Существуют специальные числовые значения:

Infinity (бесконечность) получается при делении на ноль;
NaN (not-a-number, не-число) получается при ошибке вычислений, к примеру, умножении на бесконечность.

Строка «string».

var string = ‘hello penguin!’; // Строки обычно хранят текстовые данные.

Важный нюанс! Запись формата var string = ‘123’ — это тоже строка, не число.

Булевый (логический) тип «boolean».

У него всего два значения: true (истина) и false (ложь). Как правило, такой тип используется для хранения значений типа да/нет.

Специальное значение «null».

Значение null не относится ни к одному из типов выше. Оно образует свой отдельный тип, состоящий из единственного значения null. Используется для того, чтобы обозначить переменной начальное «пустое» состояние (потому что 0 — это уже значение).

К примеру, у вас есть корзинка для яблок, но в ней яблок еще нет, то есть их 0. А NULL в таком случае — это когда нет даже самой корзинки.

var number = null; // создали контейнер для числа, но его еще нет, оно неизвестно;
number = 0; // присвоили цифру 0, теперь у нее точно определено значение и оно равно 0.

ВАЖНО! 0 — это не то же самое, что «пусто» ! 0 — тоже результат.

Специальное значение «undefined».

Значение undefined, как и null, образует свой собственный тип, состоящий из одного этого значения. Оно имеет смысл «значение не присвоено». Если переменная объявлена, но в нее ничего не записано, то ее значение как раз и есть undefined.

Объекты «object».

Первые 5 типов называют «примитивными». Особняком стоит шестой тип: «объекты». Он используется для коллекций данных и для объявления более сложных сущностей.

Объявляются объекты при помощи фигурных скобок {…}, например:

var penguin = {name : "Pingvi", age : ‘26’, email: ‘snow@arctica.com’ };

Теперь вы уже понимаете, какого рода данные могут встретиться на пути скриптов и как их правильно читать.

#3 Функция

Функция — это готовый набор кода с определенной функциональностью, который можно использовать повторно. К примеру, вы написали 100 строк кода в одном скрипте, а потом поняли, что его можно применить в еще одном месте, а потом в еще одном… Теперь у вас два варианта действий: каждый раз набирать один и тот же код заново или использовать функцию, в которой записаны эти 100 строк. Функция позволяет вызвать их просто по имени каждый раз, когда вам нужна определенная процедура.

Пример объявления функции:

function showMessage() {
  alert( 'Привет всем присутствующим!' );
}

Сначала идет ключевое слово function → дальше имя функции → список параметров в скобках (в примере выше он пустой) и тело функции — код, который выполняется при ее вызове.

Объявленная функция доступна по имени, например:

function showMessage() {
  alert( 'Привет всем присутствующим!' );
}

showMessage();
showMessage();

Этот код выведет сообщение два раза. Уже здесь видна главная цель создания функций — избавление от дублирования кода.

Если понадобится поменять сообщение или способ его вывода, достаточно изменить его в одном месте — в функции, которая его выводит.

Интересно! Весь код скрипта в целом всегда должен быть помещен внутри функции main().

Добавление всего скрипта в функцию main — требование самого Google. Это нужно, чтобы Google всегда знал, что нужно запустить, чтобы ваш скрипт работал. Именно внутри этой функции система запускает код. Без этого был бы полный хаос: каждый бы человек называл функцию, как ему нужно. Поэтому все, что вы пишете, все равно должно быть запущено внутри main — иначе работать не будет.

Иногда вы можете увидеть и такой вид скрипта:

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

Оба варианта допускаются и работают.

Структура скрипта Google Ads. Основные понятия

В этом разделе мы рассмотрим очень много материала: как выглядит скрипт, какие основные понятия нужно знать для работы со скриптами Google Ads, какие ошибки чаще всего допускают что разработчики, что РРС-специалисты при копировании скриптов из интернета. Поехали?

Структура скрипта

Скрипт может выглядеть вот таким образом:

function main() {
    /* главная функция запуска */
    func();
}

Ключевой момент: код должен быть помещен в функцию main. А уже сам формат, в котором вы его будете размещать туда, зависит от вас.

В этом случае весь код скрипта вынесен в отдельную функцию func, которая располагается где-то ниже по коду, это более полный пример:

Как видите, нужный нам код был вынесен в отдельную функцию с названием func(), но в коде есть еще скрытые места.

В самом низу скрипта есть 3 выделенных блока — это тоже функции, но уже другие, вспомогательные, которые выполняют определенную работу в рамках одного большого скрипта.
В рамках одного скрипта может быть неограниченное количество собственных функций. Эти функции могут быть несколько раз вложены друг в друга. Если вы видите подобные функции, значит, где-то дальше в этом коде они описаны. Найти их среди кода можно через поиск в браузере.

Обратите внимание: сколько бы функций вы ни вкладывали друг в друга, они не заработают, если самую главную функцию не поместить в main. Функция MAIN — точка запуска.

Основные понятия в рамках скриптов Ads

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

Пример:

Метод — это специальная функция, которая скрыта внутри сущностей Ads. Она написана со стороны Google и ее реализация от нас скрыта. Название «метод» пошло от специфики написания кода. Если не слишком глубоко рассматривать программирование, то объясняется это так:

Код можно писать в функциональном и в объектно-ориентированном стилях.
Когда вы пишете свой код в скриптах Google, вы пишете в функциональном стиле.
Код, написанный самим Google, оформлен в объектно-ориентированном стиле (ООП). Там уже используется название «метод».

Пример:

Теперь про сущности. Сущность — понятие, которым очень любят сыпать разработчики. На самом деле сущность — это описание элементов, которые можно объединить одним названием. К примеру, элементы стол, стул, тумбочка — это сущность «мебель»; Коля, Алена, Марина — это сущность «Пингвины»; мама, папа, я — сущность «семья». Таким образом, все составляющие аккаунта разбиты на сущности.

Вот пример в коде:

А вот пример из документации. Тут вы можете увидеть, как много сущностей в принципе существует в рамках аккаунта:

Это основные понятия, которые важно понимать в первую очередь. Но, конечно, список на этом не заканчивается. Если копать в детали, выясняется, что слово «метод» может иметь абсолютно разные значения в разных случаях.

К примеру, вот несколько методов:

withCondition( )
withIds( )
forDateRange( )
orderBy( )
withLimit( )

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

Например:

withCondition("LabelNames CONTAINS_ANY ['p.c.c.a']") // Имя метки содержит имя «p.c.c.a».
withCondition("CampaignStatus = ENABLED") // Статус кампании «включена».
withCondition("Impressions > 0") // Показов больше 0.

Чтобы получить 50 аккаунтов с меткой, которая содержит слово «accounts», мы используем вот такой прием:

var accountSelector = MccApp.accounts()
      .withCondition("LabelNames CONTAINS 'accounts'") // Указывает условие поиска: в метке есть «accounts».
      .withLimit(50); // Указывает лимит поиска: 50 штук.

Вот пример еще одного кода, где используются методы:

var accountIterator = MccApp.accounts()
.withCondition('Clicks > 10') // Фильтрует случаи, кликов больше 10.
.forDateRange('LAST_MONTH') // Диапазон времени — последний месяц. 
.orderBy('Clicks DESC') // Сортировка по кликам от большего к меньшему.
.get();

Вот уже пример с другим методом:

Это уже не метод-селектор, а метод-итератор — вспомогательный метод, позволяющий «перебирать» в циклах все ваши слова, кампании, аккаунты и прочее. Проще говоря, некий указатель на то, существует следующий элемент в списке или нет.

Цикл — это обход определенного количества данных (или выполнения набора команд) определенное количество раз. То есть повторение действия.

Углубляясь еще дальше, можно добраться до классификации методов — эта тема уже касается программирования. Есть методы, которые служат только для получения значений — геттеры. И есть методы, которые занимаются изменением (установкой) значений — сеттеры.

Вот краткий пример:

Но это уже, как говорится, совершенно другая история…

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

Топ ошибок в скриптах

№1. «Я скопировал, а оно не работает»

При копировании скрипта из интернета (особенно с текстовых страниц сайтов), обращайте внимания на кавычки, которые расставлены в коде. Например, вы видите на сайте код вот в таком формате:

Копируете его себе, вставляете… Но что то идет не так:

А ларчик просто открывался. Посмотрите, какие кавычки у вас стоят.

На сайте они проставлены довольно интересно, в виде красивых кавычек “”, которые позволяют выделить строку. Но вот беда: в программировании таких кавычек нет. Есть только одинарные и двойные.

Попробуем исправить код и посмотрим, что будет теперь:

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

Будьте бдительны, мойте руки перед едой и копируйте код правильно.

№2. «Впихнуть невпихуемое»

Нам пару раз попадались примеры, где два совершенно разных скрипта были заключены в одну функцию main в рамках одного скрипта. Это неправильно. Старайтесь разбивать скрипты. Вы должны понимать, что один скрипт — это одно назначение, не более.

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

№3. «Сейчас я сделаю другим больно»

Это ошибка касается не функциональности скрипта, а удобности его использования. И относится уже не столько к пользователям скриптов, сколько к их создателям.

Что имеется в виду? Давайте посмотрим на пример:

Что мы имеем? Вот тут скрипт говорит нам: «Если тебе что-то не нужно, просто напиши названия сюда». Но вот беда: названий-то может быть и 100 штук. А еще вы можете работать через MCC-аккаунт с десятком клиентов, и каждому нужно поставить этот скрипт и руками написать «то, что не нужно».

Юзер-френдлинесс этого скрипта стремится к абсолютному нулю, как вы понимаете.

Так вот, если мы пишем для себя и нам не лень вручную перечислять названия, или же мы «как умею, так и пишу» — то да, вопросов нет, можно делать скрипт каким-угодно. Но! Но если планируется делать скрипт достоянием общественности, важно довести его до нормальной кондиции.

Конкретный совет: завязывайте скрипты на метки (label). Метку прицепить гораздо быстрее, чем перечислить 100 наименований. Так что вывод этого пункта: делайте (или переделывайте) по-человечески.

№4. «Книги уже никто не читает»

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

Сразу пример, потом слова:

Вот невероятно большой скрипт, в котором нет ни одной строчки комментариев. Конечно, на сайте-источнике может быть краткая информация о том, как он работает, но вот изменить его самостоятельно вы, скорей всего, уже не сможете. Почему? Да потому что придется перечитывать скрипт полностью не один раз, чтобы понять логику автора и разобраться, как изменить ее под себя.

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

№5. «Тестировать — не мое дело»

Скачать, поставить и запустить скрипт очень легко. Но насколько вы уверены, что он сработает так, как нужно? А может быть скрипт удалит все объявления? А может поставит заоблачные цены в Google Shopping?

Если не хотите проколоться на чем-то подобном, проверяйте скрипт в режиме просмотра (preview) перед запуском. Это достаточно сделать только один раз.

Чтобы понять, что все работает правильно, достаточно посмотреть на вкладку LOGS. Если ошибки есть, в этой вкладке окажется уведомление о них с указанием на конкретные строки в скрипте.

Вот мы и разобрали основные понятия в скриптах, посмотрели на частые ошибки и варианты их решения. Теперь можем попрактиковаться!

Последний пункт в нашей программе, своего рода вишенка на тортике — это чтение и разбор скрипта.

Пример скрипта с пояснением

/*
* Разработано специалистами агентства Penguin-team
* © 2018 Penguin-team, Ukraine
* https://pengstud.com/
*/
function main() {
    /* главная функция запуска */
    func();
}

function func() {
    /* выбираем все включенные кампании с меткой p.c.c.a */
    var campaigns = AdWordsApp.campaigns().withCondition("LabelNames CONTAINS_ANY ['p.c.c.a']").withCondition("CampaignStatus = ENABLED").get();

    /* пока есть кампании, работаем */
    while (campaigns.hasNext()) {
        var campaign = campaigns.next();
        /* берем метку, которая начинается с фразы tcc (регистр не важен) */
        var positionLabel = campaign.labels().withCondition("LabelName STARTS_WITH_IGNORE_CASE 'tcc'").get().next().getName();
        /* получаем из названия метки значение желаемой позиции , например tcc1.5 => 1.5 */
        var position = parseFloat(positionLabel.replace(/[^\d.-]/g, ''));
        /* берем метку, которая начинается с фразы tcb (регистр не важен) */
        var bidBorderLabel = campaign.labels().withCondition("LabelName STARTS_WITH_IGNORE_CASE 'tcb'").get().next().getName();
        /* получаем из названия метки значение денег , например tcb10 => 110 */
        var bidBorder = parseFloat(bidBorderLabel.replace(/[^\d.-]/g, ''));
        /* устанавлиаем персональный бид бордер как 20% от того что указано в метке */
        var personalBidBorder = bidBorder * 0.2;
        /* скрипт для повышения позиции */
        raisePositionControl(campaign, bidBorder, position);
        /* скрипт для понижения позиции */
        lowerPositionControl(campaign, bidBorder, position);
        /* скрипт для изменения ставки */
        funcAddBids(campaign, bidBorder, personalBidBorder);
    }
}

function raisePositionControl(campaign, bidBorder, position) {
    /* получем включенные ключевые слова из кампании у которых есть показы, AveragePosition > 0 за вчера */
    var keywords = AdWordsApp.keywords().withCondition("Status = ENABLED").withCondition("CampaignName = '" + campaign.getName() + "'")
        .withCondition("Impressions > 0")
        .withCondition("AveragePosition > " + position)
        .orderBy("AveragePosition ASC")
        .forDateRange("YESTERDAY").get();

    /* для каждого ключевого слова работаем */
    while (keywords.hasNext()) {
        var keyword = keywords.next();
        /* берем статистику за вчера */
        var stats = keyword.getStatsFor('YESTERDAY');


        var positionCoef = 0.1;
        var positionDiff = position/stats.getAveragePosition();
        if (positionDiff >= 0.9) {
            positionCoef = 0.01;
        }

        /* делим позицию из метки tcc на среднюю позицию */
        var statsto = position / stats.getAveragePosition();

        /* производим магию просчета */
        statsto = 1 - statsto.toFixed(2) - positionCoef;

        /* изменяем только тогда, если результат рассчета больше  0*/
        if (statsto > 0 && stats.getAveragePosition() > 0) {
            statsto = keyword.getMaxCpc() + keyword.getMaxCpc() * statsto;
            if (statsto <= bidBorder) {
                keyword.setMaxCpc(statsto);
            } else {
                keyword.setMaxCpc(bidBorder);
            }
        }
    }
}


function lowerPositionControl(campaign, bidBorder, position) {
    /* получем включенные ключевые слова из кампании у которых есть показы, AveragePosition > 0 за вчера */
    var keywords = AdWordsApp.keywords().withCondition("Status = ENABLED").withCondition("CampaignName = '" + campaign.getName() + "'")
        .withCondition("Impressions > 0")
        .withCondition("AveragePosition < " + position)
        .orderBy("AveragePosition ASC")
        .forDateRange("YESTERDAY").get();
    /* для каждого ключевого слова работаем */
    while (keywords.hasNext()) {
        var keyword = keywords.next();
        /* берем статистику за вчера */
        var stats = keyword.getStatsFor('YESTERDAY');

        var positionCoef = 0.1;
        var positionDiff = stats.getAveragePosition()/position;
        if (positionDiff >= 0.9) {
            positionCoef = 0.01;
        }

        /* делим среднюю позицию  на позицию из метки tcc */
        var statsto = stats.getAveragePosition() / position;
        /* производим магию просчета */
        statsto = 1 - statsto.toFixed(2) - positionCoef;
        if (statsto > 0 && stats.getAveragePosition() > 0) {
            statsto = keyword.getMaxCpc() - keyword.getMaxCpc() * statsto;
            if (statsto <= bidBorder) {
                keyword.setMaxCpc(statsto);
            } else {
                keyword.setMaxCpc(bidBorder);
            }
        }
    }
}

/* изменение ставки */
function funcAddBids(campaign, bidBorder, personalBidBorder) {
    /* выбираем включенные слова с нулевыми показами за последние 7 дней */
    var keywords = AdWordsApp.keywords()
        .withCondition("Status = ENABLED")
        .withCondition("AdGroupStatus = ENABLED")
        .withCondition("CampaignName = '" + campaign.getName() + "'")
        .withCondition("Impressions = 0")
        .forDateRange("LAST_7_DAYS")
        .get();
    /* для каждого слова начинаем просчет */
    while (keywords.hasNext()) {
        var keyword = keywords.next();
        var topCpcKeyword = keyword.getTopOfPageCpc();
        var firstCpcKeyword = keyword.getFirstPageCpc();
        var nowCpcKeyword = keyword.getMaxCpc();
        if (topCpcKeyword !== null) {
            bidCreatorTop(bidBorder, personalBidBorder, keyword, topCpcKeyword, firstCpcKeyword, nowCpcKeyword);
        } else {
            bidCreatorFirst(bidBorder, personalBidBorder, keyword, topCpcKeyword, firstCpcKeyword, nowCpcKeyword);
        }
    }
}

function bidCreatorTop(bidBorder, personalBidBorder, keyword, topCpcKeyword, firstCpcKeyword, nowCpcKeyword) {
    if (bidBorder > topCpcKeyword && personalBidBorder <= topCpcKeyword && nowCpcKeyword < topCpcKeyword) {
        keyword.setMaxCpc(topCpcKeyword);
    } else if (bidBorder <= topCpcKeyword && nowCpcKeyword < topCpcKeyword && nowCpcKeyword < bidBorder) {
        keyword.setMaxCpc(bidBorder);
    }
}

function bidCreatorFirst(bidBorder, personalBidBorder, keyword, topCpcKeyword, firstCpcKeyword, nowCpcKeyword) {
    if (bidBorder > firstCpcKeyword && personalBidBorder <= firstCpcKeyword && nowCpcKeyword < firstCpcKeyword) {
        keyword.setMaxCpc(firstCpcKeyword);
    } else if (bidBorder <= firstCpcKeyword && nowCpcKeyword < firstCpcKeyword && nowCpcKeyword < bidBorder) {
        keyword.setMaxCpc(bidBorder);
    }
}

Давайте возьмем несколько участков кода и разберем их!

Код:

В этом участке кода происходит выборка сущности «кампания» с определенными селекторами (фильтрами). Конкретно нам нужны те, которые содержат метку p.c.c.a и только включенные кампании. Селекторы кампании работают по принципу «И» (И это И это И это).

В этом случае campaings — это переменная, в которую помещается список полученных кампаний с заданными параметрами.

Код:

Здесь же используется цикл с итератором next(). Он позволяет вам отработать каждую кампанию, которая была получена выше. Например мы получили 10 кампаний, соответственно у нас будет 10 итераций (повторов) цикла. И в каждом цикле мы будет работать только с одной кампанией.

Как же работает этот цикл?

В переменной campaigns содержится список кампаний (у нас — 10 штук). Далее запускается процесс, именуемый циклом, и в каждую итерацию (один проход) мы работаем только с одной кампанией из списка. Над каждой кампанией выполняется набор команд (операций, действий) внутри этого цикла. Для каждой кампании мы ищем метки с определенным названием, формируем bidBorder (границу ставки) и производим или понижение, или повышение ставки. Вот и все.

А вот пример работы с ключевыми словами:

Здесь мы выбираем ключевые слова с целым набором нужных нам характеристик и фильтром по времени (forDateRange). В примере — за вчерашний день. Так это и работает.

Собственно, вот такого умения базово читать скрипт уже достаточно для успешного применения в контекстной рекламе. Теперь вы можете понять, подходит ли вам выбранный скрипт, нет ли ошибок в алгоритме обработки данных, корректно ли все работает… и повышать свою продуктивность в разы!

Happy campaigning 🐧