インタースティシャル広告

<ph type="x-smartling-placeholder">


インタースティシャル広告は、それまでアプリのインターフェース上に全画面表示される広告です。 終了です。通常は、次のアクティビティに移行する前やゲームレベルをクリアした後の合間など、アプリの操作中に画面が切り替わるタイミングで表示されます。アプリにインタースティシャル広告が表示される場合、ユーザーは選択肢を提示できます。 広告をタップしてリンク先に移動するか、広告を閉じて戻ります。 必要があります。 事例紹介

このガイドでは、インタースティシャル広告を Android アプリや iOS アプリに組み込む方法について説明します Google Mobile Ads C++ SDK を使用します

前提条件

常にテスト広告でテストする

アプリを作成、テストする際は、テスト広告ではなく、 配信します。実際の広告を使用すると、アカウントが停止される可能性があります。

テスト広告を読み込むには、次に示すインタースティシャル広告向けのテスト専用広告ユニット ID を使う方法が便利です。この ID はデバイス プラットフォームによって異なります。

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

すべてのリクエストに対してテスト広告を返すように特別に構成されており、 独自のアプリでコーディング、テスト、デバッグを行う際に、自由に使用できます。 必ずご自身の広告ユニット ID に置き換えてください。 。

Mobile Ads 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. 親ビューを VM にキャストして InterstitialAd インスタンスを初期化します。 AdParent 型。親ビューは、Android への JNI jobject 参照です。 Activity、または 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. フューチャーを変数として保持する代わりに、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 クラスを拡張する必要があります。 インタースティシャル広告の表示やライフサイクル イベントの通知を通知できます。カスタム FullScreenContentListener サブクラスは InterstitialAd::SetFullScreenContentListener() メソッドで登録できます。このサブクラスは、広告の表示が成功または失敗したとき、および広告が閉じられたときにコールバックを受け取ります。

次のコードは、クラスを拡張して広告に割り当てる方法を示しています。

  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();

ベスト プラクティス

インタースティシャル広告がアプリに適した広告タイプかどうかを検討します。
インタースティシャル広告は、自然な移行ポイント(画面の切り替わりなど)があるアプリに適しています。画像の共有やゲームレベルのクリアなど、アプリ内で特定のタスクが完了したタイミングがこうした切り替わりポイントになります。ユーザーも流れの中断を想定しているため、インタースティシャル広告を表示しても操作性を損ないません。アプリのワークフローのどの時点でインタースティシャル広告を表示するか、ユーザーがそれにどう反応しそうかをよく検討してください。
インタースティシャル広告を表示する際には必ずアクションを一時停止しましょう。
インタースティシャル広告にはさまざまなタイプ(テキスト、イメージ、 使用できます。アプリにインタースティシャル広告を表示する際は、アプリで一部のリソースの使用を停止して、広告でそのリソースを利用できるようにすることが重要です。たとえば、スペースを表示するための呼び出しを行うと、 アプリからの音声出力は、必ず一時停止してください。 音声の再生を再開するには、次の OnAdDismissedFullScreenContent メソッドを実行します。 インストールされている FullScreenContentListener: ユーザーが ユーザーが広告の操作を終了したとき。また、サービスを一時的に停止することや、 広告の再生中に負荷の高い計算タスク(ゲームループなど)を 表示されます。これにより、処理が遅くなったり、 グラフィックが反応しない、動画が途切れる。
十分な読み込み時間を確保しましょう。
インタースティシャル広告を適切なタイミングで表示することも大事ですが、それと同様に読み込みの待ち時間を短くすることも重要です。広告の読み込みを事前に完了しておくと、表示の段階で待ち時間が発生しません。
過度に広告を表示しないよう注意しましょう。
インタースティシャル広告の表示頻度を増やすことで収益の向上が見込める一方、ユーザー エクスペリエンスが損なわれ、クリック率の低下につながります。ユーザーがアプリを楽しめなくなるほど頻繁に広告を表示しないでください。
インタースティシャルの表示に読み込み完了 Future を使用しないでください。
ユーザー エクスペリエンスが低下する可能性があります。代わりに、広告を表示する前にプリロードして、

参考情報

GitHub の例

チュートリアル動画シリーズ「Mobile Ads Garage」

成功事例

次のステップ