API ЕРИР¶

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

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

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

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

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

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

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

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

• Креативах — файлах рекламных материалов (изображения, видео, текст) с указанием их уникального идентификатора (токена).
• Рекламных кампаниях — настройках кампании: целевая аудитория, бюджет, геотаргетинг, временные рамки.
• Фактах показа — данные о каждом показе рекламы пользователю: дата и время, идентификатор пользователя (обезличенный), URL страницы, где был показ, тип устройства.

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

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

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

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

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

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

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

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

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

• Протокол: HTTPS (TLS 1.2+).
• Формат данных: JSON (JavaScript Object Notation) для запросов и ответов.
• Аутентификация: по токену (bearer token), который выдаётся после регистрации участника в системе.
• Лимиты: существуют ограничения на количество запросов в единицу времени (rate limiting) — обычно не более 10-20 запросов в секунду для одного токена.
• Объём данных: максимальный размер одного запроса на загрузку данных — 10 МБ.

¶Применение

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 требует значительных затрат времени и ресурсов, особенно для малых и средних компаний, не имеющих собственных IT-отделов.
• Ошибки в документации — по отзывам разработчиков, документация API содержала неточности и противоречия, что приводило к сбоям при интеграции.
• Ограничения по объёму — лимиты на размер запроса и частоту запросов могут быть недостаточными для крупных рекламодателей с миллионами показов в день.
• Отсутствие обратной связи — при отклонении данных система часто возвращает общие коды ошибок без подробного описания причины, что затрудняет исправление.
• Необходимость поддержки устаревших версий — при обновлении API старые версии могут переставать работать, требуя от участников постоянного обновления интеграций.

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

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

• Упрощения процедуры регистрации и интеграции для малого бизнеса.
• Внедрения механизмов автоматической валидации данных перед отправкой.
• Расширения функционала для анализа и мониторинга рекламного рынка в реальном времени.

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

¶Источники

• Федеральный закон от 2 июля 2021 г. № 347-ФЗ «О внесении изменений в Федеральный закон «О рекламе»».
• Приказ Роскомнадзора от 29.04.2022 № 77 «Об утверждении Порядка ведения единого реестра интернет-рекламы».
• Официальная документация API ЕРИР (версия 1.0) на портале Роскомнадзора.
• Разъяснения Федеральной антимонопольной службы (ФАС России) по вопросам применения закона об интернет-рекламе.
• Материалы конференций и вебинаров для участников рынка интернет-рекламы (2022-2024 гг.).