Unity广告变现实战：Google移动广告SDK插件集成与避坑指南-拓冰建站

1. 项目概述：为什么你需要关注Google移动广告Unity插件？

如果你是一名Unity开发者，正在为你的手游或应用寻找稳定、高效的变现方案，那么Google移动广告SDK的官方Unity插件，绝对是你绕不开的核心工具。我见过太多团队，一开始图省事，要么自己用原生代码（Java/Objective-C）去桥接，要么用一些第三方封装不完善的插件，结果在广告加载、展示、收益统计上踩了无数的坑，后期维护成本高得吓人。这个官方插件的核心价值，就是它提供了一个纯粹的C#接口，让你能在Unity编辑器里，用你最熟悉的脚本语言，直接调用Google移动广告SDK的所有功能，无缝部署到Android和iOS双平台。

这不仅仅是省去了学习两门原生语言的成本，更重要的是，它确保了与Google官方SDK的同步更新和最佳兼容性。无论是新推出的广告格式，还是关乎收益和合规性的重要政策更新（比如用户隐私保护框架UMP），官方插件都能第一时间支持。简单来说，它把你从复杂的平台差异和底层集成工作中解放出来，让你能更专注于广告策略的优化和用户体验的提升。无论你是独立开发者还是中型团队的技术负责人，掌握这套官方集成流程，都是构建商业化应用的基础技能。

2. 环境准备与插件安装：避开第一个“坑”

在开始写第一行广告代码之前，正确的环境搭建是成功的一半。很多新手开发者容易在这里出问题，导致后续编译失败或运行时崩溃。

2.1 硬性前提条件核查

首先，你需要对照检查你的开发环境，这绝不是走过场。根据官方文档，以下是必须满足的条件：

Unity编辑器：要求2019.4 LTS或更高版本。但我强烈建议你直接使用2022.3 LTS或更新版本。原因很简单，新版本对包管理器（Package Manager）的支持更好，能更顺畅地通过OpenUPM安装插件，而且修复了许多旧版本的潜在兼容性问题。使用过旧的版本可能会导致插件依赖解析失败。
Android平台：
- 最低API级别（Min SDK）必须为23（Android 6.0）或更高。这是SDK运行的基础。
- 目标API级别（Target SDK）建议设置为35（Android 14）或更高。这不仅是适配新系统特性的需要，更是满足Google Play商店上架政策的强制要求。你可以在File -> Build Settings -> Player Settings... -> Android tab -> Other Settings中找到并进行设置。
iOS平台：
- Xcode版本：要求16.0或更高。苹果每年都会更新Xcode，并经常引入新的构建系统或签名机制，使用旧版Xcode编译包含最新广告SDK的项目，极大概率会失败。
- 部署目标：需要设置为iOS 13.0或更高。同样，这既是功能需要，也符合App Store的审核趋势。
- CocoaPods：确保你的Mac上安装了最新稳定版的CocoaPods。它是管理iOS项目第三方库依赖的事实标准，Google的插件会通过它自动引入必要的原生框架。

注意：很多开发者容易忽略Target API/SDK版本的要求。如果你设置的目标版本过低，在打包提交到商店时可能会被警告甚至拒绝。务必在项目初期就将其设置为当前推荐的最新稳定版。

2.2 插件安装的两种主流方式及选择

官方提供了几种安装方式，但最主流、最推荐的是以下两种：

方式一：通过OpenUPM包管理器安装（强烈推荐）

这是目前最现代化、最易于管理依赖的方式。它的原理是将插件作为一个标准的Unity Package，从OpenUPM仓库中引入。

添加OpenUPM注册表：
- 打开Unity，点击顶部菜单Edit -> Project Settings。
- 在设置窗口中，选择Package Manager分类。
- 在Scoped Registries区域，点击加号（+）添加一个新的注册表。
- 填写信息：
  - Name:OpenUPM
  - URL:https://package.openupm.com
  - Scopes:com.google（这个很重要，指明了从这个仓库下载com.google开头的包）
