ネイティブ広告

プラットフォームを選択: Android iOS Flutter Unity

ネイティブ広告は、プラットフォームに備わっている UI コンポーネントを通じてユーザーに表示される広告アセットです。作成済みのレイアウトになじむ形で表示されるのに加え、アプリのビジュアル デザインに合わせたフォーマットの調整が可能です。

ネイティブ広告が読み込まれる際は、アセットを含む広告オブジェクトをアプリが受け取り、Google Mobile Ads SDK ではなくアプリがアセットの表示処理を実行します。

ネイティブ広告の実装を 2 つの段階に大きく分けると、SDK を使用して広告を読み込み、アプリにその広告コンテンツを表示するということになります。

このページでは、SDK を使用してネイティブ広告を読み込む方法について説明します。ヒント: ネイティブ広告の詳細については、ネイティブ広告ハンドブックをご覧ください。

成功事例も併せてご覧ください（事例紹介 1 / 事例紹介 2）。

前提条件

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

アプリの開発とテストでは必ずテスト広告を使用し、配信中の実際の広告は使用しないでください。

次のネイティブ広告（Android）向けのテスト専用広告ユニット ID を使うと、テスト広告を簡単に読み込むことができます。

ca-app-pub-3940256099942544/2247696110

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

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

広告を読み込む

ネイティブ広告の読み込みには AdLoader クラスを使用します。このクラスは、独自の Builder クラスを使用して作成時にカスタマイズできるようになっています。AdLoader の作成時にリスナーを追加すると、アプリで受け取るネイティブ広告の種類を指定できます。指定すると、AdLoader はその種類の広告だけをリクエストするようになります。

AdLoader の作成

ネイティブ広告の読み込みが可能な AdLoader を作成する方法については、次のコードをご覧ください。

Java

// It is recommended to call AdLoader.Builder on a background thread.
new Thread(
        () -> {
          AdLoader adLoader =
              new AdLoader.Builder(context, "AD_UNIT_ID")
                  .forNativeAd(
                      new NativeAd.OnNativeAdLoadedListener() {
                        @Override
                        // The native ad loaded successfully. You can show the ad.
                        public void onNativeAdLoaded(@NonNull NativeAd nativeAd) {}
                      })
                  .withAdListener(
                      new AdListener() {
                        @Override
                        // The native ad load failed. Check the adError message for failure
                        // reasons.
                        public void onAdFailedToLoad(@NonNull LoadAdError adError) {}
                      })
                  // Use the NativeAdOptions.Builder class to specify individual options
                  // settings.
                  .withNativeAdOptions(new NativeAdOptions.Builder().build())
                  .build();
        })
    .start();
NativeAdSnippets.java

Kotlin

// It is recommended to call AdLoader.Builder on a background thread.
CoroutineScope(Dispatchers.IO).launch {
  val adLoader =
    AdLoader.Builder(context, "AD_UNIT_ID")
      .forNativeAd { nativeAd ->
        // The native ad loaded successfully. You can show the ad.
      }
      .withAdListener(
        object : AdListener() {
          override fun onAdFailedToLoad(adError: LoadAdError) {
            // The native ad load failed. Check the adError message for failure reasons.
          }
        }
      )
      // Use the NativeAdOptions.Builder class to specify individual options settings.
      .withNativeAdOptions(NativeAdOptions.Builder().build())
      .build()
}
NativeAdSnippets.kt

AD_UNIT_ID は、実際のテストデバイス ID に置き換えてください。

forNativeAd() メソッドは、NativeAd フォーマットの AdLoader を準備します。広告の読み込みに成功すると、リスナー オブジェクトの onNativeAdLoaded() メソッドが呼び出されます。

AdLoader で AdListener を設定する（省略可）

AdLoader を作成する際、withAdListener 関数で AdLoader の AdListener を設定します。このメソッドは AdListener を唯一のパラメータとして受け取ります。広告のライフサイクル イベントが発生すると、このパラメータは AdLoader からコールバックを受け取ります。

Java

adLoaderBuilder.withAdListener(
    // Override AdListener callbacks here.
    new AdListener() {});
NativeAdSnippets.java

Kotlin

adLoaderBuilder.withAdListener(
  // Override AdListener callbacks here.
  object : AdListener() {}
)
NativeAdSnippets.kt

広告をリクエストする

AdLoader の作成が完了したら、それを使用して広告を読み込みます。広告の読み込みに使用できるメソッドには、loadAd() と loadAds() の 2 つがあります。

loadAd()

このメソッドは、1 つの広告に対してリクエストを送ります。

Java

adLoader.loadAd(new AdRequest.Builder().build());
NativeAdSnippets.java

Kotlin

adLoader.loadAd(AdRequest.Builder().build())
NativeAdSnippets.kt

loadAds()

このメソッドは、次のように複数の広告（最大 5 個）に対してリクエストを送ります。

Java

// Load three native ads.
adLoader.loadAds(new AdRequest.Builder().build(), 3);
NativeAdSnippets.java

Kotlin

// Load three native ads.
adLoader.loadAds(AdRequest.Builder().build(), 3)
NativeAdSnippets.kt

