시작하기

借助 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 > Player > Android > Other Settings > Other Settings

导入 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 Resolver > Resolve,以便 Unity 外部依赖项管理器库将声明的依赖项复制到 Unity 应用的 Assets/Plugins/Android 目录中。

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()。此操作仅需执行一次,最好在 应用启动。

以下示例展示了如何在附加到 GameObject 的脚本的 Start() 方法中调用 Initialize()

...
using GoogleMobileAds.Api;
...
public class GoogleMobileAdsDemoScript : MonoBehaviour
{
    public void Start()
    {
        // Initialize the Google Mobile Ads SDK.
        MobileAds.Initialize(initStatus => { });
    }
}

如果您使用的是中介功能,请等到回调发生后再加载广告, 确保已初始化所有中介适配器

选择广告格式

现在,当您将 Google Mobile Ads SDK 部署到 在 Android 或 iOS 平台上均可使用现在,您就可以植入广告了。AdMob 提供了多种不同的广告格式,您可以从中选择最适合您的用户体验的格式。

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

植入横幅广告

插页式广告

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

植入插页式广告

原生

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

植入原生广告

激励广告

激励广告单元可让用户通过玩游戏、接受调查或观看视频来获得游戏代币、额外的生命或积分等应用内奖励。您可以设置 为不同广告单元设置不同的奖励,并指定奖励价值和 用户收到的项。

植入激励广告

插页式激励广告

插页式激励广告是一种激励用户的新型广告格式 为自动展示的广告提供奖励,如金币或额外的生命 自动应用。

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

插页式激励广告需要 介绍奖励的屏幕,告知用户该奖励并让用户有机会选择退出 自己希望实现的目标

植入插页式激励广告

开屏广告

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

植入开屏广告