Что такое UrbanAds API и как он связан с Яндексом
UrbanAds — это платформа Яндекса для размещения цифровой наружной рекламы. Она объединяет операторов цифровых экранов и рекламодателей: вы загружаете креатив, выбираете локации и запускаете показы. API этой платформы даёт программный доступ к тем же действиям, которые доступны в веб-интерфейсе.
UrbanAds API — это способ управлять наружной рекламой так же, как контекстной: через код, без ручных операций в личном кабинете.
Для маркетолога это означает: можно автоматически запускать кампании по расписанию, останавливать их при достижении лимита бюджета, выгружать статистику в свою систему аналитики. Всё это работает через стандартные HTTP-запросы с авторизацией по токену.
Это же делается за пару кликов
Разбор из статьи — ручная работа на каждом клиенте. В PRO-кабинете такие проверки идут по расписанию сами, а вам приходит короткий вывод: где поехало и что делать.
Как работает интеграция с Директом
Яндекс Директ и UrbanAds связаны на уровне аккаунта. Если у вас есть кабинет в Директе, вы можете подключить наружную рекламу как дополнительный канал размещения. Интеграция позволяет управлять кампаниями обоих типов из одного интерфейса и получать сводную статистику.
Через API Директа можно управлять медийными кампаниями, которые размещаются на наружных экранах. UrbanAds API дополняет это доступом к конкретным площадкам, расписаниям показов и детальной статистике по каждому экрану.
Для настройки интеграции нужен OAuth-токен Яндекса с правами на управление рекламными кампаниями. Токен получают через стандартную процедуру авторизации приложения. После этого можно отправлять запросы к обоим API из одного скрипта.
Какие данные можно получить через API
UrbanAds API возвращает три типа данных: список доступных площадок, статистику показов и информацию о кампаниях. Площадки описываются адресом, типом экрана, размером и ценой за тысячу показов. Статистика включает число показов, цену и период.
Эти данные нужны для расчёта эффективности. Без API вы бы вручную скачивали отчёты из личного кабинета и сводили их в Excel. С API вы получаете JSON-ответ, который можно сразу передать в свою систему аналитики.
Для сквозной аналитики важно связать показы наружной рекламы с конверсиями на сайте. Это делается через UTM-метки в креативах или через сопоставление временных интервалов показа и визитов. Подробнее о настройке целей читайте в статье Цели в Яндекс Метрике: как настроить для обучения Директа.
Как автоматизировать запуск кампаний
Автоматизация начинается с создания шаблона кампании. В шаблоне вы задаёте креатив, список площадок, расписание показов и бюджет. Затем скрипт по расписанию отправляет запрос на создание кампании через API.
Типичный сценарий: кампания запускается в понедельник утром, останавливается в пятницу вечером, а в выходные показы не идут. Скрипт проверяет остаток бюджета и при достижении порога отправляет уведомление. Это экономит время, которое раньше уходило на ручные операции.
Кампанию с показами на наружных экранах создают через API Директа, а конкретные площадки, расписание и статистику по показам получают через UrbanAds API.
Как считать ROI по наружной рекламе
ROI наружной рекламы считается по той же формуле, что и для других каналов: (доход − расход) / расход × 100%. Сложность в том, что доход от билборда не всегда напрямую виден в аналитике.
Чтобы связать показы с продажами, используйте несколько методов. Первый — UTM-метки в креативах: пользователь видит рекламу, запоминает адрес сайта и вводит его вручную. Второй — сравнение периодов: запускаете кампанию в одном городе и смотрите на изменение числа заявок в этом регионе.
Для точного расчёта нужна сквозная аналитика. Она связывает показы наружной рекламы с действиями на сайте и звонками. Подробнее о формуле и примерах расчёта читайте в статье Как считать ROI рекламной кампании: формула и примеры.
<!-- inline-cta -->Типичные ошибки при работе с API
Первая ошибка — неверный формат запроса. UrbanAds API принимает данные в JSON, и любая опечатка в названии поля приводит к ошибке 400. Проверяйте документацию перед каждым запросом.
Вторая ошибка — отсутствие обработки ошибок. Скрипт, который не проверяет код ответа, может молча пропустить сбой и оставить кампанию неактивной. Добавляйте проверку статуса и логирование.
Третья ошибка — игнорирование лимитов API. У UrbanAds есть ограничения на число запросов в минуту. Превышение лимита приводит к временной блокировке. Настраивайте паузы между запросами.
Чек-лист перед стартом
- Получите OAuth-токен с правами на управление рекламными кампаниями.
- Изучите документацию UrbanAds API: методы, форматы, лимиты.
- Подготовьте креативы в нужных размерах и форматах.
- Определите список площадок и расписание показов.
- Настройте UTM-метки для отслеживания переходов.
- Подключите сквозную аналитику для расчёта ROI.
- Напишите скрипт с обработкой ошибок и логированием.
После настройки автоматизации вы сможете управлять наружной рекламой так же, как контекстной. Если нужно настроить отчёты по всем каналам в одном месте, посмотрите Мастер отчётов Яндекс Директ: настройка автоотчётов.
Частые вопросы
▸Можно ли использовать UrbanAds API без аккаунта в Яндекс Директе?
Да, UrbanAds работает как отдельная платформа. Но для сквозной аналитики и единого управления кампаниями удобнее иметь аккаунт в Директе и связать его с UrbanAds.
▸Какие форматы креативов поддерживает UrbanAds?
Платформа поддерживает статические изображения и видео. Точные требования к размерам и форматам зависят от типа экрана и оператора площадки. Проверяйте спецификации в документации UrbanAds.
▸Как часто обновляется статистика в API?
Статистика показов обновляется с задержкой от нескольких минут до часа. Для оперативного мониторинга используйте веб-интерфейс, для отчётов — API.
Источники
- Яндекс Директ API — документация — Яндекс
