ネイティブ広告は、プラットフォーム ネイティブの UI コンポーネントを介してユーザーに表示される広告アセットです。すでにレイアウトを作成しているのと同じタイプのビューを使用して表示され、アプリのビジュアル デザインに合わせてフォーマットできます。
ネイティブ広告が読み込まれると、アプリはそのアセットを含む広告オブジェクトを受け取り、(Google Mobile Ads SDK ではなく)アプリが広告を表示します。
大まかに言うと、ネイティブ広告の実装は、SDK を使用して広告を読み込み、アプリに広告コンテンツを表示するという 2 つの段階に分かれています。
このページでは、SDK を使用して ネイティブ広告を読み込む方法について説明します。
前提条件
- スタートガイドを完了している。
必ずテスト広告でテストする
アプリの作成とテストの際は、実際の実際の広告ではなく、テスト広告を使用してください。
次のように、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 by logging, altering the UI, and so on.
}
})
.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
を設定します。このメソッドは 1 つのパラメータとして 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()
が呼び出されると、前に定義したリスナー メソッドにコールバックが 1 回行われ、ネイティブ広告オブジェクトを配信するか、エラーが報告されます。
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()
メソッドを使用してください。これにより、利用されたリソースが解放され、メモリリークが防止されます。
すべての NativeAd
参照がアクティビティの onDestroy()
メソッドで破棄されていることを確認します。
onNativeAdLoaded
コールバックでは、逆参照される既存のネイティブ広告をすべて破棄してください。
もう 1 つの重要なチェックは、アクティビティが破棄されているかどうかです。破棄された場合は、返された広告で 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>
ハードウェア アクセラレーションを制御するオプションの詳細については、HW アクセラレーション ガイドをご覧ください。アクティビティが無効になっている場合、個々の広告ビューでハードウェア アクセラレーションを有効にできないため、アクティビティ自体でハードウェア アクセラレーションを有効にする必要があります。
広告を表示する
広告を読み込んだら、あとは広告をユーザーに表示するだけです。 手順については、ネイティブ アドバンスに関するガイドをご覧ください。