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

GADAdLoader の作成に含まれる最後のパラメータは、オブジェクトのオプション配列です。このセクションでは、これらのオプションについて説明します。

Swift

adLoader = GADAdLoader(adUnitID: "ca-app-pub-3940256099942544/3986624511",
    rootViewController: self,
    adTypes: [ ... ad type constants ... ],
    options: [ ... ad loader options objects ... ])

Objective-C

self.adLoader = [[GADAdLoader alloc]
      initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
    rootViewController:rootViewController
               adTypes:@[ ... ad type constants ... ]
               options:@[ ... ad loader options objects ... ]];

GADNativeAdImageAdLoaderOptions

GADNativeAdImageAdLoaderOptions には、ネイティブ アドバンス広告の画像に関連するプロパティが含まれます。GADNativeAdImageAdLoaderOptions オブジェクトを作成し、そのプロパティ(disableImageLoadingpreferredImageOrientationshouldRequestMultipleImages)を設定して初期化中に渡すことで、ネイティブ アドバンス広告の画像アセットを GADAdLoader で処理する方法をアプリでコントロールできます。

GADNativeAdImageAdLoaderOptions には次のプロパティがあります。

disableImageLoading
ネイティブ広告の画像アセットは、imageimageURL のプロパティを含む GADNativeAdImage のインスタンスを介して返されます。disableImageLoadingfalse(Objective-C では NO)が設定されると、SDK が自動的に画像アセットを取得し、imageimageURL の両方のプロパティを設定します。このプロパティに true(Objective-C では YES)が設定されると、SDK が自動的に設定するのは imageURL のみとなり、実際の画像はご自身の判断でダウンロードできます。画像を手動でダウンロードする際は、GADMediaContentmainImage プロパティを使ってメディアビューの画像を設定します。
preferredImageOrientation

クリエイティブによっては、デバイス画面の向きに合わせられるように複数の画像が用意されている場合があります。アプリで特定の向きの画像をリクエストするには、画面の向きを示す次のいずれかの定数値をこのプロパティに設定します。

  • GADNativeAdImageAdLoaderOptionsOrientationAny
  • GADNativeAdImageAdLoaderOptionsOrientationLandscape
  • GADNativeAdImageAdLoaderOptionsOrientationPortrait

    preferredImageOrientation を使って画像の向き(横向きか縦向き)を指定した場合、SDK は指定された向きに一致する画像を画像アセット配列の最初に配置し、一致しない画像をその後に配置します。画像の向きが 1 つだけの広告もあるため、アプリでは横向きと縦向きのどちらの画像にも対応できるようにしてください。

    このメソッドが呼び出されなければ、デフォルト値の GADNativeAdImageAdLoaderOptionsOrientationAny が使われます。

shouldRequestMultipleImages

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

GADAdLoader を初期化する際に GADAdLoaderOptions オブジェクトが渡されない場合は、どのオプションでもデフォルト値が使われます。

GADNativeAdViewAdOptions

GADNativeAdViewAdOptions オブジェクトでは、ネイティブ広告ビューで広告をどのように表示したいかを示すことができます。このオブジェクトの唯一のプロパティ preferredAdChoicesPosition では、AdChoices アイコンを配置する場所を指定できます。このアイコンは広告の四隅のいずれかに表示でき、デフォルトは GADAdChoicesPositionTopRightCorner です。このプロパティで指定可能な値は次のとおりです。

  • GADAdChoicesPositionTopRightCorner
  • GADAdChoicesPositionTopLeftCorner
  • GADAdChoicesPositionBottomRightCorner
  • GADAdChoicesPositionBottomLeftCorner

AdChoices アイコンを広告の左上に配置する方法について、次に例を示します。

Swift

let adViewOptions = GADNativeAdViewAdOptions()
adViewOptions.preferredAdChoicesPosition = .topLeftCorner
adLoader = GADAdLoader(adUnitID: "ca-app-pub-3940256099942544/3986624511",
    rootViewController: self,
    adTypes: [ ... ad type constants ... ],
    options: [ ... ad loader options objects ... ])

Objective-C

GADNativeAdViewAdOptions *adViewOptions = [[GADNativeAdViewAdOptions alloc] init];
adViewOptions.preferredAdChoicesPosition = GADAdChoicesPositionTopLeftCorner;
self.adLoader = [[GADAdLoader alloc]
      initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
    rootViewController:self
               adTypes:@[ ... ad type constants ...  ]
               options:@[ ... ad loader options objects ... ]];

GADVideoOptions

GADVideoOptions オブジェクトでは、ネイティブ動画アセットをどのように表示するかを示すことができます。このオブジェクトの唯一のプロパティは startMuted です。

このブール値は、動画アセットの再生をミュート状態で開始するかどうかを示します。デフォルト値は true です。

GADMultipleAdsAdLoaderOptions

GADMultipleAdsAdLoaderOptions オブジェクトでは、1 回のリクエストで複数の広告を読み込むように広告ローダに指示できます。この方法で読み込まれる広告は、決して重複しません。GADMultipleAdsAdLoaderOptions の唯一のプロパティ numberOfAds は、広告ローダがリクエストに対して(可能な限り)返すべき広告数を表します。デフォルト値は 1 で、上限は 5 です(アプリで上限を超える広告数をリクエストしても、返される広告は最大で 5 個になります)。実際に返される広告数は保証されませんが、ゼロから numberOfAds 個のいずれかになります。

GADNativeAdMediaAdLoaderOptions

この機能を使うには、GADAdLoader 初期化のネイティブ広告オプション配列に GADNativeAdMediaAdLoaderOptions クラスを含めます。

GADNativeAdMediaAdLoaderOptions オブジェクトでは、メディアのアスペクト比を選択できます。このオプションは画像と動画の両方に適用されます。このクラスのプロパティ mediaAspectRatio を使うと、サポート対象のメディア アスペクト比を指定できます。このプロパティで指定可能な値は次のとおりです。

Objective-CSwift
GADMediaAspectRatioAny .any
GADMediaAspectRatioLandscape .landscape
GADMediaAspectRatioPortrait .portrait
GADMediaAspectRatioSquare .square

これらのオプションのいずれかに mediaAspectRatio を設定すると、そのアスペクト比のメディアを使った広告だけが返されます。このプロパティが明示的に設定されていない場合、値はデフォルトで GADMediaAspectRatioUnknown となり、アスペクト比に関する制限は何も適用されません。