TapTap Maker 广告接入实战

更新时间昨天 16:1714 浏览综合包含 AI 合成内容

一、核心观点 (Point)

广告接入的难点不在实现，在调试。封装一个统一的 ShowAdWrapped 入口 + 四层频控，就能在"不打断玩家"和"有效变现"之间找到平衡。

说实话，写代码只占 20%，剩下 80% 全在跟环境较劲……(；一_一)

二、为什么需要这套设计 (Reason)

Maker 的 Lua 运行时有三个特殊性：

tap 对象不存在 — 不能用 tap.getSystemInfoSync 判断真机 → 试了三版才发现这个事实，心态裂开 (╯°□°）╯︵ ┻━┻
真机和预览环境行为不同 — 同一段代码两种表现，预览测不出来 → 预览一切正常，上车就炸，经典 (￣▽￣)~*
sdk:ShowRewardVideoAd 回调行为诡异 — 返回 false 时回调可能同步触发 → 你以为它异步，它非要同步回调你一脸 Σ(っ °Д °;)っ

没有统一入口就散落各处改不干净，没有频控就招玩家反感。所以——搞它！( •̀ ω •́ )✧

三、怎么做 (Example)

① 真机检测（唯一可靠方式）

-- Phase 1: 脚本加载阶段设 false 兜底 isTapTapApp_ = false

-- Phase 2: Start() 中真正检测 if sdk and type(sdk.GetNativeExitMenuRect) == "function" then if sdk.GetNativeExitMenuRect(sdk) then isTapTapApp_ = true -- 真机有退出胶囊 end end

记住：退出胶囊有 → 真机 → 广告可用；退出胶囊无 → 预览 → 跳过。就这么简单，但我们踩了三个版本才搞对……(´；ω；`)

② 统一入口 + 双标志防重复

function ShowAdWrapped(trigger, onReward) if not CanShowAd() then return false end if not isTapTapApp_ then onReward(); return true end -- 预览 fallback

  local completed, callbackFired = false, false
  sdk:ShowRewardVideoAd(function(result)
      if callbackFired then return end   -- 守卫！防双重触发
      callbackFired = true
      if result.success then completed = true; onReward() end
  end)
  return completed

end

callbackFired 这个守卫看似多余，不加的话奖励莫名其妙发两次 → 到时候玩家白嫖双倍，你只能看着日志发呆 (￣～￣)

③ 四层频控

第1层环境 (isTapTapApp_) — 预览跳过，方便调试第2层新手 (前2局免广告) — 让玩家先上瘾第3层上限 (单局<=5次) — 防广告轰炸第4层 CD (两次最短间隔) — 给喘息空间

四层下来，该拦的都拦住了，玩家体验丝滑 ( ͡° ͜ʖ ͡°)

④ 五触发点

复活（高频）→ 双倍经验（中频）→ 重抽技能 → 开局加成 → 充能炸弹（极低频）频率与价值匹配，只在自然断点出现。

死得越多看得越多，但玩家是自愿点的——这就叫优雅变现 ٩(ˊᗜˋ*)و

⑤ Banner 生命周期

游戏中显示 → 菜单/死亡隐藏。重启时务必先 hide() 再销毁。别问我为什么知道要先 hide() 再销毁……(；′⌒`)