原生廣告選項

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

必要條件

資產控制選項

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

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

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

  • 如未設定,傳回的廣告可以採用任何媒體顯示比例。

  • 設定後,只要指定 偏好的顯示比例類型

以下範例會指示 SDK 優先採用含有 挑選出適當的顯示比例

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

AdLoader loader = new AdLoader.Builder(this, '/21775744923/example/native')
                              .withNativeAdOptions(nativeAdOptions)
                              .build();

圖片下載控制項

透過圖片下載控制項,您可以決定圖片素材資源是還是只有 URI SDK 傳回的 IP 位址

呼叫 NativeAdOptions.Builder.setReturnUrlsForImageAssets() 並指定 boolean 值。
  • 圖片下載控制項預設為停用。

  • 停用後,Google Mobile Ads SDK 會替您填入圖片和 URI。

  • 啟用後,SDK 只會填入 URI,方便您下載 自訂圖片。

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

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

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

映像檔酬載控制項

有些廣告會使用一系列圖片,而非單張圖片。這項功能可用來 指出應用程式是否已準備好顯示所有圖片或只顯示一張。

呼叫 NativeAdOptions.Builder.setRequestMultipleImages() 並指定 boolean 值。
  • 映像檔酬載控制項預設為停用。

  • 停用後,應用程式會指示 SDK 只提供 第一張圖片。

  • 啟用後,應用程式表示已準備好顯示所有圖片 屬性含有多個素材資源

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

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

AdLoader loader = new AdLoader.Builder(this, '/21775744923/example/native')
                              .withNativeAdOptions(nativeAdOptions)
                              .build();

AdChoices 刊登位置

AdChoices 位置控制項

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

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

  • 如未設定,AdChoices 圖示位置會設為右上方。

  • 如果已設定,AdChoices 會顯示在自訂位置,

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

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

AdLoader loader = new AdLoader.Builder(this, '/21775744923/example/native')
                              .withNativeAdOptions(nativeAdOptions)
                              .build();

AdChoices 自訂檢視畫面

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

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

下例示範如何設定自訂 AdChoices 檢視畫面。 顯示在 AdChoicesView 中的 AdChoices 圖示。


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

影片控制選項

啟動靜音行為

啟動靜音行為後,即可停用或啟用影片的起始音訊。

呼叫 VideoOptions.Builder.setStartMuted() 並指定 boolean 值。
  • 啟動靜音行為預設為啟用。

  • 如果停用這項設定,應用程式會要求播放影片 音訊。

  • 啟用後,您的應用程式會要求將影片開頭設為靜音。

以下範例說明如何以取消靜音的音效開始播放影片。

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

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

AdLoader loader = new AdLoader.Builder(this, '/21775744923/example/native')
                              .withNativeAdOptions(adOptions).build();

自訂播放控制項

這樣您就能要求自訂影片輸入控制項來播放、暫停或靜音 影片。

呼叫 VideoOptions.Builder.setCustomControlsRequested() 並指定 boolean 值。
  • 自訂播放控制項預設為停用,

  • 停用後,影片就會顯示 SDK 轉譯的輸入控制項。

  • 如果廣告已啟用影片內容和自訂控制項,您應該 然後同時顯示自訂控制項與廣告,因為廣告不會實際放送 控制項本身接著,控制項可以呼叫 VideoController

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

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

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

AdLoader loader = new AdLoader.Builder(this, '/21775744923/example/native')
                              .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
  }
}

自訂點擊手勢

自訂點擊手勢是原生廣告功能,使用者只要滑動廣告檢視畫面, 。這項功能可與使用滑動手勢瀏覽內容的應用程式搭配使用。本指南將說明如何在原生廣告中啟用自訂點擊手勢。

呼叫 NativeAdOptions.Builder.enableCustomClickGestureDirection() 使用 NativeAdOptions.SwipeGestureDirectionboolean 用於指定是否要允許輕觸動作當做點擊。

  • 自訂點擊手勢預設為停用。

  • 停用後,應用程式就會支援正常的點擊行為。

  • 啟用後,您的應用程式將支援自訂滑動手勢。

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

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, '/21775744923/example/native')
    .withNativeAdOptions(adOptions);

監聽滑動手勢事件

記錄滑動手勢點擊時,Google Mobile Ads SDK 會叫用 AdListeneronAdSwipeGestureClicked() 方法,加上現有 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 行動服務的原生廣告 廣告 SDK 呈現。具有 需要使用第三方 SDK 請不要回應自訂點擊路線設定。