Google Ads MCP: будуйте всю структуру кампанії з агента, атомарно

Чи є MCP-сервер для Google Ads? Так. Hermoso є розміщеним MCP-сервером Google Ads. Додайте https://app.hermoso.ai/mcp до Claude, ChatGPT або Cursor і підключіть обліковий запис Google Ads один раз. Тоді ваш помічник зможе створювати кампанії Search, медійні та Performance Max, знаходити ідеї ключових слів, встановлювати бюджети, ставки й таргетинг та запускати звіти. Запуск кампанії завжди потребує вашого явного підтвердження.

Google Ads є деревом, а саме в деревах скриптове створення кампаній зазвичай і ламається. Ви створюєте бюджет, потім кампанію, потім групу оголошень, потім оголошення. Якщо на четвертому кроці оголошення відхилено, у вас лишаються три осиротілі об’єкти й бюджет, якого ви не хотіли. Прибирати це вручну: причина, через яку більшість людей відмовляється від автоматизації Google Ads.

MCP-сервер Hermoso будує все дерево однією атомарною операцією, використовуючи тимчасові ідентифікатори ресурсів, щоб дочірні об’єкти могли посилатися на батьківські, яких ще не існує. Або з’являються кампанія, група оголошень, оголошення та ключові слова разом, або не з’являється жодне з них. Відхилене оголошення означає, що й бюджет не було створено.

Встановіть один раз: у Claude.ai або Claude Desktop вставте https://app.hermoso.ai/mcp у Settings → Connectors і підтвердьте з обліковим записом Hermoso. У програмному агенті це одна команда: /plugin marketplace add hermoso-ai/hermoso, а потім /plugin install hermoso@hermoso у Claude Code, codex plugin marketplace add hermoso-ai/hermoso, а потім codex plugin add hermoso@hermoso у Codex, або npx skills add hermoso-ai/hermoso -a cursor у Cursor (після -a вкажіть назву свого агента), а потім увійдіть один раз командою npx -y hermoso auth login. Повне налаштування на сторінці MCP & CLI.

Інструменти Google Ads

Створення. create_google_ads_campaign, create_google_ads_ad_group, create_google_ads_ad, add_google_ads_keywords, create_google_ads_performance_max_campaign, upload_google_ads_asset, add_google_ads_assets для посилань на сторінки сайту, виносок і структурованих фрагментів.

Налаштування. set_google_ads_budget, set_google_ads_bidding (шість стратегій), set_google_ads_targeting (географія та мова), find_google_ads_locations, set_google_ads_networks (партнери Search і Display увімкнено або вимкнено), create_google_ads_conversion_action і list_google_ads_conversion_actions.

Дослідження. google_ads_keyword_ideas підключає Keyword Planner до розмови: реальні місячні обсяги пошуку, конкуренцію та діапазони ставок для верхньої частини сторінки, з початком від набору ключових слів, цільової сторінки або цілого сайту.

Читання і зміни. list_google_ads_campaigns, google_ads_report для довільного GAQL, google_ads_change_history, щоб бачити, що і коли змінилося в обліковому записі, delete_google_ads_object для видалення одного об’єкта, а також set_google_ads_status, єдиний перемикач із підтвердженням, який запускає реальні витрати.

create_google_ads_campaign також підтримує режим пробного запуску, тож агент може перевірити все дерево в живому API, нічого не створюючи. Це добрий варіант за замовчуванням, коли агент пропонує план для вашого затвердження.

Що ваш агент може робити з Google Ads MCP

Кожен рядок є справжнім інструментом на сервері. Просто напишіть звичайною мовою, а агент сам вибере, які інструменти запустити.

Приклади запитів

Вставте будь-який із них у Claude, ChatGPT або Cursor, коли Hermoso вже підключено.

• «Знайди 30 ключових слів для нашого застосунку для управління проєктами з місячним пошуковим обсягом понад 1 000 у США і згрупуй їх за наміром».
  google_ads_keyword_ideas повертає обсяги, конкуренцію та діапазони ставок із Keyword Planner, а агент їх групує.
• «Побудуй кампанію Search на ці ключові слова на паузі: $50 на день, США і Канада, англійська, максимізувати конверсії».
  create_google_ads_campaign будує бюджет, кампанію, групу оголошень, оголошення та ключові слова однією атомарною операцією, на паузі, а потім читає результат назад.
