歡迎加入 Google 廣告與評估社群伺服器的官方 Ad Manager Discord 頻道，與成員一起討論產品並提供意見回饋。

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

原生廣告選項

選取平台： Android iOS

原生廣告有許多進階功能，可供您進行額外的自訂作業，打造最佳廣告體驗。本指南說明如何使用原生廣告的進階功能。

必要條件

整合原生廣告格式。

素材資源控制選項

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

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

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

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

如果未設定，傳回的廣告媒體顯示比例可能為任意數值。
設定後，您就能指定偏好的顯示比例，提升使用者體驗。

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

Java

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

AdLoader loader =
    new AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(nativeAdOptions).build();NativeAdOptionsSnippets.java

Kotlin

val nativeAdOptions =
  NativeAdOptions.Builder()
    .setMediaAspectRatio(NativeAdOptions.NATIVE_MEDIA_ASPECT_RATIO_LANDSCAPE)
    .build()

val loader = AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(nativeAdOptions).build()NativeAdOptionsSnippets.kt

將 AD_UNIT_ID 替換為廣告單元 ID。

圖片下載控制項

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

呼叫 NativeAdOptions.Builder.setReturnUrlsForImageAssets()，並將值設為 boolean。

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

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

Java

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

AdLoader loader =
    new AdLoader.Builder(context, "AD_UNIT_ID")
        .withNativeAdOptions(nativeAdOptions)
        .forNativeAd(
            nativeAd -> {
              List<Uri> imageUris = new ArrayList<>();
              for (Image image : nativeAd.getImages()) {
                imageUris.add(image.getUri());
              }
            })
        .build();NativeAdOptionsSnippets.java

Kotlin

val nativeAdOptions = NativeAdOptions.Builder().setReturnUrlsForImageAssets(true).build()

val loader =
  AdLoader.Builder(context, "AD_UNIT_ID")
    .withNativeAdOptions(nativeAdOptions)
    .forNativeAd { nativeAd ->
      val imageUris = nativeAd.images.mapNotNull { it.uri }
    }
    .build()NativeAdOptionsSnippets.kt

圖片酬載控制項

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

呼叫 NativeAdOptions.Builder.setRequestMultipleImages()，並將值設為 boolean。

圖片酬載控制項預設為停用。
停用時，應用程式會指示 SDK 對含有系列圖片的素材資源，僅提供第一張圖片。
啟用時，應用程式會表示已準備好，為含有多張圖片的素材資源顯示所有圖片。

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

Java

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

AdLoader loader =
    new AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(nativeAdOptions).build();NativeAdOptionsSnippets.java

Kotlin

val nativeAdOptions = NativeAdOptions.Builder().setRequestMultipleImages(true).build()

val loader = AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(nativeAdOptions).build()NativeAdOptionsSnippets.kt

AdChoices 刊登位置

本節將詳細說明如何放置 AdChoices 疊加層。您可以選擇將其放置在四個角落之一，或在自訂檢視區塊中算繪。

AdChoices 位置控制項

您可以透過 AdChoices 位置控制項，選擇要在哪個角落算繪 AdChoices 圖示。

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

如未設定，AdChoices 圖示位置會設為右上角。
如已設定，AdChoices 會放置在您自訂的位置。

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

Java

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

AdLoader loader =
    new AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(nativeAdOptions).build();NativeAdOptionsSnippets.java

Kotlin

val nativeAdOptions =
  NativeAdOptions.Builder()
    .setAdChoicesPlacement(NativeAdOptions.ADCHOICES_BOTTOM_RIGHT)
    .build()

val loader = AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(nativeAdOptions).build()NativeAdOptionsSnippets.kt

AdChoices 自訂檢視區塊

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

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

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

Java

NativeAdView nativeAdView = new NativeAdView(context);
AdChoicesView adChoicesView = new AdChoicesView(context);
nativeAdView.setAdChoicesView(adChoicesView);NativeAdOptionsSnippets.java

Kotlin

val nativeAdView = NativeAdView(context)
val adChoicesView = AdChoicesView(context)
nativeAdView.adChoicesView = adChoicesViewNativeAdOptionsSnippets.kt

影片控制選項

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

初始靜音行為

您可以透過「開始靜音行為」，停用或啟用影片的起始音訊。

呼叫 VideoOptions.Builder.setStartMuted()，並將值設為 boolean。

系統會預設啟用開始靜音行為。
停用時，應用程式會要求影片在開始時播放音訊。
啟用時，應用程式會要求影片開始播放時靜音。

以下範例說明如何在影片開始時播放音訊。

Java

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

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

