OPPO广告 Omni API

历史版本记录

【版本：9.1】 发布时间：2024-12-20 16:04:37 查看详情

1、更新定向接口新增传参isModifyAudienceFile，是否修改人群包文件：0-否，1-是。详情见13.5
【版本：9.0】 发布时间：2024-12-20 16:03:13 查看详情

1、广告报表新增分成后变现ltv7、详情见6.1，6.3

【版本：8.9】 发布时间：2024-12-12 16:39:33 查看详情

1、rta外部实验id明细数据查询新增回传激活量、回传留存量、昨日回传激活量、次日留存率详情见6.27
【版本：8.8】 发布时间：2024-12-12 16:38:46 查看详情

1、代理商/运营报表新增游戏报表-游戏汇总数据、小游戏汇总数据、游戏实时汇总数据，详情见6.31，6.33，6.34 2、子客户/直客报表新增游戏报表-游戏汇总数据、小游戏汇总数据，详情见6.30，6.31
【版本：8.7】 发布时间：2024-12-12 14:18:59 查看详情

1、广告报表入参新增浅层转化ID集合、深层转化ID集合筛选项，详情见6.1，6.3 2、广告报表响应新增浅层转化名称、浅层转化量、深层转化名称、深层转化量、详情见6.1，6.

【版本：8.6】 发布时间：2024-11-11 15:22:10 查看详情

1、广告报表新增激活付费率、快应用OS关键行为量、快应用OS关键行为成本、流水金额，详情见6.1，6.3

【版本：8.5】 发布时间：2024-10-22 19:11:35 查看详情

1、新增4.16 批量修改广告组ROI系数

【版本：8.4】 发布时间：2024-10-17 17:01:18 查看详情

1、新增15.4获取智能短信服务号

【版本：8.3】 发布时间：2024-10-11 17:46:56 查看详情

1、应用转化报表新增付费金额（分），订单id 详情见6.28 2、游戏实时数据新增首日roi（分成后）、首日广告收入（分成后）详情见6.7，6.8 3、广告报表新增应用关键行为量，应该关键行为成本详情见6.1，6.3

【版本：8.2】 发布时间：2024-09-18 10:49:02 查看详情

1、新增DPA+RTA商品库绑定广告，详情见18.8、18.9
【版本：8.1】 发布时间：2024-09-18 10:48:40 查看详情

1、广告报表新增应用付费LTV1，应用付费ROI1，详情见6.1，6.3 2、广告报表新增完件成本，完件量，完件授信率，详情见6.1，6.3

【版本：8.0】 发布时间：2024-07-25 16:41:35 查看详情

1、程序化创新新增支持更多规格 2、支持分页查询渠道包

【版本：7.9】 发布时间：2024-06-11 19:42:48 查看详情

1.OmniAPI自定义字段和营销平台对比缺失，更新新增字段，删除弃用字段，涉及数据——关键词报表，游戏数据，游戏实时数据，小游戏数据，代理商效果数据

【版本：7.8】 发布时间：2024-05-24 11:40:57 查看详情

1、更新计划创建支持投放策略增加 2-最优成本能力
【版本：7.7】 发布时间：2024-05-24 11:40:17 查看详情

1、更新了Omni-API SDK版本到1.1.0，增加了从1.0.2版本到现在新增的广告计划、广告组、广告字段；更新了接口调用错误时返回错误码和msg到接口返回对象中。

【版本：7.6】 发布时间：2024-05-15 10:42:05 查看详情

1、更新13.2创建定向里过滤已转化参数的属性，增加过滤已转化的过滤时间；2、更新13.11的imei文件上传接口的file参数的说明

【版本：7.5】 发布时间：2024-05-14 14:20:04 查看详情

1、查询渠道包列表接口，添加查询指定渠道包ID的参数，返回数据新增md5、下载地址、版本信息，详情见：4.12 查询渠道包列表

【版本：7.4】 发布时间：2024-05-07 10:20:23 查看详情