• «Налаштуй кампанію Performance Max для нашого каталогу Shopify з використанням фіда Merchant Center».
  list_merchant_accounts обирає магазин, потім create_google_ads_performance_max_campaign будує її на паузі з прикріпленим фідом.
• «Які пошукові запити минулого місяця витратили гроші без конверсій? Додай найгірші десять як мінус-слова».
  google_ads_report витягує звіт за пошуковими запитами, потім add_google_ads_keywords додає мінус-слова.
• «Додай чотири посилання на сторінки сайту до брендової кампанії: ціни, демо, кейси та контакти».
  add_google_ads_assets створює посилання на сторінки сайту і прив’язує їх до кампанії.
• «Вимкни партнерів Search у кожній кампанії й покажи мені результат до і після».
  set_google_ads_networks спочатку читає поточне налаштування, потім змінює його кампанія за кампанією.
• «Хтось у п’ятницю змінив наші ставки. Що саме змінилося?»
  google_ads_change_history показує зміни з часом.
• «Під’єднай нашу властивість GA4, щоб реєстрації зараховувалися як конверсії в Google Ads».
  link_google_ads_to_analytics під’єднує обидві системи, а create_analytics_key_event позначає подію реєстрації як ключову.

Performance Max, побудована так само

create_google_ads_performance_max_campaign будує міжканальний тип кампанії Google (Search, YouTube, Display, Discover, Gmail і Maps з однієї кампанії), і будує його однією атомарною операцією, бо Google вимагає саме цього: бюджет, кампанія, таргетинг за місцем і мовою, група ресурсів і всі прив’язки ресурсів надсилаються разом, тож відхилений ресурс не залишає напівзбудованої кампанії. Вона створюється на паузі, а все дерево читається назад із Google, перш ніж ваш агент повідомить, що воно існує.

Мінімальні вимоги Google до ресурсів перевіряються тут до відправлення, тож відсутнє квадратне зображення дає зрозуміле повідомлення, а не непрозору відмову API: від 3 до 15 заголовків до 30 символів, від 1 до 5 довгих заголовків до 90, від 2 до 5 описів до 90, одна назва компанії до 25 символів, а також щонайменше один логотип, одне маркетингове зображення і одне квадратне маркетингове зображення. Спершу завантажте зображення через upload_google_ads_asset і передайте назви ресурсів. Відео YouTube необов’язкове. Google згенерує його з групи ресурсів, якщо ви його не додасте.

Performance Max не має ключових слів і ручних ставок: вона оптимізує лише на конверсії. Тому побудова відмовляє в обліковому записі без увімкненої дії конверсії, а не створює кампанію, яка не може оптимізуватися, і називає обидва виходи: створити дію через create_google_ads_conversion_action або запустити стратегію, якій вона не потрібна. Настройки брендингу за замовчуванням увімкнено для нових кампаній PMax з Google Ads API v21, і це змінює, де прив’язуються назва компанії та логотип; Hermoso прив’язує їх до кампанії за вас.

Performance Max з фідом покупок (retail) працює так само: передайте merchantCenterId, і кампанія рекламуватиме ваш каталог Merchant Center, а feedLabel звузить її до одного фіда. Вона будується й читається назад точно так, як описана вище кампанія. Читання назад показує обліковий запис Merchant Center і мітку фіда, які Google справді зберіг, тож ви бачите, що це справді роздрібна кампанія, а не маєте вірити нам на слово. Вона рекламує весь фід під одним кореневим листингом групи; розбиття фіда за брендом, категорією чи власною міткою не реалізовано, і така вимога відхиляється з назвою, а не ігнорується мовчки, щоб ви ніколи не вважали, що звузили фід, коли цього не сталося.

Merchant Center, щоб агент знав, що він продає

«Чому цей товар не показується?»: це питання, на яке звітність Google Ads за своєю структурою відповісти не може, бо відхилений товар не має показів для звіту. Відповідь міститься в Merchant Center, і те саме підключення до Google дає доступ до нього без другого входу.