AdLoader loader =
    new AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(nativeAdOptions).build();NativeAdOptionsSnippets.java

Kotlin

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

val nativeAdOptions = NativeAdOptions.Builder().setVideoOptions(videoOptions).build()

val loader = AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(nativeAdOptions).build()NativeAdOptionsSnippets.kt

自訂播放控制項

您可以要求自訂影片輸入控制項，播放、暫停或將影片設為靜音。

呼叫 VideoOptions.Builder.setCustomControlsRequested()，並將值設為 boolean。

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

如果廣告含有影片內容且已啟用自訂控制項，您應連同廣告顯示自訂控制項，因為廣告本身不會顯示任何控制項。然後，控制項可以呼叫以下項目的相關方法：

VideoController。

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

Java

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

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

AdLoader loader =
    new AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(nativeAdOptions).build();NativeAdOptionsSnippets.java

Kotlin

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

val nativeAdOptions = NativeAdOptions.Builder().setVideoOptions(videoOptions).build()

val loader = AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(nativeAdOptions).build()NativeAdOptionsSnippets.kt

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

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

Java

MediaContent mediaContent = nativeAd.getMediaContent();
if (mediaContent != null) {
  VideoController videoController = mediaContent.getVideoController();
  boolean canShowCustomControls = videoController.isCustomControlsEnabled();
}NativeAdOptionsSnippets.java

Kotlin

val mediaContent = nativeAd.mediaContent
if (mediaContent != null) {
  val videoController = mediaContent.videoController
  val canShowCustomControls = videoController.isCustomControlsEnabled
}NativeAdOptionsSnippets.kt

算繪自訂影片控制項

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

將自訂控制項檢視區塊，算繪為原生廣告檢視區塊的子項。採用這種做法後，Open Measurement 可視度計算會將自訂控制項視為友善遮擋物。
避免在整個媒體檢視區塊上算繪不可見的疊加元素。疊加元素會阻擋媒體檢視區塊上的點擊，對原生廣告成效造成負面影響。請改為建立小型疊加元素，大小只要足以容納控制項即可。

自訂點擊手勢

自訂點擊手勢是原生廣告功能，可將廣告瀏覽畫面上的滑動動作註冊為廣告點擊。這項功能適用於使用滑動手勢導覽內容的應用程式。本指南說明如何為原生廣告啟用自訂點擊手勢。

使用 NativeAdOptions.SwipeGestureDirection 呼叫 NativeAdOptions.Builder.enableCustomClickGestureDirection()，並使用 boolean 指出是否要將輕觸視為點擊。

以下範例說明如何導入向右滑動的自訂滑動手勢，並保留一般輕觸行為。

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

以下範例說明如何導入向右滑動的自訂滑動手勢，並保留一般輕觸行為。

Java

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

// ca-app-pub-3940256099942544/2247696110 is a sample ad unit ID that has custom click
// gestures enabled.
AdLoader.Builder builder =
    new AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(adOptions);NativeAdOptionsSnippets.java

Kotlin

val adOptions =
  NativeAdOptions.Builder()
    .enableCustomClickGestureDirection(NativeAdOptions.SWIPE_GESTURE_DIRECTION_RIGHT, true)
    .build()

val builder = AdLoader.Builder(context, "AD_UNIT_ID").withNativeAdOptions(adOptions)NativeAdOptionsSnippets.kt

監聽滑動手勢事件

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

Java

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

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

Kotlin

val adLoader =
  AdLoader.Builder(context, AD_UNIT_ID)
    .withAdListener(
      object : AdListener() {
        override fun onAdSwipeGestureClicked() {
          // Called when a swipe gesture click is recorded.
          Log.d(TAG, "A swipe gesture click has occurred.")
        }

        override fun onAdClicked() {
          // Called when a swipe gesture click or a tap click is recorded, as
          // configured in NativeAdOptions.
          Log.d(TAG, "A swipe gesture click or a tap click has occurred.")
        }
      }
    )
    .build()NativeAdOptionsSnippets.kt

中介服務

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

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

必要條件

素材資源控制選項

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

Java

Kotlin

圖片下載控制項

Java

Kotlin

圖片酬載控制項

Java

Kotlin

AdChoices 刊登位置

AdChoices 位置控制項

Java

Kotlin

AdChoices 自訂檢視區塊

Java

Kotlin

影片控制選項

初始靜音行為

Java

Kotlin

自訂播放控制項

Java

Kotlin

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

Java

Kotlin

算繪自訂影片控制項

自訂點擊手勢

Java

Kotlin

監聽滑動手勢事件

Java

Kotlin

中介服務

原生廣告選項