原生廣告選項

原生廣告提供許多進階功能,可讓您進行額外自訂,並提供最佳廣告體驗。本指南將說明如何使用原生廣告的進階功能。

必要條件

素材資源控制選項

偏好的媒體顯示比例控制項

媒體顯示比例控制項可讓您指定廣告素材的顯示比例偏好設定。

使用 GADMediaAspectRatio 設定 GADNativeAdMediaAdLoaderOptions mediaAspectRatio

  • 如果未設定,傳回的廣告可以採用任何媒體顯示比例。

  • 設定後,即可指定偏好的顯示比例類型,提升使用者體驗。

以下範例指示 SDK 偏好採用特定顯示比例的傳回圖片或影片。

GADNativeAdMediaAdLoaderOptions *nativeOption = [[GADNativeAdMediaAdLoaderOptions alloc] init];
nativeOption.mediaAspectRatio = GADMediaAspectRatioAny;

GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
                                           rootViewController:self
                                                      adTypes:@[ GADAdLoaderAdTypeNative ]
                                                      options:@[ nativeOption ]];

圖片下載控制項

圖片下載控制項可讓您決定 SDK 要傳回圖片素材資源或僅傳回 URI。

使用 BOOL 值設定 GADNativeAdImageAdLoaderOptions disableImageLoading
  • 圖片下載控制項預設為停用。

  • 停用後,Google Mobile Ads SDK 會為您填入圖片和 URI。

  • 啟用後,SDK 只會填入 URI,讓您自行決定是否要下載實際圖片。

以下範例會指示 SDK 只傳回 URI。

GADNativeAdImageAdLoaderOptions *nativeOption = [[GADNativeAdImageAdLoaderOptions alloc] init];
nativeOption.disableImageLoading = YES;

GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
                                           rootViewController:self
                                                      adTypes:@[ GADAdLoaderAdTypeNative ]
                                                      options:@[ nativeOption ]];

圖片酬載控制項

有些廣告內含一系列的圖片,而不是單一圖片。您可以使用這項功能,指出應用程式是否已準備好顯示所有圖片或只有一張。

使用 BOOL 值設定 GADNativeAdImageAdLoaderOptions shouldRequestMultipleImages
  • 圖片酬載控制項預設為停用。

  • 停用後,應用程式會指示 SDK 只為包含系列叢書的任何素材資源提供第一張圖片。

  • 啟用後,應用程式會表示已準備好顯示所有圖像,適用於任何擁有多個圖像的素材資源。

以下範例會指示 SDK 傳回多個圖片資產。

GADNativeAdImageAdLoaderOptions *nativeOption = [[GADNativeAdImageAdLoaderOptions alloc] init];
nativeOption.shouldRequestMultipleImages = YES;

GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
                                           rootViewController:self
                                                      adTypes:@[ GADAdLoaderAdTypeNative ]
                                                      options:@[ nativeOption ]];

AdChoices 刊登位置

AdChoices 位置控制項

AdChoices 位置控制項可讓您選擇要顯示 AdChoices 圖示的角落。

使用 GADAdChoicesPosition 值設定 GADNativeAdViewAdOptions preferredAdChoicesPosition

  • 如果未設定,AdChoices 圖示位置會設為右上方。

  • 如果已設定,AdChoices 就會依要求放置在自訂位置。

以下範例說明如何設定自訂 AdChoices 圖片位置。

GADNativeAdViewAdOptions *nativeOptions = [[GADNativeAdViewAdOptions alloc] init];
nativeOptions.preferredAdChoicesPosition = GADAdChoicesPositionTopLeftCorner;

GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
                                           rootViewController:self
                                                      adTypes:@[ GADAdLoaderAdTypeNative ]
                                                      options:@[ nativeOptions ]];

AdChoices 自訂檢視畫面

AdChoices 自訂檢視畫面功能可讓您將 AdChoices 圖示放在自訂位置。這與 AdChoices 位置控制項不同,後者只允許指定四個角落中的一個。

在算繪前,請使用 GADAdChoicesView 設定 GADNativeAd.adChoicesView 屬性,AdChoices 內容就會算繪至 GADAdChoicesView 中。

以下範例說明如何設定自訂 AdChoices 檢視畫面。AdChoices 圖示會在 GADAdChoicesView 中顯示。

Objective-C

- (void)adLoader:(GADAdLoader *)adLoader didReceiveNativeAd:(GADNativeAd *)nativeAd {

    ...

    
    GADAdChoicesView *customAdChoicesView =
        [[GADAdChoicesView alloc] initWithFrame: CGRectMake(..., ..., ..., ...)];

    [nativeAdView addSubview:customAdChoicesView];
    nativeAdView.adChoicesView = customAdChoicesView;

    // Associate the native ad view with the native ad object. This is
    // required to make the ad clickable.
    // Note: this should always be done after populating the ad views.
    nativeAdView.nativeAd = nativeAd;
}

Swift

func adLoader(_ adLoader: GADAdLoader, didReceive nativeAd: GADNativeAd) {
    refreshAdButton.isEnabled = true

    ...
    // Define a custom position for the AdChoices icon.
    let customRect = CGRect(x: 100, y: 100, width: 15, height: 15)
    let customAdChoicesView = GADAdChoicesView(frame: customRect)
    nativeAdView.addSubview(customAdChoicesView)
    nativeAdView.adChoicesView = customAdChoicesView

    // Associate the native ad view with the native ad object. This is
    // required to make the ad clickable.
    // Note: this should always be done after populating the ad views.
    nativeAdView.nativeAd = nativeAd;
}

