Перейти к содержимому
ГлавнаяСкрипты/gads-anomaly-detector

Z-score детектор аномалий (Python CLI)

Команда из репозитория google-ads-agents. Считает скользящее среднее и стандартное отклонение за 14 дней по расходу, CTR, CPC и конверсиям и отмечает дни с отклонением больше двух сигм.

Python CLI
# Run via google-ads-agents CLI
python scripts/gads_anomalies.py \
  --customer 123-456-7890 \
  --days 30 \
  --baseline-days 14 \
  --z 2 \
  --json

Как это работает

  1. Вычисляет среднее и стандартное отклонение метрик (расход, CTR, CPC, конверсии) за 14-дневный базовый период.
  2. Рассчитывает отклонение текущего дня от исторической нормы.
  3. Сигнализирует о статистической аномалии при Z-оценке >= 2.0 (p < 0.05).

Инструкция по установке

  1. Клонируйте репозиторий: git clone https://github.com/arcbaslow/google-ads-agents
  2. Установите зависимости: uv pip install -r scripts/requirements.txt
  3. Авторизуйтесь: python scripts/gads_auth.py --adc
  4. Запустите команду поиска аномалий.

Частые вопросы

Можно ли запускать в CI/CD?

Да, флаг --json возвращает чистый структурированный JSON для автоматических пайплайнов.

Нужен скрипт под вашу задачу?

Пишем скрипты Google Ads, настраиваем server-side GA4 и собираем отчётность под конкретные вопросы бизнеса.