如何高效利用Cocos游戏实现抖音小游戏广告收益的快速接入？

引言大家好，之前帮大家整理的常用的组件，帮助大家快速接入流量主，深受大家的喜爱。很多小伙伴使用了之后都觉得非常地靠谱，迫切地想要抖音小游戏版本的API组件。笔者也透露了近期会帮助大家整理一份抖音版本的API组件，今天它终于来了。言归正传，今天笔者重点为大家介绍一下Cocos开发抖音小游戏常用的API和整理，如果对大家有帮助，欢迎点赞转发收藏哦，再次感谢大家的大力支持哦！本文源工程可在文末获取，小伙伴们自行前往。总览为了更好地演示效果，笔者参考之前微信SDK组件简单搭了一个Demo小程序，简单但又不失优雅。其中分享模块和流量主广告模块相关配置可视化调整。资源结构清晰易懂，分享、广告独立成模块。组件简单易用。Cocos3.8.3、2.4.13和其他多版本支持。分享模块抖音小游戏和微信小游戏一样，依赖于它的环境，容易分享传播，因此我们小游戏务必接入分享模块，不能错过一次裂变的机会。 1.被动转发tt.onShareAppMessage()接口如下：

/**  * 注册事件 */ registerEvent(): void {     //转发     tt.onShareAppMessage(() =&gt; {         return this.getShareData();     }); }
/**  * 随机获取配置的分享内容 */ getShareData() {     var data = {         title: &#34;&#34;, //分享抖音的标题         imageUrl: &#34;&#34;, //通过MP系统审核的图片地址         query: &#34;&#34;,//自定义附加参数     };     if (this.shareContents.length > 0) {         var index = Math.floor(Math.random() * this.shareContents.length);         data.title = this.shareContents[index].title;         data.imageUrl = assetManager.utils.getUrlWithUuid((this.shareContents[index].image.texture as Texture2D).image.uuid, { isNative: true, nativeExt: &#34;.png&#34; });     }     return data; }
/**  * 主动转发 */ tt.shareAppMessage()
接口如下：

主动转发

/**  * 主动转发 */
shareAppMessage(title: string = '', imageUrl: string = '', query: string = '', shareCallback: any = null): void {
this.shareCallback = shareCallback;
var that = this;
var data = {
title: title,
imageUrl: imageUrl,
query: query,
success() {
that.shareCallback(true);
},
fail() {
that.shareCallback(false);
},
};
tt.shareAppMessage(data);
}

流量主广告模块

作为个人小游戏的主要收入来源，实现变现必须要接入这个模块。

激励视频：激励视频广告组件是由客户端原生的图片、文本、视频控件组成的，层级最高，会覆盖在上屏Canvas上。接口如下：

private rewardedVideoAd: any; private rewardAdCallback: any; private rewardAdCallbackObj: any; /**  * 播放激励视频广告  */
showRewardedVideoAd(rewardAdCallback: Function, rewardAdCallbackObj: any): void {     this.rewardAdCallback = rewardAdCallback;     this.rewardAdCallbackObj = rewardAdCallbackObj;     this.createRewardedVideoAd();     if (!this.rewardedVideoAd) {         this.onRewardAdCallback(false);         return;     }     // 用户触发广告后，显示激励视频广告     this.rewardedVideoAd.show().catch(() =&gt; {         // 失败重试         this.rewardedVideoAd.load()             .then(() =&gt; this.rewardedVideoAd.show())             .catch(err =&gt; {                 this.onRewardAdCallback(false);             })     }) }
/**  * 创建激励视频广告  */
createRewardedVideoAd() {     if (!this.rewardedVideoAd &amp;&amp; this.rewardedVideoAdConfig.adUnitId != &#34;&#34;) {         this.rewardedVideoAd = tt.createRewardedVideoAd({             adUnitId: this.rewardedVideoAdConfig.adUnitId         })         this.rewardedVideoAd.onClose(res =&gt; {             // 用户点击了【关闭广告】按钮             // 小于 2.1.0 的基础库版本，res 是一个 undefined             if (res &amp;&amp; res.isEnded || res === undefined) {                 // 正常播放结束，可以下发游戏奖励                 this.onRewardAdCallback(true);             }             else {                 // 播放中途退出，不下发游戏奖励                 this.onRewardAdCallback(false);             }         })         this.rewardedVideoAd.onError(err =&gt; {             this.onRewardAdCallback(false);         })     } }
/**  * 激励视频广告回调  */
onRewardAdCallback(success) {     if (this.rewardAdCallback) {         this.rewardAdCallback.call(this.rewardAdCallbackObj, success);         if (success) {             this.rewardedVideoAd.load();         }         this.rewardAdCallback = null;         this.rewardAdCallbackObj = null;     } }

Banner广告组件，是由客户端原生的图片、文本控件组成的最高层级的原生组件。它通常会覆盖在屏幕上的Canvas上。不过，值得注意的是，抖音小游戏很少使用Banner广告。接口如下：

private bannerAd: any; /**  * 显示Banner广告 */
showBannerAd(show: boolean): void {     if (show) {         // 在适合的场景显示 Banner 广告         this.createBannerAd(true);     }     else {         this.bannerAd.hide();         this.bannerAd.destroy();         this.bannerAd = null;     } }
/**  * 创建Banner广告 */
createBannerAd(show: boolean = false) {     if (!this.bannerAd) {         let sysInfo = tt.getSystemInfoSync();         // 创建 Banner 广告实例，提前初始化         var width = 320;         this.bannerAd = tt.createBannerAd({             adUnitId: this.bannerAdConfig.adUnitId,             adIntervals: 30,             style: {                 left: sysInfo.screenWidth / 2 - width / 2,                 top: sysInfo.screenHeight,                 width: width             }         })         this.bannerAd.onResize(res => {             this.bannerAd.style.top = sysInfo.screenHeight - this.bannerAd.style.realHeight;         })         this.bannerAd.onError(err => {             console.log(err)         })         this.bannerAd.onLoad(res => {             if (show)                 this.bannerAd.show();         })     }     else {         this.bannerAd.show();     } }

插屏广告插屏广告组件是客户端原生的，由图片、文本、视频控件组成，层级最高，会覆盖在普通组件上。其接口如下： private interstitialAd: any; /**

创建插屏广告 */ createInterstitialAd() { // 创建插屏广告实例，提前初始化 if (tt.createInterstitialAd && !this.interstitialAd) { this.interstitialAd = tt.createInterstitialAd({ adUnitId: this.interstitialAdConfig.adUnitId }); this.interstitialAd.onClose(res => { this.interstitialAd = null; this.createInterstitialAd(); }); } } /**
创建插屏广告 */ showInterstitialAd() { // 在适合的场景显示插屏广告 this.createInterstitialAd(); if (this.interstitialAd) { this.interstitialAd.show().catch((err) => { console.error(err); }); } }

格子广告格子广告组件是由客户端原生的图片、文本控件组成的原生组件，层级最高，会覆盖在上屏 Canvas 上。在抖音小游戏，通常我们可以通过格子广告替代Banner广告。其接口如下：

private customAd: any; /**  * 显示格子广告 */ showGridGamePanel(show: boolean): void {     if (this.gridGamePanel) {         this.gridGamePanel.destroy();     }     this.gridGamePanel = this.createGridGamePanel();     if (this.gridGamePanel) {         if (show)             this.gridGamePanel.show();         else {             this.gridGamePanel.destroy();             this.gridGamePanel = null;         }     } } createGridGamePanel() {     try {         const oneGridGamePanel = tt.createGridGamePanel({             gridCount: this.gridAdConfig.GridCount,         });         return oneGridGamePanel;     } catch (error) {         console.error(`创建游戏推荐组件失败`, error);         return null;     } }
常用模块
1.侧边栏
抖音小游戏
需要额外接入，官方提供的
侧边栏功能
，增加额外
留存
。
此能力将于「
2023年11月24日
」起开启「
必接审核
」，届时未接入该能力的小游戏在「
新游首发
」&amp;「
版本更新
」环节会有「
拒审
」风险，为避免影响游戏上线&amp;更新节奏，同时也为了提升小游戏留存，请尽快规划接入时间，感谢您的配合！
接入的关键
有以下几个
API
。
checkScene
：检测是否应该显示侧边栏按钮。注意该接口在头条渠道没有。
navigateToScene
：跳转打开侧边栏。
isSidebarEnter
通过showOptiions的scene、launch_from和location判断是否从侧边栏进入，从而进行发奖。
图片
接口如下：
```javascript
function checkScene(callback) {
try {
var res = this.getSystemInfoSync();
console.log(`手机型号为 ${res.model}`);
if (res.appName == "Toutiao" || res.appName == "news_article_lite") {
callback(false);
return;
}
} catch (error) {
console.log(`获取系统信息失败`);
}
tt.checkScene({
scene: "sidebar",
success: (res) => {
console.log("checkScene1", res, res.isExist);
callback(res.isExist);
},
fail: (res) => {
console.log("checkScene2", res);
callback(false);
}
});
}
function isSidebarEnter() {
var showOptions = tt.getLaunchOptionsSync();
console.log(showOptions);
return showOptions["scene"] == "021036" && showOptions["launch_from"] == "homepage" && showOptions["location"] == "sidebar_card";
}
function navigateToScene(callback) {
tt.navigateToScene({
scene: "sidebar",
success: (res) => {
console.log("navigateToScene1", res);
callback(true);
},
fail: (res) => {
console.log("navigateToScene2", res);
callback(false);
},
});
}

/** * 保存好友排行榜信息 */ setUserCloudStorage(userRankData) { tt.setUserCloudStorage({ userRankData: userRankData, success: () => { console.log(“用户排行榜保存成功”); }, fail: () => { console.log(“用户排行榜保存失败”); } }); } /** * 保存世界排行榜信息 */ setWorldCloudStorage(worldRankData) { tt.setWorldCloudStorage({ worldRankData: worldRankData, success: () => { console.log(“世界排行榜保存成功”); }, fail: () => { console.log(“世界排行榜保存失败”); } }); } /** * 通过getImRankData接口获取排行榜信息，并自定义绘制界面 */ getImRankData(rankData) { tt.getImRankData({ rankData: rankData, success: () => { console.log(“排行榜数据获取成功”); }, fail: () => { console.log(“排行榜数据获取失败”); } }); } /** * 通过getImRankList接口直接调用显示排行榜，无需自己绘制界面 */ getImRankList() { tt.getImRankList({ success: () => { console.log(“排行榜列表显示成功”); }, fail: () => { console.log(“排行榜列表显示失败”); } }); }

/** 对用户托管数据进行写操作。支持同时写入多组KV数据。 */
setUserCloudStorage(value: number, rankName: string = 'default') {
tt.checkSession({
success() {
console.log('session未过期');
tt.setImRankData({
dataType: 0, //成绩为数字类型
value: value + '', //该用户得了999999分
zoneId: rankName, //不同的榜可以通过zoneId区分
success(res) {
console.log('setImRankData success res: ${res}');
},
error(err) {
console.log('setImRankData fail res: ${err.errMsg}');
},
});
},
error() {
console.log('session已过期，需要重新登录');
tt.login({
success(res) {
console.log('登录成功');
that.setUserCloudStorage(value, rankName);
},
error(err) {
console.log('登录失败');
},
});
},
});
}
getImRankList(rankName: string = 'default') {
tt.checkSession({
success() {
console.log('session未过期');
tt.getImRankList({
relationType: 'default', //好友榜、总榜都展示
dataType: 0, //只圈选type为枚举类型的数据进行排序
rankType: 'all', //每天凌晨0点更新，只对当天0点到现在写入的数据进行排序
suffix: '分', //为空或不填，一般枚举类型不需要填后缀
rankTitle: '分数榜', //标题
zoneId: rankName, //不同的榜可以通过zoneId区分
success(res) {
console.log('getImRankData success res: ${res}');
},
error(err) {
console.log('getImRankData fail res: ${err.errMsg}');
// App.ViewManager.open(ViewConst.Tips, '暂无数据');
},
});
},
error() {
console.log('session已过期，需要重新登录');
tt.login({
success(res) {
console.log('登录成功');
that.getImRankList(rankName);
},
error(err) {
console.log('登录失败');
},
});
},
});
}

获取系统信息常用于获取手机型号、App渠道等相关信息。接口如下：

/**  * 获取系统信息。  */
getSystemInfoSync(): { screenWidth: number, screenHeight: number, model: string, appName: string } {
return tt.getSystemInfoSync();
}

显示消息提示框显示小程序自带的提示框。接口如下：

/**  * 显示消息提示框  * @param title   * @param success   * @param duration   */
showToast(title: string, success: boolean, duration: number = 0) {
tt.showToast({
title: title,
success: success ? 'success' : 'fail',
duration: duration
});
}

剪贴板设置系统剪贴板的内容，便于用户复制和分享。接口如下：

/**  * 设置系统剪贴板的内容  */
setClipboardData(data: string): void {
tt.setClipboardData({ data: data });
}

设置屏幕常亮接口如下：

/**  * 设置屏幕常亮  */
start() {
tt.setKeepScreenOn({
keepScreenOn: true,
success: () => {
console.log('抖音屏幕保持常亮成功');
}
});
}

监听版本更新接口如下：

start() {     //监听小程序有版本更新事件
const updateManager = tt.getUpdateManager()
updateManager.onCheckForUpdate(function (res) {         // 请求完新版本信息的回调
console.log(res.hasUpdate)
})
updateManager.onUpdateReady(function () {         tt.showModal({             title: '更新提示',             content: '新版本已经准备好，是否重启应用？',             success(res) {                 if (res.confirm) {                     // 新的版本已经下载好，调用 applyUpdate 应用新版本并重启
updateManager.applyUpdate()
}
}         })
})
updateManager.onUpdateFailed(function () {         // 新版本下载失败
})
}
结语
以上是整理的全部核心内容，整理不易，时间宝贵，需要源工程的小伙伴可以阅读原文获取。
付费不仅是知识的获取，更是对笔者的支持和认可，感谢！
https://store.cocos.com/app/detail/6786
我是“亿元程序员”，一位有着8年游戏行业经验的主程。在游戏开发中，希望能给到您帮助, 也希望通过您能帮助到大家。
AD:笔者线上的小游戏《打螺丝闯关》《贪吃蛇掌机经典》《重力迷宫球》《填色之旅》《方块掌机经典》大家可以自行点击搜索体验。
实不相瞒，想要个赞和在看！请把该文章分享给你觉得有需要的其他小伙伴。谢谢！
推荐专栏：

如何高效利用Cocos游戏实现抖音小游戏广告收益的快速接入？

主动转发

流量主广告模块

主营业务

解决方案

服务百科

常见问题

客户案例

如何有效管理谷歌竞价广告预算：避免超支的策略

提升付费点击广告（PPC）效果的九大策略

亚马逊广告策略：提升点击率与转化率的技巧

2022年亚马逊站内PPC广告优化策略

如何高效优化亚马逊PPC广告投放？掌握批量文件应用技巧

8种方法提升小型企业PPC广告效果

如何优化亚马逊站内PPC广告竞价策略？

优化亚马逊PPC广告的十大策略|Amz520跨境卖家导航首页

2025年PPC广告优化必备工具指南

掌握关键报告指标，优化亚马逊PPC广告效果

提升亚马逊PPC广告效果的8个关键步骤

亚马逊旺季广告优化：如何有效控制PPC支出，提升转化率？

如何提升亚马逊PPC广告效果？| 全球跨境支付解决方案

如何提升您的PPC广告转化率？

提升竞价广告效果的PPC策略优化

抖音游戏服务类目开通指南：技术全面攻略！

如何通过抖音游戏实现盈利？探索主要变现途径

如何在抖音上轻松赚取收入：六个简单步骤助你月入过万

《王者》在抖音掀起热潮，腾讯游戏如何成为流量焦点？

1小时内赚取10万，这类互动游戏真是令人惊叹

抖音直播游戏推广收益的计算方法

独家专访：“游戏发行人计划”：100万抖音达人如何重塑游戏内容发行格局

抖音小游戏中心：无广告体验

游戏发行商战略计划更新

广州抖音信息流广告投放一个月的成本大概为多少？

如何通过抖音平台推广小程序并实现盈利

抖音小程序定制费用指南及复制链接导入操作教程

如何在微信小程序中嵌入抖音链接？

抖音平台推广小程序的策略与实施步骤

如何通过抖音推广小程序实现收益？探索抖音小程序推广的策略与方法。