原生廣告提供許多進階功能 量身打造最適合的廣告體驗本指南說明 如何使用原生廣告的進階功能
必要條件
- 整合原生廣告格式。
資產控制選項
偏好的媒體顯示比例控制項
媒體顯示比例控制項可讓您指定偏好設定 廣告素材。
呼叫 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, 'ca-app-pub-3940256099942544/2247696110')
.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, 'ca-app-pub-3940256099942544/2247696110')
.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, 'ca-app-pub-3940256099942544/2247696110')
.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, 'ca-app-pub-3940256099942544/2247696110')
.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, 'ca-app-pub-3940256099942544/2247696110')
.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, 'ca-app-pub-3940256099942544/2247696110')
.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.SwipeGestureDirection
和 boolean
用於指定是否要允許輕觸動作當做點擊。
自訂點擊手勢預設為停用。
如果停用這項功能,應用程式將支援正常的點擊行為。
啟用後,您的應用程式將支援自訂滑動手勢。
以下範例會實作向右自訂滑動手勢,並 可保留一般的分頁行為。
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, 'ca-app-pub-3940256099942544/2247696110')
.withNativeAdOptions(adOptions);
監聽滑動手勢事件
記錄滑動手勢點擊時,Google Mobile Ads SDK 會叫用
AdListener
的 onAdSwipeGestureClicked()
方法,加上現有
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 請不要回應自訂點擊路線設定。