Claude-скіл /spilno-ga4-roas-corridor-analysis: прогноз доходу Google Ads за 5 хвилин

TL;DR: ми написали Claude-скіл, який за 5 хвилин будує готовий звіт-прогноз: скільки доходу принесе Google Ads, якщо збільшити бюджет на +10k / +25k / +50k грн. Метод — «коридор коливання ROAS» на основі фактичних даних GA4 за 6 місяців. Звіт оформлений за нашим внутрішнім текстовим стайл-гайдом (Montserrat, нумеровані розділи, числа з пробілами на розряди) — без логотипу, кольорів і шапки/футера, тільки чисте структуроване форматування. Нижче — що скіл вміє, як виглядає шаблон, які доступи треба, як він працює крок-за-кроком, обмеження методу та посилання на GitHub для встановлення.

Що робить скіл

Скіл /spilno-ga4-roas-corridor-analysis повністю автоматизує рутинну роботу аналітика над типовим питанням клієнта «а скільки буде з 1 грн витрат на рекламу, якщо я докину ще 25 тисяч у Google Ads?». Замість години ручного збору даних — 5 хвилин і готовий Google Doc, оформлений за нашим текстовим стайл-гайдом, з якого видно:

1. скільки гривень доходу приносить 1 грн витрат на Google Ads просто зараз;
2. як коливався ROAS за останні 6 місяців (коридор min / avg / max);
3. наскільки стабільний коридор (коефіцієнт варіації CV);
4. скільки додаткового доходу принесе збільшення бюджету на +10k / +25k / +50k грн — у трьох сценаріях (песимістичний / базовий / оптимістичний);
5. з якого сценарію стартувати з урахуванням обмежень методу.

Звіт зберігається на Google Drive як звичайний Google Doc, оформлений за стайл-гайдом Spilno Agency: Montserrat як єдиний шрифт, нумеровані розділи без крапок у заголовках, числа з пробілами на розряди, числа в таблицях по правому краю, Pageless mode з розкривними заголовками, окремий блок «Короткий висновок» (TL;DR для клієнта). Це не «брендування» в дизайнерському сенсі — без логотипа, фірмових кольорів і складних елементів — а просто текстовий стайл-гайд, який легко відтворити у будь-якому Google Doc.

Як виглядає шаблон документа

Нижче — повний приклад заповненого звіту для умовного інтернет-магазину з місячним бюджетом Google Ads ~130k грн. Це фактичний вигляд того, що ви отримаєте у Google Doc — усі 10 розділів зі справжніми цифрами:

У реальному Google Doc застосоване форматування зі стайл-гайду Spilno Agency: Montserrat, нумеровані розділи без крапок, числа з пробілами на розряди (1 340 400), числа в таблицях по правому краю, Pageless mode з розкривними заголовками. Розділи «Технічні деталі» і «Обмеження методу» зазвичай згорнуті — щоб клієнт одразу бачив головні цифри і висновок. Логотипа, кольорів, шапки/футера у звіті немає — у скілі ми навмисно лишили чистий текстовий формат, який кожен агент може форкнути і додати своє оформлення.

Скачати шаблон і заповнити вручну

Якщо хочеться зробити аналіз без Claude — для тих, хто любить хардкор — нижче чисті шаблони. Беріть, заповнюйте по 6 місяцях зі своєї GA4 і отримуйте такий самий звіт ручками.

Як отримати Google-документ: завантажте DOCX → відкрийте Google Drive → перетягніть файл у вікно Drive → правою кнопкою → «Відкрити через» → «Google Документи». Документ конвертується автоматично і збережеться на вашому диску з тим самим форматуванням. Pageless mode і розкривні заголовки увімкніть через Файл → Налаштування сторінки → Без сторінок.

Які доступи потрібні

Скіл працює у Claude Code через UI-автоматизацію Google Analytics 4 — не використовує API і не питає ваші OAuth-токени. Для роботи потрібно:

