广告展示位置

本指南介绍了如何使用 Google 移动广告 Unity 插件的广告展示位置功能为应用制作和展示广告。

前提条件

初始化 Google Mobile Ads Unity Plugin

加载广告之前,请先调用 MobileAds.Initialize() 来初始化 Google Mobile Ads Unity Plugin,并提供 Action<InitializationStatus> 回调。此操作仅需执行一次,最好是在应用启动时执行。

using GoogleMobileAds.Api;
using System.Collections.Generic;
...
public class GoogleMobileAdsDemoScript : MonoBehaviour
{
    ...
    public void Start()
    {
        // Initialize Google Mobile Ads Unity Plugin.
        MobileAds.Initialize((initStatus) =>
        {
            // SDK initialization is complete
        });
        ...
    }
}

创建广告展示位置

若要使用 Google 移动广告展示横幅广告,第一步是创建并配置广告展示位置。您可以在 Unity 编辑器中依次选择 Assets(资源)> Google Mobile Ads(Google 移动广告)> Ad Placements(广告展示位置),然后选择横幅广告、插页式广告或激励广告格式的广告展示位置。然后,系统会设置三个演示广告展示位置,供您使用。

如需添加新的广告展示位置,请点击列表末尾的添加新展示位置按钮。您可以在 Inspector 视图中配置广告展示位置。

广告展示位置配置

每个展示位置都具有以下属性:

展示位置名称
展示位置的名称。用于在场景中设置广告时标识展示位置。
广告格式
横幅广告、激励广告、插页式广告。广告的类型。
广告单元 ID
提供 Android 和 iOS 版本的横幅广告单元 ID。您必须至少提供一个广告单元 ID。
跨场景持久保留
选中后,无论场景如何变化,横幅广告都会持续显示在屏幕上(行为与 DontDestroyOnLoad 相同)。
已启用自动充值
选中后,系统会在加载与广告展示位置关联的场景时自动加载广告。

以下屏幕截图显示了一个名为我的超棒横幅广告的广告展示位置示例。

向场景添加 AdGameObject

您可以在 Unity 编辑器中依次选择 GameObject > Google Mobile Ads,向场景中添加横幅广告、插页式广告或激励广告格式的 AdGameObject。选择格式,将展示位置添加到活动场景中。

将 AdGameObject 添加到场景后,您会在 Unity 编辑器的“Hierarchy”(层次结构)视图中看到一个代表该广告的 GameObject。

您可以通过更改 GameObject 本身的名称来更改展示位置的名称。以下屏幕截图显示了一个名为横幅广告的 AdGameObject 示例。

AdGameObject 设置

您可以在 Ad Game Object (Script) 组件设置中的“Inspector”视图中配置场景中的 AdGameObject。

广告展示位置

从已配置展示位置的下拉列表中选择广告展示位置。该列表将仅包含格式正确的广告单元。例如,对于横幅广告游戏对象,下拉菜单将仅显示已配置的横幅广告展示位置。

BannerAdGameObject 配置(仅限横幅)

  • 尺寸 - 选择要使用的横幅尺寸。
    • 锚定自适应横幅广告提供了更多选项:
      • 屏幕方向 - 选择用于计算广告高度的设备屏幕方向。
      • 使用全屏宽度 - 选中后,横幅广告将占据全屏宽度。如果您取消选中使用全屏宽度选项,则可以调整屏幕宽度的百分比 (50~99%)。
    • 自定义:允许您提供横幅宽度和高度。
  • 广告位置 - 选择应放置横幅广告的位置。

回调

您可以实现与广告回调对应的函数。例如,如果您想在横幅广告加载失败时进行处理,请执行以下操作:

  1. 创建一个与广告回调兼容的函数。

    public void OnBannerAdFailedToLoad(string reason) {
        Debug.Log("Banner ad failed to load: " + reason);
    }
    
  2. 将包含上述函数的脚本附加到场景中的任何 GameObject。

  3. 点击 + 按钮,然后拖放您已附加脚本的 GameObject。

  4. 选择要关联到广告回调的函数。对于参数化广告回调,请选择接受动态变量的函数,以便从 SDK 获取参数值。

