如要討論產品並提供意見，請加入 Google 廣告與評估社群伺服器中的官方 AdMob 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。

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

圖片下載控制項預設為停用。
停用後，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

圖片酬載控制項

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

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

圖片有效負載控制項預設為停用。
停用後，應用程式會指示 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

影片控制選項

設定影片素材資源行為。

開始靜音行為

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

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

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

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

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

自訂播放控制項

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

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

自訂播放控制項預設為停用。
停用後，影片會顯示 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

顯示自訂影片控制項

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

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

自訂點擊手勢

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

使用 NativeAdOptions.SwipeGestureDirection 和 boolean 呼叫 NativeAdOptions.Builder.enableCustomClickGestureDirection()，指出是否要允許輕觸動作視為點擊。

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

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

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

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

中介服務

原生廣告選項