插页式广告

插页式广告是全屏广告,它会覆盖整个应用界面,直到用户将其关闭。这些广告通常会在应用流程的自然过渡点(例如,活动之间或游戏关卡之间的暂停时段)展示。当应用展示插页式广告时,用户可以选择点按广告并访问其目标网址,也可以选择关闭广告并返回应用。案例研究

本指南将向您介绍如何使用 Google 移动广告 C++ SDK 将插页式广告植入到 Android 和 iOS 应用中。

前提条件

务必用测试广告进行测试

构建和测试应用时,请确保使用测试广告,而不是实际投放的广告。否则,可能会导致您的帐号被暂停。

对于插页式广告,加载测试广告最简便的方法就是使用下面的专用测试广告单元 ID,此 ID 因设备平台而异:

  • Android:ca-app-pub-3940256099942544/1033173712
  • iOS:ca-app-pub-3940256099942544/4411468910

这些测试广告单元 ID 已经过专门配置,可为每个请求返回测试广告,您可以在自己应用的编码、测试和调试过程中随意使用该测试广告单元 ID。只是一定要在发布应用前用您自己的广告单元 ID 替换该测试广告单元 ID。

如需详细了解移动广告 SDK 的测试广告如何运作,请参阅测试广告

实现

植入插页式广告的主要步骤如下所示:

  1. 加载广告。
  2. 注册回调。
  3. 展示广告并处理其生命周期事件。

配置 InterstitialAd

插页式广告显示在 InterstitialAd 对象中,因此要将插页式广告集成到您的应用中,首先要创建并初始化一个 InterstitialAd 对象。

  1. 将以下头文件添加到应用的 C++ 代码中:

     #include "firebase/gma/interstial_ad.h"
    

  2. 声明并实例化一个 InterstitialAd 对象:

     firebase::gma::InterstitialAd* interstitial_ad;
     interstitial_ad = new firebase::gma::InterstitialAd();
    

  3. 使用转换为 AdParent 类型的父视图初始化 InterstitialAd 实例。父视图是对 Android Activity 的 JNI jobject 引用或指向 iOS UIView 的指针。

    // my_ad_parent is a jobject reference to an Android Activity or
    // a pointer to an iOS UIView.
    firebase::gma::AdParent ad_parent =
      static_cast<firebase::gma::AdParent>(my_ad_parent);
    firebase::Future<void> result = interstitial_ad->Initialize(ad_parent);
    
  4. 除了将 Future 作为变量保留之外,您还可以通过对 InterstitialAd 对象调用 InitializeLastResult() 来定期检查初始化操作的状态。这有助于跟踪全局游戏循环中的初始化过程。

    // Monitor the status of the future in your game loop:
    firebase::Future<void> result = interstitial_ad->InitializeLastResult();
    if (result.status() == firebase::kFutureStatusComplete) {
      // Initialization completed.
      if(future.error() == firebase::gma::kAdErrorCodeNone) {
        // Initialization successful.
      } else {
        // An error has occurred.
      }
    } else {
      // Initialization on-going.
    }
    

如需详细了解如何使用 firebase::Future,请参阅使用 Future 监控方法调用的完成状态

加载广告

广告的加载是通过对 InterstitialAd 对象使用 LoadAd() 方法完成的。加载方法要求您初始化 InterstitialAd 对象,并且拥有广告单元 ID 和 AdRequest 对象。系统会返回 firebase::Future,您可以使用它来监控加载操作的状态和结果。

以下代码展示了如何在成功初始化 InterstitialAd 后加载广告:

firebase::gma::AdRequest ad_request;
firebase::Future<firebase::gma::AdResult> load_ad_result;
load_ad_result = interstitial_ad->LoadAd(interstitial_ad_unit_id, ad_request);

注册回调

您必须扩展 FullScreenContentListener 类才能接收插页式广告展示和生命周期事件的通知。您可以通过 InterstitialAd::SetFullScreenContentListener() 方法注册自定义 FullScreenContentListener 子类,它将在广告成功展示或展示失败以及关闭时收到回调。

以下代码展示了如何扩展该类并将其分配给广告:

  class ExampleFullScreenContentListener
      : public firebase::gma::FullScreenContentListener {

   public:
    ExampleFullScreenContentListener() {}

    void OnAdClicked() override {
      // This method is invoked when the user clicks the ad.
    }

    void OnAdDismissedFullScreenContent() override {
     // This method is invoked when the ad dismisses full screen content.
    }

    void OnAdFailedToShowFullScreenContent(const AdError& error) override {
      // This method is invoked when the ad failed to show full screen content.
      // Details about the error are contained within the AdError parameter.
    }

    void OnAdImpression() override {
      // This method is invoked when an impression is recorded for an ad.
    }

    void OnAdShowedFullScreenContent() override {
      // This method is invoked when the ad showed its full screen content.
    }
  };

  ExampleFullScreenContentListener* full_screen_content_listener =
    new ExampleFullScreenContentListener();
  interstitial_ad->SetFullScreenContentListener(full_screen_content_listener);

InterstitialAd 是一次性对象。这意味着,插页式广告一经展示便无法再次展示。最佳做法是在 FullScreenContentListenerOnAdDismissedFullScreenContent() 方法中加载另一个插页式广告,以便在上一个插页式广告关闭后,立即开始加载下一个插页式广告。

展示广告

插页式广告应在应用流程的自然停顿期间进行展示,例如游戏的不同关卡之间或用户完成一项任务之后,这些都是非常不错的展示时机。虽然 FullScreenContentListener 可用于确定广告何时展示其全屏内容,但 Show() 返回的 Future 还会指示广告何时成功展示。

  firebase::Future<void> result = interstitial_ad->Show();

最佳实践

考虑插页式广告是否为适合您应用的广告类型。
在具有自然过渡点的应用中,插页式广告的效果最好。此类过渡点通常存在于应用内的任务结束时,例如分享完图片或完成一个游戏关卡时。由于用户希望可以在操作过程中休息一下,因此这时展示插页式广告不会影响用户体验。请务必考虑在应用流程的哪些时间点展示插页式广告,以及用户可能会以何种方式响应。
请注意,在展示插页式广告时暂停操作。
插页式广告类型多样,包括文字广告、图片广告和视频广告等。确保应用在展示插页式广告时,也会暂停使用某些资源,以便供广告使用,这一点十分重要。例如,当您发出展示插页式广告的调用后,请务必暂停应用产生的所有音频输出。您可以在已安装的 FullScreenContentListenerOnAdDismissedFullScreenContent 方法中恢复声音播放,当用户结束与广告的互动时,就会调用该方法。此外,请考虑在广告展示时暂时停止所有密集计算任务(例如游戏循环)。这样可以确保用户不会遇到图像无响应、响应慢或视频卡顿的现象。
留出充足的加载时间。
确保在恰当的时间展示插页式广告十分重要,同样,确保用户无需等待广告加载也十分重要。在您打算展示广告之前提前加载广告,可确保应用在广告展示时间到来时,已准备好加载完毕的插页式广告。
不要向用户展示太多广告。
虽然提高插页式广告在应用中的展示频次似乎是实现增收的好方法,但这么做也会影响用户体验并降低点击率。应确保用户不会频繁受到广告打扰,使他们可以充分享受到使用应用的乐趣。
请勿使用未来加载完成的方式来展示插页式广告。
这可能会导致用户体验不佳。不过,您可以在需要展示广告之前预加载广告。

其他资源

GitHub 中的示例

“Mobile Ads Garage”视频教程

成功案例

后续步骤