Открыть сервис
Главная → Блог → API ЕРИР

API ЕРИР

API ЕРИР — это программный интерфейс (API) для взаимодействия с Единым реестром интернет-рекламы (ЕРИР), государственной информационной системой, созданной в Российской Федерации для учёта, хранения и обработки данных о распространении интернет-рекламы. API ЕРИР обеспечивает автоматизированный обмен информацией между участниками рекламного рынка (рекламодателями, операторами рекламных систем, издателями, посредниками) и оператором реестра — Федеральной службой по надзору в сфере связи, информационных технологий и массовых коммуникаций (Роскомнадзором).

История создания и нормативная база

Создание ЕРИР и его API связано с вступлением в силу Федерального закона от 2 июля 2021 года № 347-ФЗ «О внесении изменений в Федеральный закон «О рекламе»». Закон обязал всех участников рынка интернет-рекламы передавать данные о каждом факте показа рекламы в единую государственную информационную систему. Основная цель — повышение прозрачности рынка, борьба с недобросовестной конкуренцией и обеспечение контроля за соответствием рекламы требованиям законодательства.

Первоначально система была запущена в тестовом режиме в 2022 году, а обязательная передача данных через API стала требоваться с 1 сентября 2022 года. Позднее, с 1 марта 2023 года, вступили в силу поправки, которые ввели обязательную маркировку интернет-рекламы и предоставление отчётности в ЕРИР. API ЕРИР стал единственным легальным способом для автоматизированной передачи этих данных.

Классификация и виды API

API ЕРИР представляет собой RESTful-интерфейс, работающий по протоколу HTTPS. Он включает несколько основных групп методов (endpoints), каждая из которых предназначена для выполнения определённых задач:

API для передачи данных о рекламных кампаниях

Этот набор методов позволяет участникам рынка отправлять в ЕРИР сведения о:

API для получения отчётов

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

API для проверки статусов

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

API для взаимодействия с операторами рекламных систем

Операторы рекламных систем (например, Яндекс.Директ, VK Реклама, myTarget — принадлежат компаниям, зарегистрированным в РФ) используют API для массовой загрузки данных от своих клиентов (рекламодателей) в ЕРИР. Это упрощает процесс, так как рекламодателю не нужно самостоятельно взаимодействовать с системой.

Устройство и характеристики

API ЕРИР построен на принципах асинхронного обмена данными. Это означает, что после отправки запроса на загрузку данных система не возвращает мгновенный результат, а ставит задачу в очередь. Ответ о статусе обработки приходит позже, что требует от клиентских приложений реализации механизмов опроса (polling) или использования вебхуков (webhooks) для получения уведомлений.

Основные характеристики:

Применение

API ЕРИР используется всеми участниками рекламного рынка, которые обязаны передавать данные в реестр:

  1. Рекламодатели — передают данные о своих рекламных кампаниях и креативах. Для крупных рекламодателей с большим объёмом рекламы API является единственным практичным способом соблюдения требований закона.
  2. Операторы рекламных систем — интегрируют API в свои платформы, чтобы автоматически передавать данные от имени своих клиентов.
  3. Издатели (владельцы сайтов и приложений) — передают данные о показах рекламы на своих ресурсах.
  4. Посредники (рекламные агентства, SSP, DSP) — обеспечивают передачу данных от нескольких рекламодателей или издателей.
  5. Разработчики программного обеспечения — создают интеграционные модули для CRM-систем, биллинговых платформ и других корпоративных инструментов.

Примеры интеграции

Типичный сценарий использования API ЕРИР включает следующие шаги:

  1. Регистрация — участник получает учётные данные (логин, пароль, токен) в личном кабинете на портале ЕРИР.
  2. Создание креатива — отправляется POST-запрос на /api/v1/creative с файлом рекламного материала и метаданными (название, тип, формат).
  3. Создание рекламной кампании — отправляется POST-запрос на /api/v1/campaign с настройками кампании и ссылкой на созданный креатив.
  4. Передача фактов показа — периодически (например, раз в час) отправляется POST-запрос на /api/v1/impression с массивом данных о показах.
  5. Проверка статуса — отправляется GET-запрос на /api/v1/status/{id} для получения информации о прохождении модерации.

Критика и сложности

Внедрение API ЕРИР вызвало ряд критических замечаний со стороны участников рынка:

Перспективы развития

По заявлениям Роскомнадзора, API ЕРИР будет развиваться в направлении:

Также рассматривается возможность интеграции API ЕРИР с другими государственными информационными системами, такими как портал Госуслуг и система маркировки товаров «Честный ЗНАК».

Источники

BFOmetr — база данных и аналитика по компаниям России.

На главную BFOmetr →

Похожие материалы