AdFox: агент для рекламы на площадке

Adfox — платформа Яндекса для управления рекламой на сайте, сбора статистики и оценки кампаний. Агент нужен маркетологу, который ведёт несколько площадок и вручную сводит показы, CTR и заполненность.

Агент — программа, которая делает дело целиком. Он не объясняет, где смотреть статистику: он обходит кампании постранично, сверяет маркировку и приносит готовый отчёт. Чат-бот ответит словами, агент вернётся с таблицей.

Три признака: работает в ваших сервисах, доводит до результата, работает без вас. Отчёт за прошлую неделю может лежать готовым к утру, пока вы занимаетесь креативами.

Коннектор — описание подключения: где взять токен, как проверить связь и какие данные открыты. Не плагин в CMS и не доработка сайта: доступ выдаётся на стороне платформы, ставить ничего не нужно.

Пароль не хранится. Коннектор работает по выданному токену и только с теми кампаниями, до которых токен допущен; отзыв токена прекращает работу.

По документации API Adfox платформа позволяет создавать рекламные кампании, контролировать их ход и выделять целевую аудиторию для показа. В API поддержана маркировка рекламы: контрагенты, включая владельца сайта, договоры, настройка маркировки на уровне кампании, то есть флайта, и на баннере. Отдельно описаны отчёты с заполненностью площадки рекламой, CTR и уникальной аудиторией. В справочнике есть разделы «Доступ», «Авторизация», «Пагинация», «Обработка ошибок» и «История изменений». API Статистики помечен как устаревший с 1.08.26.

### Реклама на площадке: доля расходов и ставки

Агент обходит кампании и флайты постранично, собирает расходы и ставки и считает долю каждой площадки в общем расходе. Сверяет, что у кампании заполнены контрагент и договор для маркировки: без них показ не соответствует требованиям. На выходе — таблица долей и список кампаний с незаполненной маркировкой.

### Отчёт по каналам: откуда трафик

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

### Каналы: что сработало и что усиливать

Агент сравнивает площадки по CTR, заполненности и уникальной аудитории, отмечает места, где показов много, а отклика нет. Проверяет, что выгрузка не упала в ошибку и не обрезалась пагинацией. Результат — короткий список: что усиливать, что проверить и где выборки не хватает.

Бюджет, ставки и запуск кампаний — за маркетологом. Агент не создаёт кампании без подтверждения и не меняет настройки маркировки самостоятельно.

Нужен аккаунт Adfox, связанный с Яндекс-аккаунтом: при регистрации они связываются, и открывается доступ и к API, и к веб-интерфейсам. Запросы авторизуются OAuth-токеном в заголовке Authorization при каждом вызове. В документации советуют завести для этого отдельный аккаунт. Достаточно токена, списка кампаний и периода отчёта.

Не придумывает данные за пропущенные дни. Не тянет всю историю одним запросом в обход пагинации. Не заменяет кабинет: сложные настройки маркировки делает человек.

Что такое агент, если коротко? Программа, которая сама выполняет работу в ваших сервисах и возвращается с готовым результатом, а не с описанием способа.

Что такое коннектор? Описание подключения: где взять токен, как проверить связь и что доступно агенту. Пароль при этом не передаётся и не хранится.

Чей аккаунт нужен? Аккаунт Adfox, связанный с Яндекс-аккаунтом; в документации советуют завести отдельный, не тот, что используется в других сервисах Яндекса.

Что с устаревшим API статистики? Он помечен как устаревший с 1.08.26, рядом описан актуальный порядок отчётов. Агент работает с актуальными методами.