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 или parquet по дате снятия для аудита.
  • Отдельные джобы для 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-услуг.