ネイティブ広告

ネイティブ広告は、プラットフォームのネイティブ UI コンポーネントを通じてユーザーに表示される広告アセットです。これらは、すでにレイアウトを作成しているのと同じタイプのビューを使用して表示され、アプリのビジュアル デザインに合わせてフォーマットできます。

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

ネイティブ広告の実装は、大まかには、SDK を使って広告を読み込み、アプリにその広告コンテンツを表示するという 2 つの段階に分けられます。

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

事例紹介 1、事例紹介 2 など、顧客の成功事例もご覧ください。

前提条件

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

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

テスト広告を読み込む最も簡単な方法は、次に示す Android のネイティブ広告向けのテスト専用広告ユニット ID を使用することです。

ca-app-pub-3940256099942544/2247696110

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

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

広告を読み込む

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

AdLoader の作成

次のコードは、ネイティブ広告を読み込むことができる AdLoader を作成する方法を示しています。

Java

AdLoader adLoader = new AdLoader.Builder(context, "ca-app-pub-3940256099942544/2247696110")
    .forNativeAd(new NativeAd.OnNativeAdLoadedListener() {
        @Override
        public void onNativeAdLoaded(NativeAd nativeAd) {
            // Show the ad.
        }
    })
    .withAdListener(new AdListener() {
        @Override
        public void onAdFailedToLoad(LoadAdError adError) {
            // Handle the failure by logging, altering the UI, and so on.
        }
    })
    .withNativeAdOptions(new NativeAdOptions.Builder()
            // Methods in the NativeAdOptions.Builder class can be
            // used here to specify individual options settings.
            .build())
    .build();

Kotlin

val adLoader = AdLoader.Builder(this, "ca-app-pub-3940256099942544/2247696110}")
    .forNativeAd { ad : NativeAd ->
        // Show the ad.
    }
    .withAdListener(object : AdListener() {
        override fun onAdFailedToLoad(adError: LoadAdError) {
            // Handle the failure.
        }
    })
    .withNativeAdOptions(NativeAdOptions.Builder()
            // Methods in the NativeAdOptions.Builder class can be
            // used here to specify individual options settings.
            .build())
    .build()

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

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

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

Java

.withAdListener(new AdListener() {
    // AdListener callbacks can be overridden here.
})

Kotlin

.withAdListener(object : AdListener() {
    // AdListener callbacks can be overridden here.
})

広告をリクエスト

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

loadAd()

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

Java

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

Kotlin

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

loadAds()

このメソッドは、複数の広告（最大 5 つ）のリクエストを送信します。

Java

adLoader.loadAds(new AdRequest.Builder().build(), 3);

Kotlin

adLoader.loadAds(AdRequest.Builder().build(), 3)

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

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

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

返される Google 広告はすべて異なります。ただし、予約済み広告枠またはサードパーティ購入者の広告が必ずしも一意であるとは限りません。

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

コールバック

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

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

onNativeAdLoaded() コールバックで isLoading() を確認する方法について、次に例を示します。

Java

final AdLoader adLoader = new AdLoader.Builder(this, "ca-app-pub-3940256099942544/2247696110")
        .forNativeAd(new NativeAd.OnNativeAdLoadedListener() {
    @Override
    public void onNativeAdLoaded(NativeAd nativeAd) {
        ...
        // some code that displays the ad.
        ...
        if (adLoader.isLoading()) {
            // The AdLoader is still loading ads.
            // Expect more adLoaded or onAdFailedToLoad callbacks.
        } else {
            // The AdLoader has finished loading ads.
        }
    }
}).build();
adLoader.loadAds(new AdRequest.Builder().build(), 3);

Kotlin

lateinit var adLoader: AdLoader
...
adLoader = AdLoader.Builder(this, "ca-app-pub-3940256099942544/2247696110")
    .forNativeAd {
        ...
        // some code that displays the ad.
        ...
        if (adLoader.isLoading) {
            // The AdLoader is still loading ads.
            // Expect more adLoaded or onAdFailedToLoad callbacks.
        } else {
            // The AdLoader has finished loading ads.
        }
    }.build()
adLoader.loadAds(AdRequest.Builder().build(), 3)

リソースを解放する

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

アクティビティの onDestroy() メソッドで、すべての NativeAd 参照が破棄されるようにします。

onNativeAdLoaded コールバックで、参照解除される既存のネイティブ広告を破棄してください。

アクティビティが破棄されているかどうかも確認します。破棄されている場合は、返された広告で destroy() を呼び出してすぐに返します。

Java

final AdLoader adLoader = new AdLoader.Builder(this, "ca-app-pub-3940256099942544/2247696110")
        .forNativeAd(new NativeAd.OnNativeAdLoadedListener() {
    @Override
    public void onNativeAdLoaded(NativeAd nativeAd) {
        // If this callback occurs after the activity is destroyed, you
        // must call destroy and return or you may get a memory leak.
        // Note `isDestroyed()` is a method on Activity.
        if (isDestroyed()) {
            nativeAd.destroy();
            return;
        }
        ...
    }
}).build();

Kotlin

lateinit var adLoader: AdLoader
...
adLoader = AdLoader.Builder(this, "ca-app-pub-3940256099942544/2247696110")
    .forNativeAd { nativeAd ->
        // If this callback occurs after the activity is destroyed, you
        // must call destroy and return or you may get a memory leak.
        // Note `isDestroyed` is a method on Activity.
        if (isDestroyed) {
            nativeAd.destroy()
            return@forNativeAd
        }
        ...
    }.build()

ベスト プラクティス

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

  • リスト内のネイティブ広告を使用するアプリは、広告のリストをプリキャッシュする必要があります。

  • 広告をプリキャッシュする場合は、キャッシュを消去してから 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>

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

広告を表示する

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