OPPO 广告：API 能力的对接

一、API 应用场景概览

二、OMINI-API 申请流程与使用

1. 定义

这是一个用于全方位为客户提供支持的程序化接口，能够帮助客户通过接口实现 OPPO 广告投放及数据获取等功能，从而减少运营人力投入。

2. 流程

（1）销售人员接到 API 对接需求后，确认广告主属性：直客、代理商或代理商子客户。

（2）通过微信群进行对接：销售同学先拉 API 对接人，然后 API 对接人再拉相关测试同学。

（3）在测试环境进行联调（统一使用测试账号）：测试账号要根据广告主类型进行区分，根据其类型提供相应的测试账号。

（4）测试环境通过后，销售向 API 对接人通过邮件申请正式环境的账号密钥（即广告主的正式账号），同时申请添加到白名单。

（5）正式环境对接。

3. 说明 – 对接文档

处理时间：所有 API 对接需求统一在当月的第二周和第四周处理，当月第一周和第三周不处理新的对接需求（已完成对接后，中间出现的问题会解决）。PS：Omni API 对接文档可先提供给广告侧的开发同学了解。

微信拉群：微信群命名规则为“OPPO_API+商户名称”（例如：OPPO_API+唯品会）。

邮件模板：OPPO 广告邮件模版。

4. 注意事项

文档获取入口：OPPO 广告营销平台工具箱→Omini API 及 OPPO 广告文档获取入口。

先向对接的销售运营申请秘钥进行鉴权。

离线侧数据通常在 5 点左右跑完，为避免客户无法获取数据，建议客户在 7 点再进行拉取。离线侧数据目前已支持数据 ready on 的接口，可用于判断数据是否已跑完，在请求数据前可先请求 ready on 接口，了解数据准备情况。

三、H5-API 申请流程及使用

1. 定义：

用于 H5 表单、小程序/小游戏等推广类型的转化数据对接回传，应用于 oCPX 广告投放。

2. H5 表单流程：

OPPO 广告 H5 表单流程

3. 小程序/小游戏流程：

分为鉴权版和免鉴权版，区别在于是否需要单独为账号申请 api_key 和 api_id。无鉴权版需客户提供加盖公章的免责说明文件。

以免鉴权为例，对接流程如下：

（1）签订免鉴权申请书，申请请求接口

流程：OPPO 广告主线下签订申请并加盖公章（2 份），返回公章扫描件并邮寄原件，申请书保留在广告业务侧销售运营处，运营为客户提供免鉴权 API 请求接口，客户对接 API 进行数据回传。鉴权说明按客户主体申请即可，无需分账号申请。

（2）对接 API – 真实环境投放验数

运营提供 API 接口，按照文档进行对接。回传游戏注册、游戏付费（107）（108）。进行广告小额投放，检验数据回传和归因是否正常。

广告预览：暂时无法通过落地页的二维码预览实现（预览方式：创建微信小游戏落地页 – 创建广告 – 工具箱强拉工具 – 配置广告 id 和手机 imei – 在 OPPO 浏览器刷广告即可验证链路）。

四、H5-API 线索创建流程

1. 权限申请优先：客户提供广告主 ID 申请 api_id 和 api_key。

2. 创建分两步：在营销平台工具箱→转化跟踪，先创建 API 类线索目标，再创建网页转化跟踪进行落地页绑定。

OPPO 广告线索跟踪管理

3. 回传验数：通过网页校验，线索状态为有效，落地页才可投放。

OPPO 广告回传验数

五、H5-API 线索投放流程

1. OPPO 广告目标链接：选择 API 线索投放，填写需要投放的落地页链接。仅白名单内的落地页链接可进行转化目标的投放。

OPPO 广告目标链接

2. 转化类型：线索提交落地页校验通过后可选择。

六、H5-JS 线索申请流程

1. 定义：

用于 H5 表单、小程序/小游戏等推广类型的转化数据对接回传，应用于 oCPX 广告投放。

2. H5 表单流程：

OPPO 广告 H5 表单流程

3. 小程序/小游戏流程：

分为鉴权版和免鉴权版，区别在于是否需要单独账号申请 api_key 和 api_id。无鉴权版需客户提供加盖公章的免责说明文件。

以免鉴权为例，对接流程如下：

（1）签订免鉴权申请书，申请请求接口

流程：广告主线下签订申请并加盖公章（2 份），返回公章扫描件并邮寄原件，申请书保留在广告业务侧销售运营处，运营为客户提供免鉴权 API 请求接口，客户对接 API 进行数据回传。鉴权说明按客户主体申请即可，无需分账号申请。

（2）对接 API – 真实环境投放验数

运营提供 API 接口，按照文档进行对接。回传游戏注册、游戏付费（107）（108）。进行广告小额投放，检验数据回传和归因是否正常。

广告预览：暂时无法通过落地页的二维码预览实现（预览方式：创建微信小游戏落地页 – 创建广告 – 工具箱强拉工具 – 配置广告 id 和手机 imei – 在 OPPO 浏览器刷广告即可验证链路）。

七、H5-JS 线索创建流程

1. 工具箱 – 转化跟踪 – 线索跟踪管理新建线索目标→JS 跟踪→选择转化类型。

OPPO 广告跟踪线索

2. 在“查看”页面查看 JS 的部署代码。OPPO 广告主需将基础代码和转化代码部署到对应的页面中。

OPPO 广告 JS 跟踪

3. 根据校验步骤，进行基础代码和转化代码的校验，确保页面 JS 部署正确上报数据，页面校验通过后投放。

OPPO 广告 JS 跟踪

八、H5-JS 线索投放流程

1. OPPO 广告目标链接：选择 JS 线索投放，填写需要投放的落地页链接。

OPPO 广告投放

2. 转化类型：线索提交落地页校验通过后可选择。

OPPO 广告出价

本文重点介绍了 OPPO 广告的 API 能力对接相关内容。目前，OPPO 广告开户费用为 5000 元，有意在 OPPO 进行推广的广告主可联系精准获客！