Как получить ключи рекламного кабинета Ozon (Performance API): пошаговая инструкция

Если вы уже подключили магазин к SellOps по инструкции про Client-Id и Api-Key, но на странице «Реклама» пусто — это не ошибка. Реклама на Ozon живёт в отдельной системе со своим собственным API (он называется Performance API) и своей отдельной парой ключей. Ключ магазина к ней доступа не даёт, и наоборот. Разберём по шагам, где взять рекламные ключи и что после этого появится в аналитике.

Коротко о разнице: у магазина — Client-Id (число) и Api-Key (длинная строка), выпускаются на вкладке Seller API. У рекламы — Client ID (выглядит как email вида 12345678-1712345678901@advertising.performance.ozon.ru) и Client Secret, выпускаются на вкладке Performance API. Это четыре разных значения, и путать их местами — самая частая причина ошибки при подключении.

Зачем это нужно

Без рекламных ключей сервис видит выручку и себестоимость, но не видит, сколько вы потратили на продвижение. А расходы на рекламу — часто вторая по величине статья после закупки товара, и без них «прибыль» на дашборде завышена. Именно из этих данных считается ДРР — доля рекламных расходов в выручке — и по товарам, и по кампаниям: главный показатель, по которому видно, какая кампания работает в плюс, а какая просто съедает маржу.

Шаг 1. Откройте раздел Performance API

Зайдите в кабинет продавца seller.ozon.ru и откройте тот же раздел настроек, где выпускались ключи магазина: «Настройки» → «API интеграции». В левом меню этого раздела, помимо «Seller API», есть отдельный пункт «Performance API» — он вам и нужен. Прямая ссылка — seller.ozon.ru/app/settings/performance-api.

Ключи Performance API выпускаются не на магазин целиком, а на так называемый сервисный аккаунт — техническую учётную запись, от имени которой внешняя программа читает статистику. Если в списке уже что-то есть — можно использовать существующий аккаунт. Если список пуст, нажмите «Создать аккаунт»: в таблице появится строка с номером, статусом «Активен» и количеством ключей.

Если пункта «Performance API» не видно совсем — скорее всего, у вашей учётной записи нет прав на рекламный кабинет. Права выдаёт владелец аккаунта продавца в разделе «Сотрудники»; на стороне SellOps это никак не обходится.

Шаг 2. Откройте сервисный аккаунт и добавьте ключ

Нажмите на строку сервисного аккаунта — откроется его карточка со списком ключей. К одному аккаунту можно подключить несколько ключей, так что заводить отдельный аккаунт под каждый сервис не нужно.

Нажмите «Добавить ключ». В открывшемся окне нужно только название — оно нужно вам, а не Ozon, чтобы потом понимать, какой ключ для чего выпущен. Ограничение — 25 символов, так что «SellOps» вполне подойдёт.

Обратите внимание: в отличие от ключа магазина, здесь не нужно выбирать роль и отмечать доступы. Ключ Performance API умеет ровно одно — читать статистику рекламы этого кабинета.

Шаг 3. Скопируйте Client ID и Client Secret

После нажатия «Добавить» ключ появится в таблице. Client ID и Client Secret в списке показаны сокращённо, а секрет — ещё и маской вида ce8N****RvOQ. Не пытайтесь переписать их с экрана: рядом с каждым значением есть кнопка копирования, и она кладёт в буфер обмена полную строку.

Здесь есть важное отличие от ключа магазина. Api-Key на вкладке Seller API показывается ровно один раз, и если его не скопировать сразу — придётся выпускать новый. С Performance API так не работает: обе строки остаются доступными для копирования в любой момент, сколько бы времени ни прошло. Потерять рекламный секрет нельзя.

Шаг 4. Вставьте оба значения в SellOps

В SellOps откройте Настройки → Магазины и раскройте карточку нужного магазина. Внизу формы есть отдельный блок «Реклама» с полями Client ID и Client Secret — вставьте туда рекламную пару (не ключи магазина!) и нажмите «Сохранить и синхронизировать». Ключи привязываются к конкретному магазину: если у вас несколько кабинетов Ozon, у каждого будет своя рекламная пара.

Частая ошибка: в поле Client ID вписывают Client-Id магазина — короткое число из Seller API, например 1234567. Он от другого ключа, и Ozon такую пару не примет. Client ID рекламы длинный и всегда заканчивается на @advertising.performance.ozon.ru — SellOps теперь проверяет это при сохранении. Если Ozon всё равно не принял ключ, на дашборде появится предупреждение: значит, секрет скопирован не целиком или ключ удалён в кабинете Ozon — выпустите новый и сохраните заново.

Свежий ключ активируется на стороне Ozon не мгновенно — обычно это занимает одну-две минуты. Если сразу после создания подключение отвечает ошибкой авторизации, это почти всегда именно она: подождите пару минут и нажмите «Сохранить и синхронизировать» ещё раз, перевыпускать ничего не нужно.

Что появится после подключения

• Страница «Реклама» — список кампаний с расходом, бюджетом (дневным или недельным), статусом и типом оплаты.
• ДРР по кампаниям и по товарам — сколько процентов выручки съедает продвижение. Считается и по магазину целиком, и по каждому товару отдельно.
• Расходы на рекламу в расчёте прибыли — на дашборде, в отчётах и в карточке товара они вычитаются из прибыли, а не игнорируются.
• Средние расходы на рекламу на одну проданную штуку — на графике динамики цены товара, рядом с заказами и ценой.

Частые вопросы

• Можно ли обойтись без рекламных ключей? Да, магазин будет работать и без них — просто расходы на продвижение не попадут в прибыль, и цифры окажутся оптимистичнее реальных. Если вы не запускаете рекламу вообще, подключать нечего.
• Это безопасно? Ключ Performance API даёт доступ к статистике рекламных кампаний, и ролей на изменение у него нет. SellOps использует его только на чтение и шифрует Client Secret перед сохранением — в интерфейсе он больше никогда не показывается, только маска.
• Ошибка авторизации, хотя ключи скопированы верно. Три обычные причины: не прошли те самые 1–2 минуты после выпуска; в поле «Client ID» вставлен числовой Client-Id магазина вместо рекламного (рекламный должен выглядеть как email); при копировании захватился пробел в начале или конце строки.
• Ключ перестал работать. Выпустите новый в том же сервисном аккаунте и обновите обе строки в карточке магазина — накопленная статистика при этом никуда не денется.
• У меня несколько магазинов. У каждого кабинета Ozon свой рекламный кабинет и своя пара ключей — заполните блок «Реклама» отдельно в карточке каждого магазина.

И если вы попали сюда раньше, чем подключили сам магазин, — начните с инструкции по ключам магазина: без них рекламные данные не с чем будет сопоставлять, ведь ДРР считается от выручки, а выручка приходит по ключу Seller API.