1、修改6.22接口文档

【版本：7.3】 发布时间：2024-04-25 11:20:18 查看详情

1.接口请求入参新增globalSpecIdList，创意规格id集合，详情见：6.1、6.2、6.32.接口请求入参新增subAccList，子账户列表集合，详情见:6.23、6.24

【版本：7.2】 发布时间：2024-04-12 11:08:53 查看详情

1.、接口请求入参flowSceneList，新增14通知栏、15网络消息，详情见：6.1、6.2、6.3、6.4、6.6、6.7、6.8、6.11、6.12、6.13、6.14、6.15、6.16、6.17、6.18、6.19、6.20 2、接口请求出参flow_scene，新增14通知栏、15网络消息，详情见：6.1、6.2、6.3、6.4、6.6、6.7、6.8、6.11、6.12、6.13、6.14、6.15、6.16、6.17、6.18、6.19、6.20

【版本：7.1】 发布时间：2024-04-08 16:06:28 查看详情

1、新增4.0节，用于描述部分广告组接口通用字段，详情见：广告组管理 -> 4.0广告组接口基础字段说明 2、广告组接口、创意接口新增对网络消息流量场景的投放支持，详情见：4.1、4.2、5.5 3、通知栏下创意的中图规格复用横板大图globalSpecId的，详情见：5.5
【版本：7.0】 发布时间：2024-04-08 16:05:33 查看详情

1、删除部分老旧OcpcType
【版本：6.9】 发布时间：2024-04-08 16:05:09 查看详情

1. 小游戏明细数据查询-代理商新增活跃ROI，详情见 6.182.小游戏明细数据查询-子客户新增活跃ROI，详情见 6.5

【版本：6.8】 发布时间：2024-03-14 09:57:11 查看详情

1、批量商品入库接口新增普通商品库的商品字段（小说和短剧行业），详情见18.1

【版本：6.7】 发布时间：2024-03-11 15:32:15 查看详情

1、修改账务接口返回字段名称描述（含义保持不变），返回账户改为返货账务，详情见6.21、8.1、8.5、8.7

【版本：6.6】 发布时间：2024-03-06 09:50:04 查看详情

1、广告组落地页类型移除波文建站（达尔文建站），详情见 4.1、4.2、4.3 2、广告组ocpcType新增【快应用变现ROI1】类型，详情见 4.1

【版本：6.5】 发布时间：2024-02-20 14:21:27 查看详情

1、在商品批量入库接口和XML导入商品对接文档的视频传参中添加size（视频大小）参数，详情见 18.1、18.2

【版本：6.4】 发布时间：2024-02-01 16:37:29 查看详情

1、广告组层级增加OCPX自动优化相关参数：ocpxOptimizeSwitch、ocpxOptimizeType

【版本：6.3】 发布时间：2024-01-26 18:11:55 查看详情

1、计划、广告组层级推广目标新增extensionType=6（应用调起） 2、广告组层级流量场景新增flowScene=14（通知栏），广告组相关接口新增pushAppPageType（应用内页）参数，对deepUrl在通知栏流量场景下的传值做了说明 3、广告层级新增短文本规格，该规格下新增广告内容content字段 4、广告层级新增通知栏预览推送接口

【版本：6.2】 发布时间：2024-01-12 10:26:43 查看详情

1、新增获取定向省市元数据接口，详情见13.14

【版本：6.1】 发布时间：2024-01-10 17:46:24 查看详情

1、新增获取定向区域元数据接口，详情见13.13
【版本：6.0】 发布时间：2024-01-10 14:51:21 查看详情

1、新增/v3/ad/page、/v3/group/page、/v3/plan/page部分返回字段，三个接口返回的数据字段统一添加在公共部分 -> 对接必读的1.9节 2、新增/v2/communal/agency/customer/list部分返回字段

【版本：5.9】 发布时间：2024-01-08 19:47:50 查看详情

1、新增6.27 rta外部实验id明细数据查询2、添加广告分页查询接口数据字段返回