- 点击Apply。
安装插件包：
- 点击顶部菜单Window -> Package Manager，打开包管理器窗口。
- 在左上角的下拉菜单中，从Unity Registry切换到My Registries。
- 在列表中找到Google Mobile Ads这个包（通常全称是Google Mobile Ads for Unity）。
- 选中它，在右侧详情页点击Install按钮。

方式二：从GitHub下载.unitypackage文件（传统方式）

如果你所在网络访问OpenUPM不稳定，或者项目有特殊限制，可以采用此方法。

访问Google官方GitHub仓库（通常地址类似github.com/googleads/googleads-mobile-unity），找到最新的Release版本，下载后缀为.unitypackage的文件。
在Unity编辑器中，点击Assets -> Import Package -> Custom Package...。
选择你下载的.unitypackage文件，在导入窗口中，通常默认全选所有文件，直接点击Import。

两种方式如何选择？

优先OpenUPM：它支持版本管理和一键更新。当插件有新版本发布时，你可以在Package Manager中直接看到更新提示并升级，依赖的库也会被自动处理，非常方便。
从.unitypackage迁移到OpenUPM：如果你之前用的是.unitypackage，现在想改用OpenUPM，必须手动删除旧文件，否则会导致冲突。需要删除的目录包括：
- Assets/ExternalDependencyManager
- Assets/GoogleMobileAds
- Assets/Plugins/Android/googlemobileads-unity.aar
- Assets/Plugins/Android/GoogleMobileAdsPlugin
- Assets/Plugins/iOS/目录下与GADU（Google Ads Unity）相关的文件（如GADUAdNetworkExtras.h等）。

2.3 配置AdMob应用ID

插件安装成功后，你需要配置你的AdMob应用ID。这个ID是你在AdMob后台创建应用时获得的唯一标识，SDK通过它来识别你的应用并关联广告单元。

在Unity编辑器中，点击顶部菜单Assets -> Google Mobile Ads -> Settings。如果菜单里没有，请检查插件是否安装成功。
会打开一个GoogleMobileAdsSettings的ScriptableObject配置面板。
在这里，你需要分别填写：
- Android App ID: 你的Android应用在AdMob的ID，格式类似ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy。
- iOS App ID: 你的iOS应用在AdMob的ID。

实操心得：即使你目前只开发Android版，也建议先把iOS的App ID填上（可以填一个测试ID），因为配置数据会保存在项目里。如果这个字段为空，当你后续切换iOS平台编译时，可能会遇到初始化错误。你可以先在AdMob后台创建一个iOS应用来获取真实的ID，或者暂时使用Google提供的测试ID（但注意测试ID不能用于生产环境收益）。

3. SDK初始化与全局配置：启动的“正确姿势”

初始化看似简单，但却是整个广告体系的基石，这里埋着不少“雷”。

3.1 初始化的核心代码与时机

初始化调用非常简单，在你的游戏启动脚本（如GameManager）的Start()或Awake()方法中，尽早执行以下代码：