これらのメソッドは、どちらも最初のパラメータとして AdRequest オブジェクトを受け取ります。これは、バナーやインタースティシャルで使用するのと同じ AdRequest クラスです。ターゲティング情報を追加する際は、他の広告フォーマットの場合と同様に AdRequest クラスのメソッドを使用できます。

複数の広告を読み込む（省略可）

loadAds() メソッドでは、追加パラメータとして、リクエストで SDK が読み込みを試行する広告の数を指定できます。指定できる数は最大 5 個です。なお、リクエストされた数の広告を SDK が返すことは保証されません。

返される Google 広告はすべて異なります。ただし、予約済み広告在庫またはサードパーティの購入者からの広告については、一意であるとは限りません。

メディエーションを使用している場合は、loadAds() メソッドを使用しないでください。複数のネイティブ広告のリクエストは、メディエーション用に設定されている広告ユニット ID では機能しません。

コールバック

loadAd() を呼び出すと、ネイティブ広告オブジェクトの配信かエラーの報告を行うために、事前に定義したリスナー メソッドに単一のコールバックが実行されます。

loadAds() を呼び出した後は、そうしたコールバックが複数回（少なくとも 1 回、最大で広告がリクエストされた回数）行われます。複数の広告をリクエストするアプリでは、読み込みプロセスが完了したかどうかを判断するため、コールバックの実装で AdLoader.isLoading() を呼び出すことが推奨されます。

onNativeAdLoaded() コールバックで isLoading() を確認する方法の例は次のとおりです。

Java

adLoaderBuilder
    .forNativeAd(
        nativeAd -> {
          // This callback is invoked when a native ad is successfully loaded.
        })
    .build();
NativeAdSnippets.java

Kotlin

adLoaderBuilder
  .forNativeAd { nativeAd ->
    // This callback is invoked when a native ad is successfully loaded.
  }
  .build()
NativeAdSnippets.kt

リソースを解放する

読み込まれたネイティブ広告では、destroy() メソッドを必ず使用してください。これにより、使用されたリソースが解放され、メモリリークが防止されます。

アクティビティの onDestroy() メソッド内で、NativeAd へのすべての参照が破棄されていることを確認してください。

onNativeAdLoaded コールバック内で、逆参照される既存のネイティブ広告が破棄されていることを確認してください。

また、アクティビティが破棄されたかどうかの確認も重要です。破棄された場合は、返された広告上で destroy() を呼び出してメソッドを直ちに終了します。

Java

nativeAd.destroy();
NativeAdSnippets.java

Kotlin

nativeAd.destroy()
NativeAdSnippets.kt

ベスト プラクティス

広告を読み込む際は、次のルールに従ってください。

  • リストでネイティブ広告を使用するアプリでは、広告のリストをプリキャッシュします。

  • 広告をプリキャッシュする場合は、1 時間後にキャッシュをクリアして再読み込みします。

  • 最初のリクエストの読み込みが完了するまで、AdLoader で loadAd() または loadAds() を呼び出さないでください。

  • ネイティブ広告のキャッシュ保存は、必要なものに限定して行います。たとえばプリキャッシュする場合は、画面にすぐに表示される広告のみをキャッシュに保存します。ネイティブ広告はメモリ使用量が大きいため、ネイティブ広告を破棄せずキャッシュに保存すると、過剰にメモリを使用することになります。

  • ネイティブ広告が不要になったら破棄します。

動画広告のハードウェア アクセラレーション

ネイティブ広告で動画広告を正常に表示するには、ハードウェア アクセラレーションを有効にする必要があります。

ハードウェア アクセラレーションはデフォルトで有効になっていますが、一部のアプリでは無効にすることもできます。お客様のアプリで無効にできる場合、広告を使用するアクティビティ クラスのハードウェア アクセラレーションを有効にすることをおすすめします。

ハードウェア アクセラレーションの有効化

ハードウェア アクセラレーションをグローバルに有効にするとアプリが正しく動作しない場合は、個々のアクティビティでの設定が可能です。ハードウェア アクセラレーションを有効または無効にするには、AndroidManifest.xml の <application> および <activity> 要素で android:hardwareAccelerated 属性を使用します。次の例では、アプリ全体でハードウェア アクセラレーションを有効にしつつ、1 つのアクティビティで無効にしています。

<application android:hardwareAccelerated="true">
    <!-- For activities that use ads, hardwareAcceleration should be true. -->
    <activity android:hardwareAccelerated="true" />
    <!-- For activities that don't use ads, hardwareAcceleration can be false. -->
    <activity android:hardwareAccelerated="false" />
</application>

HardwareAccelerationSnippet.xml

ハードウェア アクセラレーションを制御するオプションについて詳しくは、ハードウェア アクセラレーション ガイドをご覧ください。アクティビティが無効の場合、個々の広告ビューではハードウェア アクセラレーションを有効にできないため、アクティビティ自体でハードウェア アクセラレーションが有効になっている必要があります。

広告を表示する

広告を読み込んだら、あとは広告をユーザーに表示するだけです。方法はネイティブ アドバンスに関するガイドでご確認ください。