ネイティブ広告

ネイティブ広告は、プラットフォームに備わっている UI コンポーネントを通じてユーザーに表示される広告アセットです。作成済みのレイアウトに溶け込むように表示され、アプリの視覚デザインに合わせてフォーマットすることができます。

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

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

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

また、お客様の成功事例（事例紹介 1、事例紹介 2）もご覧ください。

前提条件

必ずテスト広告でテストする

アプリの作成とテストでは、実際の配信中の広告ではなくテスト広告を使用するようにしてください。

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

ca-app-pub-3940256099942544/2247696110

この 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() メソッドは、AdLoader を NativeAd 形式用に準備します。広告が正常に読み込まれると、リスナー オブジェクトの 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>

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

広告を表示する

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