Ваш агент може перелічити облікові записи Merchant Center, до яких має доступ ваш підключений обліковий запис Google, за допомогою list_merchant_accounts (в агентства їх зазвичай кілька, тож агент питає, який магазин, а не вгадує), прочитати товари у фіді за допомогою list_merchant_products (реальний каталог, який обслуговує кампанія Shopping або роздрібна Performance Max), і прочитати проблеми на рівні облікового запису, які Google висуває проти нього, за допомогою list_merchant_issues. Цього достатньо, щоб написати рекламний текст про товари, які справді існують, за цінами, що справді діють, і пояснити кампанію, яка мовчить.

Він також і записує. create_merchant_data_source створює фід продуктів API, upsert_merchant_product додає товар до нього, update_merchant_product змінює поля, що щодня змінюються (ціну й наявність), а delete_merchant_product та delete_merchant_data_source видаляють їх лише після підтвердження. list_merchant_data_sources показує, які фіди справді можуть приймати запис.

Три речі варто знати заздалегідь. Google блокує кожен виклик Merchant API, доки хмарний проєкт Hermoso не зареєстровано в межах вашого облікового запису Merchant Center, тож register_merchant_developer виконує це зв’язування один раз і називає це прямо. Це не зламане підключення, і повторний вхід його не виправить. Записи товарів потрапляють лише у джерело даних API: файловий фід, автофід і фід, який створює сам інтерфейс Merchant Center, зазвичай показуються у списку, але всі відхиляють записи, тому Hermoso сам обирає придатний для запису фід, створює його, якщо його немає, і відмовляє з назвою, якщо їх кілька, а не ставить ваш товар на ринок, на який ваші кампанії можуть не таргетуватися. А upsert_merchant_product є записом всього рядка, тоді як update_merchant_product є частковим оновлення. Для першого надсилайте кожне поле, яке хочете зберегти, а для другого лише ті, які змінюєте.

Нічого з цього не означає, що ви маєте переносити свій каталог. Якщо фід уже живе в Shopify або на вашій платформі, залиште його там і дозвольте агенту лише читати його. Записи потрібні тоді, коли фід ще ні в кого немає, або коли одну ціну чи наявність треба виправити зараз, а не під час наступної синхронізації.

Google Analytics 4, щоб ви бачили, що зробили кліки

Звітність Google Ads закінчується на кліку. Те, що сталося далі (сесія, реєстрація, замовлення), живе в Google Analytics, і той самий вхід до Google відкриває й його (це окреме підключення, бо воно потребує власного дозволу).

Ваш агент може визначити, яку властивість GA4 читати, за допомогою list_analytics_properties. Це важливо, бо кожен виклик Analytics приймає числовий ідентифікатор властивості, а у вас є ідентифікатор вимірювання G-XXXXXXXXX з вашого фрагмента коду відстеження. Далі analytics_report повертає сесії, користувачів, конверсії та дохід з розбивкою за каналом, джерелом/медіумом, кампанією, цільовою сторінкою, країною, пристроєм або датою, а analytics_realtime показує, хто зараз на сайті. Тож «побудуй кампанію» і «скажи мені, що вона заробила»: одна й та сама розмова.

Він також і записує, і ця частина безпосередньо повертається в Google Ads: create_analytics_key_event позначає подію, яку GA4 уже збирає, як ключову подію, а саме її Google Ads імпортує як конверсію, і без дії конверсії жодна стратегія розумного призначення ставок на цій сторінці не працює. create_analytics_custom_dimension реєструє параметр події, щоб звіти можна було розбивати за ним, а list_analytics_definitions показує, що властивість уже вимірює, перш ніж ви додасте щось одне. Дві речі залишаються незмінними назавжди: це лише GA4, бо API взагалі не має поверхні Universal Analytics, а власний розмір можна архівувати, але не видалити, і для кожної властивості є 50 слотів з областю подій, тож агент спершу перевіряє наявний набір.

Гейт живих витрат ширший за один інструмент

Призупинення кампанії не є єдиним способом уникнути витрат, і вважати його таким: справжня пастка: створення увімкненої групи оголошень, оголошення або ключового слова в уже увімкненому батьківському об’єкті починає показуватися на наступному аукціоні. Тому те саме підтвердження, що захищає set_google_ads_status, захищає також create_google_ads_ad_group, create_google_ads_ad і add_google_ads_keywords, коли батьківський об’єкт активний, і це визначається з рядка, який кожен із них уже отримує, без додаткового запиту. Мінус-слова лише обмежують витрати, тому вони ніколи не блокуються.

