SDK 广告集成-激励广告
前置要求
- 知道在什么地方展示广告，如果没有，请先查看 广告集成示例
- 已经获取了 BlockId，如果没有，请先查看 获取 BlockId
- 请参考 SDK 安装 了解如何安装 SDK
激励广告
用户点击“观看广告”按钮后，可以获得奖励，例如：
执行以下代码：
import { TonAdPopupShow } from 'ton-ai-sdk'
TonAdPopupShow({
blockId: 'your_block_id',
countdown: 15, // 可以不设置，默认值为 10 秒，最小值为 10 秒，最大值为 30 秒
autoClose: true, // 默认值为 true，表示广告倒计时结束后自动关闭广告
onAdComplete: (ad) => {
// 用户看完了广告, 可以在此发放奖励
// sendReward(ad)
},
onAdClick: (ad) => {
// 用户点击了广告, 可以在此发放奖励
// sendReward(ad)
},
onAdError: (error) => {
// 用户在播放广告时遇到错误
console.error(error)
},
onAdClose: (ad) => {
// 用户手动关闭了广告
}
})然后根据您的产品设计，选择在对应的时机发送奖励
onAdComplete: 对应 CPM 模式，意味着用户看完了广告就能获得奖励onAdClick: 对应 CPC 模式，对用户较强的引导作用，意味着用户点击了广告才能获得奖励
各类事件中返回的 ad 对象的结构如下：
{
"adId": "string", // 广告 ID
"adBlockId": "string", // 广告位 ID
"adFormat": "string", //"image" | "video",
"icon": "string", // 广告商家图标
"text": "string", // 广告文案
"buttonText": "string", // 按钮文案
"url": "string", // 广告跳转链接
}提示
如果您希望发送奖励的逻辑不在前端执行，可以参考 getBlockId 中的 reward-webhook 章节
提示
出现 onAdError 错误的原因可能是：
- 获取广告时遇到网络错误
- 播放广告时遇到错误
- 当前没有任何广告
广告效果
