OCPX关键行为上报及前期配置说明
一、上报方式说明
1. 选择上报方式
| 上报方式 | 核心特征 | 典型场景 | 特点 |
|---|---|---|---|
| 客户端 SDK 上报 | 实时性强，用户在客户端操作时可即时上报；适用于轻量级行为，无需复杂逻辑判断；依赖客户端环境触发 | 玩家在游戏内点击 "观看广告" 按钮、页面加载完成（PV）、从 A 页面跳转至 B 页面等可直接在客户端感知的即时行为 | 链路短（客户端触发→SDK 解析→上报）；实现简单（集成 SDK 后调用接口即可）；实时性强（第一时间捕获用户行为） |
| 服务端上报 | 支持延迟上报，自主可控性强，支持复杂逻辑判断；依赖服务端数据校验 | 玩家完成付费（需服务端确认订单状态）、24 小时内观看广告超过 10 次（需服务端统计时间和次数）、注册成功（需服务端验证账号有效性）等需复杂判断的关键行为 | 链路长（需自行记录biz_id等）；可自行验证数据（经服务端校验）；支持复杂业务逻辑（如多条件组合判断关键行为） |
2. 上报功能对比
| 上报方式 | 操作流程 | 关键说明 |
|---|---|---|
| 客户端 SDK 上报 | 1. 在游戏内直接调用 SDK 接口上报eventType（如按钮点击、页面跳转等） 2. 服务端自动校验当前玩家是否存在关联的biz_id 3. 若biz_id存在，服务端自动按规则将数据上报至启明平台 | - 无需客户端手动处理biz_id，由 SDK 及服务端自动关联 - 依赖 SDK 对落地页参数的解析和biz_id的缓存 |
| 服务端上报 | 1. 需主动上报uuid、appid、biz_id、eventType等参数 2. biz_id需从落地页 URL 中自行提取并记录 3. 服务端会校验biz_id的一致性，不一致则上报失败 | - biz_id必须与落地页拼接的参数完全一致，否则上报失败 - 需自行实现biz_id的存储与关联逻辑（如绑定uuid和appid） |
二、前期配置流程
1. 登录启明广告平台
访问地址：https://dsp.da.mgtv.com/ ，使用账号登录。
2. 创建 API 转化跟踪
- 入口路径：数据 → API 转化跟踪 → 新建转化
-
填写关键信息：
- 转化类型：选 "落地页"；
- 转化目标：下拉选择（如付费、按钮点击、PV、页面跳转等）；注意，名称与实际关键行为不必对应。您可自行定义该ID的实际行为，例：付费 其实是 观看广告＞3次 且 24小时内注册的用户
- 转化名称：自定义（如 "小游戏 - 付费转化" ，便于识别）；
- 落地页地址：填写 H5 或应用真实 URL，需与广告投放地址一致。
-
广告投放绑定转化ID
- 创建广告计划 / 组时，在 "落地页" 或 "转化设置" 中，关联已创建的 "API 转化跟踪"。
- 绑定后，用户点击广告时，启明平台会自动在落地页 URL 拼接 mediabuy_id、creative_id、biz_id（即行业 click_id），用于转化回传。
三、关键说明
-
biz_id 生成条件: 仅成功创建 "API 转化跟踪"，且用户点击广告时，才会生成并拼接 biz_id。
-
回传失败风险: 若落地页未正确配置（未关联 API 转化跟踪），用户点击广告不携带 biz_id，将导致转化数据无法回传。