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

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

Swift

adLoader = GADAdLoader(adUnitID: "/6499/example/native",
    rootViewController: self,
    adTypes: [ ... ad type constants ... ],
    options: [ ... ad loader options objects ... ])

Objective-C

self.adLoader = [[GADAdLoader alloc]
      initWithAdUnitID:@"/6499/example/native"
    rootViewController:rootViewController
               adTypes:@[ ... ad type constants ... ]
               options:@[ ... ad loader options objects ... ]];

GADNativeAdImageAdLoaderOptions

GADNativeAdImageAdLoaderOptions には、ネイティブ広告の画像に関するプロパティが含まれています。アプリは、GADNativeAdImageAdLoaderOptions オブジェクトを作成し、そのプロパティ(disableImageLoadingpreferredImageOrientationshouldRequestMultipleImages)を設定して、初期化時にそれを渡すことにより、GADAdLoader による画像アセットの処理方法を制御できます。

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

disableImageLoading
ネイティブ広告の画像アセットは、image プロパティと imageURL プロパティを含む GADNativeAdImage のインスタンスを介して返されます。disableImageLoading がデフォルトの false(Objective-C では NO)に設定されている場合、SDK は自動的に画像アセットを取得し、image プロパティと imageURL プロパティの両方に値を設定します。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: "/6499/example/native",
    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:@"/6499/example/native"
    rootViewController:self
               adTypes:@[ ... ad type constants ...  ]
               options:@[ ... ad loader options objects ... ]];

GADVideoOptions

GADVideoOptions は、ネイティブ動画アセットの表示方法を示すためのオブジェクトです。

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

Swift

let videoOptions = GADVideoOptions()
// Ads start muted by default. Set to false to start video ads with sound.
videoOptions.startMuted = false
adLoader = GADAdLoader(
    adUnitID: "/6499/example/native",
    rootViewController: self,
    adTypes: [ ... ad type constants ... ],
    options: [videoOptions])

Objective-C

GADVideoOptions *videoOptions = [[GADVideoOptions alloc] init];
// Ads start muted by default. Set to NO to start video ads with sound.
videoOptions.startMuted = NO;
self.adLoader = [[GADAdLoader alloc]
      initWithAdUnitID:@"/6499/example/native"
    rootViewController:self
               adTypes:@[ ... ad type constants ... ]
               options:@[videoOptions]];

GADNativeAdMediaAdLoaderOptions

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

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

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

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