借助 Google 移动广告 Unity 插件，Unity 开发者可以投放 Google 移动广告 而无需编写 Java 或 Objective-C 代码。通过 插件提供了一个用于请求广告的 C# 接口，供 C# 脚本 Unity 项目
本指南面向希望通过 Unity 应用创收的发布商。
前提条件
- 使用 Unity 2019.4 或更高版本
- 部署到 iOS
- Xcode 15.3 或更高版本
- 定位到 iOS 12.0 或更高版本
- CocoaPods
- 部署到 Android
- 最低 Android API 级别为 21 或更高级别
- 以 Android API 级别 31 或更高级别为目标平台
Android API 级别在 Project Settings >播放器 > Android >其他设置 >其他设置。
导入 Mobile Ads for Unity 插件
OpenUPM-CLI
如果您使用 OpenUPM CLI 则可以使用以下命令安装 OpenUPM 注册表 命令：
openupm add com.google.ads.mobile
移除 .unitypackage 项插件资源
如果您要从使用 .unitypackage 改为使用 OpenUPM，
必须从原位置手动卸载素材资源。移除
以下是从 .unitypackage 导入的以下目录：
- Assets/ExternalDependencyManager
- 素材资源/GoogleMobileAds
- Assets/Plugins/Android/googlemobileads-unity.aar
- Assets/Plugins/Android/GoogleMobileAdsPlugin
- Assets/Plugins/iOS/GADUAdNetworkExtras
- Assets/Plugins/iOS/unity-plugin-library.a
OpenUPM
- 打开软件包管理器设置 方法是选择 Unity 菜单选项 编辑 >项目设置 >软件包管理器。
将 OpenUPM 作为限定范围的注册表添加到 Package Manager 窗口：
Name: OpenUPM URL: https://package.openupm.com Scopes: com.google依次选择 Unity 应用，打开 package manager（软件包管理器）菜单 菜单选项 窗口 >软件包管理器。
设置 Manager 范围下拉菜单，然后选择 My Registries。
从软件包列表中选择 Google Mobile Ads for Unity 软件包 然后按安装。
移除 .unitypackage 项插件资源
如果您要从使用 .unitypackage 改为使用 OpenUPM，
必须从原位置手动卸载素材资源。移除
以下是从 .unitypackage 导入的以下目录：
- Assets/ExternalDependencyManager
- 素材资源/GoogleMobileAds
- Assets/Plugins/Android/googlemobileads-unity.aar
- Assets/Plugins/Android/GoogleMobileAdsPlugin
- Assets/Plugins/iOS/GADUAdNetworkExtras
- Assets/Plugins/iOS/unity-plugin-library.a
从 GitHub 导入
- 下载最新版
.unitypackage。 - 通过选择 Unity 菜单选项，导入
.unitypackage文件 资产 >导入软件包 >Custom Package 和导入所有项。
包含外部依赖项
Google 移动广告 Unity 插件随 Unity Play 服务一起分发 解析器库。此库 旨在供任何需要访问 Android 专用插件的 Unity 插件使用。 库（例如 AAR）或 iOS CocoaPods。它为 Unity 插件提供了 来声明依赖项，这些依赖项随后会被自动解析并复制到 Unity 项目
请按照以下步骤确保您的项目包含所有依赖项：
Android
转到项目设置 >播放器 >Android >发布设置 >构建 然后选择：
- 自定义主 Gradle 模板
- 自定义 Gradle 属性模板
在 Unity 编辑器中，依次选择 Assets >External Dependency Manager >Android 设备
解析器 >解析以使用 Unity External Dependency Manager 库
将声明的依赖项复制到 Assets/Plugins/Android 目录中
Unity 应用界面
iOS
Unity for iOS 使用 CocoaPods 来识别和管理依赖项。 请参阅 CocoaPods 文档 与您的 iOS 相关的特定要求或问题排查步骤 依赖项
下面列出了 Google 移动广告 Unity 插件依赖项
Assets/GoogleMobileAds/Editor/GoogleMobileAdsDependencies.xml。
设置您的 Ad Manager 应用 ID
在 Unity 编辑器中，依次选择 Assets >Google 移动广告 >设置 。
输入您的 Android 和 iOS 设备 Ad Manager 应用 ID 。
初始化 SDK
加载广告之前，请先让您的应用初始化 Google 移动广告 SDK，具体方法如下所示：
正在调用 MobileAds.Initialize()。此操作仅需执行一次，最好在
应用启动。
以下示例展示了如何在 Start() 方法中调用 Initialize()
附加到 GameObject 的脚本：
...
using GoogleMobileAds.Api;
...
public class GoogleMobileAdsDemoScript : MonoBehaviour
{
public void Start()
{
// Initialize the Google Mobile Ads SDK.
MobileAds.Initialize(initStatus => { });
}
}
如果您使用的是中介功能，请等到回调发生后再加载广告， 确保已初始化所有中介适配器
选择广告格式
现在，当您将 Google 移动广告 SDK 部署到 在 Android 或 iOS 平台上均可使用现在，您就可以植入广告了。AdMob 提供了许多不同的广告格式 您可以从中选择能够 以提供最佳用户体验。
横幅
横幅广告单元展示的矩形广告会占用应用空间的一部分 布局。它们可以在设定的时间后自动刷新。这意味着 用户会定期查看新广告，即使他们保持不变 界面也是一种实施起来最简单的广告格式。
插页式广告
插页式广告单元可在您的应用中展示全屏广告。放在自然的地方 应用界面中的停顿和过渡，例如在通关后 展示这种广告
原生
在原生广告中，您可以自定义素材资源（例如标题和 在您的应用中展示号召性用语。通过自行设置广告样式，您可以 制作自然、毫不唐突的广告展示方式，为富有价值的用户带来 体验。
激励广告
激励广告单元允许用户玩游戏、参与调查或观看视频， 获得应用内奖励，例如金币、额外的生命或积分。您可以设置 为不同广告单元设置不同的奖励，并指定奖励价值和 用户收到的项。