1. Claude Code з активованим розширенням Claude for Chrome. Розширення дозволяє Claude бачити вкладку браузера і клікати по інтерфейсу.
2. Google-акаунт з доступом до GA4-property проекту. Будь-яка роль, що дозволяє переглядати звіти (зокрема Viewer), — достатньо.
3. GA4 property з налаштованим e-commerce tracking і подією purchase (звичайна налаштування інтернет-магазину).
4. Лінк GA4 ↔ Google Ads у розділі Admin → Product Links → Google Ads links. Без цього колонка Cost буде порожня — скіл попередить про це і запропонує взяти Cost напряму з Google Ads UI.
5. MCP Google Drive (опціонально, але рекомендовано) — потрібен для збереження готового Google Doc одразу на диск користувача. Якщо не підключений, скіл автоматично переключається на створення локального DOCX-файлу — див. наступний розділ.

OAuth-токени, сервісні акаунти, API-ключі — нічого з цього скіл не вимагає. Всі дані витягуються з того ж GA4, який ви бачите у браузері — просто Claude робить це за вас.

Як підключити Google Drive (і що буде, якщо не підключати)

Google Drive у Claude підключається як MCP-сервер за 1 хвилину. Це опціональний крок: скіл повністю працює і без Drive — просто звіт буде у форматі DOCX, який ви відкриєте у Word, LibreOffice або тому ж Google Docs (через Drive → Open with).

Підключити Google Drive у Claude — крок за кроком

1. Відкрийте Claude Code → меню /mcp (або у Claude.ai: Settings → Connectors).
2. Знайдіть у каталозі конектор «Google Drive» (офіційний від Anthropic). Натисніть Connect.
3. У вікні OAuth, що відкриється, виберіть Google-акаунт, у який скіл збереже звіт. Це той самий акаунт, який вам зручно тримати робочим — необов’язково той, що має доступ до GA4 клієнта.
4. Підтвердіть запитувані права: Drive file (створення/читання файлів, які створив сам застосунок) — мінімально необхідний скоуп. Скіл не отримує доступу до ваших існуючих файлів.
5. У переліку інструментів Claude має з’явитися mcp__<id>__create_file — це і є виклик, який скіл використовує для збереження звіту.

Після першого підключення Claude запам’ятовує токен — далі скіл працює без додаткових питань. Відкликати доступ можна у будь-який момент: myaccount.google.com/permissions.

Що відбувається, якщо Google Drive НЕ підключений

На початку Кроку 7 скіл перевіряє чи доступний у Claude інструмент виду mcp__*__create_file. Якщо такого немає (або виклик повертає auth-помилку) — скіл автоматично переключається на fallback-сценарій:

1. Викликає вбудований Anthropic-скіл anthropic-skills:docx з тією самою структурою, що й Google Doc — Montserrat, нумеровані розділи, таблиці з межами, числа з пробілами на розряди.
2. Зберігає файл у поточному робочому каталозі: Прогноз зростання доходу [домен].docx.
3. У фінальному повідомленні дає абсолютний шлях до файлу і коротке пояснення: «Google Drive не підключений, тому згенеровано локальний Word-файл. Якщо потрібен Google Doc — завантажте файл у свій Drive і відкрийте через Google Документи».

Якщо ж і anthropic-skills:docx з якоїсь причини недоступний (рідкісний випадок) — третій fallback: скіл віддає повний звіт у чат форматованим Markdown. Користувач може скопіювати його у Word/Google Docs одним рухом.

Підсумок: скіл працює завжди. Найкомфортніший шлях — підключений Drive і одразу Google Doc на диску. Без Drive — отримуєте такий самий звіт, але DOCX-файлом локально.

Як він працює — 8 кроків

Перед запуском Claude задає 4 уточнюючих питання: домен проекту і три прапорці «моделювати +10k / +25k / +50k?» (за замовчуванням усі «так»). Далі автоматичний пайплайн:

