Performance API Ozon - это интерфейс для программного управления рекламой на маркетплейсе. Через него можно автоматизировать запуск и остановку рекламных кампаний, управлять ставками, получать детальную статистику по кампаниям и отдельным товарам. Инструмент незаменим для селлеров, которые ведут десятки и сотни кампаний одновременно и хотят управлять рекламой без ручного переключения между вкладками кабинета.
В статье разберём, как получить доступ к Performance API Ozon, какие методы он предоставляет и как его можно использовать для повышения эффективности рекламы.
Что такое Performance API Ozon
Performance API - это отдельный API Ozon, предназначенный исключительно для управления рекламными кампаниями. Он не пересекается с основным API маркетплейса (который работает с товарами, заказами, остатками) - для рекламы нужен отдельный ключ доступа.
Чем отличается от обычного API Ozon
Обычный API Ozon (Client API) даёт доступ к каталогу товаров, заказам, отзывам, остаткам на складах. Performance API работает только с рекламным кабинетом:
| Возможность | Обычный API | Performance API |
|---|---|---|
| Товары, заказы, цены, остатки | Да | Нет |
| Управление рекламными кампаниями | Нет | Да |
| Статистика по рекламным кампаниям | Нет | Да |
| Управление ставками на места | Нет | Да |
| Работа с ключевыми словами в рекламе | Нет | Да |
| Автоматизация рекламных бюджетов | Нет | Да |
Какие задачи решает Performance API Ozon
Performance API позволяет автоматизировать рутинные операции в рекламном кабинете. Вот основные сценарии, которые закрывает этот инструмент:
Управление рекламными кампаниями. Создание, запуск, остановка и удаление кампаний через API. Это избавляет от необходимости вручную нажимать кнопки в интерфейсе для каждой кампании.
Автоматизация ставок. Если вы используете стратегию ручного управления ставками, API позволяет менять ставки на отдельные товарные позиции в зависимости от внешних данных: времени суток, дня недели, наличия товара на складе, цен конкурентов.
Сбор статистики. Performance API отдаёт подробные отчёты по каждой кампании: показы, клики, расходы, заказы, выручка. Данные можно забирать автоматически и загружать в свою систему аналитики.
Массовое управление товарами в рекламе. Добавление и удаление товаров из рекламных кампаний, настройка ставок для каждого товара - все эти операции можно выполнять программно через API.
Как получить токен Performance API Ozon
Для доступа к Performance API нужны два значения: Client ID и Client Secret. Они создаются в личном кабинете Ozon.
Шаг 1: Перейти в настройки Performance API
В личном кабинете Ozon откройте Настройки → Performance API. Раздел находится в меню настроек продавца.
Шаг 2: Создать или выбрать сервисный аккаунт
У вас может быть два варианта:
- если сервисный аккаунт уже создан - выберите его из списка;
- если нет - нажмите Создать аккаунт.
Сервисный аккаунт - это технический аккаунт Ozon, который используется для доступа к API. Он не привязан к конкретному сотруднику и не требует прав основного аккаунта. Если вы работаете с несколькими сервисами аналитики и автоматизации рекламы, можно создать отдельный сервисный аккаунт для каждого из них - это удобно для разграничения доступа и отслеживания действий каждого сервиса.
Шаг 3: Добавить ключ
После выбора или создания сервисного аккаунта нажмите Добавить ключ. Система сгенерирует пару Client ID и Client Secret.
Можно выпустить несколько ключей для одного аккаунта - например, отдельный ключ для каждого внешнего сервиса, с которым вы интегрируетесь.
Шаг 4: Скопировать Client ID и Client Secret
Ozon показывает созданные ключи в таблице. Чтобы скопировать значения:
- Наведите на строку с ключом, чтобы увидеть Client ID (Реклама) - скопируйте его. Важно: копируйте только цифры, без текста
@advertising.performance.ozon.ru. - Ниже наведите на строку, чтобы увидеть Client Secret (Реклама) - это пароль, который нужно хранить в безопасном месте.
Client Secret показывается только один раз при создании. Если вы его не сохранили, удалите ключ и создайте новый.
Шаг 5: Настроить права доступа
Performance API может быть сгенерирован только владельцем кабинета Ozon или менеджером, которому выданы соответствующие права доступа. Если вы менеджер и не видите раздела Performance API в настройках - обратитесь к владельцу кабинета.
Как добавить токен в сервис аналитики
После получения Client ID и Client Secret их нужно добавить в сервис, через который вы планируете управлять рекламой Ozon.
Если используете MP Manager
В MP Manager подключение Performance API Ozon происходит в разделе управления юридическими лицами и маркетплейсами.
При добавлении аккаунта Ozon нужно вставить два значения из кабинета:
- Client ID (Реклама) - только цифры, без служебного текста;
- Client Secret (Реклама) - полное значение из поля секретного ключа.
После этого MP Manager получает доступ к управлению рекламными кампаниями Ozon, и вы можете:
- видеть все рекламные кампании в едином интерфейсе;
- управлять ставками и бюджетами;
- отслеживать ключевые метрики рекламы рядом с данными по продажам.
Если используете другой сервис
Логика подключения везде одинаковая: сервис запрашивает Client ID и Client Secret для Ozon Performance API. Вставьте их в соответствующие поля и сохраните. В большинстве сервисов также нужно указать, для какого юридического лица предназначен этот ключ.
Важные ограничения
Performance API можно добавить только после основного API Ozon. Если у вас ещё не подключён базовый API (Client ID для работы с товарами и заказами), поле для добавления Performance API будет недоступно. Сначала подключите основной API Ozon в кабинете, а затем добавляйте Performance API.
Client Secret не восстанавливается. Если вы потеряли секретный ключ, его нельзя посмотреть повторно в кабинете Ozon. Удалите старый ключ и создайте новый.
Возможности Performance API Ozon
После подключения API открывается доступ к управлению рекламой через программные запросы. Вот что именно можно делать через Performance API.
Управление кампаниями
Performance API поддерживает все типы рекламных кампаний Ozon:
- Поиск (поисковая реклама) - показ товаров в поисковой выдаче и каталоге;
- Трафареты (реклама на карточках конкурентов) - показ на карточках товаров других продавцов;
- Медийная реклама (баннеры) - показ на главной странице и в каталоге;
- Акции - участие в акционных механизмах Ozon.
Через API можно создать кампанию, настроить её параметры, запустить и остановить в любой момент.
Управление ставками
Главное преимущество Performance API - возможность гибко управлять ставками. Через API можно:
- установить ставку на товар в конкретной кампании;
- изменить ставку для нескольких товаров одновременно;
- настроить автоматическое изменение ставок по расписанию;
- задать максимальную ставку для кампании.
Это особенно полезно для товаров с высокой конкуренцией, где ставка может меняться несколько раз в день.
Получение статистики
Performance API отдаёт структурированные отчёты по кампаниям. Можно получить данные за произвольный период по всем кампаниям или по отдельной кампании. В отчёт входят:
- количество показов и кликов;
- расходы на рекламу;
- количество заказов с рекламы;
- выручка с рекламных заказов;
- стоимость заказа (CPO);
- ROAS (окупаемость рекламы).
Эти данные можно выгружать регулярно и строить собственную аналитику, если стандартных отчётов Ozon недостаточно.
Работа с ключевыми словами
Для поисковых кампаний Performance API позволяет:
- добавлять и удалять ключевые слова;
- изменять ставки по отдельным ключевым словам;
- получать отчёт по эффективности каждого ключевого слова;
- выгружать поисковые запросы, по которым показывался товар.
Как автоматизировать рекламу на Ozon с помощью API
Performance API открывает возможности для автоматизации, которые вручную реализовать либо невозможно, либо слишком трудоёмко. Рассмотрим несколько практических сценариев.
Сценарий 1: Автокорректировка ставок по расписанию
Вы торгуете товарами, спрос на которые меняется в течение дня. Например, утром - пик, вечером - спад. Через Performance API можно настроить автоматическое изменение ставок:
- с 08:00 до 12:00 - ставка 100% (высокий спрос);
- с 12:00 до 18:00 - ставка 70% (средний спрос);
- с 18:00 до 23:00 - ставка 50% (низкий спрос);
- с 23:00 до 08:00 - кампания на паузе.
Для реализации такого сценария нужен внешний сервис или собственное решение, которое по таймеру отправляет запросы в Performance API на изменение ставок.
Сценарий 2: Динамическое изменение ставок по остаткам
У вас ограниченный запас товара на складе. Пока товар есть - рекламируем агрессивно. Когда остаток падает ниже порога - снижаем ставки, чтобы не переплачивать за рекламу товара, которого скоро не будет в наличии.
Сценарий реализуется через связку основного API Ozon (остатки) и Performance API (ставки). Как только остаток по товару достигает, например, 10 единиц - ставки по всем кампаниям для этого товара снижаются на 50%.
Сценарий 3: Массовое добавление товаров в рекламу
Вы запускаете новую партию товаров - 50 позиций. Вручную добавлять каждую в рекламную кампанию и устанавливать ставки - несколько часов работы. Через Performance API это делается одним запросом: список товаров и ставок передаётся за секунду.
Сценарий 4: Cбор и анализ рекламной статистики
Стандартные отчёты Ozon по рекламе хороши, но не всегда дают нужный срез. Через Performance API можно забрать сырые данные и построить собственную аналитику:
- сравнение эффективности кампаний за произвольные периоды;
- расчёт ARPU, LTV, CAC с учётом рекламных расходов;
- поиск товаров с отрицательной окупаемостью рекламы;
- построение дашбордов по рекламным каналам.
Ограничения и лимиты Performance API Ozon
При работе с Performance API важно учитывать ограничения, чтобы ваш скрипт или сервис корректно обрабатывал ответы.
Лимит запросов. Ozon устанавливает ограничение на количество запросов к API в единицу времени. При превышении лимита API возвращает ошибку. Точные значения лимитов периодически меняются - сверяйтесь с документацией Ozon.
Задержка обновления данных. Статистика по рекламным кампаниям обновляется не мгновенно. Между фактическим показом рекламы и появлением данных в API может пройти от нескольких минут до нескольких часов.
Ограничение по периоду отчёта. В Performance API нельзя запросить статистику за период длиннее определённого количества дней (обычно 90-180 дней). Для долгосрочной аналитики данные нужно собирать регулярно и хранить самостоятельно.
Как проверить, что подключение работает
После добавления ключа в сервис аналитики стоит проверить, что данные подтягиваются корректно. Вот несколько признаков успешного подключения:
- в сервисе отображается список ваших рекламных кампаний Ozon;
- видна статистика по кампаниям (показы, клики, расходы);
- кампании подгружаются для всех типов (Поиск, Трафареты, Медийная);
- можно создать тестовое изменение - например, приостановить неактивную кампанию и убедиться, что изменение применилось.
Если данные не подгружаются, проверьте:
- правильно ли скопирован Client ID - лишние пробелы или служебный текст могут блокировать подключение;
- активен ли основной API Ozon - Performance API не работает без базового ключа;
- достаточно ли прав у аккаунта - ключ должен быть выпущен владельцем кабинета или менеджером с полными правами.
Часто задаваемые вопросы
Что такое Client ID и Client Secret в Performance API Ozon?
Это пара ключей для доступа к API управления рекламой. Client ID - идентификатор приложения, Client Secret - секретный ключ, который служит паролем для доступа.
Можно ли использовать несколько ключей Performance API?
Да, Ozon позволяет создавать несколько ключей для одного сервисного аккаунта. Это удобно, если вы подключаете несколько внешних сервисов - для каждого свой ключ.
Что делать, если потерял Client Secret?
Client Secret не восстанавливается. Удалите старый ключ в настройках Performance API и создайте новый.
Зачем нужен сервисный аккаунт?
Сервисный аккаунт - это технический аккаунт Ozon для API-доступа. Он не привязан к конкретному сотруднику и не требует постоянного входа в кабинет. Через него выпускаются ключи доступа.
Можно ли управлять рекламой Ozon через API других маркетплейсов?
Нет, Performance API - это специфический API Ozon. Для Wildberries используется отдельный рекламный API (Bidder API), для Яндекс.Маркета - свой набор методов. В MP Manager можно централизованно управлять рекламой на всех трёх площадках, ключи для каждой настраиваются отдельно.
Какие типы рекламных кампаний доступны через Performance API?
Через API доступны все основные типы: Поиск, Трафареты, Медийная реклама и Акции.
Как часто обновляется статистика в Performance API?
Данные в API обновляются с задержкой. Для оперативного управления ставками статистика приходит с минимальной задержкой, для детальных отчётов по заказам и выручке - может потребоваться до нескольких часов.
Выводы
Performance API Ozon - ключевой инструмент для селлеров, которые хотят вывести управление рекламой на новый уровень. Автоматизация ставок по расписанию, массовое управление кампаниями, централизованная статистика - всё это становится доступно после подключения API.
Без Performance API управление десятками рекламных кампаний превращается в рутину с постоянным переключением между вкладками и ручным вводом ставок. С API эта работа масштабируется без пропорционального роста трудозатрат.
В MP Manager подключение Performance API Ozon - один из этапов настройки аккаунта, после которого вся реклама на маркетплейсе становится видна в едином интерфейсе вместе с данными по продажам, остаткам и аналитике. Это позволяет быстрее принимать решения и не терять данные между разными системами.
Если вы ещё не подключали Performance API Ozon - начните с инструкции в этой статье. Процесс занимает 5-10 минут, а экономия времени на управлении рекламой окупается уже в первую неделю.
