バナー広告

バナー広告は、デバイス画面の上部か下部にアプリのレイアウト内の一部分を使用して表示されます。ユーザーがアプリを操作している間、画面に表示され続けます。 一定の時間が経過すると自動的に更新されるよう設定できますGoogle Cloud の その出発点として最適です 事例紹介

前提条件

必ずテスト広告でテストする

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

テスト広告を読み込むには、専用のテスト広告ユニット ID を使用すると、 バナーはデバイス プラットフォームによって異なります。

  • Android: ca-app-pub-3940256099942544/6300978111
  • iOS: ca-app-pub-3940256099942544/2934735716

これらの広告ユニット ID は、すべてのリクエストに対してテスト広告を返すように特別に設定されており、アプリのコーディング、テスト、デバッグで自由に使うことができます。必ずご自身の広告ユニット ID に置き換えてください。 必要があります。

Mobile Ads SDK のテスト広告の仕組みについて詳しくは、 テスト広告

実装

AdView を構成する

バナー広告は AdView オブジェクトで表示されるため、 バナー広告を組み込むことは、AdView を作成して配置することです。

  1. アプリの C++ コードに次のヘッダーを追加します。

     #include "firebase/gma/ad_view.h"
  2. AdView オブジェクトを宣言してインスタンス化します。

      firebase::gma::AdView* ad_view;
      ad_view = new firebase::gma::AdView();
  3. AdSize を作成し、AdParent 親を使用して広告ビューを初期化します。 表示されます。親ビューは、Android Activity への JNI jobject 参照です。 または、AdParent 型にキャストする 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 result =
       ad_view->Initialize(ad_parent, kBannerAdUnit, firebase::gma::AdSize::kBanner);
  4. 将来を変数として保持する代わりに、 初期化オペレーションのステータスを定期的にチェックするには、 AdView オブジェクトに対する InitializeLastResult()。この情報は以下に役立つかもしれません グローバル ゲームループで初期化プロセスを追跡します。

      // Monitor the status of the future in your game loop:
      firebase::Future<void> result = ad_view->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.
      }
    
  5. firebase::Future の使用について詳しくは、以下をご覧ください。 Future を使用してメソッドの完了ステータスをモニタリングする 呼び出し

広告の掲載順位を設定する

AdView の位置は、初期化後にいつでも設定できます。

firebase::Future<void> result = ad_view->SetPosition(firebase::gma::AdView::kPositionTop);

広告を読み込む

AdView が初期化されたら、広告を読み込むことができます。

firebase::gma::AdRequest ad_request;
firebase::Future<firebase::gma::AdResult> load_ad_result = ad_view->LoadAd(my_ad_request);

AdRequest オブジェクトは単一の広告リクエストを表し、ターゲティングなどの情報のプロパティを含みます。

広告を表示する

最後に、Show() を呼び出して画面に広告を表示します。このメソッドは、広告が初期化された後でいつでも呼び出されます。

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

広告イベント

Google Mobile Ads C++ SDK には、拡張可能な AdListener クラスが用意されています。 広告の変更について通知を受けるには、AdView::SetListener() に渡します。 必要があります。

AdListener のメソッドの拡張は任意であるため、必要な操作は あります。以下は、すべてのクラスを拡張するクラスの実装例です。 AdListener メソッドクラスの:

class ExampleAdListener
    : public firebase::gma::AdListener {
 public:
  ExampleAdListener() {}
  void OnAdClicked() override {
    // This method is invoked when the user clicks the ad.
  }

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

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

  void OnAdOpened() override {
    // This method is invoked when an ad opens an overlay that covers the screen.
  }
};

ExampleAdListener* ad_listener = new ExampleAdListener();
ad_view->SetAdListener(ad_listener);

下の表は標準のバナーサイズを示しています。

ポイント単位(幅×高さ) 説明 対象 firebase::gma::AdSize 定数
320×50 バナー 携帯電話とタブレット kBanner
320×100 バナー(大) 携帯電話とタブレット kLargeBanner
300×250 IAB レクタングル(中) 携帯電話とタブレット kMediumRectangle
468×60 IAB フルサイズ バナー タブレット kFullBanner
728×90 IAB ビッグバナー タブレット kLeaderboard
指定された幅 x 最適な高さ アダプティブ バナー 携帯電話とタブレット なし

カスタムの広告サイズ

カスタムのバナーサイズを定義するには、 firebase::gma::AdSize 指定しています:

firebase::gma::AdSize ad_size(/*width=*/320, /*height=*/50);

参考情報

GitHub の例

成功事例