Переход конструктора отчётов Adfox на API статистики v2
Яндекс запустил мажорную версию API статистики Adfox v2 и оставил старый API в параллельной работе до 1 августа 2026 года. После этой даты прежняя версия отключена, поэтому фоновые выгрузки и дашборды на старом маршруте перестают получать свежие данные. В v2 отчёт собирается иначе: фильтры, группировки и метрики перечисляются прямо в запросе к API.
Параметры отчёта задаются в самом запросе, без предварительно сохранённой формы в интерфейсе Adfox. Авторизационный токен остаётся прежним, поэтому переход сосредоточен на структуре запросов, обработке ответа и проверке цифр. Мы находим все задания, которые обращаются к статистике: ежедневную выгрузку для BI, таблицу дохода по площадкам, кабинет рекламодателя, сверку кампаний или внутренний отчёт редакции.
Для каждого фиксируем период, уровни детализации, фильтры, группировки, метрики и последующее преобразование колонок. Затем составляем эквивалентный запрос v2 и обновляем код, который читает ответ. Один отчёт проверяем по общей сумме и детализации. Сравниваем характерные дни, кампании, площадки и выбранные срезы, чтобы заметить другую группировку, пропущенный фильтр или изменение типа поля.
Отдельно проверяем пустой период, большой ответ и временную ошибку API. Результат поступает в прежний BI-набор, таблицу или экран с понятным журналом запуска. В дальнейшем аналитик сможет менять выбранные параметры отчёта в конфигурации запроса без создания новой сохранённой формы в Adfox.
Когда стоит обратиться
Обычно к нам обращаются в таких ситуациях:
- После 1 августа 2026 года ежедневная выгрузка Adfox завершилась ошибкой или перестала добавлять свежие строки.
- BI-отчёт зависит от старого API и заранее сохранённой настройки конструктора в интерфейсе Adfox.
- В компании несколько похожих отчётов, а их фильтры, группировки и метрики спрятаны в коде без единого реестра.
- Новый запрос v2 уже написан, однако итоговые суммы или разрезы расходятся с привычной выгрузкой.
Что именно мы сделаем
Собираем список старых запросов Adfox, расписаний, сохранённых отчётов, получателей данных и контрольных периодов.
Разбираем фильтры, группировки, метрики и правила преобразования каждого востребованного отчёта.
Формируем эквивалентные запросы API статистики v2 с действующим OAuth-токеном и обновляем обработчик ответа.
Сверяем старую выгрузку и v2 по общим итогам, дням, площадкам, кампаниям и другим значимым срезам.
Переключаем расписание, добавляем журнал и передаём карту полей, контрольные запросы и инструкцию сопровождения.
Что входит в стоимость
49 900 ₽ за всю работу
Инвентаризируем задания и приложения, которые получали статистику Adfox, фиксируем периоды, сохранённые отчёты, поля и получателей. Переносим запросы на v2 с прямым описанием фильтров, группировок и метрик, сохраняя действующий токен. Сравниваем старые выгрузки с новыми на одинаковых периодах, обновляем преобразование ответа, расписание и контроль ошибок.
Что будет готово
Передадим вам
- Рабочие запросы API статистики Adfox v2 для выбранных отчётов и обновлённый клиент загрузки данных.
- Карта фильтров, группировок, метрик и соответствия полей целевой BI-модели, таблицы или кабинета.
- Протокол сверки старой выгрузки и v2 по итогам и значимым срезам на контрольных периодах.
- Журнал запусков, конфигурация расписания и инструкция изменения и проверки отчётов после перехода.
Перед сдачей проверим
- Каждый выбранный отчёт формируется через API статистики v2 с действующим токеном и возвращает ожидаемые поля.
- Итоги и контрольные срезы v2 совпадают с эталонной выгрузкой либо имеют документированное объяснение различия.
- Данные поступают в прежний BI-набор, таблицу или внутренний кабинет по выбранному расписанию без повторных строк.
- Ошибка API и пустой период получают различимые статусы, а журнал показывает период, конфигурацию и результат запуска.
Как это выглядит на практике
Ежедневный отчёт по площадкам снова поступает в BI
- 01
Старое задание использует сохранённый отчёт Adfox и после отключения API перестаёт добавлять новый день.
- 02
Разработчик переносит фильтр, группировку по площадке и нужные метрики в прямой запрос API статистики v2.
- 03
Обработчик сопоставляет поля с витриной и сверяет общий итог и несколько площадок за контрольную дату.
- 04
Расписание загружает свежий период в BI, а журнал показывает параметры запроса, количество строк и результат сверки.
Что понадобится для работы
От вас
- Код или настройки скриптов, ETL и заданий, которые загружали статистику через прежний API Adfox.
- Действующий OAuth-токен Adfox либо участие администратора, который предоставит безопасный доступ к нему.
- Примеры старых выгрузок, список используемых отчётов и описание целевых таблиц, витрин или экранов.
- Контрольные периоды и срезы, по которым владелец данных обычно проверяет доход, показы и другие показатели.
Если у вас немного другая ситуация
Небольшие уточнения, которые помогают довести согласованный результат до рабочего состояния, уже учитываем в цене. Если по ходу работы появится отдельный крупный блок или понадобится платная лицензия, сначала обсудим варианты и стоимость. Расскажите о своей ситуации — подстроим план под неё.
- 3 000 ₽после подписания договора через Диадок
- 46 900 ₽после выполнения, демонстрации и приёмки результата
Предоплата входит в общую стоимость. Оставшуюся сумму оплачиваете после демонстрации и приёмки готовой работы.
Часто спрашивают
Об этой услуге
Когда отключили прежний API статистики Adfox?
Яндекс сообщил о параллельной работе старого API и v2 до 1 августа 2026 года. После этой даты прежняя версия отключена, поэтому её вызовы требуется перевести на API статистики v2.
Потребуется новый токен Adfox?
Существующий авторизационный токен продолжает работать — это прямо указано в официальном описании v2. Мы сохраняем его в защищённой конфигурации и меняем структуру запросов и обработки данных.
Чем v2 отличается от старого конструктора отчётов?
Фильтры, группировки и метрики перечисляются прямо в запросе API. Отчёт строится по этим параметрам без предварительно сохранённой формы в интерфейсе Adfox.
Можно сохранить привычные колонки в BI или таблице?
Да. Сопоставляем ответ v2 с существующими колонками и типами данных. При изменении структуры добавляем явное преобразование и подтверждаем результат на контрольной выгрузке.
Почему цифры нового отчёта могут отличаться?
Обычно причина находится в наборе фильтров, последовательности группировок, выбранной метрике, периоде или преобразовании ответа. Сверка по нескольким срезам показывает конкретное место расхождения.
Подойдёт переход для нескольких отчётов?
Да. Общий клиент v2 дополняем отдельными конфигурациями отчётов. После инвентаризации согласуем приоритеты и проверяем каждый востребованный срез по собственной контрольной выборке.
Что произойдёт при временной ошибке Adfox?
Задание сохраняет период и конфигурацию, выполняет контролируемый повтор и пишет результат в журнал. Успешная повторная загрузка учитывает уже полученные строки и исключает дублирование периода.
Как принимается готовая работа?
Запускаем каждый выбранный отчёт через v2, сравниваем итоги и значимые срезы с эталоном и проверяем появление данных у конечного получателя. Протокол и конфигурации остаются у команды.
Цена и изменения по ходу работы
Цена на странице окончательная?
Да. Перед началом мы сверяем исходные данные и фиксируем результат в договоре. Указанная на странице сумма покрывает согласованную работу целиком, даже если её техническая реализация потребует больше времени, чем ожидалось при оценке.
Что означает резерв незапланированных работ?
Это уже включённый в цену запас времени на небольшие связанные уточнения заказчика, которые появляются после старта: например, добавить поле, изменить формат уведомления или учесть ещё одно условие обработки.
Резерв рассчитывается по формуле: стоимость услуги × 30% ÷ 1 500 ₽. Для услуги за 30 000 ₽ это 6 часов. Эти часы относятся только к дополнительным, заранее незапланированным уточнениям. Они не являются сроком проекта и не ограничивают время на основную работу: согласованный результат мы выполняем полностью.
Можно уточнять детали уже во время работы?
Да. Небольшие связанные изменения обычно помещаются во включённый резерв и не требуют доплаты. Если новая идея заметно меняет результат или превращается в самостоятельную задачу, сначала обсудим подход и стоимость. Любое решение согласуем до выполнения.
Начало работы и оплата
Как оформляются договор и оплата?
Подписываем договор через Диадок. Предоплата составляет 3 000 ₽ и входит в общую стоимость услуги. Остаток оплачивается после демонстрации и приёмки готового результата.
Когда начинается срок выполнения?
Срок отсчитывается после согласования задачи, получения необходимых доступов и материалов, подписания договора и поступления предоплаты. Конкретную дату старта и плановый день готовности подтверждаем перед началом.
Как учитываются платные лицензии и внешние сервисы?
До старта проверяем, нужны ли тарифы, лицензии, сертификаты или дополнительные ресурсы внешних систем. Если они потребуются, заранее покажем варианты и стоимость. По возможности аккаунты и лицензии оформляются сразу на заказчика.
Проверка результата и гарантия
Как принимается готовая работа?
Вместе проверяем согласованные сценарии на контрольных данных или тестовой копии, а затем демонстрируем результат. Для интеграций сверяем передачу данных и обработку ошибок, для сайта — работу нужных страниц и действий пользователя, для отчёта — расчёты и обновление данных.
Какая гарантия действует после сдачи?
На выполненные изменения действует гарантия 3 месяца. Если в изменённой нами части обнаружится ошибка нашей реализации, проверим и исправим её без дополнительной оплаты. Переданные материалы, настройки и код остаются у заказчика.
Связанные шаги
- 01Аудит интернет-рекламы и рекламных площадок
Проверить рекламные площадки и структуру отчётности
- 02Переход конструктора отчётов Adfox на API статистики v2
Перевести статистику Adfox на API v2
- 03Витрина данных для управленческих отчётов из 1С, CRM и рекламы
Собрать данные рекламы в управленческую витрину