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