このページは Cloud Translation API によって翻訳されました。

リワード広告

リワード広告では、ユーザーが広告を操作することと引き換えに、アプリ内で報酬を受け取ることが可能です。このガイドでは、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

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

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

実装

リワード広告を統合する主な手順は次のとおりです。

広告を読み込みます。
コールバックを登録します。
広告を表示し、報酬イベントを処理します。

`RewardedAd` を構成する

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

アプリの C++ コードにヘッダー「
```
 #include "firebase/gma/rewarded_ad.h"
```
」を追加します。

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

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

親ビューを 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);

Future を変数として保持する代わりに、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);

よくある質問

初期化の呼び出しにタイムアウトはありますか？: メディエーションネットワークの初期化が完了していなくても、10 秒が経過すると、Google Mobile Ads C++ SDK は Initialize() から返された firebase::Future を完了します。
初期化コールバックを受け取ったときに、準備が完了していないメディエーションネットワークがある場合はどうなりますか？: SDK の初期化が完了した後に広告を読み込むことをおすすめします。メディエーションネットワークの準備ができていない場合でも、Google Mobile Ads C++ SDK はそのネットワークに広告をリクエストします。そのため、タイムアウト後にメディエーションネットワークが初期化を完了しても、そのセッションで以降の広告リクエストは引き続き処理できます。; アプリセッション中は、GetInitializationStatus() を呼び出すことで、引き続きすべてのアダプタの初期化ステータスをポーリングできます。
特定のメディエーションネットワークの準備ができていない理由を調べるにはどうすればよいですか？: AdapterStatus.description() は、アダプタが広告リクエストを処理する準備ができていない理由を表します。メディエーションアダプタのステータスロギングの例については、GitHub のクイックスタートアプリのサンプルのソースコードをご覧ください。

補足資料

GitHub の例

GitHub にあるサンプルのクイックスタートアプリのソースコードを表示する。