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

原生廣告選項

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

必要條件

整合原生廣告格式。

素材資源控制選項

首選媒體顯示比例控制項

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

使用 NativeAd.NativeMediaAspectRatio 值呼叫 NativeAdRequest.Builder.setMediaAspectRatio()。

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

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

Kotlin

val adRequest = NativeAdRequest.Builder(
  "/21775744923/example/native",
  listOf(NativeAd.NativeAdType.NATIVE))
  .setMediaAspectRatio(NativeAd.NATIVE_MEDIA_ASPECT_RATIO_LANDSCAPE)
  .build()

Java

NativeAdRequest adRequest = new NativeAdRequest.Builder(
  "/21775744923/example/native",
  List.of(NativeAd.NativeAdType.NATIVE))
  .setMediaAspectRatio(NativeAd.NATIVE_MEDIA_ASPECT_RATIO_LANDSCAPE)
  .build();

圖片下載控制項

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

呼叫 NativeAdRequest.Builder.disableImageDownloading()。

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

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

Kotlin

val adRequest = NativeAdRequest.Builder(
    "/21775744923/example/native",
    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(
  "/21775744923/example/native",
  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 圖示的角落。

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

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

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

Kotlin

val adRequest = NativeAdRequest.Builder(
  "/21775744923/example/native",
  listOf(NativeAd.NativeAdType.NATIVE))
  .setAdChoicesPlacement(NativeAdOptions.ADCHOICES_BOTTOM_RIGHT)
  .build()

Java

NativeAdRequest adRequest = new NativeAdRequest.Builder(
  "/21775744923/example/native",
  List.of(NativeAd.NativeAdType.NATIVE))
  .setAdChoicesPlacement(NativeAdOptions.ADCHOICES_BOTTOM_RIGHT)
  .build();

AdChoices 自訂檢視畫面

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

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

以下範例說明如何設定自訂 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);
}

影片控制選項

開始靜音行為

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

使用 boolean 值呼叫 VideoOptions.Builder.setStartMuted()，然後呼叫 NativeAdOptions.Builder.setVideoOptions()。

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

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

Kotlin

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

val adRequest = NativeAdRequest.Builder(
  "/21775744923/example/native",
  listOf(NativeAd.NativeAdType.NATIVE))
  .setVideoOptions(videoOptions)
  .build()

Java

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

NativeAdRequest adRequest = new NativeAdRequest.Builder(
  "/21775744923/example/native",
  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(
  "/21775744923/example/native",
  listOf(NativeAd.NativeAdType.NATIVE))
  .setVideoOptions(videoOptions)
  .build()

Java

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

NativeAdRequest adRequest = new NativeAdRequest.Builder(
  "/21775744923/example/native",
  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 可視度計算會將自訂控制項視為友善阻礙物。
避免在整個媒體檢視畫面上顯示不可見的疊加層。疊加層會阻擋媒體檢視畫面上的點擊，進而影響原生廣告成效。請改為建立小型疊加層，大小剛好可容納控制項。

自訂點擊手勢

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

使用 NativeAd.SwipeGestureDirection 和 boolean 值呼叫 NativeAdRequest.Builder.enableCustomClickGestureDirection()。

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

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

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

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(
  "/21775744923/example/native",
  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(
  "/21775744923/example/native",
  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

中介服務

原生廣告選項