【版本：5.8】 发布时间：2023-12-20 17:16:17 查看详情

添加批量修改广告监测链接的接口，详情见5.13

【版本：5.6】 发布时间：2023-12-11 15:08:50 查看详情

omni api支持查询dpa商品id粒度数据接口

【版本：5.4】 发布时间：2023-11-24 17:34:16 查看详情

1、添加商品库授权、商品库取消授权、查询商品库授权列表三个接口，详情见18.5、18.6、18.7

【版本：5.3】 发布时间：2023-11-15 14:40:33 查看详情

1、添加查询Rta动态出价相关数据接口：6.22 查询Rta动态出价数据

【版本：5.2】 发布时间：2023-11-03 09:38:49 查看详情

1、添加商品库相关接口：18.3 商品批量删除接口、18.4 商品库商品查询接口

【版本：5.1】 发布时间：2023-10-27 14:45:54 查看详情

定向：imei文件上传SDK接口描述修改

【版本：5.0】 发布时间：2023-10-17 16:27:33 查看详情

修正13.2新增定向接口SDK接入说明

【版本：4.9】 发布时间：2023-10-11 16:34:03 查看详情

1、获取单个广告创意详情接口：/v3/ad/get，添加showStatus枚举含义说明，showStatus=4为程序化广告待优选

【版本：4.8】 发布时间：2023-09-25 20:05:20 查看详情

1、接口信息更正：/v3/ad/dpa_strategy/detail接口方法为GET方法 2、商品批量入库接口：/dpa/v2/product/batchSave，商品库ID字段为必填

【版本：4.7】 发布时间：2023-09-19 18:50:56 查看详情

新增5.12 sdpa广告投放全流程指引文档；投放sdpa广告前需关注该文档。

【版本：4.6】 发布时间：2023-09-15 11:25:23 查看详情

1、广告报表（子客户）、效果数据（代理商）新增字段： quick_app_act_rate 快应用关键行为转化率 2、游戏报表-游戏数据（代理商）新增字段： buy_user_income_active 买量广告收入
【版本：4.5】 发布时间：2023-09-15 11:24:53 查看详情

1、商品库批量接口、xml文件在sDPA直投模式时，品牌名称及品牌logo为必填

【版本：4.4】 发布时间：2023-09-08 18:47:33 查看详情

1、增加18. 商品库接口分类 2、在商品库分类下增加商品批量入库接口 /dpa/v2/product/batchSave

【版本：4.3】 发布时间：2023-08-23 17:46:22 查看详情

1、子客户广告报表新增字段： roi14 广告变现ROI14（分成后） ltv14 广告变现LTV14（分成后） cate_name 一级行业名称 sub_cate_name 二级行业名称 third_cate_name 三级行业名称

【版本：4.2】 发布时间：2023-08-22 10:47:45 查看详情

1、/v3/ad/dpa_strategy/add接口补充遗漏参数曝光检测链接 exposeUrl 点击检测链接 clickUrl

【版本：4.1】 发布时间：2023-08-18 10:46:28 查看详情

1、增加新的接口 /v3/ad/dpa_strategy/edit 编辑商品广告创意（新）

【版本：4.0】 发布时间：2023-08-10 09:53:12 查看详情

1、增加商品广告详情接口 /v3/ad/dpa_strategy/detail 支持广告组id或者细化到广告层id查询 2、增加 /v3/ad/dpa_strategy/add 接口注释

【版本：3.8】 发布时间：2023-04-24 02:23:26 查看详情

1、广告组新增、编辑接口添加商品广告相关字段，/v3/group/add、/v3/group/edit 2、查询广告组详情接口添加商品广告相关字段返回，/v3/group/get 3、新增接口：操作商品广告创意、查询商品广告创意接口，/v3/ad/dpa_strategy/save、/v3/ad/dpa_strategy/get

【版本：3.7】 发布时间：2023-03-07 03:02:20 查看详情

