Как выгрузить статистику из Яндекс Директа

Выгрузка статистики из Директа начинается задолго до кнопки «Скачать»: сначала в Мастере отчётов задаётся период, группировки и метрики, и только потом файл уходит в XLSX или CSV. Если пропустить настройку, файл придёт с не тем периодом или без нужных строк, и сверять его с кабинетом придётся заново. Порядок действий охватывает путь от входа в Мастер до проверки скачанного файла.

Где открыть Мастер отчётов и какие есть входы

Мастер отчётов — инструмент для просмотра статистики кампаний и показателей их работы ^[2]. Попасть в него можно несколькими способами: через навигационное меню, список кампаний или страницу редактирования кампании ^[2].

Прямой путь — в меню Директа выбрать Статистика → Мастер отчётов ^[2].

Из списка кампаний есть два входа: меню действий напротив кампании, где в блоке Статистика выбирается тип отчёта, или кнопка Статистика под названием кампании ^[2]. В обоих случаях откроется статистика по выбранной кампании. Можно выделить несколько кампаний — внизу появятся кнопки перехода к статистике по ним ^[2]. Так же переходят к статистике групп или объявлений: переключитесь на нужный уровень и выделите элементы ^[2].

Со страницы редактирования кампании путь такой: меню действий справа от названия кампании → Статистика ^[2].

Есть нюанс: при переходе из списка кампаний или со страницы редактирования открывается готовый отчёт из Библиотеки, подобранный под тип кампании — перфоманс, охватная, продвижение приложений ^[2]. Это стартовая точка, а не пустой бланк: перед выгрузкой проверьте, что в нём стоят нужные вам группировки.

Период, группировки и метрики до нажатия «Скачать»

Порядок настройки в Мастере отчётов одинаков для любой задачи. Официальный пример — статистика по конкретному объявлению: задать период, выбрать группировки № объявления и Площадки, выбрать метрики, при необходимости добавить фильтры ^[2].

Разложим по шагам.

1. Период. Задайте вручную или выберите из предложенных вариантов ^[2]. Запишите даты начала и конца — они понадобятся при сверке файла.
2. Группировки. Это уровни, по которым разложатся строки: объявление, площадка, тип условия показа, место клика ^[2]. Чем больше группировок, тем мельче строки и тем больше их в файле.
3. Метрики. Показы, клики, расход и остальные показатели, которые нужны в отчёте. В примере с источником клика выбирается одна метрика — Клики ^[2].
4. Фильтры. Добавляются, если нужен срез: например, только одна кампания или только площадки с кликами ^[2].

В новом Мастере фильтр по группировкам вынесен отдельно, а фильтры по метрикам перенесены в настройки столбцов ^[3]. Если ищете фильтр там, где он был в старой версии, — смотрите настройки столбца.

При изменении настроек отчёт обновляется в режиме реального времени ^[3]. Перед скачиванием проверьте настройки и сохраните их для сверки файла с таблицей в кабинете.

Форматы XLSX и CSV: как выбрать и что попадёт в файл

Отчёты скачиваются в двух форматах — XLSX и CSV ^[1].

В настройках отмечается формат, который будет использоваться по умолчанию ^[1]. Дальше поведение кнопки зависит от того, сколько форматов отмечено:

• выбран один из вариантов, XLSX или CSV, — при нажатии Скачать загрузка начнётся сразу ^[1];
• указаны оба формата — при нажатии Скачать появится выбор формата файла ^[1].

Практический выбор простой. XLSX удобен, когда файл открывают в таблице и передают дальше человеку. CSV удобен для загрузки в другую систему, где нужен плоский текст. Если отчёт уходит в регулярную обработку, отметьте один формат по умолчанию — так кнопка скачивания сработает без лишнего шага.

Пустой отчёт и расхождения: что проверить

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

Период. Слишком узкое окно или даты, когда кампания не работала, дают пустые строки. Сверьте даты в отчёте с теми, что вы задавали.