Звітність GAQL, з одним застереженням, яке варто знати

google_ads_report приймає довільний GAQL, тож ваш агент може запитувати будь-який потрібний йому зріз, а не обмежуватися фіксованою формою звіту. Одне, що варто пам’ятати, якщо ви пишете запити вручну або дозволяєте їх писати моделі: GAQL не є SQL. У ньому немає підзапитів, а IN приймає лише літеральний список. Вираз WHERE id IN (SELECT …) недійсний і не повертатиме тихо неправильні рядки, а просто завершиться помилкою. Передайте результат прямо в таблицю через create_sheet і append_to_sheet або в документ через create_doc.

Перевірка читанням назад, потім звіт

Після мутації дерево читається назад із Google, і підсумок, який ви отримуєте, складається з цього читання, а не з того, що було запитано. Це дисципліна, яка ловить конкретний збій, коли агент упевнено розповідає про кампанію, яку платформа насправді змінила або відхилила.

Чого він не зробить без запиту

Агент із бюджетом корисний лише тоді, коли радіус його дій обмежений, тому повноваження щодо витрат закріплено на сервері, а не в промпті. Кампанії, набори оголошень і оголошення Meta створюються зі статусом PAUSED без можливості перевизначення з боку викликача. Перемикачі статусу, які можуть запустити реальні рекламні витрати (один на кожній рекламній платформі: set_meta_campaign_status, set_google_ads_status, set_microsoft_ads_status, set_reddit_ads_status, set_linkedin_ads_status, set_pinterest_ads_status, set_x_ads_status і set_openai_ads_status серед інших), не виконуються без явного прапорця підтвердження, і той самий гейт охоплює створення увімкненої групи оголошень, оголошення або ключового слова в Google Ads під уже увімкненим батьківським об’єктом, бо це показується на наступному аукціоні. Видалення також потребують підтвердження. Щодо генерації, hermoso_capabilities публікує точну вартість кредитів для кожної моделі до запуску, і кожен рендер резервує оцінку, а потім списує фактичну вартість, тож невдала відправка повертає кошти, а не тихо списує їх.

Підключення облікового запису Google Ads

Ви підключаєте Google Ads до Hermoso через власний потік OAuth від Google у налаштуваннях Connectors; жоден пароль не проходить через модель. Підключення до Google Ads спільні на рівні бренду, тож уся команда, яка працює з брендом, користується одним підключенням, а не кожен заново авторизує його.

Креативна частина

Керування кампаніями корисне лише тоді, коли є що запускати. Той самий сервер досліджує, що вже працює на вашому ринку, у бібліотеках оголошень Meta, Google і LinkedIn, створює готовий графічний і відеокреатив на основі вашого реального продукту з понад 100 моделей і завантажує ресурси, тож «що нам запустити» і «побудуй це» : одна розмова замість двох інструментів. Див. огляд маркетингового MCP, повний список інструментів або MCP для Meta Ads, якщо ви ведете обидві платформи.

Поширені запитання

Чи є MCP-сервер для Google Ads?

Так. MCP-сервер Hermoso будує й керує Google Ads з будь-якого MCP-клієнта: create_google_ads_campaign, create_google_ads_ad_group, create_google_ads_ad і add_google_ads_keywords для побудови дерева пошукової або медійної кампанії; create_google_ads_performance_max_campaign для Performance Max; set_google_ads_budget, set_google_ads_bidding і set_google_ads_targeting для налаштування; google_ads_keyword_ideas для дослідження в Keyword Planner; list_google_ads_campaigns і google_ads_report для звітності; читання Merchant Center для фіда товарів за кампанією Shopping; а також set_google_ads_status з підтвердженням для активації.

Чи може ШІ-агент створити кампанію Google Ads?

Так, і все дерево створюється однією атомарною операцією з тимчасовими ідентифікаторами ресурсів: кампанія, група оголошень, адаптивне текстове або медійне оголошення та ключові слова разом. Якщо оголошення відхилено, бюджет також не створюється, тож ви не змушені прибирати осиротілі об’єкти. Режим пробного запуску перевіряє дерево в живому API, нічого не створюючи.

Чи може він створити кампанію Performance Max?

