ネイティブ広告は、プラットフォームに備わっている 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>
ハードウェア アクセラレーションを制御するオプションについて詳しくは、ハードウェア アクセラレーション ガイドをご覧ください。アクティビティが無効の場合、個々の広告ビューではハードウェア アクセラレーションを有効にできないため、アクティビティ自体でハードウェア アクセラレーションが有効になっている必要があります。
広告を表示する
広告を読み込んだら、あとは広告をユーザーに表示するだけです。方法はネイティブ アドバンスに関するガイドでご確認ください。