1. Знаходить GA4 property. Відкриває analytics.google.com, натискає селектор property у верхньому лівому куті, у пошук вводить домен. Запам’ятовує property_id з URL.
2. Заходить у звіт «Эффективность конверсий». Прямий URL у GA4 нестабільний, тому скіл навігує через сайдбар: іконка «Реклама» → «Эффективность конверсий». Це єдиний звіт, де помісячно є і Cost, і Revenue по каналах.
3. Фільтрує по події purchase. Знімає галочки з усіх ключових подій крім [домен] purchase і натискає «Применить».
4. Збирає дані за 6 повних місяців. Для кожного місяця: відкриває date picker, вводить дві дати, чекає рендер, витягує таблицю через невеликий JavaScript-скрипт. З кожного місяця бере тільки канали Google Ads: Cross-network (Performance Max), Paid Shopping, Paid Search — і сумує Cost і Revenue.
5. Рахує коридор ROAS. Для кожного місяця ROAS = Revenue / Cost. По 6 точках обчислює MIN, AVG, MAX, стандартне відхилення σ, коефіцієнт варіації CV. CV <15% — коридор стабільний; CV >25% — попереджає про нестабільність.
6. Будує прогноз приросту доходу. Для кожного сценарію (+10k / +25k / +50k): песимістичний приріст = Δ × MIN ROAS, базовий = Δ × AVG, оптимістичний = Δ × MAX. Окремо — таблиця абсолютного нового місячного доходу.
7. Створює Google Doc зі стайл-гайдом Spilno. Через MCP Google Drive завантажує HTML на диск користувача → відкриває у Google Документах → застосовує Pageless mode. У документі: Montserrat, нумеровані розділи без крапок у заголовках, числа з пробілами на розряди (1 340 400), числа в таблицях по правому краю. Без лого і кольорів — лише текстове форматування.
8. Презентує результат. Дає клікабельне посилання на Google Doc, короткий summary в чаті (середній ROAS, рекомендований сценарій) і список застережень: низький CV, неповний рік даних, мала вибірка по Paid Search.

Обмеження методу

Метод «коридор ROAS» — це швидкий і чесний інструмент для розмови з клієнтом про масштабування реклами, але він не замінює повноцінного медіапланування. У звіті в розділі 8 завжди є три обмеження — їх варто прочитати разом з прогнозом:

1. Лінійний прорахунок. Прогноз припускає, що ROAS зберігається в історичному коридорі при будь-якому бюджеті. Реально маржинальний ROAS зазвичай нижчий за середній — кожна додаткова гривня витрачається на менш цільовий трафік (закон спадної віддачі). Фактичний приріст доходу при +25k / +50k може бути на 20–40% нижчим за оптимістичний сценарій.
2. Не враховано конкуренцію. Метод не моделює дії конкурентів в аукціоні Google Ads. Якщо конкуренти підвищать ставки, частина додаткового бюджету піде на дорожчі покази без приросту конверсій. Для точної оцінки потрібен Search Lost Impression Share (Rank) і Auction Insights з Google Ads UI.
3. Не враховано насиченість ринку. GA4 не показує скільки ще показів доступно у пошуковій видачі. Якщо кампанія вже виграє >80% імпресій (Impression Share), додатковий бюджет дасть лише незначний приріст. Цю метрику треба перевірити окремо в Google Ads → Search Lost IS (Budget).

Крім цього скіл не аналізує seasonality (для проектів з вираженою сезонністю краще брати 12 місяців замість 6), не вміє розкладати ROAS по продуктових категоріях і не враховує атрибуційну модель — бере дефолтну з GA4 (Data-Driven).

Встановлення — скачати з GitHub

Скіл відкритий під MIT-ліцензією і опублікований на GitHub. Можна форкнути, кастомізувати під свій бренд (поміняти Montserrat на свій фірмовий шрифт, додати свій лого в шапку Doc-а тощо).

⚡ Завантажити скіл з GitHub

Швидке встановлення в Claude Code (займає <1 хвилини):

git clone https://github.com/spilno-agency/spilno-agency-skills.git
cp -r spilno-agency-skills/ga4-roas-corridor-analysis ~/.claude/skills/

Перезапустіть Claude Code — скіл буде доступний як /ga4-roas-corridor-analysis (або під будь-яким іншим іменем, якщо перейменувати папку). Подивитись повну специфікацію скіла можна одразу з GitHub: SKILL.md.

Замість висновку

Це наш перший публічний Claude-скіл, але точно не останній. У роботі — скіли для типових агентських задач: технічного SEO-аудиту, аналізу канібалізації запитів, валідації GTM-конфігурацій, авто-генерації Title/Meta для нових категорій. Якщо хочеться щось додати або кастомізувати — пишіть issue або pull request у репо.