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

原生廣告選項

原生廣告支援多種進階功能，您可以自訂更多項目，打造最佳廣告體驗。本指南說明如何運用這些進階功能。

必要條件

整合原生廣告格式。

素材資源控制選項

本節將詳細說明如何自訂原生廣告中的廣告素材資源。您可以指定偏好的媒體素材資源顯示比例，以及圖片素材資源的下載和顯示方式。

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

「媒體顯示比例控制項」用於指定偏好的廣告素材顯示比例。

呼叫 NativeAdRequest.Builder.setMediaAspectRatio()，並傳遞 NativeAd.NativeMediaAspectRatio 值。

如未設定這個控制項，傳回的廣告可能採用任何媒體顯示比例。
如有設定，廣告將採用指定的顯示比例，有助您提升使用者體驗。

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

Kotlin

val adRequest = NativeAdRequest.Builder(
  "ca-app-pub-3940256099942544/2247696110",
  listOf(NativeAd.NativeAdType.NATIVE))
  .setMediaAspectRatio(NativeAd.NATIVE_MEDIA_ASPECT_RATIO_LANDSCAPE)
  .build()

Java

NativeAdRequest adRequest = new NativeAdRequest.Builder(
  "ca-app-pub-3940256099942544/2247696110",
  List.of(NativeAd.NativeAdType.NATIVE))
  .setMediaAspectRatio(NativeAd.NATIVE_MEDIA_ASPECT_RATIO_LANDSCAPE)
  .build();

圖片下載控制選項

您可使用圖片下載控制項，指示 SDK 傳回圖片素材資源，或只傳回 URI。

呼叫 NativeAdRequest.Builder.disableImageDownloading()。

圖片下載控制項預設為停用。
這個控制項停用時，GMA Next Gen SDK 會代您填入圖片和 URI。
如果啟用這個控制項，SDK 會只填入 URI。您可自行決定是否下載實際圖片。

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

Kotlin

val adRequest = NativeAdRequest.Builder(
    "ca-app-pub-3940256099942544/2247696110",
    listOf(NativeAd.NativeAdType.NATIVE))
    .setMediaAspectRatio(NativeAd.NATIVE_MEDIA_ASPECT_RATIO_LANDSCAPE)
    .disableImageDownloading()
    .build()

val adCallback: NativeAdLoaderCallback =
  object : NativeAdLoaderCallback {
    override fun onNativeAdLoaded(nativeAd: NativeAd) {
      // Get the image uri.
      val imageUri = nativeAd.image?.uri
    }
  };

// Load the native ad with the ad request and callback.
NativeAdLoader.load(adRequest, adLoaderCallback);

Java

NativeAdRequest adRequest = new NativeAdRequest.Builder(
  "ca-app-pub-3940256099942544/2247696110",
  List.of(NativeAd.NativeAdType.NATIVE))
  .disableImageDownloading()
  .build();

NativeAdLoaderCallback adLoaderCallback =
  new NativeAdLoaderCallback() {
    @Override
    public void onNativeAdLoaded(@NonNull NativeAd nativeAd) {
      // Get the image uri.
      Uri imageUri = nativeAd.getImage().getUri();
    }
  };

// Load the native ad with the ad request and callback.
NativeAdLoader.load(adRequest, adLoaderCallback);

圖片酬載控制項

部分廣告不會只顯示一張圖片，而是一系列多張圖片。您可以使用這項功能，指示應用程式準備顯示所有圖片，或只顯示一張圖片。

圖片酬載控制項預設為停用。
如果停用這個控制項，應用程式會指示 SDK 在處理多張圖片的素材資源時，只提供第一張圖片。
如果啟用這個控制項，代表應用程式已準備好顯示多張圖片素材資源。

以下範例說明如何指示 SDK 傳回多個圖片素材資源。

AdChoices 刊登位置

本節詳細說明如何疊放 AdChoices 標籤。除了四個角落之一，這個標籤也可以在自訂檢視區塊中顯示。

AdChoices 位置控制項

您可使用 AdChoices 位置控制項，選擇要在哪個角落顯示 AdChoices 圖示。

呼叫 NativeAdRequest.Builder.setAdChoicesPlacement()，並傳遞 NativeAdRequest.AdChoicesPlacement 值。

