1. 先别急着写代码把广告位“地盘”圈好很多Unity开发者朋友一上来就问我“哥激励广告的代码怎么写” 我通常会先拦住他们问一句“你的微信小游戏流量主开通了吗广告位创建好了吗” 这就好比你想开个店卖东西连营业执照和店铺招牌都没弄好就急着研究怎么收钱那肯定不行。所以咱们第一步得先把“地盘”圈好拿到那个至关重要的“钥匙”——广告位ID。我刚开始做的时候也犯过这个急代码写了一大堆结果一运行就报错折腾半天才发现后台根本没配置。所以咱们按部就班来。首先你得有个微信小游戏并且这个游戏的累计注册用户数得达到500人。这个门槛是微信官方定的达到了之后系统通常会在24小时后自动为你开放流量主申请的入口。这时候你登录微信公众平台注意是小程序后台不是公众号后台在左侧菜单栏里找到“流量主”这个选项点进去。开通流程基本是傻瓜式的跟着指引填信息、签协议就行。开通成功后你的“武器库”就解锁了。接下来点击“广告管理”你会看到一个大大的“新建广告位”按钮。这里就是关键了。微信小游戏提供了好几种广告类型但对于我们游戏开发者来说最常用、变现效率最高的就是激励视频广告和插屏广告。我建议你至少为每种类型创建一个独立的广告位。为什么因为这样数据清晰方便你后期分析哪个场景的广告效果更好从而优化你的广告策略。创建时系统会让你填一个“广告位名称”。这个名称只有你在后台能看到主要是为了你自己区分。比如你可以命名为“关卡复活激励广告”、“主界面插屏广告”等等一目了然。创建成功后页面会生成一个独一无二的“广告位ID”。请务必把这个ID复制保存好它就是我们后续在Unity代码里需要填写的那个adUnitId是连接你的游戏和微信广告系统的桥梁。这里有个小经验分享广告位状态默认是“开启”的。如果你在测试阶段不想让真实广告曝光影响数据或者某个广告位暂时不想用了可以在这里手动关闭。等正式上线前再打开非常灵活。2. 给你的Unity项目装上“微信引擎”地盘圈好了钥匙也拿到了接下来我们得把游戏“搬”到微信小游戏这个平台上并装上能调用广告的“引擎”。这一步的核心就是使用WeChatWASM SDK。你可以把它理解为一个转接器它能让你的Unity游戏原本是为PC或手机原生应用设计的在微信的浏览器环境里跑起来并且能调用微信提供的各种能力其中就包括广告。现在Unity官方已经提供了非常便捷的发布支持。我以Unity 2021 LTS或更新版本为例讲讲步骤安装转换工具在Unity Editor中打开Window - Package Manager。点击左上角的“”号选择“Add package from git URL...”然后输入com.unity.wechatgame。等待安装完成。这个官方包集成了SDK和发布流程比早期手动配置省心太多了。转换项目安装好后在File - Build Settings中选择WeChat Game作为目标平台。第一次选择时Unity可能会提示你下载必要的支持文件照做就行。关键配置在Build Settings面板下方点击Player Settings...会打开微信小游戏的专属配置页。这里你需要填写几个关键信息AppID这是你微信小游戏的ID在公众平台“开发 - 开发管理”页面可以找到。产品名称就是你的游戏名。游戏资源CDN这是个大坑微信小游戏有包体大小限制目前是20MB。你的游戏资源场景、模型、纹理等很容易超限。必须将资源上传到自己的云存储比如腾讯云COS或CDN并在这里填写资源的基础URL。Unity在构建时会自动将超过设定大小的资源进行远程加载配置。配置好后点击BuildUnity会生成一个minigame文件夹。这个文件夹里的内容就是可以运行在微信环境下的游戏包。但光这样还不够我们还需要在代码层面引入广告SDK。WeChatWASM SDK的API是通过JavaScript提供的但在Unity C#中我们可以直接调用这背后是转换工具帮我们做了桥接。你只需要在需要调用广告的C#脚本开头引用WeChatWASM这个命名空间即可就像原始文章里那样using WeChatWASM;这个using语句就是告诉Unity“我接下来要用微信小游戏的能力了”。准备工作到此全部就绪我们可以开始动手写广告逻辑了。3. 手把手集成激励广告让玩家心甘情愿看广告激励广告是游戏变现的“王牌”。它的精髓在于“价值交换”玩家通过观看一段15-30秒的视频广告来获取游戏内的某种奖励比如复活、金币、道具、额外次数等。设计得好玩家不会反感反而觉得“赚了”。集成它主要分为四个步骤加载、展示、监听关闭、发放奖励。我们结合代码一步步拆解。3.1 广告对象的创建与加载你不能每次玩家点击按钮时才临时去创建一个广告那样加载慢、体验差。正确的做法是在游戏初始化时比如某个管理器脚本的Start或Awake方法里就创建好广告实例并让它预加载。using WeChatWASM; using UnityEngine; public class AdManager : MonoBehaviour { // 声明一个激励广告对象 private WXRewardedVideoAd _rewardedAd; void Start() { // 游戏启动时初始化激励广告 InitRewardedAd(); } void InitRewardedAd() { // 创建激励广告实例 _rewardedAd WX.CreateRewardedVideoAd(new WXCreateRewardedVideoAdParam() { // 替换成你在后台创建激励广告位时得到的那个ID adUnitId adunit-xxxxxxxxxxxxxxxx, // multiton 参数是否支持创建多个实例。通常设为 true 更灵活。 multiton true }); // 绑定广告关闭事件的监听器 _rewardedAd.OnClose(OnRewardedAdClosed); // 还可以绑定其他事件比如加载成功/失败 _rewardedAd.OnLoad(OnRewardedAdLoaded); _rewardedAd.OnError(OnRewardedAdError); } void OnRewardedAdLoaded(WXADLoadResponse res) { Debug.Log(激励广告加载成功可以展示了); } void OnRewardedAdError(WXRewardedVideoAdOnErrorResponse err) { Debug.LogError($激励广告加载失败: {err.errMsg}); // 这里可以做一些失败处理比如提示玩家网络不佳或者隐藏广告按钮 } }我把广告实例做成了单例管理器的一部分这样在整个游戏里都能方便地调用。CreateRewardedVideoAd这个调用会触发微信SDK去后台拉取一条可用的视频广告并进行缓存。OnLoad回调告诉我们广告准备好了OnError则能让我们及时知道问题比如网络错误、广告填充失败等便于做降级处理。3.2 触发展示与游戏状态管理广告的展示通常由一个玩家主动触发的行为引起比如点击一个“复活”按钮。这里有一个至关重要的细节当广告视频全屏播放时你的游戏逻辑应该暂停否则后台可能还在跑计时、敌人还在移动体验会非常割裂。public class UIManager : MonoBehaviour { // 假设这是一个复活按钮的点击事件 public void OnReviveButtonClicked() { // 先检查广告实例是否存在且状态正常 if (_rewardedAd ! null) { // 暂停游戏逻辑。这是关键一步 Time.timeScale 0; // 暂停游戏背景音乐、音效 AudioListener.pause true; // 调用SDK方法展示广告 _rewardedAd.Show(); } else { Debug.LogWarning(广告未初始化成功无法展示); // 可以给玩家一个提示比如“广告加载中请稍后” } } }把Time.timeScale设为0是Unity里最常用的暂停方法它会停止所有基于时间的更新如UpdateFixedUpdate里的移动、动画等。同时暂停音频形成一个沉浸式的广告观看环境。3.3 监听关闭事件与奖励发放逻辑这是激励广告的核心逻辑判断点。玩家关闭广告窗口时SDK会触发我们之前绑定的OnClose事件。回调参数res里有一个极其重要的字段isEnded。这个字段直接决定了玩家是否看完了广告以及我们是否应该发放奖励。void OnRewardedAdClosed(WXRewardedVideoAdOnCloseResponse res) { // 广告关闭了首先无论成功与否都要恢复游戏 Time.timeScale 1; AudioListener.pause false; // 关键判断是否播放完成 if (res ! null res.isEnded) { Debug.Log(激励广告播放完成发放奖励); // 这里调用你的游戏奖励逻辑 GrantReward(); // 例如增加金币、复活角色、解锁道具... // GameManager.Instance.AddCoins(100); // Player.Instance.Revive(); } else { Debug.Log(激励广告未播放完成不发放奖励。); // 这里可以给玩家一个友好提示 // ShowToast(看完广告才能获得奖励哦~); } // 广告关闭后旧的广告实例可能失效最好重新加载一次以备下次使用 // 可以延迟一小段时间再调用避免频繁请求 StartCoroutine(ReloadRewardedAd()); } System.Collections.IEnumerator ReloadRewardedAd() { yield return new WaitForSeconds(1.0f); InitRewardedAd(); // 重新初始化广告 }一定要理解isEnded的含义它为true仅代表视频播放到了自然结束看完了。如果用户点击了右上角的关闭按钮提前退出或者网络中断导致播放失败isEnded都会是false。我们必须严格根据这个值来决定是否发放奖励这是平台规则也是保证广告主效果和用户体验的底线。奖励发放后我习惯性地调用一个ReloadRewardedAd协程来重新创建和加载广告实例确保下一次点击按钮时广告是准备好的。这是一个保持广告可用性的好习惯。4. 无缝接入插屏广告平衡体验与收益插屏广告就像游戏里的“间歇性插播”通常在场景切换、关卡结束、暂停返回时弹出。它不需要用户付出“观看”这个主动行为但也不能滥用否则会严重破坏游戏体验。集成插屏广告比激励广告更简单因为它没有“是否完成”的状态判断主要流程就是加载和在合适时机展示。4.1 创建与自动加载展示插屏广告的创建和激励广告非常相似但它的展示策略通常是“加载成功即展示”。public class AdManager : MonoBehaviour { // 声明一个插屏广告对象 private WXInterstitialAd _interstitialAd; void Start() { // 游戏启动时也初始化插屏广告 InitInterstitialAd(); } void InitInterstitialAd() { _interstitialAd WX.CreateInterstitialAd(new WXCreateInterstitialAdParam() { // 替换成你在后台创建的插屏广告位ID adUnitId adunit-yyyyyyyyyyyyyyyy }); // 绑定加载成功事件一旦成功就自动展示 _interstitialAd.OnLoad(OnInterstitialAdLoaded); _interstitialAd.OnError(OnInterstitialAdError); _interstitialAd.OnClose(OnInterstitialAdClosed); } void OnInterstitialAdLoaded(WXADLoadResponse res) { Debug.Log(插屏广告加载成功自动展示); if (_interstitialAd ! null) { // 加载成功后立即展示 _interstitialAd.Show(); } } void OnInterstitialAdError(WXInterstitialAdOnErrorResponse err) { Debug.LogError($插屏广告加载/展示失败: {err.errMsg}); // 加载失败可以静默处理或者记录日志下次再试 } void OnInterstitialAdClosed(WXInterstitialAdOnCloseResponse res) { Debug.Log(插屏广告被关闭); // 广告关闭后同样需要重新加载以备下次使用 StartCoroutine(ReloadInterstitialAd()); } System.Collections.IEnumerator ReloadInterstitialAd() { yield return new WaitForSeconds(2.0f); // 可以间隔稍长一点时间 InitInterstitialAd(); } }注意看我在OnLoad回调里直接调用了Show()。这意味着只要SDK成功从后台拉取到一个插屏广告它就会立刻弹出来。这种模式适用于“非关键路径”的展示比如玩家死亡后查看结算页面时广告已经默默加载好并展示出来。4.2 设计合理的展示时机与频率控制但是我们不能让广告随时随地乱弹。你需要设计一个展示管理器来控制频率和时机。一个粗暴但有效的策略是使用计数器或冷却时间。public class InterstitialAdController : MonoBehaviour { private int _gameOverCount 0; private float _lastAdShowTime -Mathf.Infinity; public float adCoolDownTime 120f; // 广告冷却时间比如2分钟 // 在游戏结束的UI显示方法中调用 public void OnGameOver() { _gameOverCount; // 策略1每3次游戏结束展示一次 if (_gameOverCount % 3 0) { TryShowInterstitial(); } // 或者策略2距离上次展示超过冷却时间才展示 // if (Time.time - _lastAdShowTime adCoolDownTime) // { // TryShowInterstitial(); // } } void TryShowInterstitial() { // 再次检查时间冷却如果使用策略2 if (Time.time - _lastAdShowTime adCoolDownTime) { return; } // 检查广告实例是否已经加载好可以通过监听加载状态维护一个布尔变量 if (AdManager.Instance.IsInterstitialReady) { AdManager.Instance.ShowInterstitialAd(); _lastAdShowTime Time.time; Debug.Log(展示插屏广告); } } }我强烈建议你将广告展示逻辑与游戏事件深度绑定。比如关卡通过后展示一次。玩家主动返回主菜单时展示一次。游戏每进行X分钟后展示一次需谨慎。 并且务必设置一个全局的冷却时间比如至少间隔1-2分钟防止玩家在短时间内在不同界面切换导致广告连续弹出那会直接导致玩家卸载游戏。5. 避坑指南那些我踩过的雷和最佳实践集成广告不是把代码跑通就万事大吉了。在实际项目中我遇到过不少坑这里总结几条血泪经验希望能帮你绕过去。坑1广告加载失败或填充率低。尤其是在开发测试阶段微信的广告测试流量可能不稳定或者你的广告位是新创建的需要一段时间可能几小时才能有稳定的广告填充。解决方案一定要做好错误监听OnError在UI上给玩家友好的提示比如“广告加载中请检查网络”或“暂时没有可看的广告哦”。正式上线后填充率会逐渐稳定。坑2激励广告奖励发放逻辑错误。这是最严重的bug之一。绝对不能根据广告是否“展示”了来发奖励必须严格根据OnClose回调里的res.isEnded来判断。我曾经因为逻辑写反导致玩家没看完广告也拿到了奖励白白损失了收入。解决方案反复测试这个流程用真机在微信环境里测试模拟提前关闭和完整看完两种场景确保奖励发放逻辑万无一失。坑3广告展示与游戏音画不同步。只设置了Time.timeScale 0可能还不够因为一些协程Coroutine或非时间缩放影响的动画可能还在继续。解决方案在暂停游戏时除了设置时间缩放最好还通知你的游戏状态管理器GameManager让所有需要暂停的系统如敌人AI生成器、背景动画控制器等都收到一个“Pause”事件全面暂停。恢复时同理。坑4频繁创建销毁广告实例导致内存或性能问题。不要在每次需要广告时都Create展示完就置之不理。最佳实践像上面代码那样在游戏生命周期内如一个游戏会话中复用广告实例。在广告关闭回调里不是销毁它而是调用Destroy方法如果SDK提供或重新创建Create来加载下一条广告。同时在游戏切后台或退出前确保正确销毁广告实例释放资源。坑5忽略玩家体验广告过于频繁。这是最影响游戏留存的一点。插屏广告绝不能“滥弹”。最佳实践制定清晰的广告策略。激励广告的触发按钮要放在玩家真正需要、心甘情愿的位置如复活、获取稀缺货币。插屏广告的展示间隔要足够长并且避开核心操作流程比如激烈的战斗过程中。可以做一个简单的“玩家疲劳度”系统记录当天广告展示次数达到上限后就停止展示。最后测试阶段务必使用微信开发者工具的“真机调试”功能或者直接上传体验版在真机上跑。模拟器里的广告行为有时和真机不一致。多找几个朋友当测试员从真实玩家的角度感受一下广告的频率和时机是否舒服。广告变现是一门平衡艺术既要赚到钱也要留住玩家找到那个微妙的平衡点你的小游戏才能走得更远。