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

ネイティブ広告では、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()

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

setReturnUrlsForImageAssets()
ネイティブ広告の画像アセットは、NativeAd.Image のインスタンス経由で返されます。NativeAd.Image には DrawableUri が格納されます。このオプションが false(デフォルト設定)の場合は、Google Mobile Ads 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()

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

setMediaAspectRatio()

返されるネイティブ広告の画像または動画のアスペクト比を設定します。NativeMediaAspectRatio を次のいずれかの定数に設定すると、指定されたアスペクト比のメディアを含む広告のみが返されます。

  • NATIVE_MEDIA_ASPECT_RATIO_LANDSCAPE
  • NATIVE_MEDIA_ASPECT_RATIO_PORTRAIT
  • NATIVE_MEDIA_ASPECT_RATIO_SQUARE
  • NATIVE_MEDIA_ASPECT_RATIO_ANY

NativeMediaAspectRatio が設定されていない場合は、任意のアスペクト比の広告が返されます。

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

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