ozon 广告

# 令牌
> 1、在后台广告里面生成 Client ID、Client ID，这个令牌信息和 商品API 的令牌信息```不是```同一个。
> 2、```/api/client/token``` 生成短令牌 ```access_token```, 每个短令牌过期时间 ```1800``` 秒。

# 广告接口
```/campaign/available```：获取广告的可用模式（测试店铺只返回手动，没返回自动，但是自动模式也是可以使用的）
```/campaign/cpc/product```：创建广告- cpc点击计费
```/campaign/cpm/product```：创建广告- cpi展示计费（做）
```GET /campaign/{campaignId}/products```：活动中的产品列表（做）
```POST /campaign/{campaignId}/products```：往广告活动中添加商品（做）
```/campaign/{campaignId}/products/delete```：从广告活动中移除商品（新增）
```PUT /campaign/{campaignId}/products```：批量修改商品出价（新增）
```/campaign/{campaignId}/activate```：开启广告（做）
```/campaign/{campaignId}/deactivate```：关闭广告（做）
```/campaign/{campaignId}```：编辑广告（没调）（包含编辑广告起始、结束时间，每日预算，费用策略）（新增）
```/campaign```：获取广告活动的列表（做）
```/campaign/{campaignId}/daily_budget```：编辑每日预算

# 广告组接口
```/campaign/{campaignId}/group```：给广告创建组（设置短语，停用词）适用于搜索与分类 广告
```GET /campaign/{campaignId}/group/{groupId}```：获取广告组的详情
```PUT /campaign/{campaignId}/group/{groupId}```：编辑广告组

# 数据统计
> ```POST /statistics```: 生成多个广告的统计报告（入参：报告ID；起始日期、时间；结束日期、时间；排序方式）
> ```POST /statistics/video```: 媒体广告的统计信息（入参：报告ID；起始日期、时间；结束日期、时间；排序方式）
> ```POST /statistics/phrases```: 短语报告的统计信息（入参：报告ID；起始日期、时间；结束日期、时间；排序方式）
> ```POST /statistics/attribution```: 订单报告的统计信息（入参：报告ID；起始日期、时间；结束日期、时间；排序方式）
> ```GET /statistics/{UUID}```：查询报告生成状态
> ```GET /statistics/report```：下载生成好的报告（返回的csv的数据，内容为俄文）
> ```GET /statistics/list```：生成的报告列表（实际调用无返回）
> ```GET /statistics/daily```：广告系列的每日统计信息（入参：报告ID；起始日期、时间；结束日期、时间）
> ```GET /statistics/expense```：广告每日消费统计（入参：报告ID；起始日期、时间；结束日期、时间）
> ```GET /statistics/campaign/product```：产品广告统计（入参：报告ID；起始日期、时间；结束日期、时间）（只能获取【模板】里面的数据）
> ```GET /statistics/campaign/media```：媒体广告统计（入参：报告ID；起始日期、时间；结束日期、时间）（测试店铺没有媒体广告，所以没有调这个接口）

# 问题：
> 1、广告列表返回的 ```advObjectType``` 字段表示后台创建的广告业务类型，但是 API 接口创建广告不需要传，并且该字段和文档写的部分不一样，比如搜索广告返回的是 ```SEARCH_PROMO``` ，文档没有写。
> 2、后台的广告分为搜索推广、媒体广告；搜索推广中又有模板、搜索结果中的推广、品牌货架；媒体广告分为首页banner，视频横幅。但是接口cpi、cpm只能创建搜索推广中的模板广告。
> 3、创建活动接口中很多字段无法确定所对应的业务含义。placement（只能传这个PLACEMENT_SEARCH_AND_CATEGORY 能创建成功，其他的都报错）、productAutopilotStrategy、autopilot
> 4、组的概念在业务上不清楚是否需要使用和如何使用。后台没有看到组的设置。
> 5、搜索推广、品牌货架没有创建接口，目前接口文档只有拉取和编辑
> 6、创建好活动以后，添加商品的时候，竞争出价、每1000次展示出价 没有接口获取（ 在有竞争力的出价栏中显示的是我们根据竞争对手前三天的出价为您建议的可以获得高达所有可能的展示次数和点击次数的50%的出价。）
> 7、修改活动接口 ，预算 不能修改，只能取取消限制，或者创建一个新的，每日预算可以修改

# 中台流程图

![](/media/202303/2023-03-20_110433_992171.png)

# 香港表结构设计
## 活动广告表
```java
CREATE TABLE `mps_ozon_campaign` (
  `id` bigint(20) NOT NULL COMMENT '主键ID',
  `app_id` bigint(20) DEFAULT NULL COMMENT 'appid',
  `shop_id` bigint(20) DEFAULT NULL COMMENT '店铺id',
  `campagin_title` varchar(1024) DEFAULT NULL COMMENT '活动名称',
  `campagin_type` varchar(255) DEFAULT NULL COMMENT '活动类型 （CPC、CPM）',
  `campagin_state` varchar(255) DEFAULT NULL COMMENT '活动状态',
  `from_date` datetime DEFAULT NULL COMMENT '活动开始时间',
  `to_date` datetime DEFAULT NULL COMMENT '活动结束时间',
  `budget` varchar(255) DEFAULT NULL COMMENT '总预算',
  `daily_budget` varchar(255) DEFAULT NULL COMMENT '每日预算',
  `expense_strategy` varchar(255) DEFAULT NULL COMMENT '费用策略',
  `placement` varchar(255) DEFAULT NULL COMMENT '广告商品的位置',
  `product_autopilot_strategy` varchar(255) DEFAULT NULL COMMENT '用于活动的自动策略 ',
  `autopilot` mediumtext COMMENT '活动信息 ',
  `product_campaign_mode` varchar(255) DEFAULT NULL COMMENT '商品活动模式（自动、手动）',
  `campaign_product` bigint(20) DEFAULT NULL COMMENT '活动中商品信息 Json',
  `campaign_id` bigint(20) DEFAULT NULL COMMENT '活动ID',
  `flag` tinyint(4) DEFAULT NULL COMMENT '创建活动状态，1：待创建   2：创建中  6：创建失败  9：创建成功',
  `result` text CHARACTER SET utf8mb4 COLLATE utf8mb4_bin COMMENT '活动创建结果',
  `create_time` datetime DEFAULT NULL COMMENT '活动创建时间',
  `update_time` datetime DEFAULT NULL COMMENT '活动更新时间',
  PRIMARY KEY (`id`),
  KEY `idx_flag` (`flag`),
  KEY `idx_campaign` (`campaign_id`),
  KEY `idx_update_time` (`update_time`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8 COMMENT='Ozon 活动广告活动表';
```

# 2023-03-20 问题记录
> 1、计费类型 1:按展示 2:按点击（charge_type）广告同步接口没有返回该字段信息。
> 2、目前测试的模板广告报告的数据都是0，测试店铺都没有数据。（广告销售额，广告费用占比）
> 3、平台拉取广告报告的接口不太稳定，以及接口写的有问题
```
{}
{"error":{}}
recover: unexpected server error (同步活动分页超出页数)
```

# advObjectType
BRAND_SHELF（品牌货架）、SKU（模板）、SEARCH_PROMO（搜索推广）