如未設定這個控制項，AdChoices 圖示預設顯示在右上角。
如有設定，AdChoices 圖示會依指示放在適當的位置。

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

Kotlin

val adRequest = NativeAdRequest.Builder(
  "ca-app-pub-3940256099942544/2247696110",
  listOf(NativeAd.NativeAdType.NATIVE))
  .setAdChoicesPlacement(NativeAdOptions.ADCHOICES_BOTTOM_RIGHT)
  .build()

Java

NativeAdRequest adRequest = new NativeAdRequest.Builder(
  "ca-app-pub-3940256099942544/2247696110",
  List.of(NativeAd.NativeAdType.NATIVE))
  .setAdChoicesPlacement(NativeAdOptions.ADCHOICES_BOTTOM_RIGHT)
  .build();

AdChoices 自訂檢視區塊

使用 AdChoices 自訂檢視區塊功能，可自由安排 AdChoices 圖示位置。這項功能不同於 AdChoices 位置控制項，只能選擇規定的四個角落。

呼叫 NativeAdView.setAdChoicesView()，並傳遞 AdChoicesView 值。

以下範例示範如何設定自訂 AdChoices 檢視區塊，並在 AdChoicesView 內算繪 AdChoices 圖示。

Kotlin

override fun onNativeAdLoaded(nativeAd: NativeAd) {
  val nativeAdView = NativeAdView(applicationContext)
  val adChoicesView = AdChoicesView(this)
  nativeAdView.adChoicesView = adChoicesView
}

Java

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

影片控制選項

本節詳細說明如何自訂影片廣告的播放體驗。您可以將初始播放狀態設為靜音，並導入自訂播放控制項。

初始靜音行為

初始靜音行為用來指定影片一開始是否播放聲音。

呼叫 VideoOptions.Builder.setStartMuted()，並傳遞 boolean 值，然後呼叫 NativeAdOptions.Builder.setVideoOptions()。

根據預設，影片一開始會靜音播放。
如果停用這個控制項，應用程式會要求影片一開始就播放聲音。
如果啟用這個控制項，應用程式會要求影片開始播放時應靜音。

以下範例說明如何使影片一開始就播放聲音。

Kotlin

val videoOptions = VideoOptions.Builder()
  .setStartMuted(false)
  .build()

val adRequest = NativeAdRequest.Builder(
  "ca-app-pub-3940256099942544/2247696110",
  listOf(NativeAd.NativeAdType.NATIVE))
  .setVideoOptions(videoOptions)
  .build()

Java

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

NativeAdRequest adRequest = new NativeAdRequest.Builder(
  "ca-app-pub-3940256099942544/2247696110",
  List.of(NativeAd.NativeAdType.NATIVE))
  .setVideoOptions(videoOptions)
  .build()

自訂播放控制項

您可以要求顯示自訂的影片輸入控制項，讓使用者選擇播放/暫停影片，或是將影片靜音。

如要設定廣告的起始靜音狀態，請呼叫 VideoOptions.Builder.setCustomControlsRequested()。

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

如果廣告有影片內容，而且您啟用了自訂控制項，則應一併顯示廣告和自訂控制項，因為廣告內不會有任何控制項。接著，這些控制項可對

VideoOptions.Builder.setCustomControlsRequested()。

以下示範如何要求影片顯示自訂播放控制項。

Kotlin

val videoOptions: VideoOptions.Builder()
  .setCustomControlsRequested(true)
  .build()

val adRequest = new NativeAdRequest.Builder(
  "ca-app-pub-3940256099942544/2247696110",
  listOf(NativeAd.NativeAdType.NATIVE))
  .setVideoOptions(videoOptions)
  .build()

Java

VideoOptions VideoOptions = VideoOptions.Builder()
  .setCustomControlsRequested(true)
  .build()

NativeAdRequest adRequest = new NativeAdRequest.Builder(
  "ca-app-pub-3940256099942544/2247696110",
  List.of(NativeAd.NativeAdType.NATIVE))
  .setVideoOptions(videoOptions)
  .build()

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

請求廣告時，無法確定傳回的廣告是否支援自訂影片控制項，因此須先檢查廣告是否已啟用這項功能。

