2025-07-21 ozon 广告管理新版接口调研分析

## ozon 业务广告背景

![](/media/202507/2025-07-25_095918_5843910.13372032260245192.png)

### 获取广告活动的列表
https://performance.ozon.ru:443/api/client/campaign
1.返回参数
- paymentType 新增 支付方式
- weeklyBudget 新增 每周广告活动预算
- autopilot 新增 活动信息

###  获取活动中商品列表
https://api-performance.ozon.ru:443/api/client/campaign/{campaignId}/v2/products

1.由原先的 https://api-performance.ozon.ru:443/api/client/campaign/{campaignId}/products改为 v2 接口，字段数据缩减，与php 同事确认缩减字段是否影响正常业务。
1.返回参数
- stopWords 删除 停用词
- groupId 删除 组id
- categories 删除 类目信息
- phrases 删除 与出价和相关状态搜索短语的列表

1.请求参数
- page 页数
- pageSize 每页大小

##### 返回参数
```json
{
  "products": [
    {
      "sku": "string",
      "bid": "string",
      "title": "string"
    }
  ]
}
```

###  将商品添加到广告活动
1.变化点主要是入参字段进行调整，返回参数是用 object 接收，与调用方确认
https://api-performance.ozon.ru:443/api/client/campaign/{campaignId}/products
入参
```json
{
  "bids": [
    {
      "sku": "string",
      "bid": "string"
    }
  ]
}
```
返回参数
```json
null
```

### 更新商品价格
https://api-performance.ozon.ru:443/api/client/campaign/{campaignId}/products
1.无变化。

### 删除活动
https://api-performance.ozon.ru:443/api/client/campaign/{campaignId}/products/delete
 1.无变化
 
###  创建活动 CPC(cpm 接口目前已被删除)
1.接口路径调整 https://api-performance.ozon.ru:443/api/client/campaign/cpc/v2/product
- autopilot 活动信息 删除
- productCampaignMode 活动商品模式 删除
- autoIncreasePercent 预算自动增加百分比 新增
- expenseStrategy  费用策略
入参
```json
{
  "title": "string",
  "fromDate": "string",
  "toDate": "string",
  "dailyBudget": "string",
  "weeklyBudget": "string",
  "placement": "PLACEMENT_INVALID",
  "productAutopilotStrategy": "NO_AUTO_STRATEGY",
  "autoIncreasePercent": 0
}
```
返回参数
```json
{
  "campaignId": "string"
}
```
### 激活广告活动
https://api-performance.ozon.ru:443/api/client/campaign/{campaignId}/activate
 1.接口路径没有变化
 2.入参没有变化
 3.返回参数有所调整
 - paymentType 新增支付方式
 - weeklyBudget 新增每周广告活动预算
 - autoIncrease  关于预算自动增加的信息
 
 请求参数
 ```json
{
"campaignId":"15947854123"
}
```
 
 返回参数
 ```json
{
  "id": "string",
  "paymentType": "CAMPAIGN_TYPE_INVALID",
  "title": "string",
  "state": "CAMPAIGN_STATE_UNKNOWN",
  "advObjectType": "string",
  "fromDate": "string",
  "toDate": "string",
  "budget": "string",
  "dailyBudget": "string",
  "weeklyBudget": "string",
  "placement": [
    "PLACEMENT_INVALID"
  ],
  "productAutopilotStrategy": "string",
  "autopilot": {
    "categoryId": "string",
    "skuAddMode": "PRODUCT_CAMPAIGN_SKU_ADD_MODE_UNKNOWN"
  },
  "createdAt": "2019-08-24T14:15:22Z",
  "updatedAt": "2019-08-24T14:15:22Z",
  "productCampaignMode": "PRODUCT_CAMPAIGN_MODE_AUTO",
  "autoIncrease": {
    "autoIncreasePercent": 0,
    "autoIncreasedBudget": "string",
    "isAutoIncreased": true,
    "recommendedAutoIncreasePercent": 0
  }
}
```
### 关闭广告活动
https://api-performance.ozon.ru:443/api/client/campaign/{campaignId}/deactivate
同激励广告活动一致
### 更新广告活动
https://api-performance.ozon.ru:443/api/client/campaign/{campaignId}
 入参调整
 - budget  新增 活动总预算
 - weeklyBudget	 新增 周活动总预算
 - autoIncreasePercent  新增 预算自动增加百分比
 - autopilot 新增 活动信息
 入参
 ```json
{
  "autopilot": {},
  "fromDate": "string",
  "toDate": "string",
  "budget": "string",
  "dailyBudget": "string",
  "weeklyBudget": "string",
  "autoIncreasePercent": 0
}
```
返回参数
```json
{
  "campaignId": "string"
}
```
### 商品活动统计
https://api-performance.ozon.ru:443/api/client/statistics/campaign/product
入参调整
- from 新增 报告周期的起始日期，以RFC3339格式。
- to 新增 报告周期的最终日期，以RFC3339格式。

入参请求
- campaignIds -广告活动标识符
- from -报告周期的起始日期，以RFC3339格式（非必填）
- to 报告周期的最终日期，以RFC3339格式。（非必填）
- dateFrom -报告周期的起始日期格式为YYYY-MM-DD。（非必填字段。）
- dateTo	- 报告周期的起始日期格式为YYYY-MM-DD（非必填字段）

### 活动费用支出
https://api-performance.ozon.ru:443/api/client/statistics/expense
无变动
### 每日广告统计
https://api-performance.ozon.ru:443/api/client/statistics/daily
 无变动

### coding 相关问题Q&A
目前已知需对接的平台接口
创建广告活动- cpc按照点击计费https://performance.ozon.ru:443/api/client/campaign/cpc/product
创建广告活动- cpi按照展示计费https://performance.ozon.ru:443/api/client/campaign/cpm/product
往广告活动中添加商品https://performance.ozon.ru:443/api/client/campaign/{campaignId}/products
开启广告https://performance.ozon.ru:443/api/client/campaign/{campaignId}/activate
关闭广告https://performance.ozon.ru:443/api/client/campaign/{campaignId}/deactivate
编辑广告https://performance.ozon.ru:443/api/client/campaign/{campaignId}
获取广告活动的列表https://performance.ozon.ru:443/api/client/campaign
获取广告数据 - 效果、成本、广告订单数等数据
编辑每日预算https://performance.ozon.ru:443/api/client/campaign/{campaignId}/daily_budget

Q1:确认给出接口是否对应正确？
答：（1）创建广告活动-cpc 按照点击计费:https://performance.ozon.ru:443/api/client/campaign/cpc/product
      该接口已经调整为https://api-performance.ozon.ru:443/api/client/campaign/cpc/v2/product
	 （2）创建广告活动-cpi 按照展示计费目前方法已经过时被删除(cpm)
	   (3) 编辑每日预算(目前没有接入)
Q2:确认Available modes for creating advertising campaigns接口的使用场景
 答：==目前可以在获取广告列表中拿到 广告活动类型：(1) sku-转盘或榜单；(2)BANNER — 横幅广告活动；  (3)SEARCH_PROMO — 搜索推广==
 Q3:确认广告数据是哪个接口获取的？ 
 （1）广告数据可以根据获取广告活动列表获取数据。
  （2）广告活动下面的商品数据 根据活动商品列表获取。
  Q4:https://performance.ozon.ru:443/api/client/campaign/{campaignId}/objects获取的是什么内容?
   答：请求参数 ：campaignId:15749922
   返回参数:id即为 广告对象标识符
   ```json
{
    "list": [
        {
            "id": "2112818726"
        }
    ]
}
```