本頁面由 Cloud Translation API 翻譯而成。

原生廣告選項

建立 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 物件，設定其屬性 (disableImageLoading、preferredImageOrientation 和 shouldRequestMultipleImages)，並在初始化期間傳入圖片資產，藉此控制 GADAdLoader 處理圖片資產的方式。

GADNativeAdImageAdLoaderOptions 包含下列屬性：

disableImageLoading

原生廣告圖片素材資源會透過 GADNativeAdImage 執行個體傳回，其中包含 image 和 imageURL 屬性。如果 disableImageLoading 設為 false (也就是預設值 C 中的 NO)，SDK 會自動擷取圖片資產，並為您填入 image 和 imageURL 屬性。如果設為 true (或 Objective-C 中的 YES)，SDK 只會填入 imageURL，讓您自行下載實際圖片。手動下載圖片時，請使用 GADMediaContent 的 mainImage 屬性設定媒體檢視畫面的圖片。

preferredImageOrientation

部分廣告素材有多張圖片可配合不同的裝置方向。應用程式可將這項屬性設為其中一個螢幕方向常數，藉此要求特定方向的圖片：

GADNativeAdImageAdLoaderOptionsOrientationAny
GADNativeAdImageAdLoaderOptionsOrientationLandscape
GADNativeAdImageAdLoaderOptionsOrientationPortrait

如果您使用 preferredImageOrientation 指定橫向或直向圖片方向的偏好設定，SDK 會將符合該方向的圖片放在圖片素材資源陣列中，並在不相符項目後方放置不符合的圖片。有些廣告只提供一種螢幕方向，因此發布商必須確保其應用程式能夠處理橫向和直向圖片。

如未呼叫這個方法，系統會使用 GADNativeAdImageAdLoaderOptionsOrientationAny 的預設值。

shouldRequestMultipleImages

有些圖片素材資源會包含一系列圖片，而非只有圖片。只要將這個值設為 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 ... ]];

GADVideo 選項

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: "ca-app-pub-3940256099942544/3986624511",
    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:@"ca-app-pub-3940256099942544/3986624511"
    rootViewController:self
               adTypes:@[ ... ad type constants ... ]
               options:@[videoOptions]];

GADMultipleAdsAdLoaderOptions

GADMultipleAdsAdLoaderOptions 物件可讓發布商指示廣告載入器在單一請求中載入多個廣告。採用這種方式載入的廣告保證不會重複。GADMultipleAdsAdLoaderOptions 具有單一屬性 numberOfAds，該屬性代表廣告載入器應嘗試傳回的廣告數量。根據預設，這個值為 1，且上限為 5 (即使應用程式請求更多廣告，最多會傳回 5 個廣告)。實際傳回的廣告數量並不保證，但會介於零和 numberOfAds 之間。

GADNativeAdMediaAdLoaderOptions

如要使用這項功能，請在 GADAdLoader 初始化的原生廣告選項陣列中加入 GADNativeAdMediaAdLoaderOptions 類別。

GADNativeAdMediaAdLoaderOptions 物件可讓您選取媒體長寬比偏好設定。這個選項會套用至圖片和影片。此類別有一個屬性：mediaAspectRatio，可用於指定支援的媒體長寬比。這個屬性的值可能如下：

Objective-C	Swift
`GADMediaAspectRatioAny`	`.any`
`GADMediaAspectRatioLandscape`	`.landscape`
`GADMediaAspectRatioPortrait`	`.portrait`
`GADMediaAspectRatioSquare`	`.square`

將 mediaAspectRatio 設為上述任一選項後，只有傳回指定長寬比媒體的廣告才會傳回。這個屬性若未明確設定，則預設值為 GADMediaAspectRatioUnknown，且不會套用長寬比限制。