リワード広告

非推奨: Google Mobile Ads C++ SDK は 2024 年 6 月 17 日をもって非推奨となりました。この SDK がまだ使用されていないプロジェクトでは採用しないでください。2025 年 6 月 17 日にメンテナンス終了（EoM）となります。EoM より前にリリースされた SDK のバージョンは引き続き機能しますが、EoM の後にバグの修正や変更がリリースされることはありません。

Google Mobile Ads C++ SDK の代わりに、AdMob の iOS SDK と Android SDK を使用することを検討してください。サポートについては、Google Mobile Ads SDK 技術フォーラムにお問い合わせください。

リワード広告は、ユーザーが広告を操作することと引き換えにアプリ内で報酬を獲得できる広告です。このガイドでは、Google Mobile Ads C++ SDK を使用して、Android アプリと iOS アプリにリワード広告を統合する方法について説明します。

お客様の成功事例のご紹介: 事例 1 | 事例 2

前提条件

• スタートガイドの手順を完了します。
• （Android のみ）JNI jobject 参照の操作に精通している（Android JNI のヒントを参照）。

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

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

テスト広告を読み込むには、リワード広告向けのテスト専用広告ユニット ID を使用する方法が便利です。この ID はデバイス プラットフォームによって異なります。

• Android: ca-app-pub-3940256099942544/5224354917
• iOS: ca-app-pub-3940256099942544/1712485313

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

Mobile Ads SDK のテスト広告の仕組みについて詳しくは、テスト広告をご覧ください。

実装

リワード広告を組み込む主な手順は、以下のとおりです。

1. 広告を読み込みます。
2. コールバックを登録する
3. 広告を表示してリワード イベントを処理する

RewardedAd を構成する

リワード広告は RewardedAd オブジェクトに表示されるため、リワード広告をアプリに統合するための最初のステップは、RewardedAd のインスタンスを作成して初期化することです。

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

    #include "firebase/gma/rewarded_ad.h"

2. RewardedAd オブジェクトを宣言してインスタンス化します。

    firebase::gma::RewardedAd* rewarded_ad;
    rewarded_ad = new firebase::gma::RewardedAd();

3. 親ビューを AdParent 型にキャストして、RewardedAd インスタンスを初期化します。親ビューは、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 = rewarded_ad->Initialize(ad_parent);
   

4. フューチャーを変数として保持する代わりに、RewardedAd オブジェクトで InitializeLastResult() を呼び出して、初期化オペレーションのステータスを定期的に確認できます。これは、グローバル ゲームループの初期化プロセスを追跡する場合に役立ちます。

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

広告を読み込む

広告の読み込みは、RewardedAd オブジェクトの LoadAd() メソッドを使用して行います。読み込みメソッドでは、RewardedAd オブジェクトを初期化し、広告ユニット ID と AdRequest オブジェクトを用意する必要があります。firebase::Future が返されます。これは、読み込みオペレーションの状態と結果のモニタリングに使用できます。

次のコードは、RewardedAd が正常に初期化された後に広告を読み込む方法を示しています。

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

コールバックを登録する

リワード広告の表示イベントとライフサイクル イベントの通知を受け取るには、FullScreenContentListener クラスを拡張する必要があります。カスタム FullScreenContentListener サブクラスは RewardedAd::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* example_full_screen_content_listener =
    new ExampleFullScreenContentListener();
  rewarded_ad->SetFullScreenContentListener(example_full_screen_content_listener);

RewardedAd は使い捨てオブジェクトです。つまり、リワード広告を一度表示すると、再度表示することはできません。おすすめの方法は、FullScreenContentListener の OnAdDismissedFullScreenContent() メソッドで別のリワード広告を読み込んでおき、前のリワード広告の表示が終了したらすぐに次のリワード広告の読み込みを開始できるようにすることです。

広告を表示してリワード イベントを処理する

リワード広告をユーザーに表示する前に、リワード広告のコンテンツを報酬と引き換えに視聴するかどうか、明確な選択肢を示す必要があります。リワード広告は、必ずユーザーの許可を受けてから表示しなければなりません。

広告を表示する際には、ユーザーへの報酬を処理する UserEarnedReward オブジェクトを指定する必要があります。

次のコードは、RewardedAd を表示する方法を示しています。

// A simple listener track UserEarnedReward events.
class ExampleUserEarnedRewardListener :
    public firebase::gma::UserEarnedRewardListener {
 public:
   ExampleUserEarnedRewardListener() { }

  void OnUserEarnedReward(const firebase::gma::AdReward& reward) override {
    // Reward the user!
  }
};

ExampleUserEarnedRewardListener* user_earned_reward_listener =
  new ExampleUserEarnedRewardListener();
firebase::Future<void> result = rewarded_ad->Show(user_earned_reward_listener);

よくある質問

初期化の呼び出しでタイムアウトは発生しますか？

メディエーション ネットワークの初期化が完了していなくても、Google Mobile Ads C++ SDK では 10 秒が経過すると Initialize() によって返された firebase::Future が完了します。

初期化コールバックを取得したときに、対応準備が完了していないメディエーション ネットワークはどうなりますか？

SDK の初期化が完了した後に広告を読み込むことをおすすめします。メディエーション ネットワークの対応準備が完了していなくても、Google Mobile Ads C++ SDK はそのネットワークに対して広告を要求します。そのため、いったんタイムアウトされても、その後に初期化が完了すれば、メディエーション ネットワークはそのセッション中に発生する後続の広告リクエストに対応することができます。

GetInitializationStatus() を呼び出せば、アプリ セッションの間、すべてのアダプタの初期化ステータスを継続的にポーリングすることができます。

特定のメディエーション ネットワークの対応準備が完了していない理由を確認するには、どうすればよいですか？

AdapterStatus.description() を参照すると、アダプタが広告リクエストの処理に対応できない理由を確認できます。メディエーション アダプタのステータスのロギングの例については、GitHub のクイックスタート アプリの例のソースコードをご覧ください。

参考情報

GitHub の例

• GitHub でクイックスタート アプリのソースコードをご覧ください。