ネイティブ広告のオプション

ネイティブ広告を使用すると、NativeAdOptions オブジェクトを使用して追加のカスタマイズを行うことができます。このガイドでは、NativeAdOptions の使用方法を説明します。

設定オプション

withNativeAdOptions()
AdLoader の作成に含まれる最後の関数は、もうひとつのオプション メソッド withNativeAdOptions() です。

Java

AdLoader adLoader = new AdLoader.Builder(context, "ca-app-pub-3940256099942544/2247696110")
    .forUnifiedNativeAd(new UnifiedNativeAd.OnUnifiedNativeAdLoadedListener() {
        @Override
        public void onUnifiedNativeAdLoaded(UnifiedNativeAd unifiedNativeAd) {
            // Show the ad.
        }
    })
    .withAdListener(new AdListener() {
        @Override
        public void onAdFailedToLoad(int errorCode) {
            // 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")
    .forUnifiedNativeAd { ad : UnifiedNativeAd ->
        // Show the ad.
    }
    .withAdListener(object : AdListener() {
        override fun onAdFailedToLoad(errorCode: Int) {
            // 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()
The

NativeAdOptions オブジェクトを使用すると、アプリはリクエストに使用される特定のオプションを設定できます。その Builder クラスは、インスタンスを作成する際に使用する以下のメソッドを提供します。

setReturnUrlsForImageAssets()
ネイティブ広告の画像アセットは、NativeAd.Image のインスタンス経由で返されます。NativeAd.Image は DrawableUri を保持します。このオプションが false(デフォルト設定)の場合は、SDK が画像アセットを自動的に取得して、DrawableUri の両方に値が入力されます。しかし、このオプションが true の場合は、SDK が Uri だけに値を入力するため、実際にダウンロードする画像はご自身の判断で決定できます。
setImageOrientation()

クリエイティブによっては、デバイスの向きに合わせて選べるように複数の画像が用意されている場合もあります。このメソッドを呼び出す際に画面の向きを示す定数 NativeAdOptions のいずれか(ORIENTATION_PORTRAITORIENTATION_LANDSCAPEORIENTATION_ANY)を指定すると、その向きの画像がリクエストされます。このメソッドを呼び出さなければ、デフォルト値 ORIENTATION_LANDSCAPE が使われます。

setRequestMultipleImages()

画像アセットには、画像が 1 つだけでなく複数含まれている場合もあります。この値を true に設定すると、複数の画像を含むアセットの場合でもアプリにすべての画像を表示できると示すことになります。この値をデフォルトの false に設定すると、複数の画像を含むアセットの場合は最初の画像だけを返すようにアプリから SDK に指示することになります。

AdLoader の作成時に withNativeAdOptions を呼び出さなければ、各オプションでデフォルト値が使われます。

setAdChoicesPlacement()

AdChoices オーバーレイは、デフォルトでは右上に配置されます。オーバーレイのレンダリング位置をアプリで変更するには、プロパティを次のいずれかに設定します。

  • ADCHOICES_TOP_LEFT
  • ADCHOICES_TOP_RIGHT
  • ADCHOICES_BOTTOM_RIGHT
  • ADCHOICES_BOTTOM_LEFT
setVideoOptions()

アプリでこのメソッドを使うと、ネイティブ広告の一部として動画アセットを返すように指定できます。詳細については、ネイティブ アドバンスのネイティブ動画セクションをご覧ください。

フィードバックを送信...

ご不明な点がありましたら、Google のサポートページをご覧ください。