Kotlin

  val adCallback: NativeAdLoaderCallback =
    object : NativeAdLoaderCallback {
      override fun onNativeAdLoaded(nativeAd: NativeAd) {
        val mediaContent = nativeAd.mediaContent;
        if (mediaContent != null) {
          val videoController = mediaContent.videoController;
          val canShowCustomControls = videoController?.isCustomControlsEnabled();
        }
      }
    };

Java

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

算繪自訂影片控制項

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

算繪時，將自訂控制項檢視區塊視為原生廣告檢視區塊的子項。這樣 Open Measurement SDK 計算可視度時，就會將自訂控制項視為無害的遮蔽物。
避免在整個媒體檢視區塊上算繪隱藏的疊加層。這會妨礙使用者點按媒體檢視區塊，對原生廣告成效產生負面影響。建議只建立剛好能容納控制項的小型疊加層。

自訂點擊手勢

自訂點擊手勢是原生廣告功能，可將使用者在廣告檢視區塊的滑動操作，計為廣告點擊，特別適合用於以滑動手勢瀏覽內容的應用程式。本指南說明如何在原生廣告中啟用自訂點擊手勢。

呼叫 NativeAdRequest.Builder.enableCustomClickGestureDirection()，並傳遞 NativeAd.SwipeGestureDirection 和 boolean 值。

以下示範如何導入向右滑動自訂手勢，並保留一般分頁行為。

自訂點擊手勢預設為停用。
如果停用這個控制項，應用程式會支援一般的點按行為。
如果啟用這個控制項，應用程式將支援自訂滑動手勢。

以下示範如何導入向右滑動自訂手勢，並保留一般分頁行為。

Kotlin

val adOptions = NativeAdOptions
  .Builder()
  .enableCustomClickGestureDirection(
    /* swipeDirection */ 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.
val adRequest = NativeAdRequest.Builder(
  "ca-app-pub-3940256099942544/2247696110",
  listOf(NativeAd.NativeAdType.NATIVE))
  .withNativeAdOptions(adOptions)
  .build();

Java

NativeAdOptions adOptions = new NativeAdOptions
  .Builder()
  .enableCustomClickGestureDirection(
    /* swipeDirection */ 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.
NativeAdRequest adRequest = new NativeAdRequest.Builder(
  "ca-app-pub-3940256099942544/2247696110",
  List.of(NativeAd.NativeAdType.NATIVE))
  .withNativeAdOptions(adOptions)
  .build();

監聽滑動手勢事件

如要監聽滑動手勢事件，請使用 NativeAdEventCallback 呼叫 NativeAd.setAdEventCallback()，並實作 onAdSwipeGestureClicked() 方法。

Kotlin

  val adCallback: NativeAdLoaderCallback =
    object : NativeAdLoaderCallback {
      override fun onNativeAdLoaded(nativeAd: NativeAd) {
        // Implement the onAdSwipeGestureClicked() method.
        val nativeAdCallback: NativeAdEventCallback = object : NativeAdEventCallback {
          override fun onAdSwipeGestureClicked() {
            // A swipe gesture click has occurred.
          }
        }
      }
    }
  // Load the native ad with the ad request and callback.
  NativeAdLoader.load(adRequest, adCallback)

Java

  NativeAdLoaderCallback adCallback =
    new NativeAdLoaderCallback() {
      @Override
      public void onNativeAdLoaded(@NonNull NativeAd nativeAd) {
        // Implement the onAdSwipeGestureClicked() method.
        NativeAdEventCallback nativeAdCallback = new NativeAdEventCallback() {
          @Override
          public void onAdSwipeGestureClicked() {
            // A swipe gesture click has occurred.
          }
        };
      }
    };
  // Load the native ad with the ad request and callback.
  NativeAdLoader.load(adRequest, adCallback);

中介服務

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

原生廣告選項 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

必要條件

素材資源控制選項

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

Kotlin

Java

圖片下載控制選項

Kotlin

Java

圖片酬載控制項

AdChoices 刊登位置

AdChoices 位置控制項

Kotlin

Java

AdChoices 自訂檢視區塊

Kotlin

Java

影片控制選項

初始靜音行為

Kotlin

Java

自訂播放控制項

Kotlin

Java

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

Kotlin

Java

算繪自訂影片控制項

自訂點擊手勢

Kotlin

Java

監聽滑動手勢事件

Kotlin

Java

中介服務

原生廣告選項