Ozon Performance (Реклама)
Управление рекламными кампаниями Ozon и получение статистики через Ozon Performance API
Ozon Performance — это the advertising management API для Ozon, Russia's leading e-commerce marketplace. It предоставляет programmatic access to advertising campaigns, ad groups, statistics, и budget management.
С помощью Ozon Performance интеграции в AACFlow можно:
- Получить campaigns: Список всех advertising campaigns in the account
- Получить statistics: Получить performance metrics для campaigns (impressions, clicks, CTR, spend)
- Создать campaign: Создать новый advertising campaign
Эта интеграция позволяет automated advertising campaign management и performance reporting для Ozon marketplace sellers.
Инструкции по использованию
Интегрируйте Ozon Performance в рабочий процесс. Требуется Client-Id и Client-Secret from your Ozon Performance API settings. OAuth credentials are configured in the Ozon Seller personal account under Settings → API.
Инструменты
ozon_performance_get_campaigns
Список advertising campaigns
Входные параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
clientId | string | Да | Ozon Performance Client-Id |
clientSecret | string | Да | Ozon Performance Client-Secret |
state | string | Нет | Campaign state filter (active, inactive, all) |
Выходные данные
| Параметр | Тип | Описание |
|---|---|---|
campaigns | array | Массив campaign objects |
total | number | Total campaigns count |
ozon_performance_get_stats
Получить campaign performance statistics
Входные параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
clientId | string | Да | Ozon Performance Client-Id |
clientSecret | string | Да | Ozon Performance Client-Secret |
campaignId | string | Да | Campaign ID |
dateFrom | string | Да | Start date (YYYY-MM-DD) |
dateTo | string | Да | End date (YYYY-MM-DD) |
Выходные данные
| Параметр | Тип | Описание |
|---|---|---|
statistics | array | Массив daily statistics records |
totals | object | Aggregated totals |
ozon_performance_create_campaign
Создать новый advertising campaign
Входные параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
clientId | string | Да | Ozon Performance Client-Id |
clientSecret | string | Да | Ozon Performance Client-Secret |
title | string | Да | Campaign name |
startDate | string | Да | Campaign start date (YYYY-MM-DD) |
endDate | string | Нет | Campaign end date (YYYY-MM-DD) |
dailyBudget | number | Нет | Daily budget in rubles |
Выходные данные
| Параметр | Тип | Описание |
|---|---|---|
campaignId | string | Created campaign ID |
success | boolean | Произошла ли campaign was created |
Ссылки
- Official API: https://docs.ozon.ru/api/performance/
- AACFlow block source: apps/aacflow/blocks/blocks/ozon_performance.ts