1、广告组新增和编辑接口添加目标ROI系数字段

【版本：3.6】 发布时间：2023-01-17 09:50:22 查看详情

1、所有报表的流量场景字段新增两个枚举值：12联盟不限、13展示优选 2、所有报表的推广目标字段新增两个枚举值：7微信小程序推广、8直播推广

【版本：3.5】 发布时间：2023-01-13 08:07:06 查看详情

1、新增程序化广告新建、编辑、查询接口

【版本：3.4】 发布时间：2022-12-13 06:33:29 查看详情

1、广告报表新增字段：预约量，取消预约量，预约下载量 2、子客户游戏数据报表新增字段：买量广告收入、广告变现活跃ROI、游戏关键行为量、游戏关键行为成本、付费次数、每次付费成本 3、子客户小游戏数据报表新增字段：快应用关键行为量、快应用关键行为成本 4、添加批量开启免一阶接口

【版本：3.1】 发布时间：2022-10-24 07:08:37 查看详情

1. 新增代理商余额查询接口：/v3/data/common/agency/query/queryMktAggData 备注：v2代理商余额查询接口的计算方式，是通过子客户累加算出来的，如果子客户太多接口有超时的风险，所以新增一个新的代理商余额查询接口 2. 新增广告组，添加绑定自定义词包或禁推词包参数：kwPackageId和kwPackageType参数，接口：/v3/group/add，/v3/group/edit 3. 新建或编辑广告组，网页推广-搜索关键词或词包信息必填，接口：/v3/group/add，/v3/group/edit

【版本：3.0】 发布时间：2022-09-09 02:35:04 查看详情

1. 增加资质相关接口（16.1-16.5）客户可以通过接口方式上传行业资质提供审核。 2. 增加人群包/定向包创建操作指引流程（13.1），定向相关接口重新编号；客户可查看该文档熟悉定向包/人群包创建流程。 3. 广告报表、推广列表新增转化指标：注册-应用付费率

【版本：2.9】 发布时间：2022-08-05 08:12:31 查看详情

1. 新增8.10接口，获取当前登录客户信息，代理商和子客户通用，在代理商进入子客户时同时返回代理商和子客户信息 2. 定向列表添加showStatus字段 3. 计划、广告组、广告层级，推广类型增加小程序推广 4. 广告组推广列表接口，增加小程序类型、小程序ID、小程序Path字段返回 5. 广告组新增、编辑接口增加关键词、词包转化出价深度转化出价目标ROI系数字段，涉及接口：/v3/group/add、/v3/group/edit 6. 关键词绑定广告组等接口增加关键词、词包转化出价深度转化出价目标ROI系数字段，涉及接口：/v3/communal/searchKeyWord/addGroupKw、/v3/communal/searchKeyWord/editGroupKw 7. 广告组新增、编辑接口，添加渠道包ID字段，涉及接口：/v3/group/add、/v3/group/edit 8. 新增渠道包列表查询接口（4.12）：/v3/channelPkg/list 9. 广告组新增、编辑接口，传参增加免一阶字段defaultSecondStage，以及单个广告组详情的查询接口，返回增加免一阶字段defaultSecondStage

【版本：2.8】 发布时间：2022-06-14 12:30:40 查看详情

1.【数据】代理商小游戏接口修改active_nums描述 2.【数据】代理商/子客户消耗报表新增流量场景筛选条件 3.【SDK】更新 ① SDK使用说明更新 ② 修改SDK依赖包版本号 ③ 修复SDK线上环境域名错误问题 ④ 修复H5模板查询接口地址错误问题 4. 增加转化目标类型、深度转化目标类型枚举值 5. 删除定向创建、更新接口的mobilePrice字段

【版本：2.7】 发布时间：2022-05-06 07:34:27 查看详情

