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

原生廣告選項

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

必要條件

整合原生廣告格式。

資產控制選項

首選媒體顯示比例控制項

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

使用 NativeAdOptions.MediaAspectRatio 值呼叫 NativeAdOptions.Builder.setMediaAspectRatio()。

如果未設定，傳回的廣告可以採用任何媒體顯示比例。
設定後，您就能指定偏好的顯示比例類型，進而改善使用者體驗。

以下範例會指示 SDK 優先傳回具有特定顯示比例的圖片或影片。

NativeAdOptions nativeAdOptions = new NativeAdOptions.Builder()
                              .setMediaAspectRatio(NativeAdOptions.NATIVE_MEDIA_ASPECT_RATIO_LANDSCAPE)
                              .build();

AdLoader loader = new AdLoader.Builder(this, 'ca-app-pub-3940256099942544/2247696110')
                              .withNativeAdOptions(nativeAdOptions)
                              .build();

圖片下載控制項

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

使用 boolean 值呼叫 NativeAdOptions.Builder.setReturnUrlsForImageAssets()。

圖片下載控制項預設為停用。
停用後，Google Mobile Ads SDK 會為您填入圖片和 URI。
啟用後，SDK 只會填入 URI，讓您自行決定是否要下載實際圖片。

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

NativeAdOptions nativeAdOptions = new NativeAdOptions.Builder()
                                                     .setReturnUrlsForImageAssets(true)
                                                     .build();

AdLoader loader = new AdLoader.Builder(this, 'ca-app-pub-3940256099942544/2247696110')
                              .withNativeAdOptions(nativeAdOptions)
                              .forNativeAd(nativeAd -> {
                                List<Uri> imageUris = new ArrayList<>();
                                for (Image image : nativeAd.getImages()) {
                                  imageUris.add(image.getUri());
                                }
                              })
                              .build();

映像檔酬載控制項

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

使用 boolean 值呼叫 NativeAdOptions.Builder.setRequestMultipleImages()。

圖片酬載控制項預設為停用。
停用後，應用程式會指示 SDK 只為包含系列叢書的任何素材資源提供第一張圖片。
啟用後，應用程式表示已準備好為具有多個素材資源的素材資源顯示所有圖片。

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

NativeAdOptions nativeAdOptions = new NativeAdOptions.Builder()
                                                     .setRequestMultipleImages(true)
                                                     .build();

AdLoader loader = new AdLoader.Builder(this, 'ca-app-pub-3940256099942544/2247696110')
                              .withNativeAdOptions(nativeAdOptions)
                              .build();

AdChoices 刊登位置

AdChoices 位置控制項

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

使用 NativeAdOption.AdChoicesPlacement 值呼叫 NativeAdOptions.Builder.setAdChoicesPlacement()。

如未設定，AdChoices 圖示位置會設為右上方。
如果已設定，AdChoices 就會依要求放置在自訂位置。

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

NativeAdOptions nativeAdOptions = new NativeAdOptions.Builder()
                                                     .setAdChoicesPlacement(NativeAdOptions.ADCHOICES_BOTTOM_RIGHT)
                                                     .build();

AdLoader loader = new AdLoader.Builder(this, 'ca-app-pub-3940256099942544/2247696110')
                              .withNativeAdOptions(nativeAdOptions)
                              .build();

AdChoices 自訂檢視畫面

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

使用 AdChoicesView 值呼叫 NativeAdView.setAdChoicesView()。

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


public void onNativeAdLoaded(NativeAd ad) {
    NativeAdView nativeAdView = new NativeAdView(getApplicationContext());
    AdChoicesView adChoicesView = new AdChoicesView(this);
    nativeAdView.setAdChoicesView(adChoicesView);
}

影片控制選項

開始靜音行為

啟動靜音行為可讓您停用或啟用影片的開始音訊。

使用 boolean 值呼叫 VideoOptions.Builder.setStartMuted()。

根據預設，系統會啟用開始靜音的行為。
停用時，應用程式要求的影片應從音訊開始。
啟用後，應用程式會要求影片一開始播放時，音訊應處於靜音狀態。

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

VideoOptions videoOptions = new VideoOptions.Builder()
                                            .setStartMuted(false)
                                            .build();

NativeAdOptions adOptions = new NativeAdOptions.Builder()
                                               .setVideoOptions(videoOptions)
                                               .build();

AdLoader loader = new AdLoader.Builder(this, 'ca-app-pub-3940256099942544/2247696110')
                              .withNativeAdOptions(adOptions).build();

自訂播放控制項

如此一來，您可以要求自訂影片輸入控制項來播放、暫停或靜音。

使用 boolean 值呼叫 VideoOptions.Builder.setCustomControlsRequested()。

自訂播放控制項預設為停用，
停用後，影片會顯示 SDK 算繪的輸入控制項。

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

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

VideoOptions videoOptions = new VideoOptions.Builder()
                                            .setCustomControlsRequested(true)
                                            .build();

NativeAdOptions adOptions = new NativeAdOptions.Builder()
                                               .setVideoOptions(videoOptions)
                                               .build();

AdLoader loader = new AdLoader.Builder(this, 'ca-app-pub-3940256099942544/2247696110')
                              .withNativeAdOptions(adOptions).build();

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

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

Java

@Override
public void onNativeAdLoaded(NativeAd nativeAd) {
  MediaContent mediaContent = nativeAd.getMediaContent();
  if (mediaContent != null) {
    VideoController videoController = mediaContent.getVideoController();
    boolean canShowCustomControls = videoController.isCustomControlsEnabled();
  }
}

Kotlin

NativeAd.OnNativeAdLoadedListener { ad ->
  val mediaContent = ad.mediaContent
  if (mediaContent != null) {
    val videoController = mediaContent.videoController
    val canShowCustomControls = videoController.isCustomControlsEnabled
  }
}

顯示自訂影片控制項

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

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

自訂點擊手勢

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

使用 NativeAdOptions.SwipeGestureDirection 和 boolean 呼叫 NativeAdOptions.Builder.enableCustomClickGestureDirection()，指定是否允許輕觸即可當做點擊操作。

自訂點擊手勢預設為停用。
停用後，應用程式會支援正常的點擊行為。
啟用後，應用程式就會支援自訂滑動手勢。

以下範例會在右側實作自訂滑動手勢，並保留一般的分頁行為。

NativeAdOptions adOptions = new NativeAdOptions
    .Builder()
    .enableCustomClickGestureDirection(NativeAdOptions.SWIPE_GESTURE_DIRECTION_RIGHT,
            /* tapsAllowed= */ true)
    .build();

// The following sample ad unit ID has been enabled for custom click gestures
// and can be used for testing.
AdLoader.Builder builder = new AdLoader
    .Builder(this, 'ca-app-pub-3940256099942544/2247696110')
    .withNativeAdOptions(adOptions);

監聽滑動手勢事件

當滑動手勢點擊動作遭到記錄時，Google Mobile Ads SDK 會在 AdListener 上叫用 onAdSwipeGestureClicked() 方法，以及現有的 onAdClicked() 方法。

AdLoader adLoader = builder
    .withAdListener(
      new AdListener() {
        // Called when a swipe gesture click is recorded.
        @Override
        public void onAdSwipeGestureClicked() {
          Log.d(TAG, "A swipe gesture click has occurred.")
        }

        // Called when a swipe gesture click or a tap click is recorded, as
        // configured in NativeAdOptions.
        @Override
        public void onAdClicked() {
          Log.d(TAG, "A swipe gesture click or a tap click has occurred.")
        }
      })
    .build();

中介服務

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