ネイティブ広告

ネイティブ広告は、広告の管理画面で表示される UI コンポーネントを通じて表示される広告アセットです。 ネイティブに実装されています同じタイプのビューを使用して表示され、 レイアウトはすでに作成中ですが、 アプリのデザインを改善できます。

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

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

このページでは、SDK を使用して読み込む方法について説明します。 ネイティブ広告。

前提条件

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

アプリを作成、テストする際は、テスト広告ではなく、 配信します。

テスト広告を読み込むには、専用のテスト広告ユニット ID を使う方法が最も簡単です Android のネイティブ広告の場合:

/21775744923/example/native

すべてのリクエストに対してテスト広告を返すように特別に構成されており、 独自のアプリでコーディング、テスト、デバッグの際に使用できます。必ず これを実際の広告ユニット ID に置き換えてから、アプリを公開してください。

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

広告を読み込む

ネイティブ広告は AdLoader クラス、 それぞれ独自の Builder 作成時にカスタマイズできます。AdLoader にリスナーを追加する アプリでは、作成可能なネイティブ広告のタイプをアプリで指定する 受信します。その後、AdLoader はそれらのタイプのみをリクエストします。

AdLoader を作成する

次のコードは、ネイティブを読み込める AdLoader のビルド方法を示しています。 広告:

Java

AdLoader adLoader = new AdLoader.Builder(context, "/21775744923/example/native")
    .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, "/21775744923/example/native}")
    .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() メソッドを使用します。このメソッドは、 AdManagerAdRequest 渡します。同じ バナーとインタースティシャルで使用される AdManagerAdRequest クラス また、AdManagerAdRequest クラスのメソッドを使用して、 以下と同様に、ターゲティング情報を追加します。 他の広告フォーマットの場合とほぼ同じです

loadAd()

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

Java

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

Kotlin

adLoader.loadAd(AdManagerAdRequest.Builder().build())

コールバック

loadAd() の呼び出しの後、以前に定義された リスナー メソッドを使ってネイティブ広告オブジェクトを配信するか、エラーを報告します。

リソースを解放する

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

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

onNativeAdLoaded コールバックで、既存の依存関係をすべて破棄し、 指定することもできます。

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

Java

final AdLoader adLoader = new AdLoader.Builder(this, "/21775744923/example/native")
        .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, "/21775744923/example/native")
    .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() を呼び出さない リクエストの読み込みが完了しました。

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

ネイティブ広告のビューで動画広告を適切に表示するには、 ハードウェア 加速 を有効にする必要があります。

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

ハードウェア アクセラレーションを有効にする

ハードウェア アクセラレーションをオンにしてアプリが正しく動作しない場合 個々のアクティビティに対しても制御できます。Google Cloud コンソールで ハードウェア アクセラレーションを無効にする（android:hardwareAccelerated 属性を使用） の <application> および <activity> AndroidManifest.xml 内の要素。次の例では、アプリ全体でハードウェア アクセラレーションを有効にしつつ、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>

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

広告を表示する

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