Ozon Performance API: обзор методов и возможностей
Работа с рекламой требует постоянного контроля эффективности размещений, своевременной корректировки настроек и анализа статистики.
Использование автоматизированных программ помогает упростить эти процессы, сократить объём ручной работы и централизовать управление рекламной активностью.
В этой статье рассмотрим что такое OZON Performance API.
Ozon Performance API это отдельный API-интерфейс рекламной платформы Ozon внутри Ozon API.
Он предоставляет программный доступ к инструментам продвижения и рекламной аналитике.
С его помощью продавцы и разработчики могут интегрировать рекламные процессы с внешними сервисами, системами управления рекламой, собственными приложениями и аналитическими платформами.
Через Performance API можно автоматизировать следующие задачи:
получать список рекламных кампаний и информацию об их состоянии
создавать рекламные кампании и изменять их настройки
запускать и останавливать продвижение
добавлять и удалять товары из рекламных кампаний
управлять ставками и бюджетами
получать статистику по показам, кликам, CTR, расходам и заказам
формировать отчёты по рекламным товарам и поисковым запросам
анализировать эффективность продвижения с помощью показателей ДРР и выручки
получать данные о внешнем трафике и рекламных размещениях
Для работы с API используются отдельные учётные данные Client ID и Client Secret.
Их необходимо получить в настройках рекламного кабинета Ozon.
Ключи Performance API отличаются от ключей Seller API и не заменяют их.
Основной адрес для обращения к API: https://api-performance.ozon.ru
Официальная документация: https://docs.ozon.ru/api/performance/
Методы Ozon Performance API разделены на тематические группы.
Каждая группа отвечает за определённую часть рекламных процессов:
управление кампаниями
работа с товарами
настройка продвижения
получение аналитики
Большинство запросов используют HTTP-методы GET, POST, PUT, PATCH и DELETE.
В зависимости от задачи API возвращает информацию о рекламных объектах, принимает команды на изменение настроек или запускает формирование отчётов.
Основные группы методов Ozon Performance API:
| Группа методов | Для чего используется |
|---|---|
| Кампании | Получение списка кампаний, создание и управление рекламой |
| Оплата за клик | Настройка и управление рекламными кампаниями CPC |
| Оплата за заказ | Работа с продвижением по модели CPO |
| Товары в рекламе | Добавление, удаление и изменение рекламируемых товаров |
| Статистика | Получение отчётов по кампаниям, товарам и заказам |
| Внешний трафик | Анализ переходов из внешних источников |
| Медийная реклама | Управление и анализ медийных размещений |
Не все методы работают одинаково.
Например, получение списка кампаний обычно выполняется одним запросом, а формирование подробного статистического отчёта может состоять из нескольких этапов:
отправки запроса
получения идентификатора задания
проверки готовности отчёта
скачивания результата
Для получения информации о рекламных кампаниях предусмотрены методы, которые позволяют просматривать список размещений и узнавать, какие объекты продвигаются в рамках конкретной кампании.
| Метод | Назначение |
|---|---|
GET /api/client/campaign | Получить список рекламных кампаний |
GET /api/client/campaign/{campaignId}/objects | Получить список продвигаемых объектов кампании |
GET /api/client/limits/list | Получить лимиты ставок для инструментов продвижения |
POST /api/client/min/sku | Получить минимальную ставку для товаров по SKU |
GET /api/client/products_with_bonuses | Получить список товаров с бонусами |
Список кампаний позволяет получить идентификаторы и основные параметры рекламных размещений.
Идентификатор кампании (campaignId) используется в последующих запросах для управления продвижением и получения статистики.
Методы получения лимитов и минимальных ставок помогают определить допустимые условия размещения рекламы.
Это полезно при автоматическом управлении большим количеством товаров, когда ставки необходимо проверять и корректировать программно.
Performance API предоставляет методы для управления рекламными кампаниями.
С их помощью можно создавать новые размещения, изменять параметры существующих кампаний, активировать и останавливать продвижение.
| Метод | Назначение |
|---|---|
POST /api/client/campaign/cpc/v2/product | Создать рекламную кампанию с оплатой за клик |
PATCH /api/client/campaign/{campaignId} | Изменить параметры рекламной кампании |
POST /api/client/campaign/{campaignId}/activate | Активировать рекламную кампанию |
POST /api/client/campaign/{campaignId}/deactivate | Остановить рекламную кампанию |
Создание кампании позволяет передать необходимые параметры рекламного размещения, включая настройки продвижения и бюджетные ограничения, предусмотренные конкретным форматом рекламы.
Изменение параметров используется для корректировки уже созданной кампании.
Активация и деактивация позволяют управлять состоянием продвижения без необходимости обращаться к рекламному кабинету вручную.
Таким образом, эти методы подходят для автоматизации рекламных сценариев: например, запуска продвижения при появлении достаточного количества товара на складе или остановки кампаний при достижении установленного лимита расходов.
Оплата за клик (CPC, Cost Per Click) это модель продвижения, при которой рекламодатель платит за переходы пользователей по рекламным объявлениям.
Performance API позволяет управлять кампаниями CPC, изменять ставки для отдельных товаров и получать информацию о конкурентных ставках.
| Метод | Назначение |
|---|---|
POST /api/client/campaign/cpc/v2/product | Создать кампанию с оплатой за клик |
PATCH /api/client/campaign/{campaignId} | Изменить настройки кампании |
POST /api/client/campaign/{campaignId}/activate | Запустить продвижение |
POST /api/client/campaign/{campaignId}/deactivate | Остановить продвижение |
GET /api/client/campaign/{campaignId}/products/bids/competitive | Получить конкурентные ставки для товара |
Для рекламы с оплатой за клик особенно важна возможность управлять ставками.
От их размера зависит участие товара в рекламном аукционе и вероятность получения рекламных показов.
Метод получения конкурентных ставок помогает оценивать ситуацию в рекламном размещении и принимать решения об изменении собственных ставок.
В сочетании с методами получения статистики это позволяет построить автоматизированную систему управления рекламой:
анализировать результаты продвижения
сравнивать расходы
корректировать ставки в зависимости от эффективности товаров
Оплата за заказ (CPO) это модель продвижения, при которой рекламодатель оплачивает продвижение в соответствии с условиями рекламного инструмента за полученные заказы.
В Performance API предусмотрены методы для включения и отключения продвижения, получения информации о товарах и управления ставками в рамках доступных возможностей инструмента.
| Метод | Назначение |
|---|---|
GET /api/client/campaign/all_sku_promo/activate | Включить продвижение для всех товаров |
GET /api/client/campaign/all_sku_promo/deactivate | Отключить продвижение для всех товаров |
GET /api/client/campaign/all_sku_promo/set_bid | Установить ставку для продвижения всех товаров |
POST /api/client/search_promo/get_cpo_min_bids | Получить фиксированные ставки для товаров |
POST /api/client/campaign/search_promo/v2/products | Получить список товаров в продвижении |
POST /api/client/campaign/search_promo/product/enable | Включить продвижение отдельного товара |
POST /api/client/campaign/search_promo/product/disable | Отключить продвижение отдельного товара |
POST /api/client/campaign/search_promo/v2/bids/delete | Удалить товар из продвижения |
Отдельные методы позволяют управлять продвижением сразу для всех товаров, другие предназначены для работы с конкретными товарами.
При использовании API важно учитывать изменения рекламной модели.
Старые методы установки ставок и получения рекомендованных ставок для товаров в CPO были выведены из использования.
Для получения ставок следует ориентироваться на метод фиксированных ставок, а для управления продвижением на действующие методы включения и отключения товаров.
Это позволяет автоматизировать массовое управление продвижением и получать сведения о товарах, участвующих в рекламном инструменте.
Для работы с отдельными товарами внутри рекламных кампаний предусмотрена группа методов, которая позволяет:
добавлять товары
удалять товары
получать список продвигаемых позиций
изменять ставки
| Метод | Назначение |
|---|---|
POST /api/client/campaign/{campaignId}/products | Добавить товары в рекламную кампанию |
PUT /api/client/campaign/{campaignId}/products | Изменить ставки товаров |
GET /api/client/campaign/{campaignId}/v2/products | Получить список товаров в кампании |
POST /api/client/campaign/{campaignId}/products/delete | Удалить товары из рекламной кампании |
GET /api/client/campaign/{campaignId}/products/bids/competitive | Получить конкурентные ставки |
Эти методы позволяют управлять составом рекламной кампании без изменения её основных параметров.
Например, можно автоматически добавлять новые товары в продвижение, исключать позиции с низкой рентабельностью или корректировать ставки для товаров с недостаточным количеством показов.
При массовой работе с товарами важно учитывать ограничения API на количество передаваемых объектов и формат данных, предусмотренный конкретным методом.
Статистика это одна из наиболее востребованных групп методов Ozon Performance API.
Она позволяет оценивать эффективность рекламных размещений, анализировать расходы и получать данные о взаимодействии покупателей с рекламными объявлениями.
В зависимости от метода можно получать общую статистику по кампании, дневные показатели, данные по расходам или подробные отчёты.
| Метод | Назначение |
|---|---|
POST /api/client/statistics | Запросить статистику по рекламной кампании |
GET /api/client/statistics/campaign/product | Получить статистику по кампании с оплатой за клик |
GET /api/client/statistics/daily | Получить дневную статистику по кампаниям |
GET /api/client/statistics/expense | Получить статистику по расходам кампаний |
GET /api/client/statistics/campaign/media | Получить статистику по медийным кампаниям |
POST /api/client/statistics/video | Запросить статистику по показам видеобаннера |
POST /api/client/statistics/attribution | Получить отчёт по заказам |
В рекламных отчётах могут присутствовать следующие показатели:
показы рекламных объявлений
количество кликов
CTR это отношение кликов к показам
средняя стоимость клика
расходы на продвижение
количество заказов
выручка от заказов
заказы после просмотра рекламы
доля рекламных расходов (ДРР)
Эти данные позволяют оценивать эффективность рекламы не только по количеству переходов, но и по результатам продаж.
Например, высокий CTR может говорить о том, что рекламное объявление привлекает внимание покупателей. Однако для оценки экономической эффективности необходимо также учитывать расходы, количество заказов и полученную выручку.
Отдельно стоит отметить метод POST /api/client/statistics.
Он используется для формирования подробной статистики по кампаниям.
После отправки запроса API возвращает идентификатор задания, по которому можно отслеживать готовность отчёта и получать его результат.
Для более детальной аналитики предусмотрены методы, позволяющие получать статистику не только по рекламным кампаниям в целом, но и по отдельным товарам и поисковым запросам.
| Метод | Назначение |
|---|---|
POST /api/client/statistics/products/sku | Получить статистику по товарам в оплате за клик |
POST /api/client/statistics/phrases | Получить отчёт по поисковым запросам |
POST /api/client/statistic/products/generate | Сформировать отчёт по товарам в оплате за заказ |
POST /api/client/statistic/orders/generate | Сформировать отчёт по заказам в оплате за заказ |
GET /api/client/statistics/all_sku_promo/products/generate | Сформировать отчёт по товарам для всех товаров в оплате за заказ |
GET /api/client/statistics/all_sku_promo/orders/generate | Сформировать отчёт по заказам для всех товаров в оплате за заказ |
Статистика по товарам позволяет оценивать результативность продвижения отдельных SKU.
Это полезно, когда в одной кампании участвует большое количество товаров и необходимо определить, какие позиции получают больше показов, кликов и заказов.
Отчёт по поисковым запросам помогает анализировать запросы, с которыми связано рекламное продвижение.
С его помощью можно оценивать эффективность поискового трафика и находить направления для оптимизации рекламных кампаний.
Для модели оплаты за заказ предусмотрены отдельные отчёты по товарам и заказам.
Они позволяют анализировать результаты продвижения и сопоставлять рекламную активность с полученными заказами.
Финансовая аналитика рекламы необходима для контроля бюджета и оценки рентабельности продвижения.
В OZON Performance API предусмотрены методы, позволяющие получать сведения о расходах рекламных кампаний и сопоставлять их с результатами размещений.
| Метод | Назначение |
|---|---|
GET /api/client/statistics/expense | Получить статистику по расходам рекламных кампаний |
Кроме того, финансовые показатели могут входить в состав подробных отчётов по кампаниям и товарам.
К основным показателям рекламной аналитики относятся:
расходы это сумма, потраченная на рекламное продвижение
средняя цена клика это средняя стоимость одного перехода по рекламе
CTR это отношение количества кликов к количеству показов
ДРР это доля рекламных расходов относительно выручки
выручка это сумма заказов, связанная с рекламным продвижением
заказы это количество заказов, полученных в рамках рекламной активности
Особенно важен показатель ДРР.
Он позволяет оценивать, какую часть выручки составляют рекламные расходы.
При автоматизации аналитики этот показатель можно использовать для сравнения товаров и принятия решений о корректировке ставок или остановке неэффективного продвижения.
Ozon Performance API предоставляет инструменты для получения аналитики внешнего трафика, то есть переходов на товары Ozon из рекламных источников за пределами маркетплейса.
Эта группа методов полезна продавцам, которые привлекают покупателей через внешние рекламные площадки, собственные сайты и другие каналы продвижения.
| Метод | Назначение |
|---|---|
GET /api/client/organisation/vendor_tag | Получить метку организации для внешних рекламных кампаний |
POST /api/client/vendors/statistics | Запросить отчёт с аналитикой внешнего трафика |
GET /api/client/vendors/statistics/list | Получить список запрошенных отчётов |
GET /api/client/vendors/statistics/{UUID} | Получить информацию об отчёте по идентификатору UUID |
С помощью этих методов можно организовать передачу данных о внешних рекламных кампаниях и получать отчётность по результатам привлечения трафика.
Метка организации используется при настройке внешних рекламных размещений.
Она помогает связать рекламную активность с соответствующей организацией в системе Ozon.
Получение статистики выполняется через формирование отчёта.
После отправки запроса можно получить список сформированных отчётов и проверить состояние конкретного задания по его UUID.
Отдельное направление рекламной платформы это медийное продвижение.
Оно ориентировано на размещение рекламных материалов и повышение узнаваемости товаров или бренда.
Для работы с аналитикой медийной рекламы предусмотрены методы получения статистики по кампаниям и видеобаннерам.
| Метод | Назначение |
|---|---|
GET /api/client/statistics/campaign/media | Получить статистику по медийным кампаниям |
POST /api/client/statistics/video | Запросить статистику по показам видеобаннера |
Отчёты могут содержать информацию об идентификаторах и названиях кампаний, форматах размещения, бюджетах, расходах, показах, кликах и других рекламных показателях.
Это позволяет анализировать результаты медийного продвижения и сравнивать эффективность разных форматов рекламных размещений.
Для повседневной работы с рекламой наиболее востребованы методы получения списка кампаний, управления продвижением, работы с товарами и формирования статистики.
| Метод | Назначение |
|---|---|
GET /api/client/campaign | Получить список рекламных кампаний |
GET /api/client/campaign/{campaignId}/objects | Получить список рекламируемых объектов кампании |
GET /api/client/limits/list | Получить ограничения по ставкам для рекламных инструментов |
POST /api/client/min/sku | Получить минимальную ставку для товаров по SKU |
POST /api/client/campaign/cpc/v2/product | Создать кампанию с оплатой за клик |
PATCH /api/client/campaign/{campaignId} | Изменить параметры рекламной кампании |
POST /api/client/campaign/{campaignId}/activate | Активировать рекламную кампанию |
POST /api/client/campaign/{campaignId}/deactivate | Остановить рекламную кампанию |
POST /api/client/campaign/{campaignId}/products | Добавить товары в рекламную кампанию |
PUT /api/client/campaign/{campaignId}/products | Изменить ставки для товаров |
GET /api/client/campaign/{campaignId}/v2/products | Получить список товаров в кампании |
GET /api/client/campaign/{campaignId}/products/bids/competitive | Получить конкурентные ставки |
POST /api/client/campaign/{campaignId}/products/delete | Удалить товары из кампании |
POST /api/client/statistics | Сформировать статистику по рекламным кампаниям |
GET /api/client/statistics/campaign/product | Получить оперативную статистику по кампаниям с оплатой за клик |
GET /api/client/statistics/daily | Получить статистику по кампаниям за дни |
GET /api/client/statistics/expense | Получить данные о расходах на рекламу |
POST /api/client/statistics/phrases | Получить отчёт по поисковым запросам |
POST /api/client/statistics/attribution | Получить отчёт по заказам |
POST /api/client/campaign/search_promo/v2/products | Получить список товаров в продвижении с оплатой за заказ |
POST /api/client/campaign/search_promo/product/enable | Включить продвижение отдельного товара |
POST /api/client/campaign/search_promo/product/disable | Отключить продвижение отдельного товара |
POST /api/client/statistic/products/generate | Сформировать отчёт по товарам |
POST /api/client/statistic/orders/generate | Сформировать отчёт по заказам |
GET /api/client/organisation/vendor_tag | Получить метку организации для внешней рекламы |
POST /api/client/vendors/statistics | Запросить статистику внешнего трафика |
GET /api/client/vendors/statistics/list | Получить список сформированных отчётов |
GET /api/client/vendors/statistics/{UUID} | Получить отчёт по идентификатору UUID |
При разработке интеграций с Ozon Performance API необходимо учитывать несколько особенностей.
Отдельная авторизация
Для работы с Performance API используются собственные
Client IDиClient Secret. Ключи OZON Seller API для авторизации в рекламном интерфейсе не подходят.Асинхронное формирование отчётов
Некоторые методы статистики не возвращают готовый отчёт непосредственно в ответе на запрос.
Сначала создаётся задание на формирование отчёта, затем API возвращает UUID.
По этому идентификатору проверяется статус задания, после чего можно получить готовые данные.
Ограничения на количество запросов
Ozon устанавливает лимиты на использование отдельных методов.
Особенно важно учитывать ограничения при массовом управлении рекламными кампаниями, добавлении товаров, изменении ставок и формировании отчётов.
Различия между оперативной и исторической статистикой
Для оперативного мониторинга рекламы с оплатой за клик предусмотрен метод получения статистики по товарам, который позволяет получать данные за текущие и предыдущие сутки без расходования лимитов отчётности.
Для получения исторических данных и формирования подробной аналитики используются отдельные методы статистики по кампаниям.
Такие запросы могут расходовать доступные квоты.
Устаревшие методы
Некоторые операции Performance API со временем выводятся из использования или заменяются новыми.
Например, методы получения рекомендованных ставок для CPO и старый способ установки ставок для отдельных товаров отмечены как устаревшие.
Обработка результатов запросов
При автоматизации рекламных процессов важно проверять не только успешность HTTP-запроса, но и содержимое ответа API.
Необходимо обрабатывать ошибки авторизации, ограничения запросов, некорректные параметры и ситуации, когда отчёт ещё не готов.
Если у вас остались вопросы по OZON Performance API, вы можете обратиться за консультацией к программисту.