通过脚本使用 AdGameObject

从脚本中获取 AdGameObject 实例

所有 AdGameObject 对象都具有便捷方法 LoadAd()。这将加载一个包含普通、未定位的 AdRequest 的广告。如需应用定位,您应使用自己配置的广告请求来使用 LoadAd(AdRequest adRequest)。

如需获取 AdGameObject 的实例,请针对每种格式使用以下方法:

MobileAds.Instance.GetAd<BannerAdGameObject>("AD_GAMEOBJECT_NAME");

返回的 BannerAdGameObject 对象还具有便捷方法 Hide() 和 Show()。

插页式广告

MobileAds.Instance.GetAd<InterstitialAdGameObject>("AD_GAMEOBJECT_NAME");

返回的 InterstitialAdGameObject 对象具有便捷方法 ShowIfLoaded()。

已获得奖励

MobileAds.Instance.GetAd<RewardedAdGameObject>("AD_GAMEOBJECT_NAME");

返回的 RewardedAdGameObject 对象具有便捷方法 ShowIfLoaded()。

例如,您可以获取 BannerAdGameObject 的实例并按如下方式加载:

using UnityEngine;

using GoogleMobileAds.Api;
using GoogleMobileAds.Placement;

public class BannerTestScript : MonoBehaviour
{
    BannerAdGameObject bannerAd;

    void Start()
    {
        bannerAd = MobileAds.Instance
            .GetAd<BannerAdGameObject>("AD_GAMEOBJECT_NAME");

        bannerAd.LoadAd();
        ...
    }
    ...
}

如果有一个名为 BannerAd 的 BannerAdGameObject,您可以像下面这样获取它的实例:

MobileAds.Instance.GetAd<BannerAdGameObject>("BannerAd");

访问 AdGameObject 中的底层广告对象

这些代码段演示了如何访问与 AdGameObject 关联的底层广告对象。

BannerAdGameObject bannerAd = MobileAds.Instance
    .GetAd<BannerAdGameObject>("AD_GAMEOBJECT_NAME");

// Access BannerView object
BannerView bannerView = bannerAd.BannerView;

插页式广告

InterstitialAdGameObject interstitialAdGameObject = MobileAds.Instance
    .GetAd<InterstitialAdGameObject>("AD_GAMEOBJECT_NAME");

// Access InterstitialAd object
InterstitialAd interstitialAd = interstitialAdGameObject.InterstitialAd;

已获得奖励

RewardedAdGameObject rewardedAdGameObject = MobileAds.Instance
    .Get<RewardedAdGameObject>("AD_GAMEOBJECT_NAME");

// Access RewardedAd object
RewardedAd rewardedAd = rewardedAdGameObject.RewardedAd;

示例

展示插页式广告

以下示例展示了如何配置游戏,以使用 AdGameObject 加载和展示插页式广告。

向场景中添加 InterstitialAdGameObject,并开启 Auto Load Enabled(已启用自动加载)功能,以便在场景加载时自动加载广告。

接下来,请确保您已按如下方式初始化 SDK。请注意,如果您忘记初始化 SDK,AdGameObject 中的自动加载功能将无法正常运行。

然后,通过调用 InterstitialAdGameObject.ShowIfLoaded() 函数在屏幕过渡间隙展示插页式广告。以下代码展示了在场景转换之间展示插页式广告的示例。

using UnityEngine;
using UnityEngine.SceneManagement;

using GoogleMobileAds.Api;
using GoogleMobileAds.Placement;

public class MainScene : MonoBehaviour
{
    InterstitialAdGameObject interstitialAd;

    void Start()
    {
        interstitialAd = MobileAds.Instance
            .GetAd<InterstitialAdGameObject>("interstitial");

        MobileAds.Initialize((initStatus) => {
            Debug.Log("Initialized MobileAds");
        });
    }

    public void OnClickShowGameSceneButton()
    {
        // Display an interstitial ad
        interstitialAd.ShowIfLoaded();

        // Load a scene named "GameScene"
        SceneManager.LoadScene("GameScene");
    }
}

由于您已在广告展示位置中启用自动加载功能,因此无需明确请求广告。当场景发生变化时,如果插页式广告已准备就绪,就会展示。

