开始使用

借助 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

  1. 打开软件包管理器设置 方法是选择 Unity 菜单选项 编辑 >项目设置 >软件包管理器。

  2. 将 OpenUPM 作为限定范围的注册表添加到 Package Manager 窗口：

    Name: OpenUPM
URL: https://package.openupm.com
Scopes: com.google

  3. 依次选择 Unity 应用，打开 package manager（软件包管理器）菜单 菜单选项 窗口 >软件包管理器。

  4. 设置 Manager 范围下拉菜单，然后选择 My Registries。

  5. 从软件包列表中选择 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 导入

  1. 下载最新版 .unitypackage 。
  2. 通过选择 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。

设置您的 AdMob 应用 ID

在 Unity 编辑器中，依次选择 Assets >Google 移动广告 >设置 。

输入您的 Android 和 iOS 设备 AdMob 应用 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 提供了许多不同的广告格式 您可以从中选择能够 以提供最佳用户体验。

横幅广告单元展示的矩形广告会占用应用空间的一部分 布局。它们可以在设定的时间后自动刷新。这意味着 用户会定期查看新广告，即使他们保持不变 界面也是一种实施起来最简单的广告格式。

植入横幅广告

插页式广告

插页式广告单元可在您的应用中展示全屏广告。放在自然的地方 应用界面中的停顿和过渡，例如在通关后 展示这种广告

植入插页式广告

原生

在原生广告中，您可以自定义素材资源（例如标题和 在您的应用中展示号召性用语。通过自行设置广告样式，您可以 制作自然、毫不唐突的广告展示方式，为富有价值的用户带来 体验。

植入原生广告

激励广告

激励广告单元允许用户玩游戏、参与调查或观看视频， 获得应用内奖励，例如金币、额外的生命或积分。您可以设置 为不同广告单元设置不同的奖励，并指定奖励价值和 用户收到的项。

植入激励广告

插页式激励广告

插页式激励广告是一种激励用户的新型广告格式 为自动展示的广告提供奖励，如金币或额外的生命 在应用自然过渡期间出现的问题

与激励广告不同，用户无需自行选择即可观看激励广告 插页式广告。

与激励广告中的选择观看提示不同，插页式激励广告需要 介绍奖励的屏幕，告知用户该奖励并让用户有机会选择退出 自己希望实现的目标

植入插页式激励广告

开屏广告

开屏广告是一种广告格式，会在用户打开或切换回 应用。广告会叠加在加载屏幕上。

植入开屏广告