Перейти к содержимому

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

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

Python
# 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. Отмечает дни, где оценка больше 2.0, это примерно крайние 5% при нормальном распределении.

Установка

  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 и собираем отчёты под конкретный вопрос.