NetPeak Biz Tech    


Как научиться читать скрипты Google Рекламы

Как научиться читать скрипты Google Рекламы

< >

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

Что такое скрипт Google Рекламы

По сути это фрагмент кода на языке JavaScript. Скрипты Google Рекламы позволяют автоматизировать рутинные и монотонные процессы. Каждый скрипт состоит из функций, переменных, объектов, сущностей, селекторов, итераторов и других элементов.

Что делают функции

Каждый скрипт начинается с записи функций, это обязательная часть кода. Функции запускают задачу или действия, которые будут повторяться постоянно.

Функции легко распознать по термину «function», за которым стоит название функции и пустые круглые скобки «()».

Например:

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

Часто в скриптах встречаются такие функции:

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

В принципе, минимального знания английского достаточно, чтобы это понять.

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

Как работают переменные

Как правило, после функции следует запись вроде «var campaign». «Var» — сокращение от variables, «переменные» в дословном переводе. Это контейнеры, в которых содержатся значения данных. Переменные обращаются к объектам и сущностям в Google Рекламе.

Переменную для каких-то определенных данных, например, ключевых слов, можно называть как угодно: «KW», «keywords». Главное, не менять названия в разных фрагментах скрипта, иначе ничего не сработает.

Что такое объекты

Это основа скрипта. Объекты по иерархии находятся выше сущностей (отдельным сущностями являются, например, кампании, группы объявлений) и по сути представляют из себя их коллекцию. В скриптах Google Рекламы четыре основных объекта: AdWordsApp, SpreadsheetApp, MccApp, UrlFetchApp.

Для основных скриптов достаточно использовать только объект AdWordsApp. Когда вы используете этот объект, то как бы сообщаете скрипту, что нужно посмотреть в Google Рекламе, чтобы найти нужные данные.

Если говорить о других объектах, то MccApp работает на уровне Центра клиентов AdWords (МСС) ; SpreadsheetApp позволяют использовать таблицы Google для отчетов, а UrlFetchApp позволяет скриптам использовать данные сторонних сервисов и приложений.

Что такое сущности

Объекты состоят из сущностей. Для AdWordsApp это:

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

Возьмем переменную «keywords» — она связана с сущностью «keywords» в объекте AdwordsApp. Чтобы составить одно выражение — строку скрипта, разместим между ними знак равенства:

var keywords = AdWordsApp.keywords()

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

Как работают селекторы

Селекторы служат для фильтрации и сортировки данных.

Чаще всего используются:

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

Например, вот этот код:

var campaignSelector = AdWordsApp.campaigns () .withCondition(\"CampaignStatus = \\\'ENABLED\\\'\"). withCondition(“Clicks > 10”).withCondition(“Impressions > 100”) .forDateRange(“TODAY”) ;

Переводится так: выбрать активные кампании в аккаунте Google Рекламы, которые получили более 10 кликов и 100 показов за сегодня.

Обратите внимание: при использовании нескольких условий .withCondition() скрипт сработает по принципу «и», а не «или». То есть необходимый объект должен соответствовать всем указанным условиям.

Как работают итераторы

Итераторы в скрипте — аналог комaнды «Идем дальше!». Они всегда идут в скрипте после селекторов и отвечают за то, чтобы скрипт без остановки двигался по аккаунту в поисках необходимого ему значения (или значений). Итераторы перебирают все варианты ключевых слов или любых других сущностей, пока не найдут то, что задано в условии.

В итераторе должен быть фрагмент next(), который при каждом обращении возвращает объект со свойствами:

  • value — если есть очередное значение;
  • done = false — если есть ещё значения;
  • done = true — в конце ответа.

Пример итератора:

while (keywords.hasNext()) {var keyword = keywords.next()

Читаем скрипт Google Рекламы

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

Выводы

  1. Каждый скрипт состоит из функций, переменных, объектов, сущностей, селекторов, итераторов.
  2. Функции запускают задачу или действия, которые будут повторяться постоянно.
  3. Переменные содержат значения данных и обращаются к объектам и сущностям в Google Рекламе.
  4. Для основных скриптов достаточно использовать только объект AdWordsApp. Когда вы используете этот объект, то как бы сообщаете скрипту, что нужно посмотреть в Google Рекламе, чтобы найти нужные данные.
  5. Объекты в AdwordsApp состоят из сущностей: аккаунта, кампаний, ключевых слов и так далее.
  6. Селекторы служат для фильтрации и сортировки данных.
  7. Итераторы отвечают за то, чтобы скрипт без остановки двигался по аккаунту в поисках необходимого ему значения (или значений).

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

Читайте также:



Комментарии:

Инсталлы по цене пирожка — кейс Apple Search Ads для приложения OLX Украина

Инсталлы по цене пирожка — кейс Apple Search Ads для приложения OLX Украина Как с помощью рекламы в Apple Search Ads получить дешевые установки и привлечь релевантных пользователей среди владельцев айфонов...

08 06 2026 5:59:47

Запускаем блоги на орбиту — МКС от Netpeak

Запускаем блоги на орбиту — МКС от Netpeak Грамотный контент важен для всех, но особенно — для аутсорсов и стартапов в B2B. Если вы согласны с этим, давайте делать медиа....

07 06 2026 6:32:49

Как получить рентабельность кампаний 400%, используя таргетированную рекламу в Facebook — кейс Secunda

Как получить рентабельность кампаний 400%, используя таргетированную рекламу в Facebook — кейс Secunda Все дело в формате объявлений Instant Experience с подключенным каталогом товаров. Нет, не только в нем. Узнать больше!...

06 06 2026 16:16:16

Как провести анализ юзабилити сайта онлайн

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

05 06 2026 8:46:57

Скелеты в шкафу РСЯ: как эффективно построить рекламную кампанию?

Как создавать результативные кампании в Рекламной сети Яндекса...

04 06 2026 8:28:21

Как привлечь на 174% больше звонков с помощью видеорекламы — кейс клиники лазерной косметологии Goldlaser.com.ua

Как привлечь на 174% больше звонков с помощью видеорекламы — кейс клиники лазерной косметологии Goldlaser.com.ua Клиникка использует лазеры и нуждается в продвижении. В специфических сферах привлечь потребителя впервые бывает сложнее и дороже, чем удержать его. Этот кейс о том, как повысить количество обращений новых клиентов с помощью видеорекламы...

03 06 2026 17:10:52

Странные сайты — 40 диких, симпатичных и очень талантливых ресурсов

Странные сайты — 40 диких, симпатичных и очень талантливых ресурсов И уж если бумага стерпит все, интернет — тем более, а значит онлайн-исповедальне быть! И не только ей......

02 06 2026 21:18:13

Какой сервис автоматического продвижения выбрать

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

01 06 2026 1:21:16

Как запустить R и R Studio в Google Cloud Platform

Как запустить R и R Studio в Google Cloud Platform Используем возможности Google Cloud Platform в работе с R...

31 05 2026 0:23:24

Как передать данные из Google ***ytics в таблицы с помощью GTM

Как передать данные из Google ***ytics в таблицы с помощью GTM Не все события удобно отслеживать в Google ***ytics, иногда удобнее сделать связку с таблицами Google. А поможет в этом Google Tag Manager...

30 05 2026 21:56:16

Владимир Усов: о цифровом сторителлинге XXI века и конструкторском бюро идей Gutenbergz

Владимир Усов: о цифровом сторителлинге XXI века и конструкторском бюро идей Gutenbergz Красивый слог и сюжет должны быть в интеpaктивной оболочке, соответствующей времени. Проект Gutenbergz идет к созданию именно такой — идеальной истории для людей XXI века. О пути к этой цели, топе App Store и успехе на Kickstarter мы поговорили с руководи...

29 05 2026 2:57:30

Facebook Like или Share?

Facebook Like или Share? Facebook buttons. Пора поделиться самым волнующим вопросом 2011-го года...

28 05 2026 11:17:15

Что такое фишинговая ссылка и как проверить сайт на её наличие

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

27 05 2026 1:16:32

Как визуализировать показатель качества ключевых слов — рецепт скрипта на языке R

Как визуализировать показатель качества ключевых слов — рецепт скрипта на языке R Как узнать слабые места ваших рекламных кампаний с помощью бесплатного скрипта....

26 05 2026 17:16:25

Особенности контекстной рекламы для 5 ниш бизнеса. Тематические стратегии Netpeak

Особенности контекстной рекламы для 5 ниш бизнеса. Тематические стратегии Netpeak Что учитывать при продвижении недвижимости, клиник красоты, магазинов косметики, сайтов по продаже семян, шин?...

25 05 2026 9:30:37

Как связать Microsoft Power BI и Google BigQuery

Как связать Microsoft Power BI и Google BigQuery Как визуализировать данные Google BigQuery в Power BI? Пошаговая инструкция от руководителя отдела веб-аналитики Netpeak Алексея Селезнева...

24 05 2026 10:28:23

Funnel Based модель атрибуции в OWOX BI — руководство по настройке

Funnel Based модель атрибуции в OWOX BI — руководство по настройке Как настроить многокaнaльную модель атрибуции для своего бизнеса....

23 05 2026 16:50:46

Кейс по таргетированной рекламе в тематике «нижнее белье» или как увеличить продажи перед праздниками: ROMI 29%

Кейс по таргетированной рекламе в тематике «нижнее белье» или как увеличить продажи перед праздниками: ROMI 29% Для продвижения интернет-магазина женского нижнего белья мы решили попробовать новый источник привлечения клиентов....

22 05 2026 10:59:13

Как работать с ключевыми словами в Excel

Как работать с ключевыми словами в Excel Как определить и повысить качество парсинга ключевых слов — лайфхак с применением Microsoft Excel....

21 05 2026 23:51:33

Как настроить автоматические правила в Facebook? Подробное руководство

Как настроить автоматические правила в Facebook? Подробное руководство Правила Facebook позволяют пользоваться автоматизированным контролем над эффективностью рекламы. Читайте, как уменьшить количество ручной работы с помощью автоматических правил...

20 05 2026 14:49:51

Как не сломать работу автостратегий Google, когда на сайте произошел сбой — используем «Исключение данных»

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

19 05 2026 5:45:32

Настраиваем отслеживание печати страниц в Google ***ytics

Как настроить просто и быстро настроить скрипт в Google ***ytics для отслеживания печати страниц сайта....

18 05 2026 7:42:19

Сотрудницы Netpeak Group о своей работе над проектами, самоорганизации, хобби — дайджест постов

Сотрудницы Netpeak Group о своей работе над проектами, самоорганизации, хобби — дайджест постов Сегодня именно тот день, когда пора решиться и отправить своё резюме в нашу компанию....

17 05 2026 8:54:41

Universal App Campaign 2.0 в Google Рекламе — как выжать максимум пользы

Universal App Campaign 2.0 в Google Рекламе — как выжать максимум пользы Как сделать рекламу в Universal App Campaign 2.0 максимально эффективной...

16 05 2026 18:57:28

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

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

15 05 2026 17:26:55

Антикейс: продвижение Endorphone.com.ua с помощью видеоблогеров

Как избежать ошибок при продвижении интернет-магазина с помощью видеоблогеров....

14 05 2026 20:14:41

Правила хорошего тона при создании Google Презентаций

Правила хорошего тона при создании Google Презентаций Как сделать красиво. Алгоритм подготовки красивых и понятных презентаций, рекомендации и полезные ссылки, а также простые правила хорошего тона в дизайне Google Презентаций. Узнать больше и сделать свою презентацию эффективнее!...

13 05 2026 12:36:35

Редизайн писем в email-маркетинге — на что обратить внимание

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

12 05 2026 22:41:27

Что такое мотивированные установки и стоит ли тратить на них деньги

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

11 05 2026 2:56:15

Исследование о влиянии отзывов в интернете на решение о покупке

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

10 05 2026 14:12:51

Что делать со старыми статьями в блоге

Что делать со старыми статьями в блоге Что делать контент-маркетологам, когда все тексты в интернете начнут генерировать боты? Спойлер: обновлять старый контент....

09 05 2026 2:46:12

Текст для главной страницы сайта — правила, требования и примеры

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

07 05 2026 11:43:46

Полезные сервисы для оптимизации удаленной работы

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

06 05 2026 19:50:44

Дополнительные функции Zoom

Дополнительные функции Zoom Как обойти «Зал ожидания» и другие неочевидные фишки...

05 05 2026 0:26:15

Как мы сделали инструмент веб-аналитики для сайта Ecommerce

Как мы сделали инструмент веб-аналитики для сайта Ecommerce Зачем амбициозным онлайн-проектам индивидуальные инструменты веб-аналитики....

04 05 2026 0:27:24

Турбо-страницы Яндекса — что это и как внедрить

Турбо-страницы Яндекса — что это и как внедрить Создаём страницы, которые быстро загружаются на мобильных устройствах....

03 05 2026 20:39:36

Как составить поисковые объявления для Google Ads и Яндекс.Директ

Как составить поисковые объявления для Google Ads и Яндекс.Директ Правила, требования, особенности. А ещё примеры, которые помогут создать правильную, с точки зрения поисковиков, рекламу. Читать!...

02 05 2026 10:29:28

Как настроить запуск R-скрипта по расписанию?

Как настроить запуск R-скрипта по расписанию? Работаете со скриптами R регулярно? Потратьте десять минут на настройку автозапуска и избавьтесь от необходимости активировать R-скрипты вручную...

01 05 2026 1:18:46

Netpeak Group купила конференцию eCommerce от OWOX

Конференцию eCommerce будет развивать комaнда Octopus Events...

30 04 2026 1:46:22

Google показывает не все результаты поиска

Google показывает не все результаты поиска Сколько страниц на самом деле показывает и может перевести поисковик Google?...

29 04 2026 20:28:20

Как привлечь клиентов в 2021 году. Способы лидогенерации, о которых вы могли не знать

Как привлечь клиентов в 2021 году. Способы лидогенерации, о которых вы могли не знать Как снизить стоимость лидов путём использования новых технологий...

28 04 2026 4:51:28

Продвижение мобильных игр — расшифровка терминов и аббревиатур

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

27 04 2026 12:32:59

Сколько стоил клик в Google Ads и Facebook в Украине в третьем квартале 2018 года

Сколько стоил клик в Google Ads и Facebook в Украине в третьем квартале 2018 года Данные по 43 миллионам кликов в 27 тематиках и 391 городах страны...

26 04 2026 22:52:56

Перфекционизм, отмена: как маркетологам писать статьи

Перфекционизм, отмена: как маркетологам писать статьи Личный опыт экс-главреда экс-блога Netpeak (сейчас — Netpeak Journal): о работе с информацией, мотивации написания, редактуре черновика, подаче информации по степени важности, выделении главного и составлении окончательной версии текста. Как сделать текст логичным и полезным? Узнайте!...

25 04 2026 9:12:58

Кейс: как провести анализ конкурентов с помощью SimilarWeb

Кейс: как провести анализ конкурентов с помощью SimilarWeb Определение, исследование и проверка конкурентов в Similarweb — первый шаг перед запуском и масштабированием проекта...

24 04 2026 4:22:30

Как обойти агрегаторы и маркетплейсы в выдаче: пошаговая инструкция

Как обойти агрегаторы и маркетплейсы в выдаче: пошаговая инструкция Доминирование маркетплейсов и агрегаторов в Яндексе усилилось. Первый магазин появляется не раньше 5 позиции. Поэтому компания Alto подготовила пошаговое руководство - как обойти агрегаторы в выдаче....

23 04 2026 17:24:54

Как улучшить показатель качества в Google Ads

Как улучшить показатель качества в Google Ads Раскрываем тайны показателя качества в рекламе гугл с помощью API...

22 04 2026 19:33:20

Платиновые правила продающего видеоконтента на YouTube

Платиновые правила продающего видеоконтента на YouTube Каким правилам нужно следовать, чтобы создать эффективный рекламный ролик?...

21 04 2026 1:22:31

Интересные Telegram-каналы о бизнесе

Интересные Telegram-каналы о бизнесе От идеи для стартапа до плана развития и масштабирования бизнеса. Познавательные, полезные каналы, которые помогут реализовать смелые бизнес-цели. Узнать больше!...

20 04 2026 15:33:47

Еще:
понять и запомнить -1 :: понять и запомнить -2 :: понять и запомнить -3 :: понять и запомнить -4 :: понять и запомнить -5 :: понять и запомнить -6 :: понять и запомнить -7 ::