Google Mobile Ads SDK はメンテナンスモードです。最新のアップデートと機能を利用するには、GMA Next-Gen SDK に移行して設定してください。

アプリ起動時広告

プラットフォームを選択: Android iOS Unity Flutter Android（以前のバージョン）

このガイドは、Google Mobile Ads SDK (Legacy) を使ってアプリ起動時広告を統合するパブリッシャー様を対象としています。

アプリ起動時広告は、アプリの読み込み画面の収益化をご希望のパブリッシャー様を対象とした広告フォーマットです。この広告は、ユーザーがアプリをフォアグラウンドに移動すると表示され、いつでも閉じることができます。

アプリ起動時広告ではアプリのブランディングエリアが自動的に表示されるため、ユーザーはアプリが起動中であることがわかります。以下は、アプリ起動時広告の表示例です。

前提条件

先に進む前に、Google Mobile Ads SDK (Legacy) を設定してください。

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

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

下記のアプリ起動時広告向けのテスト専用広告ユニット ID を使うと、テスト広告を簡単に読み込むことができます。

ca-app-pub-3940256099942544/9257395921

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

Google Mobile Ads SDK (Legacy) のテスト広告の仕組みについて詳しくは、テスト広告を有効にするをご覧ください。

Application クラスを拡張する

Application クラスを拡張する新しいクラスを作成します。これにより、単一の Activity ではなくアプリの状態に関連付けられた広告を、ライフサイクルを認識した方法で管理できます。

Java

