インタースティシャル広告は、ユーザーが閉じるまでアプリのインターフェース上に全画面表示される広告です。通常は、次のアクティビティに移行する前やゲームレベルをクリアした後の合間など、アプリの操作中に画面が切り替わるタイミングで表示されます。アプリにインタースティシャル広告が表示されると、ユーザーは広告をタップしてリンク先に移動するか、広告を閉じてアプリに戻るかを選択できます。事例紹介
このガイドでは、Google Mobile Ads C++ SDK を使用して Android アプリと iOS アプリにインタースティシャル広告を組み込む方法について説明します。
前提条件
- スタートガイドの手順を完了します。
- (Android のみ)JNI
jobject参照の操作に精通していること(Android JNI のヒントを参照)。
必ずテスト広告でテストする
アプリの開発とテストでは、配信中の実際の広告ではなく、必ずテスト広告を使用してください。実際の広告を使用すると、アカウントが停止される可能性があります。
テスト広告は、次に示すインタースティシャル広告向けの専用テスト広告ユニット ID を使うと簡単に読み込むことができます。この ID はデバイス プラットフォームごとに異なります。
- Android:
ca-app-pub-3940256099942544/1033173712 - iOS:
ca-app-pub-3940256099942544/4411468910
この ID は、すべてのリクエストに対してテスト広告を返すように設定されており、アプリのコーディング、テスト、デバッグで自由に使用することができます。なお、このテスト専用広告ユニット ID は、アプリを公開する前に必ずご自身の広告ユニット ID に置き換えてください。
Mobile Ads SDK のテスト広告の仕組みについて詳しくは、テスト広告をご覧ください。
実装
インタースティシャル広告を組み込む主な手順は、以下のとおりです。
- 広告を読み込みます。
- コールバックを登録します。
- 広告を表示して、そのライフサイクル イベントを処理します。
InterstitialAd を構成する
インタースティシャル広告は InterstitialAd オブジェクトに表示されるため、アプリにインタースティシャル広告を組み込む最初のステップは、InterstitialAd オブジェクトを作成して初期化することです。
アプリの C++ コードに次のヘッダーを追加します。
#include "firebase/gma/interstial_ad.h"
InterstitialAdオブジェクトを宣言してインスタンス化します。firebase::gma::InterstitialAd* interstitial_ad; interstitial_ad = new firebase::gma::InterstitialAd();
AdParent型にキャストされた親ビューを使用して、InterstitialAdインスタンスを初期化します。親ビューは、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 = interstitial_ad->Initialize(ad_parent);future を変数として保持する代わりに、
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 は使い捨てオブジェクトです。つまり、インタースティシャル広告を一度表示すると、再度表示することはできません。おすすめの方法は、FullScreenContentListener の OnAdDismissedFullScreenContent() メソッドで別のインタースティシャル広告を読み込んでおき、前のインタースティシャル広告の表示が終了したらすぐに次のインタースティシャル広告の読み込みを開始できるようにすることです。
広告を表示する
インタースティシャルは、ゲームのレベルが切り替わる合間やタスクが完了した直後など、アプリの実行の流れが自然に一時停止するタイミングで表示される必要があります。FullScreenContentListener を使用して広告が全画面コンテンツを表示したタイミングを判断できますが、Show() から返される Future でも、広告が正常に表示されたタイミングをシグナルで通知できます。
firebase::Future<void> result = interstitial_ad->Show();
ベスト プラクティス
- インタースティシャル広告がご自分のアプリに適しているかどうかを考慮しましょう。
- インタースティシャル広告は、自然な移行ポイント(画面の切り替わりなど)があるアプリに適しています。画像の共有やゲームレベルのクリアなど、アプリ内で特定のタスクが完了したタイミングがこうした切り替わりポイントになります。ユーザーも流れの中断を想定しているため、インタースティシャル広告を表示しても操作性を損ないません。アプリのワークフローのどの時点でインタースティシャル広告を表示するか、ユーザーがそれにどう反応しそうかをよく検討してください。
- インタースティシャル広告を表示する際には、必ずアクションを一時停止しましょう。
- インタースティシャル広告には、テキスト、イメージ、動画など、さまざまな種類があります。アプリにインタースティシャル広告を表示する際は、一部のリソースの使用を停止して、広告でそのリソースを利用できるようにすることも重要です。たとえば、インタースティシャル広告を表示するための呼び出しを行う場合は、アプリで行っているオーディオ出力を一時停止してください。オーディオ出力は、ユーザーが広告の操作を終了した際に呼び出される、インストール済みの
FullScreenContentListenerのOnAdDismissedFullScreenContentメソッドで再開できます。また、負荷の大きい計算処理(ゲームループなど)も、広告の表示中は一時的に止めておくことを検討しましょう。グラフィックの遅延や反応の遅れ、動画の乱れなどを防ぐことができます。 - 十分な読み込み時間を確保しましょう。
- インタースティシャル広告の読み込みに時間がかからないようにすることは、適切なタイミングで表示することと同じくらい重要です。広告の読み込みを事前に完了しておくと、アプリにインタースティシャル広告が完全に読み込まれた状態で、表示の段階で待ち時間が発生しません。
- 過度に広告を表示しないよう注意しましょう。
- インタースティシャル広告の表示頻度を上げると増収につながる可能性がありますが、ユーザー エクスペリエンスが損なわれてクリック率が低下する可能性もあります。ユーザーがアプリを楽しめなくなるほど頻繁に広告を挟むことは避けましょう。
- 読み込み完了の Future を使用してインタースティシャルを表示しないでください。
- ユーザー エクスペリエンスの低下につながる可能性があります。代わりに、広告を表示するタイミングの前に広告をプリロードします。
参考情報
GitHub の例
- GitHub で、サンプル クイックスタート アプリのソースコードをご覧ください。
チュートリアル動画シリーズ「Mobile Ads Garage」
成功事例
次のステップ
- ご自身のインタースティシャル広告ユニットをお持ちでない場合は、AdMob 管理画面で作成します。
- 詳しくは、広告のターゲット設定とインタースティシャル広告のガイダンスをご覧ください。