天幕QQ版文档
回到天幕微信版文档联系我们
  • 3分钟了解天幕QQ版
  • 买量助手
    • 主要功能及操作说明
      • 数据菜单
      • 渠道管理与机制
      • 渠道商与开放数据
      • 腾讯广告投放说明
      • 自动计算成本
    • 渠道类型说明
    • 数据指标说明
    • 技术接入指南
  • 游戏数据
    • 主要功能说明
    • 数据指标说明
      • 核心数据
      • 活跃用户
      • 新增用户
      • 新增留存
      • 活跃留存
      • 收入概况
      • 广告分析
      • 内购分析
      • 渠道分析
      • 分享裂变
      • 性能分析
    • 技术接入指南
  • 游戏配置
    • A/Btest
    • 自定义事件
    • 版本控制
    • 分享素材配置
    • 在线参数
    • 技术接入指南
  • 游戏收支
    • QQ收入管理操作说明
    • 买量成本管理操作说明
    • 内购退款管理操作说明
  • 通用功能
    • 成员权限
    • 自定义视图
    • 游戏管理
    • 有效新增用户
    • 获取accessToken
  • 技术接入指南
    • 必须或基础功能
      • SDK接入(重要)
      • SDK初始化(重要)
      • 登录/获取用户信息(重要)
        • .login
        • .updateUserInfo
    • 游戏数据类功能
      • 内购分析
      • QQbanner分析(.createBannerAd)
      • QQ激励视频分析(.createRewardedVideoAd)
      • 性能分析 (.sendLoadingLog)
    • 游戏配置类功能
      • 分享素材配置
        • .onShareAppMessage
        • .shareAppMessage
        • .getShareTemplates
      • 版本控制 (.getJudgeConfig)
      • 在线参数 (.getAppJSONConfig)
      • 自定义事件(.sendEvent)
      • A/B test(.abtest)
  • 常见问题
    • 热门问题
    • SDK兼容问题
  • 服务与隐私条款
    • 服务条款
    • 隐私政策
  • 联系我们
由 GitBook 提供支持
在本页
  • 概述
  • Step1.下载SDK
  • Step2.接入SDK
  • 1、所有版本SDK接入流程说明
  • 2、无登录版SDK使用说明

这有帮助吗?

  1. 技术接入指南
  2. 必须或基础功能

SDK接入(重要)

上一页必须或基础功能下一页SDK初始化(重要)

最后更新于4年前

这有帮助吗?

概述

在接入天幕SDK前请做好以下准备:

  1. 是否有天幕账号,若无,请先,已有账号请登录;

  2. 添加游戏,在控制台页面可见当前账号已加入的主体,请进入对应主体中的【游戏管理】后台进行添加。

下面对接入流程进行详细说明,共有两个步骤,十分钟左右即可搞定SDK接入。

Step1.下载SDK

在【游戏管理】页面,点击操作中的【下载/接入SDK】开始接入。

天幕提供了登录以及无登录两种版本SDK文件。

登录功能版SDK由天幕集成封装QQ登录功能,可供开发者调用,接入后才可以使用天幕的所有功能,蓝色的下载按钮即可下载此版本SDK。

请按要求配置QQ的域名白名单,非常重要,务必添加,确认添加完毕后,点击下一步。

  1. 请勿多个游戏使用同一个SDK,每个游戏会对应一个单独的SDK文件;

  2. 微信小游戏转为qq小游戏时,请将其视为接入一个新游戏,创建一个QQ平台类型的主体,加入到该主体中下载SDK文件。

如果接入时报错:小程序session解析错误

请检查接入的SDK与小游戏本身是否对应(SDK及SDK所在项目的appid/appsecret,与小游戏实际是否一致)

接入前请确保以下域名白名单已在QQ后台正确添加:

request

upload

download

UDP通信IP

120.55.151.217

Step2.接入SDK

1、所有版本SDK接入流程说明

小游戏引入SDK时请务必注意如下事项:

  • SDK必须放在主包中加载,切勿分包加载(在game.js 中第一行引入sdk文件)

  • 在laya引擎中,文件名必须为.min.js结尾,否则会导致编译报错

将下载的sdk文件放置到小游戏工程中,在小游戏game.js中引入SDK,并在需要使用sdk功能的地方调用。

请注意:

  • 在cocos引擎中,如果打包之前没有game.js文件,则只需将SDK文件放在主包中一起打包,这样就可以直接调用了,无需引入SDK文件(还可以在qq.d.ts中定义tmSDK变量)

植入方式(注意根据所下载SDK版本文件名植入,以下以天幕包含登录的全功能sdk为例)

  • TypeScript或ES6 JavaScript语法植入方式:import 'tm_sdk_qq.min.js';

  • ES5 JavaScript使用commonJs规范的植入方式:require('tm_sdk_qq.min.js');

校验SDK

  • 植入SDK后,复制屏幕上的检测码,在小程序开发工具中将启动参数设为检测码,开始编译;

  • 设置好参数并完成了编译,请点击“开始检测”按钮进行检测接入状态;

  • 天幕将自动检测您的接入是否正常,即可了解SDK接入是否正常;

2、无登录版SDK使用说明

以下流程仅使用了无登录版SDK的开发者需要阅读。

  1. 下载无登录版本的SDK,在接入该SDK后,开发者需要自行接入QQ登录流程并获取openid

  2. 开发者通过自己的服务端接口获取到openid后调用SDK接口,发送openid。(若不发送openid将导致天幕功能无法使用)

qq.tmSDK.sendUserInfo({ openId: '开发者传入的openId', gender: 1 }); 
// gender可选传入,默认值为1,默认代表男生 

强烈建议在登录获取到openid以后第一时间发送给天幕,避免数据统计、卖量助手等功能出现异常。

【注意事项】

1、无登录版本SDK,以下接口或功能无法使用

2、无openid无法使用数据统计功能、买量助手功能,请接入SDK后及时发送openid避免数据统计、买量助手等功能无法使用或功能异常。

无登录功能版SDK需要由开发者自行接入QQ登录并发送openid提供给天幕方可使用天幕的功能。蓝色按钮下方的文字按钮即可下载此版本SDK。

(天幕-更新用户信息)

(天幕-登录/获取用户信息)

无登录版天幕SDK接入说明请见下方。
https://api.skysriver.com
https://api.kuaiyugo.com
https://cdn.kuaiyugo.com
https://h5game-log.kuaiyugo.com
https://cdn.kuaiyugo.com
https://cdn.kuaiyugo.com
SDK初始化
.updateUserInfo
.login
注册天幕账号