Фильтры. Фильтр по группировке или по метрике отсекает строки ещё до выгрузки. В новом Мастере фильтры по метрикам живут в настройках столбцов ^[3] — проверьте и там, и в блоке фильтров по группировкам.

Группировки. Лишний уровень дробит строки; если по выбранной группировке у кампании нет данных, строк просто не будет. Уберите уровень и посмотрите, появятся ли строки.

Конверсии за прошлые периоды. Данные о конверсиях за прошлые периоды могут быть неполными ^[2]. Если расхождение касается целей, а не показов и кликов, причина может быть в этом.

Изменения настроек. При изменении настроек отчёт обновляется в режиме реального времени ^[3]. Перед сверкой убедитесь, что после скачивания вы не меняли период, группировки, метрики и фильтры.

Мастер отчётов, Библиотека и API: что выбрать под задачу

Три способа получить статистику решают разные задачи.

Библиотека включает набор готовых отчётов для разных аналитических задач и типов кампаний; с их помощью оценивают результаты перфоманс- и охватных кампаний и смотрят статистику по отдельным направлениям — поисковым запросам, площадкам, эффективности продаж ^[2]. На основе готовых отчётов из Библиотеки можно строить свои ^[2].

Есть и ИИ-помощник: он сам построит отчёт по запросу, без разбора группировок, метрик и фильтров ^[2]. Это вариант для быстрого взгляда, когда точный состав колонок не важен.

Перед передачей данных клиентов во внешний сервис определите, какие сведения можно передавать. Уберите из файла персональные данные, лишние идентификаторы и колонки, которые не нужны для задачи.

Проверка файла перед отправкой

Скачанный файл — это ещё не отчёт для получателя. Пройдите сверку по чек-листу.

• Период. Даты в файле совпадают с теми, что заданы в отчёте в кабинете.
• Фильтры. В файле нет строк, которые отсекает фильтр, и нет лишних, которые он должен был убрать.
• Группировки. Набор колонок-группировок в файле совпадает с выбранным в Мастере.
• Формат. Расширение файла совпадает с выбранным при скачивании.
• Итог. Сумма показов, кликов и расхода по файлу сходится с таблицей в кабинете за тот же период.
• Пропуски. Отмечены группировки, по которым в файле нет строк, и записана причина: нет данных, отсекает фильтр, неполные конверсии.

Учебный пример

Возьмём отчёт по одной кампании за завершённую неделю с группировкой по дням и метриками «Показы», «Клики», «Расход». Значений статистики в примере нет — проверяется карта сверки файла с кабинетом.

Входные настройки отчёта:

Заполненная карта сверки после скачивания:

Проверка. Сначала убедитесь, что все даты в колонке «День» входят в заданный период. Если в начале или конце периода нет строк, проверьте причину отдельно, как и для других отсутствующих дней. Затем сверьте набор колонок: «День», «Показы», «Клики», «Расход» — лишняя колонка означает лишнюю группировку или метрику, недостающая — потерянную настройку. Дальше выпишите дни периода, по которым в файле нет строк, и отдельно проверьте каждый: была ли кампания активна в этот день и не исключают ли данные выбранные фильтры. Отсутствие строки по дню — повод разобраться, а не автоматический признак ошибки выгрузки. Итог по каждой колонке сверяйте с таблицей в кабинете за тот же период. Если итог не сошёлся, проверяйте по порядку: границы периода в отчёте, активные фильтры по группировкам и метрикам, набор группировок, состояние отчёта на момент скачивания — не менялись ли настройки после нажатия «Скачать». Так расхождение получает конкретную причину, а не общий вывод о неверном файле.

Дальше файл можно отдавать в работу. Если нужен разбор динамики по группам пользователей, пригодится когортный анализ; если сверяете провал трафика из поиска, посмотрите разбор падения позиций в GSC.