public class MyApplication extends Application
    implements ActivityLifecycleCallbacks, DefaultLifecycleObserver {

  private AppOpenAdManager appOpenAdManager;
  private Activity currentActivity;

  @Override
  public void onCreate() {
    super.onCreate();
    this.registerActivityLifecycleCallbacks(this);

    ProcessLifecycleOwner.get().getLifecycle().addObserver(this);
    appOpenAdManager = new AppOpenAdManager();
  }
MyApplication.java

Kotlin

class MyApplication :
  Application(), Application.ActivityLifecycleCallbacks, DefaultLifecycleObserver {

  private lateinit var appOpenAdManager: AppOpenAdManager
  private var currentActivity: Activity? = null

  override fun onCreate() {
    super<Application>.onCreate()
    registerActivityLifecycleCallbacks(this)

    ProcessLifecycleOwner.get().lifecycle.addObserver(this)
    appOpenAdManager = AppOpenAdManager()
  }
MyApplication.kt

次に、以下のコードを AndroidManifest.xml に追加します。

<!-- TODO: Update to reference your actual package name. -->
<application
    android:name="com.google.android.gms.example.appopendemo.MyApplication" ...>
...
</application>

ユーティリティコンポーネントを実装する

広告ができるだけ早く表示されるように、表示するタイミングの前に広告を読み込むことをおすすめします。そうすることで、アプリがフォアグランドに移動するとすぐに広告が表示されるようになります。

ユーティリティコンポーネント AppOpenAdManager を実装して、アプリ起動時広告の読み込みと表示に関連する処理をカプセル化します。

Java

private class AppOpenAdManager {

  private static final String LOG_TAG = "AppOpenAdManager";
  private static final String AD_UNIT_ID = "ca-app-pub-3940256099942544/9257395921";

  private AppOpenAd appOpenAd = null;
  private boolean isLoadingAd = false;
  private boolean isShowingAd = false;

  /** Keep track of the time an app open ad is loaded to ensure you don't show an expired ad. */
  private long loadTime = 0;

  /** Constructor. */
  public AppOpenAdManager() {}MyApplication.java

Kotlin

private inner class AppOpenAdManager {

  private var appOpenAd: AppOpenAd? = null
  private var isLoadingAd = false
  var isShowingAd = false

  /** Keep track of the time an app open ad is loaded to ensure you don't show an expired ad. */
  private var loadTime: Long = 0MyApplication.kt

AppOpenAdManager を使用するには、シングルトン MyApplication インスタンスでパブリックラッパーメソッドを呼び出します。Application クラスは、コードの残りの部分とインターフェースをとり、広告の読み込みと表示の作業をマネージャーにデリゲートします。

広告を読み込む

次のステップでは、loadAd() メソッドを入力して、広告読み込みコールバックを処理します。

Java

AppOpenAd.load(
    context,
    "AD_UNIT_ID",
    new AdRequest.Builder().build(),
    new AppOpenAdLoadCallback() {
      @Override
      public void onAdLoaded(AppOpenAd ad) {
        // Called when an app open ad has loaded.
        Log.d(LOG_TAG, "App open ad loaded.");

        appOpenAd = ad;
        isLoadingAd = false;
        loadTime = (new Date()).getTime();
      }

      @Override
      public void onAdFailedToLoad(LoadAdError loadAdError) {
        // Called when an app open ad has failed to load.
        Log.d(LOG_TAG, "App open ad failed to load with error: " + loadAdError.getMessage());

        isLoadingAd = false;
      }
    });MyApplication.java

Kotlin

AppOpenAd.load(
  context,
  "AD_UNIT_ID",
  AdRequest.Builder().build(),
  object : AppOpenAdLoadCallback() {
    override fun onAdLoaded(ad: AppOpenAd) {
      // Called when an app open ad has loaded.
      Log.d(LOG_TAG, "App open ad loaded.")

      appOpenAd = ad
      isLoadingAd = false
      loadTime = Date().time
    }

    override fun onAdFailedToLoad(loadAdError: LoadAdError) {
      // Called when an app open ad has failed to load.
      Log.d(LOG_TAG, "App open ad failed to load with error: " + loadAdError.message)

      isLoadingAd = false
    }
  },
)MyApplication.kt

AD_UNIT_ID は、実際の広告ユニット ID に置き換えられます。

広告を表示する

アプリ起動の最も一般的な実装方法は、アプリの起動直前にアプリ起動時広告の表示を試み、広告の準備ができていない場合はアプリのコンテンツを開始して、次のアプリ起動の機会に備えて別の広告をプリロードすることです。実装例については、アプリ起動時広告のガイドラインをご覧ください。

次のコードは、広告を表示してから再読み込みします。

Java

public void showAdIfAvailable(
    @NonNull final Activity activity,
    @NonNull OnShowAdCompleteListener onShowAdCompleteListener) {
  // If the app open ad is already showing, do not show the ad again.
  if (isShowingAd) {
    Log.d(TAG, "The app open ad is already showing.");
    return;
  }

  // If the app open ad is not available yet, invoke the callback then load the ad.
  if (appOpenAd == null) {
    Log.d(TAG, "The app open ad is not ready yet.");
    onShowAdCompleteListener.onShowAdComplete();
    // Load an ad.
    return;
  }

  isShowingAd = true;
  appOpenAd.show(activity);
}
AppOpenAdSnippets.java

Kotlin

fun showAdIfAvailable(activity: Activity, onShowAdCompleteListener: OnShowAdCompleteListener) {
  // If the app open ad is already showing, do not show the ad again.
  if (isShowingAd) {
    Log.d(TAG, "The app open ad is already showing.")
    return
  }

  // If the app open ad is not available yet, invoke the callback then load the ad.
  if (appOpenAd == null) {
    Log.d(TAG, "The app open ad is not ready yet.")
    onShowAdCompleteListener.onShowAdComplete()
    // Load an ad.
    return
  }

  isShowingAd = true
  appOpenAd?.show(activity)
}
AppOpenAdSnippets.kt

FullScreenContentCallback を設定する

FullScreenContentCallback は、AppOpenAd の表示に関連するイベントを処理します。AppOpenAd を表示する前に、コールバックを以下のように設定してください。

Java

appOpenAd.setFullScreenContentCallback(
    new FullScreenContentCallback() {
      @Override
      public void onAdDismissedFullScreenContent() {
        // Called when full screen content is dismissed.
        Log.d(TAG, "Ad dismissed fullscreen content.");
        // Don't forget to set the ad reference to null so you
        // don't show the ad a second time.
        appOpenAd = null;
        isShowingAd = false;

        onShowAdCompleteListener.onShowAdComplete();
        // Load an ad.
      }

      @Override
      public void onAdFailedToShowFullScreenContent(@NonNull AdError adError) {
        // Called when full screen content failed to show.
        Log.d(TAG, adError.getMessage());
        appOpenAd = null;
        // Don't forget to set the ad reference to null so you
        // don't show the ad a second time.
        isShowingAd = false;

        onShowAdCompleteListener.onShowAdComplete();
        // Load an ad.
      }

      @Override
      public void onAdShowedFullScreenContent() {
        Log.d(TAG, "Ad showed fullscreen content.");
      }

      @Override
      public void onAdImpression() {
        // Called when an impression is recorded for an ad.
        Log.d(TAG, "The ad recorded an impression.");
      }

      @Override
      public void onAdClicked() {
        // Called when ad is clicked.
        Log.d(TAG, "The ad was clicked.");
      }
    });AppOpenAdSnippets.java

Kotlin

appOpenAd?.fullScreenContentCallback =
  object : FullScreenContentCallback() {
    override fun onAdDismissedFullScreenContent() {
      // Called when full screen content is dismissed.
      Log.d(TAG, "Ad dismissed fullscreen content.")
      // Don't forget to set the ad reference to null so you
      // don't show the ad a second time.
      appOpenAd = null
      isShowingAd = false

      onShowAdCompleteListener.onShowAdComplete()
      // Load an ad.
    }

    override fun onAdFailedToShowFullScreenContent(adError: AdError) {
      // Called when full screen content failed to show.
      Log.d(TAG, adError.message)
      // Don't forget to set the ad reference to null so you
      // don't show the ad a second time.
      appOpenAd = null
      isShowingAd = false

      onShowAdCompleteListener.onShowAdComplete()
      // Load an ad.
    }

    override fun onAdShowedFullScreenContent() {
      Log.d(TAG, "Ad showed fullscreen content.")
    }

    override fun onAdImpression() {
      // Called when an impression is recorded for an ad.
      Log.d(TAG, "The ad recorded an impression.")
    }

    override fun onAdClicked() {
      // Called when ad is clicked.
      Log.d(TAG, "The ad was clicked.")
    }
  }AppOpenAdSnippets.kt

広告の有効期限を考慮する

期限切れの広告を表示しないようにするには、メソッドを AppOpenAdManager に追加して、広告参照の読み込みからの経過時間と、広告の有効性を確認できるようにします。

Java

/** Check if ad was loaded more than n hours ago. */
private boolean wasLoadTimeLessThanNHoursAgo(long numHours) {
  long dateDifference = (new Date()).getTime() - loadTime;
  long numMilliSecondsPerHour = 3600000;
  return (dateDifference < (numMilliSecondsPerHour * numHours));
}

/** Check if ad exists and can be shown. */
private boolean isAdAvailable() {
  // For time interval details, see: https://support.google.com/admob/answer/9341964
  return appOpenAd != null && wasLoadTimeLessThanNHoursAgo(4);
}
MyApplication.java

Kotlin

/** Check if ad was loaded more than n hours ago. */
private fun wasLoadTimeLessThanNHoursAgo(numHours: Long): Boolean {
  val dateDifference: Long = Date().time - loadTime
  val numMilliSecondsPerHour: Long = 3600000
  return dateDifference < numMilliSecondsPerHour * numHours
}

/** Check if ad exists and can be shown. */
private fun isAdAvailable(): Boolean {
  // For time interval details, see: https://support.google.com/admob/answer/9341964
  return appOpenAd != null && wasLoadTimeLessThanNHoursAgo(4)
}
MyApplication.kt

現在のアクティビティをトラッキングする

広告を表示するには、Activity コンテキストが必要です。使用されている最新のアクティビティをトラッキングするには、Application.ActivityLifecycleCallbacks を登録して実装します。

Java

@Override
public void onActivityCreated(@NonNull Activity activity, @Nullable Bundle savedInstanceState) {}

@Override
public void onActivityStarted(@NonNull Activity activity) {
  // An ad activity is started when an ad is showing, which could be AdActivity class from Google
  // SDK or another activity class implemented by a third party mediation partner. Updating the
  // currentActivity only when an ad is not showing will ensure it is not an ad activity, but the
  // one that shows the ad.
  if (!appOpenAdManager.isShowingAd) {
    currentActivity = activity;
  }
}

@Override
public void onActivityResumed(@NonNull Activity activity) {}

@Override
public void onActivityPaused(@NonNull Activity activity) {}

@Override
public void onActivityStopped(@NonNull Activity activity) {}

@Override
public void onActivitySaveInstanceState(@NonNull Activity activity, @NonNull Bundle outState) {}

@Override
public void onActivityDestroyed(@NonNull Activity activity) {}
MyApplication.java

Kotlin

override fun onActivityCreated(activity: Activity, savedInstanceState: Bundle?) {}

override fun onActivityStarted(activity: Activity) {
  // An ad activity is started when an ad is showing, which could be AdActivity class from Google
  // SDK or another activity class implemented by a third party mediation partner. Updating the
  // currentActivity only when an ad is not showing will ensure it is not an ad activity, but the
  // one that shows the ad.
  if (!appOpenAdManager.isShowingAd) {
    currentActivity = activity
  }
}

override fun onActivityResumed(activity: Activity) {}

override fun onActivityPaused(activity: Activity) {}

override fun onActivityStopped(activity: Activity) {}

override fun onActivitySaveInstanceState(activity: Activity, outState: Bundle) {}

override fun onActivityDestroyed(activity: Activity) {}
MyApplication.kt

registerActivityLifecycleCallbacks を使用すると、すべての Activity イベントをリッスンできます。アクティビティの開始と破棄のタイミングをリッスンすることで、現在の Activity への参照をトラッキングして、アプリ起動時広告の表示に使用します。

アプリのフォアグラウンドイベントをリッスンする

アプリのフォアグラウンドイベントをリッスンする手順は次のとおりです。

Gradle ファイルにライブラリを追加する

アプリのフォアグラウンドイベントについて通知を受け取るには、DefaultLifecycleObserver を登録する必要があります。アプリレベルのビルドファイルに依存関係を追加します。

Kotlin

  dependencies {
    implementation("com.google.android.gms:play-services-ads:25.4.0")
    implementation("androidx.lifecycle:lifecycle-process:2.8.3")
  }

Groovy

  dependencies {
    implementation 'com.google.android.gms:play-services-ads:25.4.0'
    implementation 'androidx.lifecycle:lifecycle-process:2.8.3'
  }

ライフサイクルオブザーバーインターフェースを実装する

DefaultLifecycleObserver インターフェースを実装すると、フォアグラウンドイベントをリッスンできます。

アプリ起動時広告を表示するには、onStart() を実装します。

Java

@Override
public void onStart(@NonNull LifecycleOwner owner) {
  DefaultLifecycleObserver.super.onStart(owner);
  // Show the ad (if available) when the app moves to foreground.
  appOpenAdManager.showAdIfAvailable(currentActivity);
}
MyApplication.java

Kotlin

override fun onStart(owner: LifecycleOwner) {
  super.onStart(owner)
  currentActivity?.let {
    // Show the ad (if available) when the app moves to foreground.
    appOpenAdManager.showAdIfAvailable(it)
  }
}
MyApplication.kt

コールドスタートと読み込み画面

このドキュメントではこれまでのところ、アプリ起動時広告が表示されるのは、メモリで一時停止していたアプリがフォアグラウンドに移動した場合のみを想定していました。「コールドスタート」は、メモリ内で一時停止されていなかったアプリが起動された場合に発生します。

コールドスタートの例として、ユーザーが初めてアプリを開くときを挙げることができます。コールドスタートでは、直ちに表示することのできる読み込み済みのアプリ起動時広告がありません。広告をリクエストしてから広告が返されるまでに時間差があるため、ユーザーが少しだけアプリを使用したところで突然コンテキストから外れた広告が表示されることになってしまいます。ユーザーエクスペリエンスの低下につながるこのような事態は、避ける必要があります。

コールドスタートでアプリ起動時広告を使用する場合のおすすめの方法は、ゲームまたはアプリのアセットを読み込んでいる読み込み画面からのみ広告を表示することです。アプリの読み込みが完了し、アプリのメインコンテンツが開いたら、そこには広告を表示しないでください。

ベストプラクティス

アプリ起動時広告では、アプリの初回起動時やアプリの切り替え時にアプリの読み込み画面が収益化されますが、ユーザーがアプリをスムーズに使用できるよう、以下のベストプラクティスを念頭に置いてください。

ユーザーがアプリを数回使用した後に、アプリ起動時広告を初めて表示します。
ユーザーが本来ならアプリの読み込みを待機しているだけの間に、アプリ起動時広告を表示します。
アプリ起動時広告の下に読み込み画面が存在し、広告が閉じられる前に読み込み画面の読み込みが完了した場合は、onAdDismissedFullScreenContent() メソッドで読み込み画面を閉じることができます。

GitHub の例

アプリ起動時広告の例: Java | Kotlin

次のステップ

次のトピックについて確認します。

アプリ起動時広告 コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

前提条件

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

Application クラスを拡張する

Java

Kotlin

ユーティリティ コンポーネントを実装する

Java

Kotlin

広告を読み込む

Java

Kotlin

広告を表示する

Java

Kotlin

FullScreenContentCallback を設定する

Java

Kotlin

広告の有効期限を考慮する

Java

Kotlin

現在のアクティビティをトラッキングする

Java

Kotlin

アプリのフォアグラウンド イベントをリッスンする

Gradle ファイルにライブラリを追加する

Kotlin

Groovy

ライフサイクル オブザーバー インターフェースを実装する

Java

Kotlin

コールド スタートと読み込み画面

ベスト プラクティス

GitHub の例

次のステップ

アプリ起動時広告

ユーティリティコンポーネントを実装する

アプリのフォアグラウンドイベントをリッスンする

ライフサイクルオブザーバーインターフェースを実装する

コールドスタートと読み込み画面

ベストプラクティス