Миграция с Google AdWords API на Google Ads API: подробный мануал
Я неоднократно рассказывал о том, как с помощью языка R и пакета RAdwords запрашивать данные из рекламных аккаунтов одной из наиболее популярных в мире рекламных платформ Google Ads (ex Google AdWords).
Проблема в том, что пакет RAdwords работает с Google AdWords API версии 201809. Данный API давно не обновляется и прекратит работу 27 апреля 2022 года.
В этой статье я расскажу о новом пакете — rgoogleads, работу над котором я начал в июне 2021 года. На данный момент в пакете реализованы все необходимые для запроса данных функции. Далее мы подробно разберёмся с тем, как перейти с RAdwords на rgoogleads, для того, чтобы с апреля 2022 года ваши скрипты по прежнему корректно собирали необходимые данные из рекламных аккаунтов в Google Ads.
Эта статья полезна тем, у кого есть некоторые навыки написания кода на языке R и работы с пакетом RAdwords. Но даже если вы впервые слышите про этот язык и RAdwords, в статье будут примеры кода. Вам необходимо подставить идентификаторы ваших Google Ads аккаунтов и запросить нужные данные.
Возможности пакета rgoogleads
На данный момент пакет rgoogleads включает в себя весь необходимый функционал для запроса данных из Google Ads API:
- авторизация в API Google Ads;
- загрузка списка аккаунтов верхнего уровня;
- загрузка всей иерархии аккаунтов из управляющих аккаунтов;
- загрузка объектов рекламного кабинета: кампании, группы объявлений, объявления и другое;
- загрузка статистических данных из рекламных аккаунтов;
- загрузка метаданных ресурсов, полей ресурсов, сегментов и метрик;
- загрузка прогноза и исторических данных из планировщика ключевых слов.
Преимущества пакета rgoogleads
Теперь давайте разберёмся, какие преимущества дает переход на новый пакет rgoogleads:
- rgoogleads работает с Google Ads API v8 (релиз от 09.06.2021), RAdwords работает с Google AdWords API v201809. Google AdWords API прекратит работу 27.04.2022;
- для авторизации rgoogleads использует пакет gargle, что даёт гораздо больше гибкости по сравнению с тем, как устроен процесс авторизации в RAdwords;
- в rgoogleads есть вшитый токен разработчика Google Ads и OAuth клиент для авторизации. Это избавит большинство пользователей от необходимости запрашивать у поддержки Google базовый доступ к API Google Ads и тратить время на создание проекта и OAuth клиента в Google Cloud Console;
- у большинства функций rgoogleads аргумент cl, который позволяет осуществлять загрузку данных в многопоточном режиме;
- в отличие от RAdwords, у rgoogleads есть функции для загрузки списков и иерархии аккаунтов;
- у rgoogleads есть отдельные функции для загрузки основных объектов рекламных кабинетов, таких как рекламные кампании, группы объявлений, ключевые слова и объявления;
- за счёт того, что запрос данных не разделён на отдельные функции, синтаксис rgoogleads более понятный и лаконичный. В RAdwords вам необходимо было изначально создать запрос функцией statement(), после чего использовать его для запроса данных в функции getData() ;
- у rgoogleads нет проблем при загрузке названий, содержащих кириллицу;
- если запрос к API столкнулся со сбоем на сервере (статус ответа 429 или выше), пакет rgoogleads автоматически выждет паузу в 100 секунд и повторит попытку запросить данные. За счёт этого работа данного пакета более стабильна и устойчива к сбоям на сервере Google Ads API;
- rgoogleads выводит подробное сообщение об ошибке. Для сравнения, если пользователь допустил ошибку в составлении запроса, RAdwords не выводит никакие сообщения;
- rgoogleads позволяет запрашивать данные из планировщика ключевых слов.
Основные различия между Google AdWords API и Google AdsAPI
К счастью, ключевых различий между устаревшим и новым API не так много, и процесс миграции не должен вызвать у вас особых сложностей. Ниже я перечислю ключевые моменты миграции.
- нет необходимости менять автоионизационные данные, токен разработчика, id и secret OAuth клиента будут работать также и с новым Google Ads API;
- в AdWords API отчёты были выделены в отдельную службу, в Google Ads API отчёты являются частью одного сервиса. Вам достаточно включить в отчёты необходимые поля с метриками, которые нужно получить;
- В AdWords API существовали типы отчётов, например, CAMPAINGN_PERFORMANCE_REPORT. В Google Ads API их нет, вместо типов отчётов представлен огромный набор ресурсов;
- у AdWords API и Google Ads API разный формат ответа от API;
- в Google Ads API отсутствует параметр includeZeroImpressions, вместо него вы можете использовать фильтр metrics.impressions > 0.
Установка rgoogleads
Пакет уже доступен для скачивания из CRAN, но в связи с тем, что сейчас он находится в активной стадии разработки, я рекомендую устанавливать наиболее актуальную версию из GitHub.
# установка из github devtools::install_github(\\\'selesnow/rgoogleads\\\')
В течение нескольких месяцев окончательно сформируется функционал пакета, после чего рекомендовую установку именно из CRAN.
# установка из CRAN install.packages(\\\'rgoogleads\\\')
Как устроена авторизация в rgoogleads
Работа пpaктически с любым API начинается с авторизации. Здесь используется функционал пакета gargle. В связи с чем, процесс авторизации будет хорошо знаком пользователям таких пакетов как googlesheets4, googledrive, bigrquery, google***yticsR.
Самый простой способ пройти авторизацию — использовать функцию gads_auth(), передав в неё логин, под которым вам необходимо авторизоваться. Наверняка именно этот способ выберет большинство пользователей пакета:
gads_auth(email = \\\'me@gmail.com\\\')
После запуска функции gads_auth() вы будете перенаправлены в браузер, где необходимо предоставить пакету все необходимые разрешения.
Если вы всё сделали правильно, появится сообщение «Authentication complete. Please close this page and return to R».
Для более продвинутых пользователей существует возможность настройки конфигурации авторизации. То есть, если есть свой токен разработчика Google Ads и / или OAuth клиент, вы можете пройти авторизацию, используя свои учётные данные. Настроить конфигурации авторизации можно с помощью функции gads_auth_configure().
Основные аргументы функции gads_auth_configure():
- path — путь к JSON файлу с данными OAuth клиента;
- app — данные OAuth клиента, созданные через функцию httr::oauth_app() ;
- developer_token — ваш токен разработчика
При настройке конфигурации важно учитывать:
- У компании, то есть юридического лица, может быть только один токен разработчика;
- При первом использовании OAuth клиент из проекта Google Cloud с токеном разработчика, идентификатор клиента привязывается к токену разработчика и не может использоваться с другим токеном разработчика. Другими словами:
- токен разработчика можно использовать с несколькими идентификаторами клиентов;
- идентификатор OAuth клиента можно использовать только с одним токеном разработчика.
Если вы используете собственный токен разработчика, необходимо использовать созданный вами OAuth клиент. Если используете встроенный токен разработчика, можете использовать либо встроенный OAuth клиент, либо свой OAuth клиент.
О том как создать и настроить OAuth клиент (приложение в Google Cloud) читайте в статье «Как загрузить данные из API Google ***ytics в R: часть 2».
Собственный токен разработчика можно запросить только из управляющего аккаунта, меню Инструменты — Центр API.
Если вам необходимо пройти авторизацию, используя свой токен разработчика, и/или собственный OAuth клиент, воспользуйтесь следующим примером кода:
# конфигурация авторизации gads_auth_configure( path = \\\'C:/auth/app.json\\\', developer_token = \"own developer token\" ) # авторизация gads_auth(email = \\\'me@gmail.com\\\')
Опции пакета rgoogleads
Для более удобной работы и исключения необходимости установки одних и тех же аргументов в каждой функции пакета, в rgoogleads добавлены функции установки опций. Установленные опции действуют в ходе текущей R сессии.
- gads_set_customer_id() — установить идентификатор клиентского аккаунта, из которого вы будете запрашивать данные в течении сессии. Также можно установить сразу несколько аккаунтов с помощью с (“111-111-1111”, “222-222-2222”).
- gads_set_login_customer_id() — установка идентификатора управляющего аккаунта. Используйте опцию только, если работаете с рекламными аккаунтами, подчинёнными в управляющем аккаунте.
# идентификатор управляющего аккаунта gads_set_login_customer_id(\"xxx-xxx-xxxx\") # установка клиентского аккаунта gads_set_customer_id(\"yyy-yyy-yyyy\")
Загрузка отчётов из Google Ads с помощью rgoogleads
Теперь можно запросить отчёты по рекламным кампаниям, группам объявлений или любым другим ресурсам:
group_report <- gads_get_report( resource = \"ad_group\", fields = c(\"ad_group.campaign\", \"ad_group.id\", \"ad_group.name\", \"ad_group.status\", \"metrics.clicks\", \"metrics.cost_micros\"), date_from = \"2021-06-10\", date_to = \"2021-06-17\", where = \"ad_group.status = \\\'ENABLED\\\'\", order_by = c(\"metrics.clicks DESC\", \"metrics.cost_micros\"), limit = 30000 )
В Google Ads API есть огромное количество ресурсов, по которым вы можете запрашивать информацию с помощью функции gads_get_report().
Список и описание всех доступных ресурсов можно найти в официальной документации Google Ads API или запросить функцией gads_get_metadata().
resources <- gads_get_metadata(\"RESOURCE\")
У каждого ресурса есть собственный набор доступных полей. Посмотреть набор полей можно либо в документации, либо запросить с помощью функции gads_get_fields().
ad_group_fields <- gads_get_fields(\"ad_group\")
Миграция с RAdwords на rgoogleads
Ниже приведу таблицу соответствия функций в пакетах RAdwords и rgoogleads.
Операция | RAdwords | rgoogleads |
Авторизация | doAuth() | gads_auth_configure() + gads_auth() |
Запрос метаданных | reports(), metrics() | gads_get_metadata(), gads_get_fields() |
Запрос отчётов | statement() + getData() | gads_get_report() |
Бывшие в Google AdWords типы отчётов, в Google Ads стали ресурсами. Ниже — таблица сопоставления из официальной справки:
Тип отчёта в Google AdWords API | Ресурс в Google Ads API |
ACCOUNT_PERFORMANCE_REPORT | customer |
AD_PERFORMANCE_REPORT | ad_group_ad |
ADGROUP_PERFORMANCE_REPORT | ad_group |
AGE_RANGE_PERFORMANCE_REPORT | age_range_view |
AUDIENCE_PERFORMANCE_REPORT | campaign_audience_view, ad_group_audience_view |
AUTOMATIC_PLACEMENTS_PERFORMANCE_REPORT | group_placement_view |
BID_GOAL_PERFORMANCE_REPORT | bidding_strategy |
BUDGET_PERFORMANCE_REPORT | campaign_budget |
CALL_METRICS_CALL_DETAILS_REPORT | call_view |
CAMPAIGN_AD_SCHEDULE_TARGET_REPORT | ad_schedule_view |
CAMPAIGN_CRITERIA_REPORT | campaign_criterion |
CAMPAIGN_PERFORMANCE_REPORT | campaign |
CAMPAIGN_SHARED_SET_REPORT | campaign_shared_set |
CAMPAIGN_LOCATION_TARGET_REPORT | location_view |
CLICK_PERFORMANCE_REPORT | click_view |
DISPLAY_KEYWORD_PERFORMANCE_REPORT | display_keyword_view |
DISPLAY_TOPICS_PERFORMANCE_REPORT | topic_view |
GENDER_PERFORMANCE_REPORT | gender_view |
GEO_PERFORMANCE_REPORT | geographic_view, user_location_view |
KEYWORDLESS_QUERY_REPORT | dynamic_search_ads_search_term_view |
KEYWORDS_PERFORMANCE_REPORT | keyword_view |
LABEL_REPORT | label |
LANDING_PAGE_REPORT | landing_page_view, expanded_landing_page_view |
PAID_ORGANIC_QUERY_REPORT | paid_organic_search_term_view |
PARENTAL_STATUS_PERFORMANCE_REPORT | parental_status_view |
PLACEHOLDER_FEED_ITEM_REPORT | feed_item, feed_item_target |
PLACEHOLDER_REPORT | feed_placeholder_view |
PLACEMENT_PERFORMANCE_REPORT | managed_placement_view |
PRODUCT_PARTITION_REPORT | product_group_view |
SEARCH_QUERY_PERFORMANCE_REPORT | search_term_view |
SHARED_SET_CRITERIA_REPORT | shared_criterion |
SHARED_SET_REPORT | shared_set |
SHOPPING_PERFORMANCE_REPORT | shopping_performance_view |
URL_PERFORMANCE_REPORT | detail_placement_view |
USER_AD_DISTANCE_REPORT | distance_view |
VIDEO_PERFORMANCE_REPORT | video |
Соответствие полей «Отчёт» и полей ресурсов можно найти в официальной справке. Таблица очень большая, поэтому не вижу смысла дублировать её здесь.
Ниже приведу пример запроса отчёта по эффективности рекламных кампаний с одним и тем же набором полей, с помощью пакета RAdwords и rgoogleads.
Запрос отчёта по эффективности рекламных кампаний с помощью RAdwords
library(RAdwords) # авторизация adwords_auth <- doAuth() # составляем запрос query <- statement( select = c(\\\'CampaignName\\\', \\\'Date\\\', \\\'Clicks\\\'), report = \\\'CAMPAIGN_PERFORMANCE_REPORT\\\', start = \\\'2021-06-01\\\', end = \\\'2021-06-30\\\' ) # загрузка данных data1 <- getData( clientCustomerId = \\\'xxx-xxx-xxxx\\\', statement = query, google_auth = adwords_auth )
Запрос отчёта по эффективности рекламных кампаний с помощью rgoogleads
library(rgoogleads) # авторизация gads_auth_configure(path = \\\'D:/ga_auth/app.json\\\') gads_auth(email = \\\'me@gmail.com\\\') # загрузка данных data2 <- gads_get_report( resource = \\\'campaign\\\', fields = c(\\\'campaign.name\\\', \\\'segments.date\\\', \\\'metrics.clicks\\\'), date_from = \\\'2021-06-01\\\', date_to = \\\'2021-06-30\\\', customer_id = \\\'676-642-7440\\\', login_customer_id = \\\'xxx-xxx-xxxx\\\' )
Полезные ссылки
На данный момент в освоении rgoogleads вам помогут:
Заключение
Если вы используете для загрузки данных из рекламных кабинетов RAdwords, то уже сейчас стоит начать перевод своих скриптов на пакет rgoogleads. В противном случае сбор данных из ваших аккаунтов скорее всего перестанет работать с 27 апреля 2022 года.
Материал изложенный в статье может быть использован даже тем, кто ранее не сталкивался с запросом данных из Google AdWords API или Google Ads API. Вам достаточно установить язык R и среду разработки RStudio, скопировать из статьи примеры кода, и подставить свои идентификаторы аккаунтов. Если вам нужна помощь в установке необходимого программного обеспечения посмотрите этот видео урок. Также начать изучения языка R можно с бесплатного курса «Язык R для пользователей Excel».
Если вы интересуетесь или планируете начать изучение языка R? вам наверняка будет полезен мой telegram и youtube канал R4marketing.
Буду рад ответить на ваши вопросы в комментариях.
Комментарии:
Google Penguin официально стал частью основного алгоритма поисковика. Как обезопасить свой бизнес и встретить апдейт алгоритма Google во всеоружии? О трафике, анкорах, бэклинках, ссылках и ссылочной массе, трастовости и постоянном мониторинге, с комментариями специалистов...
19 07 2025 20:20:42
12 идей для видеоконтента и расскажем, где их лучше размещать, чтобы зрители стали клиентами. Как использовать видео для повышения продаж? Длинный, но все равно неполный список форматов. Читайте дальше и предлагайте свои варианты!...
18 07 2025 19:24:29
Чем полезна вкладка Network в DevTools для SEO-специалиста...
17 07 2025 9:40:52
Процесс привлечения сторонних ресурсов отнимает основную часть времени у большинства основателей стартапов. Читайте руководство, которое поможет сделать этот процесс во время серии А более эффективным....
16 07 2025 13:20:12
Мы отключили интернет всем сотрудникам агентства интернет-маркетинга и получили удивительные результаты....
15 07 2025 21:48:15
Забавные и полезные штуки от Google и как их найти...
14 07 2025 12:31:16
2013, 2014, 2015 — годы, когда конференция 8p радовала все сео-сообщество СНГ. Прошла она и в 2016 году. Мы собрали лучшие советы интернет-магазинам от экспертов и участников круглого стола на конференции 8P 2016....
13 07 2025 1:54:12
Пока вы не осознаете причины, почему вам выгодно не хвалить, забудьте про качественную обратную связь и максимальную включенность комaнды. Фишки управления собой, людьми и проектами....
12 07 2025 7:51:26
Как настроить и получить эффективную отдачу от Google Local Campaigns...
11 07 2025 8:11:14
Крауд-маркетинг предполагает взаимодействие с целевой аудиторией с помощью рекомендательных комментариев на форумах, сайтах вопросов и ответов, в блогах, на других площадках...
10 07 2025 6:44:24
Мануал для SEO-специалистов, как автоматизировать сбор данных из блока People also ask (Пользователи также ищут). Это блок, который показывается в верхней части страницы результатов поиска. Он нужен, чтобы уточнить запрос пользователя....
09 07 2025 22:57:36
Зачем нужен мемуарник, как отличить истинные цели от навязанных и многое другое....
08 07 2025 11:51:49
Интересный и важный документ, не пропустите. Для ранжирования используется сумма коммерческой и тематической релевантности. Уходя с головой в SEO, многие вебмастера забывают о пользовательских факторах. Узнайте больше об этом!...
07 07 2025 18:23:28
Пожар в дата-центре, неудачные обновления и то самое падение Facebook....
06 07 2025 6:22:28
Какие форматы видеорекламы логичнее купить для создания спроса на новую продукцию? Выясняем на примере кейса бренда Yves Rocher...
05 07 2025 2:24:50
Как найти релевантный сайт-донор для размещения своей ссылки...
04 07 2025 23:30:16
Как правильно писать нарицательное слово «интернет»....
03 07 2025 18:30:42
Всё об оценке эффективности SEO-продвижения с инструментами и рекомендациями...
02 07 2025 7:39:27
«Rework» — одна из самых любимых книг нетпиковцев....
01 07 2025 19:32:13
Alexa Rank учитывает как число страниц, так и количество просмотров страниц. Alexa Rank 1, что означает, что все сайты и сервисы Google посещают больше всего посетителей в интернете....
30 06 2025 10:31:48
Обсуждаем, как попробовать инфлюенсер-маркетинг без особого бюджета...
29 06 2025 5:56:45
K-pop заpaбатывает деньги: как и сколько...
28 06 2025 1:54:41
Фишка, которую можно позволить себе даже когда портал продает всего несколько товаров или услуг...
27 06 2025 0:16:18
Стоит установить и освоить Google Tag Manager для расширения представления сайта в выдаче...
26 06 2025 22:20:53
Как с помощью ботов ControllerBot и BotFather упростить управление каналами и разнообразить контент....
25 06 2025 9:47:23
Сезонность — повторяющиеся колебания трафика сайта в зависимости от различных внешних факторов....
24 06 2025 4:32:48
Чтобы раскрутить себя в Твиттер иногда нужно чистить списки фолловеров и это намного проще, чем кажется :)...
23 06 2025 16:10:26
Как настроить эксперимент на сайте без сторонней помощи...
22 06 2025 11:50:19
Как найти сетку сайтов конкурентов — рассказываем о популярных методах и секретных фишках. Бонус — инструкция по выявлению PBN конкурентов. Читать дальше!...
21 06 2025 5:36:30
Помимо полезного и качественного продукта, услуги, компании нужен мощный маркетинг. И возможно это только благодаря хорошему директору по маркетингу. Только так это работает. Кто лучшие в этой нише в Казахстане? Узнать!...
20 06 2025 9:44:37
Как научиться продвигать мобильные приложения и заpaбатывать на этом....
19 06 2025 19:58:17
После того, как мы разобрали виды мобильных версий сайтов, их плюсы и минусы — стоит поговорить о сервисах, которые облегчают аудит....
18 06 2025 12:52:36
Пример пользовательских отчетов в Google ***ytics, созданных за 15 минут...
17 06 2025 4:50:26
Как быстро настроить DSA с помощью Netpeak Spider. Рассмотрим подробнее «Только URL из фида страниц». Этот таргетинг помогает точнее определить целевую аудиторию и привести ее на максимально релевантные страницы сайта (к примеру, на карточку товара)....
16 06 2025 20:32:27
Какими бывают формы подписки и как их используют бренды...
15 06 2025 11:40:40
Зачем амбициозным онлайн-проектам индивидуальные инструменты веб-аналитики....
14 06 2025 1:16:43
Наши сотрудники смогли составить разбор непростых вещей, дать им определение и рассказать о них простым языком....
13 06 2025 3:35:33
Расскажем про ошибки интернет-магазинов, которые трудно найти соответствующими программами и сервисами проверки...
12 06 2025 5:20:55
Создатель сервиса Foster Кирилл Винокуров рассказал, как зарегистрировать приложение для полноценной работы с Директом....
11 06 2025 5:58:18
Иконки отличаются между собой размером, формой, весом, количеством оттенков и объемом. Наиболее популярными считаются векторные пиктограммы...
10 06 2025 1:46:56
На украинском рынке услуг велик выбор качественных платформ. Главное понимать, как правильно проводить миграцию....
09 06 2025 13:24:50
Как начать продавать и увеличить продажи, наращивая бесплатные ссылки...
08 06 2025 3:11:51
Отчет «Многокaнaльные последовательности» в Google ***ytics помогает оценить влияние каждого канала, сделать выводы о работе рекламных кампаний — понять их вклад и участие в цепочке до совершения конверсии. Показываем на примере....
07 06 2025 14:59:46
Дропшип предполагает минимум затрат со стороны предпринимателя. Например, не нужно думать о логистике, держать склад. Можно минимизировать и траты на рекламу. Узнать как!...
06 06 2025 9:37:55
Адвент-календарь, конкурсы и викторины, праздничные линейки товаров, подборки подарков для родных и близких, опросы, тесты и другие интересности. Используйте, если нужны идеи и вдохновение....
05 06 2025 12:23:51
Рассказываем об интересных диджитал-специальностях и зарплатах, как обучиться этим профессиям с нуля (в том числе в зрелом возрасте) и можно ли работать удалённо....
04 06 2025 23:21:14
Мы запустили email с нуля и стали получать стабильный ежемecячный доход....
03 06 2025 11:32:50
Email-маркетинг — хороший полицейский, спам — плохой....
02 06 2025 17:36:52
Руководитель отдела HR, Ольга Пачесная, написала пост о главном — людях, которые выбрали работу в Netpeak....
01 06 2025 4:20:54
Делимся итогами продвижения телеграм-канала «Артём Бородатюк» за 2021 год...
31 05 2025 10:34:35
Еще:
понять и запомнить -1 :: понять и запомнить -2 :: понять и запомнить -3 :: понять и запомнить -4 :: понять и запомнить -5 :: понять и запомнить -6 :: понять и запомнить -7 ::