リワード広告では、ユーザーが広告を操作することと引き換えに、アプリ内で報酬を受け取ることが可能です。このガイドでは、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
インスタンスを初期化します。親ビューは、AndroidActivity
への JNIjobject
参照、または iOSUIView
へのポインタです。// 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 にあるサンプルのクイックスタート アプリのソースコードを表示する。