分享
引力&腾讯广告小游戏 SDK 接入指南(Unity C#版)
输入“/”快速插入内容
引力&腾讯广告小游戏 SDK 接入指南(Unity C#版)
用户5562
用户5562
用户6255
用户6255
用户5989
用户5989
5月9日修改
❗
请注意,引力SDK的这次
集成
改造,仅仅是为了方便客户快速支持腾讯微小SDK,不是必须使用引力的SDK来上报给腾讯,您依然可以忽略引力SDK的本次更新,直接和腾讯SDK对接!腾讯SDK官方文档,参考
这里
。
🚨
常见问题自查
•
数据未上报腾讯
:
◦
检查
clientId
是否微信openid
◦
检查宏定义
ENABLE_TENCENT_SDK_TRACK
是否配置
◦
检查腾讯SDK初始化参数是否正确
◦
检查微信后台配置的合法域名是否含有腾讯
安全域名
:
https://api.datanexus.qq.com
◦
检查是否有调用回传腾讯的相关方法
◦
腾讯小游戏广告SDK—CHECKLIST:
https://docs.qq.com/sheet/DVXpPakNRS1BGdFlS?tab=BB08J2&nlc=1
◦
腾讯DN数据校验未通过自查文档:
https://docs.qq.com/sheet/DVXpPakNRS1BGdFlS?tab=wekwp4&nlc=1
使用背景
为方便客户快速接入腾讯广告小游戏SDK,引力引擎SDK直接融合内置了腾讯小游戏SDK,方便开发者以低廉的接入成本完成腾讯SDK适配。
无需再分别接入引力SDK和腾讯SDK,
本文档主要讲解接入过程中可能的问题。
步骤总览
1.
升级引力引擎SDK版本到
4.8.34
版本
及以上;
2.
在引力后台-
应用管理
页面同步数据版本到10
52
及以上;
3.
按照
引力引擎官方文档
正常接入,依次完成:
a.
配置并启动SDK
b.
用户初始化
4.
根据
这篇文档
验证数据上报到引力引擎后台通路是否正常;
5.
改造部分代码,以完成腾讯SDK埋点采集;
小游戏激励直玩能力改造
官方参考文档
:
腾讯广告-小游戏激励直玩能力文档
注意:当前为灰度阶段,测试必须用
1.5.7版本的腾讯SDK
才可测,相关SDK
请联系腾讯官方小游戏流量运营/对应销运
获取
添加腾讯SDK 直玩状态判断 宏参数(5.0.38及以上版本支持,可选)
需要在Unity打包配置中添加宏参数:
ENABLE_AUTO_CHECK_DIRECT_AD_GAME_STATUS
,添加步骤为:
1.
打开 Unity的 Project Settings 界面;
2.
找到
Scripting Define Symbols
,新增一行输入:
ENABLE_AUTO_CHECK_DIRECT_AD_GAME_STATUS
,然后点击 Apply 按钮完成设置
改造代码
1.
添加
腾讯SDK 上报
宏参数
需要在Unity打包配置中添加宏参数:
ENABLE_TENCENT_SDK_TRACK
,添加步骤为:
1.
打开 Unity的 Project Settings 界面;
2.
找到
Scripting Define Symbols
,新增一行输入:
ENABLE_TENCENT_SDK_TRACK
,然后点击 Apply 按钮完成设置
2.
腾讯SDK 上报失败收集宏参数(5.0.38及以上版本支持,可选)
如果需要收集腾讯上报失败日志,可配置宏参
ENABLE_TENCENT_SDK_TRACK_ERROR
,添加步骤为:
1.
打开 Unity的 Project Settings 界面;
2.
找到
Scripting Define Symbols
,新增一行输入:
ENABLE_TENCENT_SDK_TRACK_ERROR
,然后点击 Apply 按钮完成设置
3.
在
引力后台-应用管理页面
同步应用的数据版本到:1048,此时应用元事件中会新增一条:
$TencentSDKLog
,引力 sdk 内部将在腾讯 sdk 上报事件失败时上报此事件;
66%
34%
3.
确保传入的clientID为微信openid
由于腾讯SDK要求启动之后,立即调用
setOpenId
方法上报
openid
,故您在调用
StartGravityEngine
启动引力SDK时,传入的
clientId
请务必为微小的
openid
,否则可能会导致数据异常!
4.
配置用户沉默唤起周期