SEO-Studio
Блог · SEO

GSC Performance API автоматизація щотижневих звітів

Практичний гайд з GSC Performance API від доступу в Cloud до щотижневого дашборду з brand/non-brand і алертами на money-URL.

~2 хв читання SEO

Дашборд щотижневого звіту Search Console Performance API

Чому Performance API а не лише CSV

Ручний експорт з Search Console ламається на регулярності. GSC Performance API дає ті самі кліки/покази/CTR/позиції в машиночитному вигляді для щотижневих звітів клієнту чи внутрішнього дашборду.

  • Повторюваність один і той самий період і dimensions щотижня.
  • Порівняння WoW без «забули зняти скрін».
  • Фільтри бренд, країна, device, page regex у пайплайні.
  • Алерти падіння кліків на money-URL можна ловити автоматично.

Доступ Cloud і Search Console

Екран Google Cloud з увімкненим Search Console API і сервісним акаунтом
Спочатку доступ і scopes, потім запити. Без коректного OAuth/service account звіти не зберуться.

Базовий шлях описаний у searchanalytics.query. Практично

  1. Увімкніть Search Console API в Google Cloud.
  2. Створіть OAuth клієнта (локальні скрипти) або service account (сервер).
  3. Для service account додайте його email як користувача в GSC property.
  4. Перевірте scope https://www.googleapis.com/auth/webmasters.readonly.

Хак на замітку. Domain-property і URL-prefix property дають різний срез. Зафіксуйте який ресурс у cron і не міняйте його між тижнями без мітки в звіті.

Структура щотижневого звіту

Таблиця кліків показів CTR і позицій за тиждень у Looker або Sheets
Фіксуйте порівняння WoW по сайту, бренду й money-URL окремо.

Мінімальний пакет який клієнт розуміє за 3 хвилини

Блок Dimensions Навіщо
Site totals date WoW кліки/покази/CTR/avg position
Brand vs non-brand query (+ фільтр) Відділити бренд від росту попиту
Money pages page Топ-20 URL і ті що впали >20%
Country / device country, device Аномалії мобайлу чи ринку

Тримайте rowLimit і startRow під контролем, дивіться ліміти API. Для великих сайтів агрегації робіть у BigQuery/Sheets після сирих вивантажень.

Автоматизація пайплайну

Схема cron Cloud Function BigQuery і Slack/email сповіщення
Автоматизація знімає ручний експорт і лишає аналітику аномалій.

Типова схема cron / Cloud Scheduler → скрипт (Apps Script, Python, Cloud Function) → сховище (Sheet, BigQuery) → Looker Studio / email / Slack. Важливо

  • GSC дані «дозрівають» з затримкою 2–3 дні не звіряйте «сьогодні» з UI.
  • Зберігайте raw response або паркет за дату зняття для аудиту.
  • Окремі джоби для query і page щоб не змішувати семантики.
  • Алерт лише якщо дельта стабільна 2 періоди поспіль (менше шуму).

Швидка перевірка перед cron

Чекліст доступу dimensions rows limit і валідації даних
Перед продакшн-cron перевірте квоти, дати й збіг сум із UI.

Чекліст на замітку (10 хвилин). Зробіть зараз

  1. Один тестовий query на 7 днів date dimension чи збігаються суми з UI ±допуск.
  2. Перевірте property URL (sc-domain vs https).
  3. Чи є доступ у сервісного акаунта саме до потрібного ресурсу.
  4. Ліміти квот і retry на 429.
  5. Фільтр бренду (regex) чи не ріже зайве.
  6. Таймзона звіту й «тиждень» (пн–нд) зафіксовані в шаблоні.
  7. Куди падає файл/дашборд і хто отримує алерт.

Типові помилки

  • Порівнювати незавершені дні з минулим тижнем.
  • Мішати searchAppearance / rich results без окремого звіту.
  • Тягнути лише avg position як KPI успіху.
  • Не логінити помилки API і мовчки слати порожній Sheet.
  • Змінювати dimensions у шаблоні без версіонування колонок.

Висновок

GSC Performance API автоматизація щотижневих звітів це дисципліна доступу, стабільних dimensions і порівняння WoW а не «ще один скрипт». Після запуску цінність у швидких алертах на money-URL і чесному brand/non-brand розкладі.

Потрібна допомога з дашбордом SEO команда SEO-Studio налаштує вимірювання в рамках SEO-послуг.