Так. create_google_ads_performance_max_campaign будує бюджет, кампанію, таргетинг, групу ресурсів і всі прив’язки ресурсів однією атомарною операцією, бо Google вимагає їх разом. Кампанія створюється на паузі й читається назад, перш ніж агент повідомить про неї. Мінімальні вимоги Google до ресурсів перевіряються до відправлення: від 3 до 15 заголовків, від 1 до 5 довгих заголовків, від 2 до 5 описів, назва компанії та щонайменше один логотип, одне маркетингове зображення і одне квадратне маркетингове зображення. PMax ставить ставки лише на конверсії, тому вона відмовляє в побудові на обліковому записі без увімкненої дії конверсії, а не створює кампанію, яка не може оптимізуватися. Performance Max з фідом покупок (retail) працює так само: передайте merchantCenterId, і кампанія рекламуватиме ваш каталог Merchant Center, а feedLabel звужує її до одного фіда; читання назад показує обліковий запис Merchant Center і мітку фіда, які Google справді зберіг.

Чи працює він із Google Merchant Center?

Так, читання і запис через те саме підключення до Google. Агент може перелічити облікові записи Merchant Center, до яких має доступ ваш обліковий запис, прочитати товари у фіді (каталог, який справді обслуговує кампанія Shopping або роздрібна Performance Max) і прочитати проблеми на рівні облікового запису, які висуває Google. Це єдине місце, де можна дізнатися, чому товар не показується, оскільки відхилений товар не має показів, які б показала звітність Google Ads. Google потребує одноразової реєстрації хмарного проєкту Hermoso в межах вашого облікового запису Merchant Center, перш ніж API почне відповідати, і є інструмент, який це виконує. Він також записує: create_merchant_data_source, upsert_merchant_product, update_merchant_product для щоденних змін ціни й наявності, а також delete_merchant_product і delete_merchant_data_source, які потребують підтвердження. Google приймає записи товарів лише в джерело даних API, тому Hermoso сам обирає придатний фід і відмовляє з назвою, якщо в обліковому записі їх кілька.

Чи може він робити дослідження ключових слів?

Так. google_ads_keyword_ideas звертається до Keyword Planner від Google і повертає реальні місячні обсяги пошуку, конкуренцію та діапазони ставок для верхньої частини сторінки, з початком від ключових слів, URL цільової сторінки або цілого сайту. Агент може передати їх прямо в add_google_ads_keywords або записати в таблицю Google Sheets.

Чи може він почати витрачати мій бюджет Google Ads?

Лише з явного підтвердження. set_google_ads_status є перемикачем, що вмикає реальні гроші, а оскільки створення увімкненого дочірнього об’єкта під уже увімкненим батьківським показується на наступному аукціоні, те саме підтвердження захищає також create_google_ads_ad_group, create_google_ads_ad і add_google_ads_keywords, коли батьківський об’єкт активний. Мінус-слова лише обмежують витрати, тому їх ніколи не блокують.

Чи може він запускати звіти?

Так. google_ads_report приймає довільний GAQL, тож агент може запитати будь-який потрібний зріз. Зауважте, що GAQL не є SQL: у ньому немає підзапитів, а IN приймає літеральний список, тому WHERE id IN (SELECT …) недійсний. Результати можна записати прямо в таблицю Google Sheets або документ.

Які ставки й таргетинг він може встановити?

Шість стратегій ставок, розклад кампанії, а також географічний і мовний таргетинг, з find_google_ads_locations для пошуку місць за назвою. Бюджети встановлюються через set_google_ads_budget, а ключові слова підтримують мінус-слова та ставку CPC для кожного ключового слова.

Чи отримує агент мій пароль від Google?

Ні. Ви підключаєте Google Ads через власний потік OAuth від Google у налаштуваннях Connectors Hermoso, а Hermoso зберігає отриманий токен. Агент лише викликає інструменти Hermoso. Підключення Google Ads спільні на рівні бренду, тож уся команда працює з одним підключенням.

Чи може він створювати й креатив для оголошення?

Так. Той самий сервер досліджує рекламу конкурентів, планує концепцію, створює готовий графічний і відеокреатив з понад 100 моделей з вашим реальним продуктом і завантажує ресурси через upload_google_ads_asset, тож дослідження, креатив і побудова кампанії відбуваються в одній розмові.