如果您想手动请求广告,请在广告展示位置检查器中停用自动加载功能,然后改为调用 InterstitialAdGameObject.LoadAd() 函数。以下代码段展示了如何手动请求广告。

public class MainScene : MonoBehaviour
{
    InterstitialAdGameObject interstitialAd;

    void Start()
    {
        interstitialAd = MobileAds.Instance
            .GetAdGameObject<InterstitialAdGameObject>("interstitial");

        MobileAds.Initialize((initStatus) => {
            Debug.Log("MobileAds initialized");

            // Load an interstitial ad after the SDK initialization is complete
            interstitialAd.LoadAd();
        });
    }
    ...
}

处理“观看激励广告”按钮状态

以下示例展示了如何使用广告展示位置启用“观看激励广告”按钮。

向场景中添加一个 Button GameObject(在本例中名为 Button),该对象将用于展示激励广告。仅当有激励广告可用时, 我们才会显示此按钮。

在 Start() 方法中,将 Button 的活跃状态更改为 false。这会使按钮从场景中消失。

public class MainScene : MonoBehaviour
{
    ...
    void Start()
    {
        GameObject.Find("Button").SetActive(false);
        ...
    }
}

向场景中添加一个 RewardedAdGameObject,然后从下拉菜单中选择 AdMob Demo Rewarded Ad 广告展示位置。

在 RewardedAdGameObject 检查器的“Callbacks”部分下,点击 On Ad Loaded() 中的 + 按钮,以便在加载激励广告时调用该函数。

将您在上一步中添加的按钮 GameObject 拖放到 None (Object) 字段中。从下拉菜单中选择要调用的函数。 依次点击 No Function > GameObject > SetActive(bool),然后点击复选框,使其发送 true 作为参数(调用 SetActive(true))。

在此“回调”部分中,您还可以关联一个在触发 RewardedAd.OnUserEarnedReward 事件时调用的事件。如需了解详情,请参阅此部分。

接下来,让按钮在被点击时展示激励广告。在按钮检查器的 On Click()(点击时)回调部分中,点击 + 按钮,然后将激励广告展示位置 GameObject(在本示例中名为 Rewarded Ad)拖放到 None (Object)(无 [对象])字段。

然后,将 RewardedAdGameObject.ShowIfLoaded() 函数附加到按钮的 On Click() 回调。

最后,别忘了初始化 SDK。以下代码段是此示例中使用的场景的完整代码:

using UnityEngine;

using GoogleMobileAds.Api;

public class MainScene : MonoBehaviour
{
    void Start()
    {
        GameObject.Find("Button").SetActive(false);

        MobileAds.Initialize((initStatus) => {
            Debug.Log("Initialized MobileAds");
        });
    }
}

运行项目后,当激励广告加载完毕并准备好展示时,您会在场景中看到该按钮。

为 RewardedAdGameObject 配置奖励回调

以下示例展示了如何为激励广告展示位置配置奖励回调,以便在调用回调函数时向用户提供奖励。

创建一个新脚本,并定义一个接受 Reward 作为参数的函数,如下所示。

using UnityEngine;
using GoogleMobileAds.Api;

class RewardedTestScript : MonoBehaviour {
    ...
    public void OnUserEarnedReward(Reward reward) {
        Debug.Log("OnUserEarnedReward: reward=" +
            reward.Type + ", amount=" + reward.Amount);
    }
    ...
}

将 RewardedTestScript 脚本附加到场景中的任何 GameObject(广告展示位置 GameObject 除外)。在此示例中,它附加到主摄像头游戏对象。

向场景添加 RewardedAdGameObject。然后,在 RewardedAdGameObject 检查器的“Callbacks”部分下,点击 On User Earned Reward (Reward) 上的 + 按钮,以便在向用户发放奖励时调用该函数。

将您在上一步中添加的主摄像头 GameObject 拖放到 None (Object) 字段中。从下拉菜单中选择要调用的函数。依次点击 No Function > RewardedTestScript > OnUserEarnedReward。

运行项目并观看激励广告后,当您因与广告互动而获得奖励时,系统会调用 RewardedTestScript.OnUserEarnedReward()。