接入流程
SDK 对用户产生的行为数据立即上报，上报数据实时性高，提升实时控制转化成本的营销投放策略效果。
1 开发前
1.1 获得账号
| 字段 | 释义 | 描述 |
|---|---|---|
| accountId | 账号id | 推广帐号 id或 DataNexus 账号 id，每个客户在腾讯营销平台上可能有一个或多个帐号，不区分环境 |
1.2 获得上报的行为清单
请联系您的数据接入需求方（如：投手/优化师/运营）获得上报清单，如 转化归因 - 金融 - 保险行业接入规范 。
不同端、不同行业的行为清单存在差异（如小程序按行业区分，小游戏分 IAP/混变 与 IAA），详见 2 开发中 各接入路径的行为上报说明。
1.3 获得数据源及密钥
情况1：使用新版转化归因
适用于：安卓端 - 游戏行业。
当您使用新版转化归因时，在新建 SDK 应用转化表单填写页面，可点击右侧的【获取密钥】按钮获取密钥。
1 个应用只能使用 1 个密钥，将密钥嵌入 SDK 中才能正常上报。
获取的密钥会自动复制到剪贴板。后续也可以在 应用转化 - 详情 - 配置信息中可以看到生成的密钥。
更多新版转化归因的使用说明请见《应用转化归因》。
情况2：通过 DataNexus 获取
适用于：安卓端 - 非游戏行业、iOS 端、鸿蒙端。
进入 数据源接入 页面，选择新建数据源或使用已有的数据源。
新建数据源完成时，根据弹框指引，点击【前往分发】。
或直接前往 资产分发 ，对此次数据上报的数据源，按“应用场景”操作分发开关的开启。
请在数据上报前完成打开分发开关。若分发开关关闭，数据将无法分发给指定应用场景。
点击 【查看密钥】，使用 SDK 的 secret_key。
2 开发中
2.0 接入路径速查
不同端、不同行业的接入流程存在差异（数据源开关、归因链路、行为清单均不同），请先按下表确认您的接入路径，再查看对应小节的流程与详细文档。
| 端 | 场景 | 数据源分发开关 | 归因链路 | 详细指引 |
|---|---|---|---|---|
| 小游戏 | IAP/混变、IAA | 开启【转化归因】 | SDK 直接上报 | 小游戏 SDK 开发指引 |
| 小程序 | 8 大行业 | 开启【转化归因】 | SDK 直接上报 | 小程序 SDK 开发指引 |
| Android | 游戏 | 开启【转化归因】【一方数据合作】 | SDK 直接归因（ClickID 注入） | 游戏行业安卓 SDK 开发指引 |
| Android | 非游戏 | 开启【预归因】【一方数据合作】【智能场景匹配】，不开启【转化归因】 | SDK 采集激活 + 实时归因接口 + API 回传 | SDK 预归因方案指引 |
| iOS | 全部行业 | 开启【预归因】【一方数据合作】【智能场景匹配】，不开启【转化归因】 | SDK 采集激活 + 实时归因接口 + API 回传 | SDK 预归因方案指引 |
| 鸿蒙 | 全部行业 | 开启【预归因】【一方数据合作】【智能场景匹配】，不开启【转化归因】 | SDK 采集激活 + 实时归因接口 + API 回传 | SDK 预归因方案指引 |
站内各端开发指引：iOS · Android · 鸿蒙 · 小游戏 · 小程序
2.1 小游戏
大致流程：准备工作 → 接入开发 → 数据校验
- 准备工作：用户隐私保护指引设置 → 添加 SDK 合法域名 → 获取数据源 ID 和密钥
- 接入开发：下载并引用 SDK → 初始化（支持微信原生小游戏及 CocosCreator、Egret、LayaAir、Unity 引擎）→ 设置 openid / unionid → 按游戏类型上报行为，IAP/混变 与 IAA 小游戏的行为列表不同
- 数据校验：通过日志查询对账，并完成兼容性测试
详细文档：小游戏 SDK 开发指引 · 站内小游戏开发指引
2.2 小程序
大致流程：准备工作 → 接入开发 → 数据校验
- 准备工作：用户隐私保护指引设置 → 添加 SDK 合法域名 → 获取数据源 ID 和密钥
- 接入开发：下载并引用 SDK → 初始化（支持微信原生小程序及 uni-app、mpvue、taro、wepy、kbone、remax 框架）→ 按行业上报行为：短剧 / 小说 / 电商 / 健康 / 本地生活 / 社交服务 / 变现工具 / 教育
- 数据校验：通过日志查询对账
详细文档：小程序 SDK 开发指引 · 站内小程序开发指引
2.3 Android
按行业分为两条路径：
游戏行业（SDK 直接归因）
- 准备工作：获取数据源 ID 和密钥。建议新建专用数据源，区隔 SDK 上报数据与 API 上报数据
- 接入开发：下载并导入 SDK（版本 ≥ 1.8.8，建议使用最新版本）→ 初始化 → 上报行为数据。同时在资产分发中开启数据源的【转化归因】【一方数据合作】分发开关；SDK 数据全量切换前，请保持 API 数据继续回传
- 数据对账：校验数据上报是否符合预期
非游戏行业（预归因方案）
- 前置准备：完成客户内部评估（隐私政策、合规说明）→ 确保现有 API 上报已完成鉴权升级（通过 api.e.qq.com 域名上报）
- 新建预归因数据源：开启【预归因】【一方数据合作】【智能场景匹配】分发开关，无需开启【转化归因】。预归因数据源不可复用历史 API 数据源，且不可用于新建转化
- SDK 接入与联调：冷启动与热启动各上报一条启动行为（START_APP，SDK 自动采集）→ 在日志查询中确认「接入方式 = SDK，行为类型 = ACTIVATE_APP」
- 服务端归因改造：请求实时归因接口（pre_attribute/get，Android 使用 android_id）→ 与原自归因结果比对后，经 API 回传激活及深度转化行为
详细文档：游戏行业安卓 SDK 开发指引 · SDK 预归因方案指引 · 站内 Android 开发指引
2.4 iOS
iOS 全部行业当前采用预归因方案，流程与 Android 非游戏行业（预归因方案） 一致，区别仅在实时归因接口使用 idfv 请求预归因结果。
详细文档：SDK 预归因方案指引 · 站内 iOS 开发指引
2.5 鸿蒙
鸿蒙全部行业当前采用预归因方案，流程与 Android 非游戏行业（预归因方案） 一致，区别仅在实时归因接口使用 AAID（MD5） 请求预归因结果。
详细文档：SDK 预归因方案指引 · 站内鸿蒙开发指引
3 开发后
进入 日志查询 ，使用右上角的时间筛选器选择上报时间，通过将同一时间段内自己上报的数据量，与「DataNexus」中展示的”共搜索到 x 条相关数据信息“进行对账。若条数一致则完成上报；若不一致，可查看接口的 返回码 信息。
FAQ
Q：没有「DataNexus」的账号，该如何处理？
A：请前往 腾讯营销 注册成为客户
Q：SDK上报数据接口（a.gdt.qq.com/sdk）返回 code 码 51000
A：当开发者使用模拟器运行App通过SDK上报数据时，服务端会对上报的数据做检测，判断该数据为无效数据，接口返回 code 码 51000。