Публичный API Яндекс UrbanAds: как автоматизировать статистику рекламы в Еде, Лавке, Go и Маркете
С 16 июля 2026 данные кампаний, отчёты по бусту и полкам и отзывы можно забирать в BI без ручной выгрузки
Получить предложениеКоротко: 16 июля 2026 года Яндекс открыл публичный API UrbanAds — рекламодатели и агентства могут автоматически забирать статистику кампаний, маркетинговые отчёты и отзывы в BI-системы без ручных выгрузок из кабинета. Документация размещена внутри urbanads.yandex.ru в разделе «API-интеграции».
Публичный API UrbanAds снимает рутину ручных CSV и открывает путь к единым дашбордам для retail media. Ниже — подключение токена в кабинете, карта отчётов по бусту, полкам и охватным форматам, связка с Директом и Метрикой без дублирования расходов.
API с 16.07.2026
Токен в «API-интеграциях» · буст, полки, охват и отзывы в выгрузке · до 94 млн охват аудитории.
urbanads → API → ODS
direct + metrika → BI
expense/upload без дублей
Что такое Яндекс UrbanAds и зачем бизнесу публичный API
Какие сервисы объединяет UrbanAds: Еда, Лавка, Go, Деливери, Маркет
UrbanAds — единый рекламный кабинет городских сервисов Яндекса. С 23 июля 2025 года под этим брендом собрана реклама в Яндекс Go, Яндекс Еде, Деливери, Яндекс Лавке и Яндекс Маркете. По данным пресс-службы, охват аудитории платформы — до 94 млн пользователей в месяц; до 60% аудитории — со средним и выше среднего доходом, до 46% — моложе 34 лет.
Для маркетолога это означает одно окно вместо пяти разрозненных кабинетов: можно запускать буст товаров, продвижение категорий в полках, охватные баннеры и видео сразу на нескольких площадках. Аналитика в интерфейсе уже давно показывала разрез по каждому сервису отдельно — API переносит те же данные в ваши инструменты.
Что изменилось 16 июля 2026: публичный API статистики и отчётов
16 июля 2026 года (публикация ppc.world в 13:52 МСК) Яндекс объявил публичный API для рекламодателей UrbanAds. Пресс-служба формулирует задачу прямо: интеграция «избавляет от необходимости выгружать статистику из личного кабинета вручную», а данные можно использовать «в привычных инструментах аналитики».
Через API доступны три группы данных:
- агрегированная статистика по рекламным кампаниям;
- маркетинговые отчёты по форматам продвижения (буст показов, буст продаж, полки, охватные форматы);
- отзывы — для обработки в собственном интерфейсе рекламодателя.
Важная оговорка: на момент релиза отдельной публичной страницы API на yandex.ru/dev (как у Директа или Метрики) нет. Токен, документация и журнал запросов — только в кабинете UrbanAds. Ниже мы описываем подключение и сценарии честно, без выдуманных адресов методов.
Геореклама Яндекса и единый рекламный кабинет городских сервисов
Запросы вроде «геореклама яндекс» (447 показов в месяц по Wordstat) часто ведут рекламодателя к UrbanAds: это retail media в привычных сценариях — заказ еды, поездка на такси, покупка в Лавке или на Маркете. Коммерческая зрелость канала подтверждается финансами: в Q4 2025 выручка от рекламы в Городских сервисах (платформа UrbanAds) составила 21,0 млрд ₽ (+31% год к году), по отчёту Яндекса от 17.02.2026. Активная аудитория блока — 62,3 млн пользователей в месяц (+17% г/г). Не путайте 94 млн (рекламный охват) и 62,3 млн (активные пользователи сервисов).
Публичный API — логичный следующий шаг: когда бюджеты растут, ручные CSV перестают масштабироваться.
| Показатель | Значение | Источник |
|---|---|---|
| Дата запуска UrbanAds | 23.07.2025 | Пресс-релиз Яндекса |
| Дата релиза API | 16.07.2026 | ppc.world, пресс-служба |
| Охват аудитории | до 94 млн/мес | urbanads.yandex.ru |
| Выручка рекламы Q4 2025 | 21,0 млрд ₽ (+31% г/г) | Финотчёт 17.02.2026 |
| Открутка Q2 2025 (рынок) | 14,5 млрд ₽ | Обзор Церебро |
архитектура данных · релиз 16.07.2026
От кабинета UrbanAds до единого дашборда
Публичный API снимает ручные CSV, но ценность — в контуре данных: выгрузка по площадкам (Еда, Лавка, Go, Маркет) → staging-слой → BI вместе с Директом и Метрикой.
- Токен в «API-интеграциях» → cron-выгрузка кампаний, буста, полок и отзывов
- Staging с ключом дата + кампания + площадка — без дублей строк
- Сверка API с UI кабинета первые 2–3 недели — рекомендация экспертов
Итог: UrbanAds API → ODS → Looker Studio — еженедельный отчёт клиенту без ручных выгрузок.
Дальше — какие метрики и форматы отдаёт API по каждому типу продвижения.
Что отдаёт API UrbanAds: метрики, отчёты и отзывы
Буст показов и продаж: какие поля забирать в отчёт
В UrbanAds четыре базовых формата продвижения — терминология единая для кабинета и API:
| Формат | Суть | Типичные метрики в дашборде |
|---|---|---|
| Буст продаж | Performance-продвижение конкретных товаров на Маркете; ставка — процент от цены товара, списание после покупки и получения | Продажи, заказы, конверсия, доля рекламных затрат |
| Буст показов | Охватные CPM-кампании для товаров в Маркете и Лавке | Показы, охват, частота, CTR, CPM |
| Продвижение в полках | Приоритет категорий в поиске и каталоге Маркета/Лавки (CPM) | Показы в полке, охват категории, CPM |
| Охватное продвижение | Медийные форматы: баннеры, видео, пуши, поп-апы в Go, Еде, Лавке, Деливери, Маркете | Охват, VTR (досмотры видео), CPT, клики |
Точный перечень полей в ответе API смотрите в документации кабинета — в открытых источниках спецификации JSON не опубликованы. Ориентир для аналитика: метрики, которые вы уже видите в UI UrbanAds (медийные: охват, клики, CTR, CPM, CPT, VTR; performance: заказы, конверсия, стоимость привлечения заказа).
В мае 2026 для поставщиков Лавки появилась стратегия «Максимум заказов»: алгоритм перераспределяет бюджет в реальном времени. По тестам Яндекса: +10% к продажам и GMV, −25–27% доли рекламных затрат, +26% CTR относительно «Максимум показов» (seonews.ru). Эти KPI логично вывести в единый e-com дашборд через API.
Продвижение в полках: статистика по форматам
Полки — инструмент для категорий, а не отдельных SKU. В отчёте важны показы в выдаче, охват и стоимость тысячи показов. При мультисервисных кампаниях UrbanAds даёт разрез по площадкам — это ключевое поле для сверки: одна кампания может крутиться и в Лавке, и в Маркете.
Охватные форматы и маркетинговые отчёты
Охватное продвижение закрывает медийные задачи: узнаваемость, запуск новинок, click-out (переход на внешний сайт). По данным Церебро, 11,5% всех кликов на площадке — переходы на сторонний сайт; минимальный CPM click-out — 50 ₽, минимальный бюджет кампании — 300 ₽, аукцион второй цены.
Для крупных бюджетов в кабинете доступны lift-отчёты (Brand Lift, Visit Lift, Sales Lift, Search Lift) — обычно через менеджера. Публичный API на момент релиза ориентирован на операционную статистику, а не на заказные исследования; уточняйте в документации кабинета, какие lift-форматы попали в выгрузку.
Отзывы через API: сценарии для локального бизнеса и репутации
Третий блок данных API — отзывы. Сценарии:
- Сеть ресторанов в Еде: единый дашборд рейтинга по точкам, SLA ответа, алерты на негатив.
- Поставщик на Маркете/Лавке: связка отзывов с рекламными кампаниями буста — видно, растёт ли оценка на фоне роста показов.
- Агентство: отчёт клиенту не только по расходу и заказам, но и по динамике репутации.
Эксперты Analito советуют сразу заложить отзывы в единый дашборд вместе с Директом, Метрикой и CRM, а не держать их в отдельной таблице.
Как подключить API-интеграцию в кабинете UrbanAds
Раздел «API-интеграции» на urbanads.yandex.ru
Подключение начинается в личном кабинете urbanads.yandex.ru:
- Авторизуйтесь под аккаунтом с правами на статистику.
- Откройте раздел «API-интеграции».
- Сгенерируйте токен доступа (формат авторизации — bearer или иной; точное описание только в документации кабинета).
- Изучите техническую документацию в том же разделе.
- Настройте выгрузку: собственный скрипт, ETL или планировщик (cron).
- Контролируйте запросы в журнале запросов.
Публичного репозитория с OpenAPI на yandex.ru/dev для UrbanAds пока нет — это отличие от API Яндекс Директа и API Яндекс Метрики.
Выпуск токена и журнал запросов
Токен — единая точка доступа для всех отчётов аккаунта. Рекомендации:
- храните токен в секрет-хранилище, не в репозитории;
- выдайте отдельные токены для prod и тестовой среды, если кабинет это позволяет;
- при компрометации — отзовите и перевыпустите через «API-интеграции».
Журнал запросов помогает отлаживать интеграцию: видно, какие выгрузки прошли, где ошибки авторизации или лимиты. Первые 2–3 недели сверяйте цифры API с UI кабинета — совет экспертов Analito.
Документация, лимиты и типичные ошибки при первом подключении
В открытых источниках не опубликованы лимиты запросов в секунду, полный список полей ответа и коды ошибок. Всё это — в документации внутри кабинета. Типичные проблемы на старте:
| Ошибка | Причина | Что сделать |
|---|---|---|
| 401 / отказ авторизации | Просроченный или отозванный токен | Перевыпустить токен, проверить заголовок Authorization |
| Пустой отчёт | Неверный период или ID кампании | Сверить с UI, проверить часовой пояс (Москва) |
| Расхождение цифр | Разные модели атрибуции или задержка обновления | Сверка 2–3 недели, единый календарь периодов |
| Дубли строк | Повторный импорт без дедупликации | Ключ: дата + кампания + площадка + формат |
Автоматическая выгрузка статистики: API против ручных отчётов
Когда достаточно выгрузки из кабинета, а когда нужен API
| Способ | Плюсы | Минусы | Когда выбирать |
|---|---|---|---|
| Ручная выгрузка | Без разработки | Не масштабируется, человеческий фактор | 1–2 кампании, разовый аудит |
| Публичный API UrbanAds | Автоматизация, журнал, отзывы | Нужен разработчик или no-code ETL | 3+ кампаний, агентство, ежедневные отчёты |
| ETL-коннекторы | Готовые цепочки | Готового коннектора UrbanAds в открытых источниках не найдено (eLama — только аккаунт и пополнение) | Следить за обновлениями агрегаторов |
| Международные пайплайны (Improvado и др.) | Managed pipeline | Покрывают Direct/Display, не UrbanAds | Не релевантно на июль 2026 |
Сценарии для агентства и рекламодателя: ежедневные дашборды без ручной работы
| Сценарий | Кто | Что забирать | Куда | Результат |
|---|---|---|---|---|
| Агентский отчёт | Агентство | Кампании, расходы, KPI по форматам | Google Sheets, Looker Studio | Еженедельный отчёт клиенту |
| E-com дашборд | In-house | Заказы, GMV, стоимость заказа, Маркет/Лавка | Power BI + CRM | Сравнение UrbanAds vs Директ |
| Репутация | Локальный бизнес | Отзывы, SLA ответа | Внутренняя CRM | Контроль рейтинга в Еде/Лавке |
| Алерты | Аналитик | Расход, CTR, доля бюджета | Telegram, email | Раннее обнаружение просадок |
Сторонние коннекторы и собственная интеграция: что выбрать
Пока UrbanAds API молодой, собственная интеграция — самый надёжный путь. Схема: cron раз в сутки → запрос отчётов → staging-таблица → BI. Когда появятся коннекторы eLama, JetStat или аналогов, оцените стоимость подписки против поддержки своего скрипта.
API UrbanAds подключён, а отчёты всё ещё в Excel? Настроим выгрузку и единый дашборд
Monster Context выпустит токен в «API-интеграциях», настроит cron-выгрузку по бусту, полкам и охватным форматам, сверит цифры с кабинетом и соберёт отчётность по Еде, Лавке, Go и Маркету — без ручных CSV каждую неделю.
- Токен, журнал запросов и staging-таблица с ключом дата + кампания + площадка
- Ежедневные дашборды: расход, заказы, GMV и доля рекламных затрат по форматам
- Сверка API с UI кабинета в первые 2–3 недели — как рекомендуют эксперты
Сквозная аналитика: связка UrbanAds, Директа и Метрики
Зачем объединять UrbanAds с Яндекс Директом и Метрикой
Запрос «сквозная аналитика» (2735 показов/мес в Wordstat) отражает боль: рекламодатель тратит в контекстной рекламе Яндекса, UrbanAds и, возможно, на маркетплейсах, а отчёты живут в трёх кабинетах. Без единого слоя данных невозможно честно сравнить каналы по стоимости заказа и возврату на рекламные расходы.
UrbanAds не синхронизируется с Метрикой автоматически — в отличие от Директа. Значит, расходы UrbanAds нужно загружать отдельно.
API Яндекс Директа и API Яндекс Метрики в едином контуре данных
Типовая архитектура (практика рынка, не официальная схема Яндекса):
- UrbanAds API → staging (кампании, расходы, показы, заказы, отзывы).
- Direct Reports API v5 (
POST https://api.direct.yandex.com/json/v5/reports, ответ TSV, асинхронно: код 201 → polling до 200) → то же хранилище. - Метрика Reports API → визиты, цели, атрибуция.
- CRM → лиды и выручка через интеграции Метрики или свой ETL.
- Слой связки: UTM-метки, client_id, yclid, дедупликация событий (24 ч).
- BI: Power BI, DataLens, Looker Studio, Tableau.
Критично: данные Директа в Метрику передаются автоматически — повторная загрузка расходов Директа через API исказит отчёт «Источники, расходы и ROI».
Для сторонних систем, включая UrbanAds, используйте загрузку расходов Метрики:
POST https://api-metrika.yandex.net/management/v1/counter/{counterId}/expense/upload
Поля CSV: Date, Expenses, TrafficSource/UTMSource, UTMCampaign, Clicks, Currency и др. — документация. В отчётах Метрики смотрите метрики ym:ev:expenses, ym:ev:expenseCPC, ym:ev:expenseFavoriteGoalsROI.
Настройка сквозной аналитики: метрики, виджеты, единый дашборд
Пошагово:
- Определите единый словарь UTM для UrbanAds-кампаний (источник, кампания, формат).
- Настройте выгрузку UrbanAds → ETL → CSV → expense/upload в Метрику.
- Подключите Direct Reports API v5 для контекста.
- Сверьте визиты и цели Метрики с CRM (Битрикс24 и др.).
- Соберите дашборд: расход по каналам, стоимость заказа, ROMI.
Подробнее о работе с отчётами Метрики — в материале «Отчёт „Клиенты“ в Метрике».
Интеграции Метрики с внешними системами
Метрика поддерживает выгрузку в CRM, коллтрекинг, email-рассылки. Для UrbanAds ключевой мост — загрузка расходов и единые UTM. Post-click и post-view пиксели UrbanAds (оценка отказов, времени на сайте, микроцелей) дополняют картину, но не заменяют expense/upload для сводного ROI-отчёта.
UrbanAds, Директ и Метрика в одном контуре: разборы retail media в Telegram Monster Context
В канале — чек-листы по expense/upload, типовые ошибки дублирования расходов Директа, схемы ODS и кейсы e-com дашбордов. Удобно сверяться с практикой, пока настраиваете сквозную аналитику самостоятельно.
Реклама в городских сервисах: Еда, Лавка и Go
Яндекс Еда для бизнеса: рекламные форматы и отчётность
«Яндекс еда реклама» — один из сильнейших коммерческих кластеров (1035 показов/мес). Для ресторанов и dark kitchen UrbanAds даёт охватные форматы и продвижение в выдаче приложения. Через API выгружайте:
- расход и показы по точкам/кампаниям;
- заказы и конверсию (где доступно в формате);
- отзывы — критично для сетей с десятками адресов.
Связка с офлайн: стратегии UrbanAds позволяют продвигать офлайн-точки на карте — актуально для франшиз.
Реклама в Яндекс Лавке: кому подходит и какие метрики смотреть
«Реклама в яндекс лавке» (411 показов/мес) — запрос поставщиков FMCG и fresh-категорий. Форматы: буст показов, буст продаж, полки, «Максимум заказов». В дашборде через API отслеживайте GMV, долю рекламных затрат, CTR по сравнению со стратегиями.
Яндекс Go: реклама, такси и геореклама в единой экосистеме
«Яндекс go реклама» (301 показ/мес) — медийка в приложении такси и смежных сценариях. Метрики: охват, VTR для видео, CPT. Click-out ведёт на лендинг — помните про UTM и Метрику на посадочной. Для георекламы UrbanAds пересекается с запросом «геореклама яндекс»: таргетинг по гео и аудитории в одном кабинете с Едой и Лавкой.
Реклама на Яндекс Маркете и маркетплейсах
Продвижение товаров на Яндекс Маркете через UrbanAds
«Реклама яндекс маркет» (1720 показов/мес) и «продвижение товара яндекс маркет» — ядро e-com кластера. Буст продаж списывает процент только после покупки и получения товара — модель снижает риск холостых кликов. Буст показов и полки закрывают задачи видимости категории.
Внутренняя реклама на маркетплейсах и retail media в 2026
Сегмент retail media, по оценке Церебро, вырос в 300 раз за 5 лет; объём H1 2025 — 375 млрд ₽ (рыночная оценка, не данные Яндекса). Число рекламодателей UrbanAds за год выросло почти в 3 раза, оборот не-ecom бюджетов — в 2,5 раза. API — сигнал, что канал переходит из «эксперимента» в системный инструмент.
Требования к маркировке рекламы на маркетплейсах меняются — следите за регуляторикой в материале «Маркировка рекламы на маркетплейсах».
Как свести статистику Маркета с остальными каналами UrbanAds
В мультисервисных кампаниях используйте разрез по площадкам в API-выгрузке. В BI стройте воронку: Маркет (буст продаж) + Лавка (полки) + Go (охват) → единый ROMI с Директом. Без API сведение пяти CSV вручную занимает часы и даёт ошибки в формулах.
Чек-лист и типичные ошибки при запуске интеграции
Проверка токена, прав доступа и полноты выгрузки
- Токен выпущен в «API-интеграции», права на нужные аккаунты
- Документация из кабинета сохранена внутри команды
- Первый прогон: сверка расхода и показов с UI за вчера
- Журнал запросов без массовых 4xx/5xx
- Staging-таблица с первичным ключом (дата, кампания, площадка)
- Расписание cron согласовано с задержкой данных в кабинете
Ошибки сквозной аналитики при смешении UrbanAds и Директа
- Дублирование расходов Директа при ручной загрузке в Метрику.
- Разные часовые пояса (Директ и Метрика — Москва по умолчанию).
- Несовпадение атрибуции UrbanAds и last click в Метрике.
- Нет единого словаря UTM — post-click из UrbanAds не стыкуется с CRM.
- Нет сверки кабинет vs API в первые недели.
Когда заказать настройку рекламы и интеграции у специалиста
Обратитесь к подрядчику, если:
- бюджет UrbanAds сопоставим с Директом, а отчётность всё ещё в Excel;
- нужна сквозная аналитика с CRM и несколькими счётчиками Метрики;
- команда не готова поддерживать ETL, а готового коннектора нет;
- требуется аудит retail media перед масштабированием на все пять площадок.
Базовые принципы настройки контекста — в «Настройка Яндекс Директа в 2026» и «Контекстная реклама Яндекс».
Бюджет UrbanAds сопоставим с Директом, а ROMI по каналам не сходится? Закажите аудит retail media и интеграции API
Оставьте заявку — проверим токен и полноту выгрузки, связку UrbanAds → Метрика без дублей Директа, единый словарь UTM и готовность дашборда к масштабированию на все пять площадок.
FAQ
Публичный API UrbanAds, Метрика и коннекторы
Есть ли публичная документация UrbanAds API на yandex.ru/dev?
Нет. Документация, токен и журнал запросов — только в кабинете urbanads.yandex.ru → «API-интеграции».
Какие отчёты отдаёт API?
Статистика кампаний, маркетинговые отчёты по бусту показов/продаж, полкам и охватным форматам, а также отзывы — по релизу 16.07.2026.
Есть ли готовый коннектор eLama или JetStat для UrbanAds?
В открытых источниках на июль 2026 готового API-коннектора не найдено; eLama поддерживает создание аккаунта и пополнение.
Как передать расходы UrbanAds в Яндекс Метрику?
Через API загрузки расходов expense/upload с полями Date, Expenses, UTMCampaign, Clicks. Директ загружать повторно нельзя — он синхронизируется автоматически.
Нужно ли сверять API с кабинетом?
Да. Analito рекомендует сверку хотя бы первые 2–3 недели после запуска.
Попадают ли lift-отчёты (Brand Lift и др.) в публичный API?
Не подтверждено. Lift обычно заказывается через менеджера; уточняйте в документации кабинета.
Чем UrbanAds отличается от рекламы только на Маркете?
UrbanAds — единый кабинет для Go, Еды, Деливери, Лавки и Маркета с кросс-сервисной аналитикой и общими форматами продвижения. ---
Читайте также
Материалы блога Monster Context
Настройка Яндекс.Директ в 2026: пошаговый гайд — Monster Context
ФАС и маркировка рекламы на маркетплейсах: что маркировать в 2026
Настройка и ведение Яндекс.Директ: в чём разница — Monster Context