1【推广】广告创意管理：增加衍生视频映射接口，用于查询广告当前是否是衍生广告以及源广告等信息 2【数据】新增广告明细实时数据查询-子客户：queryAdRTExtData接口 3 子客户游戏明细数据、子客户&代理商小游戏数据添加留存率相关字段 4 数据相关接口更新timeLevel字段说明：广告明细数据总量查询-子客户、广告明细数据查询-子客户、游戏明细数据总量查询-子客户、游戏明细数据查询-子客户、关键词明细数据总量查询-子客户、关键词明细数据查询-子客户、代理商消耗数据总量查询、代理商消耗数据查询、代理商效果数据总量查询、代理商效果数据查询去掉MONTH、WEEK两个时间粒度查询 5 游戏实时明细数据查询-子客户，游戏实时汇总数据查询-子客户接口增加：新增付费金额，游戏付费ROI1字段

【版本：2.6】 发布时间：2022-03-31 08:59:12 查看详情

1.更新SDK使用说明 2.广告报表更新子客户广告报表新增：回传次留率、快应用关键行为量、快应用关键行为成本、表单转化率、表单关键行为量、表单关键行为成本、有效咨询量、有效咨询成本、微信关注量、微信关注成本、网页购买量、网页购买成本、拨打电话量、拨打电话成本、快应用加桌量、快应用加桌成本、deeplink回传留存量、deeplink回传留存成本等18个字段；子客户小游戏报表新增：总付费流水等7个游戏内购相关字段；代理商小游戏报表新增：总付费流水等15个游戏内购相关字段 3.更新地域编码对照表：增加区县编码

【版本：2.5】 发布时间：2022-03-23 11:58:27 查看详情

1. 接入SDK请求方法以及传参明细 2. 补全部分接口字段备注 3. 新增SDK请求示例和SDK接入范围 4. 创意批量管理v3/ad/batch接口新增互动素材id字段 5. 查询规格列表/v3/communal/spec/list接口增加互动素材相关内容，并对required、format及v3/ad/batch接口参数的关系做了说明 6. /v3/data/common/summary/queryGameRTData接口修改filter_zero参数的说明 7. 更新【公共部分】SDK使用文档 8. 添加子客户消耗查询接口

【版本：2.4】 发布时间：2021-12-27 11:34:55 查看详情

1. 素材统一查询接口 /v3/creative/material/communal/query 新增按更新时间查询参数startUpdateTime、endUpdateTime 2. 新增，编辑广告组增加开启动态衍生开关 dynamicCr ，1-开启 0-关闭开启后不允许关闭

【版本：2.3】 发布时间：2021-12-16 13:45:10 查看详情

1. 新增上传素材到素材库接口 /v3/creative/material/communal/uploadDepot 2. 新增转化类型 25-deepLink出传留存, 26-系统新增激活, 27-快应用加桌 3. 配置接口增加规格创意数量限制的type说明 4. 添加代理商小游戏接口/v3/data/common/agency/query/queryAgentQuickGame5.修正素材查询接口/v3/creative/material/communal/query文档：pageNum、pageSize参数无上限限制，type参数不传时默认查询全部类型素材 5. 美化备注部分的demo格式

【版本：2.2】 发布时间：2021-11-04 12:11:23 查看详情

1. 提供关键词相关接口 2. 广告组 /v3/group/get、v3/group/edit 接口添加快应用打开并加桌参数

【版本：2.1】 发布时间：2021-10-14 06:43:38 查看详情

1. 定向类型type新增枚举： 6-电话包 11-OAID 2. 数据接口单位由元改为分

【版本：2.0】 发布时间：2021-09-23 13:24:06 查看详情

1.【数据】各数据接口添加exra字段说明。 2.【数据】各数据接口添加总量接口说明。 3. 修改/v3/group/get接口的showStatus的含义，改成和/v3/group/page的showStatus一致。 4. 在下列接口新增（如果当前不存在的话）showStatusName对应showStatus的中文解释，subShowStatusName对应status的中文解释。当前的返回字段不变。涉及的接口： v3/plan/page v3/group/page v3/ad/page v3/plan/get v3/group/get v3/ad/get