游戏上架只是开始:H5 小游戏接广告 SDK 的真实踩坑记录

4 阅读4分钟

第三篇了。前两篇写了怎么量产 103 个小游戏和怎么把上架素材全自动化, 这篇写最后一块拼图:接广告 SDK——游戏不接广告,上架再多也是用爱发电。 全文都是这两天真实操作的记录,包括被平台拒审的完整现场。

一、先搞清楚:三种接入模式,成本天差地别

HTML5 游戏分发平台接广告的方式分三类,接入成本完全不同:

模式代表平台对代码的侵入适合谁
域名守卫式CrazyGames / GameDistribution几乎为零(SDK 只在平台域名下自动加载)任何人,无脑接
强制声明式GameMonetize要在 <head> 里接 SDK_OPTIONS + 引 sdk.js接受人工审核条款的
商店包装式TapTap(H5 包体)平台自己包壳,你零改动国内上架

域名守卫式是小白福音:你的游戏代码里加一段判断,在自家网站/GitHub Pages 上运行时 SDK 完全不加载、零请求;被平台收了之后在他们的域名下运行时 SDK 自动生效。一份代码,两边通用。

if (host.indexOf("gamedistribution") !== -1 || host.indexOf("gd.games") !== -1) {
  var s2 = document.createElement("script");
  s2.src = "https://sdk.gamedistribution.com/v2/main.min.js";
  document.head.appendChild(s2);
}

二、GameMonetize:强制式接入的真实流程

GM 的流程坑最多,我踩了一整晚,把完整的坑列出来。

第一步:SDK 代码必须真的在包里。 这个坑就很离谱——我第一次上传的 zip 没接 SDK,后台一直显示"待验证",我以为平台会自动测试,等了一整天。真相是:验证要靠你本人,在后台的 Verify Game 弹窗里打开你的游戏,完整看完一条广告,激活按钮才会解锁。SDK 不在包里 = 弹窗里永远没有广告 = 死循环。

正确的接入代码(放在 <head> 里,越早越好):

<script>
window.SDK_OPTIONS = {
  gameId: "你的GameId",
  onEvent: function (a) {
    switch (a.name) {
      case "SDK_GAME_PAUSE":  /* 广告开始,静音 */ break;
      case "SDK_GAME_START":  /* 广告结束,恢复 */ break;
      case "SDK_READY": break;
    }
  }
};
(function (a, b, c) {
  var d = a.getElementsByTagName(b)[0];
  a.getElementById(c) || (a = a.createElement(b), a.id = c,
    a.src = "https://api.gamemonetize.com/sdk.js", d.parentNode.insertBefore(a, d));
})(document, "script", "gamemonetize-sdk");
</script>

第二步:广告打断期间必须静音。 这是硬要求——广告放着,你的 BGM 还在响,玩家体验稀碎,平台也会拿这个说事。我的做法是给游戏的音频出口加一个强制门:

// SDK 事件里翻开关
window.__trAdForceMute = true;   // SDK_GAME_PAUSE
window.__trAdForceMute = false;  // SDK_GAME_START

// 游戏的音效函数里加一行
function beep(freq, dur, type, gainv) {
  if (muted || window.__trAdForceMute) return;  // ← 广告期间静音
  // ...原有逻辑
}

整个游戏的音频都从 beep() 走,一行门控全部搞定。

第三步:验证广告的完整流程。 后台 → Verify Game → 弹窗 iframe 里打开你的游戏 → 先开始游戏再点弹窗底部的 showBanner() 调试按钮(这是最容易漏的:不先让游戏跑起来,广告不触发)→ 会弹 Google DFP 的测试广告"Linear Inline 5 Seconds" → 完整看完 → 刷新页面,Request activation 按钮就解锁了。

另外一个提交层的坑:GM 的上传组件是 Dropzone.js,不吃合成事件——自动化传 zip 时注入 change 事件没用,得直接 fetch POST FormData 到它的上传接口。

三、接入之后的真相:钱不是马上有的

把时间线摊开说,这是我在别的教程里没看到的实话:

  1. GM 激活 ≠ 有流量:激活只是让游戏进入他们的分发池,具体被多少站长嵌入、什么时候开始有曝光,完全被动。我的游戏激活申请提交后的第二天收到的是拒信——"AI-generated games that do not meet our quality standards"。
  2. 拒审是账号级的:这个账号之前被拒过一次,第二次提交直接连坐拒掉,tester 备注里没有任何针对新游戏本身的具体意见。教训:给 GM 的第一发子弹要留到游戏打磨到位再打。
  3. CrazyGames 有 1000 游玩门槛:接入后广告功能要等游戏跑够 1000 次游玩才开启。所以推广文章、合集页、TapTap 导流这些"主动拉量"的动作不是可选项,是接广告的前置条件。

四、给独立开发者的接入顺序建议

结合三篇的实践,我推荐的顺序:

  1. 所有游戏出厂自带域名守卫式 SDK(零成本,万一被收录直接生效)
  2. TapTap 上架国内线(平台包壳,零广告改动,先攒作品矩阵)
  3. 主动拉量:文章 / 合集页 / 社区,把核心一款推过平台的游玩门槛
  4. GM 这类强制式平台:游戏质量有信心了再提交,账号被拒一次就名花有主了

我的游戏合集(免费直接玩):shuangyueliao.github.io/game-arcade… TapTap 在线三款:搜「光廊冲刺」「水滴排序」「连连看塔」

下一篇写什么还没想好,可能是"1000 游玩怎么拉"的实战复盘。评论区有想看的方向可以说。


前篇:《103 个小游戏的商店素材,我一张图都没手动做》《我用 AI 四天做了 103 个小游戏,还真上架了 TapTap》