---
name: yandex-metrika
description: "Аналитика кампаний через Яндекс Метрику: отчёты по UTM, CPA, конверсии, сравнение периодов. Используй при запросах 'метрика', 'аналитика', 'CPA', 'конверсии', 'как работает кампания', 'отчёт по кампании', 'покажи статистику'."
---

# Яндекс Метрика — аналитика рекламных кампаний

Workflow-гайд для аналитики кампаний через MCP-инструменты `metrika_*`.

**MCP-сервер:** `yandex-direct` — Метрика является частью единого MCP-сервера Яндекс Директа. Токен Метрики не нужен отдельно — используется тот же OAuth что и для Директа.

**Зачем:** Директ даёт данные по расходам и кликам, Метрика — по поведению на сайте (визиты, отказы, конверсии). Вместе — полная картина эффективности.

---

## Инструменты `metrika_*`

| Инструмент | Описание |
|---|---|
| `metrika_get_counters` | Список доступных счётчиков (ID, сайт, статус) |
| `metrika_get_counter` | Детали одного счётчика (название, сайт, настройки) |
| `metrika_get_goals` | Цели счётчика — ID нужны для метрик конверсий |
| `metrika_get_report` | Универсальный отчёт: любые метрики + группировки + фильтры |
| `metrika_get_report_bytime` | Данные с разбивкой по времени (день/неделя/месяц) — для графиков |
| `metrika_get_report_comparison` | Сравнение двух сегментов или периодов |
| `metrika_get_direct_report` | Кампании Директа из Метрики: визиты, отказы, конверсии после клика |
| `metrika_get_traffic_sources` | Источники трафика: Директ, поиск, соцсети, прямые заходы |
| `metrika_get_audience` | Демография и техника: гео, устройства, пол, возраст |
| `metrika_get_popular_pages` | Популярные страницы входа/выхода — для оптимизации посадочных |
| `metrika_get_goals_report` | Отчёт по конверсиям: достижения, конверсия, целевые визиты |

---

## Workflow 1: Счётчики и цели

Начни с идентификации счётчика и целей.

1. **Найти счётчик:**
   ```
   metrika_get_counters()
   ```
   Или использовать ID из `PROJECTS.md`.

2. **Получить цели:**
   ```
   metrika_get_goals(counter_id: <id>)
   ```
   Запомнить ID основной цели конверсии — нужен для всех отчётов.

---

## Workflow 2: Отчёт по кампании (основной)

Полный отчёт по эффективности кампании — сочетает данные Директа и Метрики.

### Шаги

1. **Статистика Директа:**
   ```
   get_campaign_stats(
     campaign_id: <id>,
     date_from: "<7 дней назад>",
     date_to: "<вчера>",
     attribution: "LYDC"
   )
   ```
   Получить: расход, клики, показы, CTR, конверсии.

2. **Данные Метрики:**
   ```
   metrika_get_direct_report(
     counter_id: <из PROJECTS.md>,
     date1: "<7 дней назад>",
     date2: "<вчера>",
     utm_campaign: "<slug кампании>"
   )
   ```
   Получить: визиты, отказы, глубина просмотра, время на сайте.

3. **Расчёт CPA:**
   ```
   CPA = расход / конверсии
   ```

4. **Оценка здоровья** (пороги из `PROJECTS.md`):

   | Статус | Условие | Действие |
   |--------|---------|----------|
   | GOOD | CPA в пределах нормы | Продолжать, масштабировать |
   | ATTENTION | CPA выше нормы | Проверить поисковые запросы, минус-слова |
   | CRITICAL | CPA сильно выше нормы | Минус-слова, пересмотр ключевых, проверка лендинга |

5. **Обновить файл кампании** `campaigns/<utm>.md` — добавить строку в таблицу результатов.

---

## Workflow 3: Трафик и источники

Анализ откуда приходит трафик.

```
metrika_get_traffic_sources(
  counter_id: <id>,
  date1: "<начало периода>",
  date2: "<конец периода>"
)
```

Смотреть: доля Директа vs органика vs соцсети, качество трафика по источникам (отказы, глубина).

---

## Workflow 4: Конверсии

Детальный анализ конверсий по целям.

```
metrika_get_goals_report(
  counter_id: <id>,
  date1: "<начало периода>",
  date2: "<конец периода>",
  goal_id: <id цели>
)
```

Анализ: какие источники и кампании приносят конверсии, конверсия по этапам воронки.

---

## Workflow 5: Сравнение периодов

Сравнение двух временных периодов — для оценки динамики.

```
metrika_get_report_comparison(
  counter_id: <id>,
  date1a: "<начало периода A>",
  date2a: "<конец периода A>",
  date1b: "<начало периода B>",
  date2b: "<конец периода B>"
)
```

Типичное использование: текущая неделя vs прошлая, текущий месяц vs предыдущий.

---

## Workflow 6: Аудитория и страницы

### Демография и устройства

```
metrika_get_audience(
  counter_id: <id>,
  date1: "<начало>",
  date2: "<конец>",
  dimension: "gender"  // или "age", "device", "geo"
)
```

Используй для корректировки таргетинга — если 80% конверсий с мобильных, усилить мобильную рекламу.

### Популярные страницы

```
metrika_get_popular_pages(
  counter_id: <id>,
  date1: "<начало>",
  date2: "<конец>"
)
```

Используй для оптимизации посадочных — если страница с высоким трафиком имеет высокие отказы, нужно её доработать.

---

## Каденция проверок

| День | Действие |
|------|----------|
| Понедельник | Недельный отчёт по всем активным кампаниям (workflow 2) |
| Четверг | Сравнение периодов (workflow 5): текущая vs прошлая неделя |
| По запросу | Разовые отчёты, аудитория, страницы |

---

## Интеграция с другими источниками

| Задача | Источник |
|--------|----------|
| Расходы, клики, показы, CTR | MCP: `get_campaign_stats` (attribution: LYDC) |
| Визиты, отказы, глубина, конверсии | MCP: `metrika_get_direct_report` |
| Поисковые запросы | MCP: `get_search_queries` |
| Ставки, стратегия, статус кампании | MCP: `get_campaigns`, `get_ads` |

---

## Кросс-ссылки

- **demand-research** — если CPA высокий, исследуй спрос и ищи новые ключи
- **serp-monitor** — если позиции падают, конверсии тоже упадут
- **yandex-direct** — создание и управление кампаниями

## Обновление файлов кампаний

После каждой проверки обнови файл `campaigns/<utm>.md`:

1. Добавь строку в таблицу результатов:
```markdown
| 2026-03-15 | 450 | 35% | 12 | 3 750₽ | GOOD |
```

2. Обнови секцию «Где сейчас» с текущим статусом и рекомендациями.

## Настройка

- **counter_id** — из `PROJECTS.md` (секция «Счётчик Яндекс Метрики»)
- **goal_id** — из `PROJECTS.md` (секция «Цель конверсии»)
- **CPA-пороги** — из `PROJECTS.md` (секция «Бюджетные правила»)
- **Атрибуция** — всегда LYDC для отчётов Директа (last yandex direct click)