using GoogleMobileAds.Api; using UnityEngine; public class AdManager : MonoBehaviour { void Start() { // 初始化Google移动广告SDK MobileAds.Initialize(initStatus => { Debug.Log("AdMob SDK 初始化完成。"); // 初始化完成后，可以在这里加载全局性的广告（如一个预加载的插页广告） }); } }

关键点在于MobileAds.Initialize()方法接受一个Action<InitializationStatus>回调。当初始化完成（无论成功与否）后，这个回调会被触发。

3.2 初始化中的“大坑”：隐私合规与初始化顺序

官方文档里有一句用警告框标出的话，但很多开发者会忽略，导致应用在欧盟等地区可能面临合规风险：

警告：在调用MobileAds.Initialize()时，Google Mobile Ads Unity Plugin或中介合作伙伴 SDK 可能会预加载广告。如果您需要征得欧洲经济区 (EEA) 用户的同意、设置专门用于特定请求的标志（例如tagForChildDirectedTreatment或tag_for_under_age_of_consent），或者在加载广告之前执行任何其他操作，请务必在初始化 Google Mobile Ads Unity Plugin之前完成这些操作。

这段话是什么意思？我翻译一下： SDK一初始化，就可能开始偷偷在后台加载广告了。如果你需要先弹窗询问用户是否同意个性化广告（这是GDPR等法律要求的），或者你要设置“面向儿童”的标签，这些操作必须在初始化之前做完！否则，SDK可能用默认设置（比如未征得同意就请求个性化广告）去加载了广告，这属于违规行为。

正确的流程应该是：

应用启动。
首先，检查用户所在地区，如果需要，则使用Google 用户消息平台 (UMP)SDK 向用户展示同意收集信息对话框。
获取用户的选择结果（同意或拒绝）。
然后，根据用户的选择，配置广告请求参数（如设置tagForChildDirectedTreatment和tag_for_under_age_of_consent）。
最后，才调用MobileAds.Initialize()初始化SDK。
SDK初始化完成后，再开始加载具体的广告。

关于UMP SDK的集成，这是另一个重要话题，简而言之就是需要导入GoogleMobileAds.Ump包，并在初始化前调用ConsentInformation.Update()和ConsentForm.Load()等方法。务必在AdMob后台和App Store Connect/Google Play控制台做好隐私声明配置。

3.3 理解初始化状态与线程问题

初始化回调中的initStatus对象包含了SDK和各个中介适配器（如果你用了中介）的初始化状态。你可以遍历它来检查是否有适配器初始化失败。

MobileAds.Initialize(initStatus => { var adapterStatusMap = initStatus.getAdapterStatusMap(); foreach (var kvp in adapterStatusMap) { Debug.Log($"Adapter {kvp.Key}: {kvp.Value.InitializationState} - {kvp.Value.Description}"); } });

另外，文档注释里提到一点：Google移动广告的事件是在非Unity主线程（子线程）中触发的。这意味着，如果你在广告事件回调（比如广告加载成功、关闭等）里直接操作GameObject、Transform等Unity引擎对象，可能会引发线程安全问题，导致崩溃或诡异的行为。

解决方案是使用MobileAdsEventExecutor.ExecuteInUpdate()方法，将你的代码包装起来，确保它在Unity的主线程（Update循环）中执行。

// 在广告事件回调中 void OnAdLoaded() { MobileAdsEventExecutor.ExecuteInUpdate(() => { // 在这里安全地操作Unity对象，比如显示一个“广告已加载”的UI文本 adLoadedText.gameObject.SetActive(true); }); }

4. 主流广告格式集成详解

SDK初始化好后，就可以开始集成具体的广告了。AdMob提供了多种格式，每种都有其适用的场景和集成方式。

4.1 横幅广告：最基础的展示形式

横幅广告是一个矩形的广告视图，通常固定在屏幕顶部或底部。它的集成相对简单。

核心步骤：

创建广告请求：AdRequest对象，可以为其添加额外的定位信息或关键词（但受隐私政策限制，现在能用的不多）。
创建横幅广告对象：BannerView对象，需要传入在AdMob后台创建的广告单元ID（格式如ca-app-pub-xxxxxxxxxxxxxxxx/yyyyyyyyyy）、广告尺寸（如AdSize.Banner）、广告位置（如AdPosition.Bottom）。
加载广告：调用bannerView.LoadAd(adRequest)。
监听事件：注册回调，如OnAdLoaded,OnAdFailedToLoad来处理加载结果。
显示与隐藏：加载成功后默认显示。你也可以用bannerView.Hide()和bannerView.Show()控制。

public BannerView bannerView; void RequestBanner() { #if UNITY_ANDROID string adUnitId = "ca-app-pub-3940256099942544/6300978111"; // 安卓测试ID #elif UNITY_IPHONE string adUnitId = "ca-app-pub-3940256099942544/2934735716"; // iOS测试ID #else string adUnitId = "unexpected_platform"; #endif // 创建一个标准尺寸（320x50）的横幅，置于屏幕底部 bannerView = new BannerView(adUnitId, AdSize.Banner, AdPosition.Bottom); // 注册事件 bannerView.OnAdLoaded += HandleBannerAdLoaded; bannerView.OnAdFailedToLoad += HandleBannerAdFailedToLoad; // 创建广告请求 AdRequest request = new AdRequest.Builder().Build(); // 加载广告 bannerView.LoadAd(request); } void HandleBannerAdLoaded() { Debug.Log("横幅广告加载成功"); } void HandleBannerAdFailedToLoad(LoadAdError error) { Debug.LogError("横幅广告加载失败: " + error.GetMessage()); }

注意事项：

测试ID：上例中使用的是Google官方提供的测试广告单元ID，在开发和测试阶段务必使用它们，避免用真实的ID产生无效点击，影响后台数据。
自适应横幅：对于不同屏幕尺寸，更推荐使用AdSize.GetCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(width)来获取自适应尺寸，体验更好。
生命周期管理：在场景切换或游戏暂停时，考虑调用bannerView.Destroy()来释放资源，避免内存泄漏。

4.2 插页式广告：自然过渡点的变现利器

插页式广告是全屏广告，通常在游戏关卡之间、应用页面切换时展示。它的集成关键在于时机。

核心步骤：

预加载：插页式广告应该在需要展示的之前就加载好。因为加载有网络延迟，如果等到需要时才加载，用户会看到白屏等待，体验极差。
创建与加载：创建InterstitialAd对象，加载广告。
检查与展示：在合适的时机（如关卡结束），检查interstitialAd.IsLoaded()，如果为真，则调用interstitialAd.Show()。
重新加载：插页式广告是一次性的，展示后就会失效。必须在OnAdClosed事件中，立即开始加载下一个，为下一次展示做准备。

public InterstitialAd interstitialAd; void RequestInterstitial() { #if UNITY_ANDROID string adUnitId = "ca-app-pub-3940256099942544/1033173712"; #elif UNITY_IPHONE string adUnitId = "ca-app-pub-3940256099942544/4411468910"; #else string adUnitId = "unexpected_platform"; #endif // 清理旧的广告实例 if (interstitialAd != null) { interstitialAd.Destroy(); interstitialAd = null; } // 创建新的插页广告 interstitialAd = new InterstitialAd(adUnitId); // 注册事件 interstitialAd.OnAdLoaded += HandleInterstitialAdLoaded; interstitialAd.OnAdFailedToLoad += HandleInterstitialAdFailedToLoad; interstitialAd.OnAdClosed += HandleInterstitialAdClosed; // 创建请求并加载 AdRequest request = new AdRequest.Builder().Build(); interstitialAd.LoadAd(request); } void HandleInterstitialAdClosed(object sender, EventArgs args) { Debug.Log("插页广告已关闭"); // 广告关闭后，立即重新加载下一个 RequestInterstitial(); } // 在关卡结束时调用 public void ShowInterstitialAd() { if (interstitialAd != null && interstitialAd.IsLoaded()) { interstitialAd.Show(); } else { Debug.Log("插页广告未就绪，直接进入下一关"); // 即使广告没加载好，也要保证游戏流程能继续 GoToNextLevel(); } }

实操心得：一定要处理好广告未加载成功的情况。你的游戏逻辑不能卡在等待广告上。如果广告没准备好，应该让游戏正常进行下去。这就是上面代码中else分支的作用。

4.3 激励广告：提升用户参与度的法宝

激励广告允许用户选择观看一段视频或完成一个互动任务来获取应用内奖励（如金币、复活机会、去广告等）。它的集成是用户主动触发的。

核心步骤：

创建与加载：创建RewardedAd对象并加载广告。同样建议预加载。
用户触发：在UI上提供一个按钮（如“观看视频获得10金币”）。
检查与展示：用户点击后，检查广告是否已加载，然后展示。
发放奖励：监听OnUserEarnedReward事件，只有在这个事件触发时，才能给用户发放奖励。OnAdClosed事件只代表广告界面关闭，不代表用户完成了观看。

public RewardedAd rewardedAd; void RequestRewardedAd() { #if UNITY_ANDROID string adUnitId = "ca-app-pub-3940256099942544/5224354917"; #elif UNITY_IPHONE string adUnitId = "ca-app-pub-3940256099942544/1712485313"; #else string adUnitId = "unexpected_platform"; #endif rewardedAd = new RewardedAd(adUnitId); // 注册核心事件 rewardedAd.OnAdLoaded += HandleRewardedAdLoaded; rewardedAd.OnAdFailedToLoad += HandleRewardedAdFailedToLoad; // 用户获得奖励的事件 rewardedAd.OnUserEarnedReward += HandleUserEarnedReward; // 广告关闭事件 rewardedAd.OnAdClosed += HandleRewardedAdClosed; AdRequest request = new AdRequest.Builder().Build(); rewardedAd.LoadAd(request); } void HandleUserEarnedReward(object sender, Reward args) { string type = args.Type; // 奖励类型，如“coin” double amount = args.Amount; // 奖励数量，如 10.0 Debug.Log($"用户获得奖励: {amount} {type}"); // ！！！在这里发放游戏内奖励！！！ GameManager.Instance.AddCoins((int)amount); // 更新UI MobileAdsEventExecutor.ExecuteInUpdate(() => { coinText.text = GameManager.Instance.Coins.ToString(); }); } void HandleRewardedAdClosed(object sender, EventArgs args) { Debug.Log("激励广告已关闭"); // 广告关闭后，重新加载下一个 RequestRewardedAd(); } // UI按钮点击事件 public void OnWatchAdForCoinsButtonClicked() { if (rewardedAd != null && rewardedAd.IsLoaded()) { rewardedAd.Show(); } else { Debug.Log("激励广告未准备好"); // 可以给用户一个提示，比如“广告加载中，请稍后再试” } }

重要警告：发放奖励的逻辑必须且只能放在OnUserEarnedReward事件回调中。用户可能提前关闭广告，那样就不会触发此事件。如果你在OnAdClosed里发奖励，用户提前关闭也能拿到奖励，这会被平台视为欺诈行为，可能导致账号被封禁。

4.4 开屏广告：应用启动的第一印象

开屏广告在应用启动时展示，能带来较高的收益。Unity插件的集成方式比较特殊，通常需要你创建一个专门的“开屏广告场景”。

集成思路：

在项目构建设置（Build Settings）中，将开屏广告场景作为第一个场景（Scene 0）。
在这个场景的脚本中，初始化SDK并加载开屏广告。
广告加载成功后立即展示。
监听广告关闭事件，在事件中跳转到你的游戏主场景。

// 位于SplashAdScene中的脚本 public class SplashAdController : MonoBehaviour { private AppOpenAd appOpenAd; private bool isShowingAd = false; void Start() { // 先初始化SDK MobileAds.Initialize(initStatus => { Debug.Log("SDK初始化完成，开始加载开屏广告"); LoadAppOpenAd(); }); } void LoadAppOpenAd() { #if UNITY_ANDROID string adUnitId = "ca-app-pub-3940256099942544/3419835294"; #elif UNITY_IPHONE string adUnitId = "ca-app-pub-3940256099942544/5662855259"; #else string adUnitId = "unexpected_platform"; #endif // 清理旧实例 if (appOpenAd != null) { appOpenAd.Destroy(); appOpenAd = null; } AdRequest request = new AdRequest.Builder().Build(); AppOpenAd.Load(adUnitId, request, (AppOpenAd ad, LoadAdError error) => { if (error != null || ad == null) { Debug.LogError("开屏广告加载失败: " + error?.GetMessage()); // 加载失败，直接进入主场景 LoadMainScene(); return; } appOpenAd = ad; appOpenAd.OnAdDidDismissFullScreenContent += HandleAdDidDismissFullScreenContent; appOpenAd.OnAdFailedToPresentFullScreenContent += HandleAdFailedToPresentFullScreenContent; // 加载成功，立即展示 appOpenAd.Show(); isShowingAd = true; }); } void HandleAdDidDismissFullScreenContent(object sender, EventArgs args) { Debug.Log("开屏广告已关闭"); appOpenAd.Destroy(); appOpenAd = null; isShowingAd = false; // 广告关闭后，进入主场景 LoadMainScene(); } void HandleAdFailedToPresentFullScreenContent(object sender, AdErrorEventArgs args) { Debug.LogError("开屏广告展示失败: " + args.AdError.GetMessage()); appOpenAd.Destroy(); appOpenAd = null; LoadMainScene(); } void LoadMainScene() { SceneManager.LoadScene("MainMenuScene"); } }

注意事项：开屏广告有展示时限（通常为4小时），即用户第一次看到广告后的4小时内，再次打开应用不应再展示开屏广告，以免打扰用户。SDK内部会处理这个逻辑，但你需要确保应用从后台恢复到前台时，不会错误地再次触发开屏广告场景。

5. 高级话题与避坑指南

掌握了基础集成后，下面这些经验能帮你走得更稳，避免掉进深坑。

5.1 中介功能：最大化广告收益的必由之路

单纯使用AdMob的广告源（称为“直接销售”或“AdMob Network”）往往不能将广告位价值最大化。中介（Mediation）是AdMob提供的一个核心功能，它允许你的广告请求同时发给多家广告网络（如Unity Ads, AppLovin, ironSource, Meta Audience Network等），由这些网络进行实时竞价（RTB），价高者得，从而显著提升你的eCPM（每千次展示收益）。

集成中介的关键步骤：

在AdMob后台配置：在AdMob控制台，为你的应用添加中介组，并选择要集成的广告网络来源。
在Unity中导入适配器：中介功能需要额外的适配器（Adapter）包。这些包通常也可以通过OpenUPM或GitHub获取。例如，要集成Unity Ads，你需要安装GoogleMobileAds.Unity.Mediation.UnityAds这个包。
更新插件和适配器：中介适配器更新频繁，以适配各广告网络SDK的变更。你需要定期检查并更新它们，否则可能导致广告请求失败。
测试中介瀑布流：在AdMob后台，你可以为每个广告单元设置中介组和瀑布流（Waterfall），即广告网络的调用顺序。务必使用测试设备ID，在真机上充分测试，确保各个广告网络都能正常返回广告。

避坑技巧：中介集成后，广告加载失败的原因会变得复杂。除了网络问题，还可能是某个特定适配器初始化失败、某个广告网络没有填充（fill）等。你需要仔细查看LoadAdError对象中的GetResponseInfo()方法返回的信息，里面通常包含了是哪个中介网络失败了以及具体原因。

5.2 广告测试与调试

在应用上架前，彻底的测试至关重要。

使用测试广告单元ID：如前所述，Google为每种广告格式提供了专门的测试ID。务必在开发阶段使用它们。
添加测试设备：在AdMob后台，找到“设置”->“应用设置”->“设备ID”，将你用于调试的真机设备ID添加进去。这样，即使你使用了真实的广告单元ID，在这些设备上看到的也仍然是测试广告，不会产生无效活动。
使用Ad Inspector（广告检查器）：这是官方提供的强大调试工具。在你的应用代码中，在初始化后调用MobileAds.OpenAdInspector()，可以在真机上打开一个调试面板，查看当前广告请求的状态、配置、是否受限以及详细的错误信息。这对于排查“为什么广告不显示”这类问题极其有效。
查看Logcat/Xcode日志：Unity编辑器控制台和原生平台的日志会输出SDK的详细运行信息，包括初始化状态、广告请求和响应、错误码等。将日志级别设为Verbose可以获得最全的信息。

5.3 性能与用户体验优化

广告不能损害你的应用体验。

预加载策略：对于插页式、激励视频这类需要即时展示的广告，一定要预加载。在合适的时机（如游戏主菜单界面、关卡加载间隙）提前加载好，做到“即点即看”。
内存管理：广告对象（如BannerView,InterstitialAd）在不使用时，特别是场景销毁时，要调用Destroy()方法。对于横幅广告，如果某个界面暂时不需要，先Hide()再考虑是否Destroy。
频率控制：不要过度展示插页式广告，尤其是在核心游戏流程中。过于频繁的弹窗会极大激怒用户，导致卸载。设定合理的展示间隔（如至少间隔1-2分钟或完成某个特定动作后）。
网络状态判断：在请求广告前，可以简单判断一下设备网络状态。如果处于离线状态，可以跳过本次请求或给用户一个友好提示，而不是让SDK默默失败。

5.4 常见问题排查实录

下面是一些我实际开发中遇到过的高频问题及解决方案：

问题现象	可能原因	排查步骤与解决方案
广告一直加载失败，错误码0	1. 网络连接问题。 2. 应用ID或广告单元ID配置错误。 3. 新创建的AdMob应用/广告单元需要一段时间（可能几小时）才能激活。	1. 检查设备网络，尝试切换Wi-Fi/4G。 2.仔细核对`GoogleMobileAdsSettings`中的App ID和代码中的Ad Unit ID，一个字符都不能错。确保平台（Android/iOS）对应正确。 3. 如果是新ID，等待一段时间再试。使用测试ID可以立刻验证集成是否正确。
iOS构建后崩溃，报错找不到符号	1. CocoaPods依赖未正确安装或更新。 2. Xcode版本太旧。 3. 插件与Unity版本不兼容。	1. 在Unity构建iOS项目后，用Xcode打开`.xcodeproj`文件，在终端进入`ios`目录，执行`pod install --repo-update`。 2. 升级Xcode到最新稳定版。 3. 确保使用的Unity插件版本支持你的Unity编辑器版本。
激励广告看完后，奖励没发放	奖励发放逻辑写在了错误的事件回调里（如`OnAdClosed`）。	绝对确保发放奖励的代码只在`OnUserEarnedReward`事件回调中执行。仔细检查代码逻辑。
在真机上看不到测试广告，但编辑器里可以	1. 未在AdMob后台添加测试设备。 2. 使用了生产环境的广告ID，而该ID未关联有效的广告活动。	1. 获取设备ID（Android可通过Logcat查找，iOS可在Xcode设备日志中查找），添加到AdMob测试设备列表。 2. 在代码中换用官方的测试广告单元ID。
中介广告填充率很低	1. 中介适配器未正确集成或版本过旧。 2. 瀑布流配置不合理，底价（eCPM floor）设置过高。 3. 某些广告网络地区填充能力弱。	1. 检查所有用到的中介适配器包是否已安装且版本兼容。 2. 登录AdMob后台，检查中介组的瀑布流配置，适当调整底价或网络顺序。 3. 使用Ad Inspector查看具体是哪个网络失败，并检查该网络的自身配置（如App ID是否正确）。
应用因“无效流量”被警告	1. 开发者自己频繁点击自己的广告。 2. 广告展示/点击模式异常（如机器人流量）。	1.严禁点击自己应用中的广告，即使是测试。只使用测试ID。 2. 确保广告展示逻辑符合政策，不要诱导用户误点（如将广告按钮做得像游戏按钮）。

集成Google移动广告SDK Unity插件是一个系统工程，从环境配置、SDK初始化、广告格式集成，到中介优化、测试调试和合规性处理，每一步都需要细心。官方文档是基础，但真正的“坑”往往需要在实际项目中才能遇到。希望这篇从实战角度总结的教程，能帮你避开那些常见的陷阱，更顺畅地在你的Unity应用中实现广告变现。记住，保持插件和适配器更新，善用测试工具，始终把用户体验放在首位，才是长期稳定收益的关键。如果在集成中遇到文档未提及的奇怪问题，不妨去Unity官方论坛或相关开发者社区搜索，很可能已经有人遇到了同样的挑战并找到了解决方案。