影片控制選項

啟動靜音行為

啟動靜音行為後,即可停用或啟用影片的起始音訊。

使用 BOOL 值設定 GADVideoOptions startMuted
  • 根據預設,系統會啟用開始靜音的行為。

  • 停用時,應用程式要求的影片應從音訊開始。

  • 啟用後,您的應用程式會要求將影片開頭設為靜音。

以下範例說明如何啟動影片,並讓音訊不靜音。

GADVideoOptions *nativeOptions = [[GADVideoOptions alloc] init];
nativeOptions.startMuted = NO;

GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
                                           rootViewController:self
                                                      adTypes:@[ GADAdLoaderAdTypeNative ]
                                                      options:@[ nativeOptions ]];

自訂播放控制項

這樣一來,您就能要求自訂影片輸入控制項,以便播放、暫停或靜音影片。

使用 BOOL 值設定 GADVideoOptions customControlsRequested
  • 自訂播放控制項預設為停用,

  • 停用後,影片會顯示 SDK 算繪的輸入控制項。

  • 如果廣告含有影片內容,且已啟用自訂控制項,則應一併顯示自訂控制項,因為廣告本身不會顯示任何控制項。控制項隨後可在 GADVideoController 上呼叫相關方法。

以下範例說明如何要求含有自訂播放控制項的影片。

GADVideoOptions *nativeOptions = [[GADVideoOptions alloc] init];
nativeOptions.customControlsRequested = YES;

GADAdLoader* adLoader = [[GADAdLoader alloc] initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
                                           rootViewController:self
                                                      adTypes:@[ GADAdLoaderAdTypeNative ]
                                                      options:@[ nativeOptions ]];

檢查是否已啟用自訂控制項

由於在要求時無法得知傳回的廣告是否允許自訂影片控制項,因此您必須檢查是否已啟用自訂控制項。

Objective-C

- (void)adLoader:(GADAdLoader *)adLoader
    didReceiveNativeAd:(GADNativeAd*)nativeAd {

  GADVideoController *videoController = nativeAd.mediaContent.videoController;
  BOOL canShowCustomControls = videoController.customControlsEnabled;

}

Swift

func adLoader(_ adLoader: GADAdLoader, didReceive nativeAd: GADNativeAd) {
        let videoController = nativeAd.mediaContent.videoController
        let canShowCustomControls = videoController?.customControlsEnabled() == true
}

顯示自訂影片控制項

請按照下列最佳做法顯示自訂影片控制項:

  1. 將自訂控制項檢視畫面顯示為原生廣告檢視畫面的子項。這麼做可確保 Open Measurement 可視度計算會將自訂控制項視為友善阻礙物。
  2. 避免在整個媒體檢視畫面上顯示不可見的疊加層。重疊層會阻擋媒體檢視畫面的點擊,進而影響原生廣告成效。請改為建立小型疊加層,大小剛好可容納控制項。

自訂點擊手勢

自訂點擊手勢是一種原生廣告功能,可讓系統將廣告檢視畫面上的滑動動作登錄為廣告點擊。這項功能可與使用滑動手勢瀏覽內容的應用程式搭配使用。本指南將說明如何在原生廣告中啟用自訂點擊手勢。

使用所選滑動方向初始化 GADNativeAdCustomClickGestureOptions 執行個體。您也必須指出是否要允許輕觸動作視為點擊。

  • 自訂點擊手勢預設為停用。

  • 關閉後,系統只會將點按動作計為點擊。

  • 啟用後,滑動手勢會計為點擊,您可以指定輕觸動作是否仍可計為點擊。

以下範例說明如何在右側實作自訂滑動手勢,並保留一般的輕觸行為。

GADNativeAdCustomClickGestureOptions *swipeGestureOptions = [[GADNativeAdCustomClickGestureOptions alloc]
        initWithSwipeGestureDirection:UISwipeGestureRecognizerDirectionRight
                          tapsAllowed:YES];

// The following sample ad unit ID has been enabled for custom click gestures
// and can be used for testing.
self.adLoader = [[GADAdLoader alloc]
        initWithAdUnitID:@"ca-app-pub-3940256099942544/3986624511"
      rootViewController:self
                 adTypes:@[ GADAdLoaderAdTypeNative ]
                 options:@[ swipeGestureOptions ]];

監聽滑動手勢事件

當滑動手勢點擊動作遭到記錄時,Google Mobile Ads SDK 會在 GADNativeAdDelegate 上叫用 nativeAdDidRecordSwipeGestureClick: 委派方法,以及現有的 nativeAdDidRecordClick: 委派方法。

#pragma mark - GADNativeAdDelegate implementation

// Called when a swipe gesture click is recorded.
- (void)nativeAdDidRecordSwipeGestureClick:(GADNativeAd *)nativeAd {
  NSLog(@"A swipe gesture click has occurred.");
}

// Called when a swipe gesture click or a tap click is recorded, as configured in
// GADNativeAdCustomClickGestureOptions.
- (void)nativeAdDidRecordClick:(GADNativeAd *)nativeAd {
  NSLog(@"A swipe gesture click or tap click has occurred.");
}

中介服務

自訂點擊手勢僅適用於 Google Mobile Ads SDK 算繪的原生廣告。需要第三方 SDK才能算繪的廣告來源,不會回應自訂點擊方向設定。