接入筹备

更新时间:2026-06-06 12:00:00OSDK

概述

O2 小游戏 SDK 为客户提供广告归因/回传/经营分析等能力,数据上报便捷高效,助力提升广告投放效果和游戏精细化运营。目前支持微信/抖音/QQ原生小游戏及采用 CocosCreator、Unity 游戏引擎开发的微信/抖音/QQ小游戏。

descript

接入流程

STEP1 准备工作:登记 APPID 以创建 TLOG 表进行数据存储,添加合法域名;

STEP2 接入开发:下载并导入 SDK 文件,进行广告归因参数获取和相关事件上报;

STEP3 数据核验:开发自测数据上报是否准确,核验数据是否落库 TLOG 表、广告归因/回传功能是否正常,正式买量投放前进行真实广告联调测试并在 O2 看数校验。

准备工作

用户隐私保护指引设置

请明确告知用户您的小游戏集成了 OSDK 服务,您应在您的小游戏《隐私政策》中添加关于 OSDK 收集使用个人信息的目的、方式和范围等,并显示本 SDK 的开发运营者名称及隐私政策链接。请您理解 SDK 提供的功能服务及所需的字段信息可能会因您的选择或配置不同而存在差异,因此请您参考《OSDK 个人信息保护规则》及您实际授权 SDK 或向 SDK 提供个人信息的情况,向用户进行充分告知并获得用户的同意,涉及敏感个人信息,应取得用户单独同意。OSDK 提供以下告知文案和截图示例供您参考:

  1. 登录微信公众平台
  2. 进入【账号设置】->【基本设置】-> 【服务内容声明】-> 【用户隐私保护指引】->【去完善】
  3. 确认小游戏对用户信息的处理情况

descript

  1. 填写第三方 SDK 信息
SDK名称:OSDK
SDK提供方名称:深圳市腾讯计算机系统有限公司
开发者收集你的设备型号、操作系统、分辨率、屏幕尺寸、内存信息、网络状态 ,用于广告投放、归因及效果优化。
开发者收集你的IP地址、UUID、广告归因参数、小游戏所属平台应用版本 ,用于广告投放、归因及效果优化。
开发者收集你的小游戏日志(使用状态、使用时长、小游戏进程记录) ,用于广告投放、归因及效果优化。
开发者收集你的小游戏日志(登录日志、角色日志、行为数据、操作信息) ,用于广告投放、归因及效果优化。
开发者收集你的广告交互数据(如播放、关闭、点击等)、产品交互数据(如收藏) ,用于广告投放、归因及效果优化。
开发者收集你的产品交互数据(如分享小游戏)、小游戏充值、消费记录 ,用于广告投放、归因及效果优化。
开发者收集你的小游戏账号信息(OpenID、UnionID) ,用于广告投放、归因及效果优化。
开发者收集你的小游戏账号信息(服务器ID、角色ID、角色名称) ,用于广告投放、归因及效果优化。
开发者收集你的小游戏账号信息(OpenID)及对应的游戏存档信息 ,用于为小游戏运营者提供游戏信息云存档服务。
开发者收集你的小游戏订阅消息 ,用于为小游戏运营者提供游戏订阅消息推送能力。
开发者收集你的小游戏账号信息( OpenID、UnionID) ,用于为小游戏运营者提供游戏登录能力。

请在【第三方插件信息/SDK信息】模块中点击【增加第三方SDK信息】填写SDK相关信息,点击【增加SDK提供方的其他自定义隐私信息类型】,选择【自定义】类型,补充开发者收集你的信息及目的(请结合小游戏使用SDK的实际情况填写SDK隐私信息)

  1. 填写补充协议
第三方SDK名称:OSDK
第三方SDK提供方的公司名称:深圳市腾讯计算机系统有限公司
使用目的及功能场景:为开发者提供广告投放、归因及效果优化的功能及其他可选能力 
第三方SDK隐私政策链接:https://privacy.qq.com/document/preview/89cdb3c357a844089652fa35c0adea61

为进一步告知用户 OSDK 处理用户个人信息的情况,请将下方 SDK 补充内容填入“补充协议”输入框:

登记小游戏 APPID

新游戏接入 SDK 前,需联系 O2 开发接口人登记小游戏 APPID,以创建 TLOG 表,生成 secret_key,方可通过 SDK 进行事件数据上报

添加 SDK 合法域名

https://mgdata.itdd.qq.com;
https://ap-guangzhou.cls.tencentcs.com;
https://test.open.itddo2page.com;
https://test.mgdata.itdd.qq.com;
https://open.itddo2page.com;
https://static.iaa.qq.com;
https://gab.qq.com;
https://test.gab.qq.com;

为保障小游戏的事件上报请求发送成功,需在对应小游戏 MP 管理端「开发管理」中,将 SDK 的上报域名(如下)添加为 request 合法域名。具体操作如下图所示:

descript

  • 在小游戏体验版/正式版中,上报正式服务器地址:https://mgdata.itdd.qq.com/api/
  • 同时自动进行数据备份,备份埋点上报CLS
  • SDK数据上报会采集小游戏的发版版本号,请确保每次发版的版本号有递增逻辑,遵循一定的版本号规范

相关文档