顯示 NativeAd
原生廣告載入時,Google Mobile Ads SDK 會叫用 對應的廣告格式接著,您的應用程式負責顯示廣告,但不一定需要立即顯示。為讓您更輕鬆地顯示系統定義的廣告格式,SDK 提供一些實用資源,如下所述。
NativeAdView
類別
如果是 NativeAd
格式,每個標記都會對應到
NativeAdView
類別本課程是
ViewGroup
敬上
發布商應將其做為 NativeAd
的根層級。A 罩杯
單一 NativeAdView
可對應到單一原生廣告。
用來顯示該廣告的素材資源 (ImageView
顯示
例如螢幕截圖素材資源) 必須是 NativeAdView
的子項
物件。
使用
LinearLayout
敬上
顯示其資產檢視可能如下所示:
<com.google.android.gms.ads.nativead.NativeAdView
xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="wrap_content">
<LinearLayout
android:orientation="vertical"
... >
<LinearLayout
android:orientation="horizontal"
... >
<ImageView
android:id="@+id/ad_app_icon"
... />
<TextView
android:id="@+id/ad_headline"
... />
</LinearLayout>
// Other assets such as image or media view, call to action, etc follow.
...
</LinearLayout>
</com.google.android.gms.ads.nativead.NativeAdView>
以下範例說明如何建立 NativeAdView
會填入 NativeAd
:
Java
AdLoader.Builder builder = new AdLoader.Builder(this, "AD_UNIT_ID")
.forNativeAd(new NativeAd.OnNativeAdLoadedListener() {
@Override
public void onNativeAdLoaded(NativeAd nativeAd) {
// Assumes you have a placeholder FrameLayout in your View layout
// (with id fl_adplaceholder) where the ad is to be placed.
FrameLayout frameLayout =
findViewById(R.id.fl_adplaceholder);
// Assumes that your ad layout is in a file call native_ad_layout.xml
// in the res/layout folder
NativeAdView adView = (NativeAdView) getLayoutInflater()
.inflate(R.layout.native_ad_layout, null);
// This method sets the text, images and the native ad, etc into the ad
// view.
populateNativeAdView(nativeAd, adView);
frameLayout.removeAllViews();
frameLayout.addView(adView);
}
});
Kotlin
val builder = AdLoader.Builder(this, "AD_UNIT_ID")
.forNativeAd { nativeAd ->
// Assumes that your ad layout is in a file call native_ad_layout.xml
// in the res/layout folder
val adView = layoutInflater
.inflate(R.layout.native_ad_layout, null) as NativeAdView
// This method sets the text, images and the native ad, etc into the ad
// view.
populateNativeAdView(nativeAd, adView)
// Assumes you have a placeholder FrameLayout in your View layout
// (with id ad_frame) where the ad is to be placed.
ad_frame.removeAllViews()
ad_frame.addView(adView)
}
請注意,特定原生廣告的所有素材資源都必須顯示在
NativeAdView
版面配置。當原生素材資源在原生廣告視圖版面配置外顯示時,Google Mobile Ads SDK 會嘗試記錄警告。
廣告檢視類別也提供方法來註冊
每個資產,另一個則用來註冊 NativeAd
物件。
以這種方式註冊檢視畫面,SDK 可自動處理工作
例如:
- 正在記錄點擊
- 在第一個像素顯示在畫面上時記錄曝光
- 顯示 AdChoices 重疊廣告
AdChoices 重疊元素
SDK 會在每個廣告檢視畫面中加入 AdChoices 重疊廣告。在原生廣告檢視畫面的偏好角落保留空間,以便系統自動插入 AdChoices 標誌。此外,請務必清楚顯示 AdChoices 重疊圖示,因此請選擇合適的背景顏色和圖片。如要進一步瞭解疊加層的外觀和 函式,請參閱原生廣告欄位 說明。
廣告標示
您必須顯示廣告標示,指出觀看次數是廣告。進一步瞭解我們的政策 指南。
程式碼範例
顯示原生廣告的步驟如下:
- 建立
NativeAdView
類別的執行個體。 - 針對每個要顯示的廣告素材資源:
- 在素材資源檢視畫面中填入廣告物件中的素材資源。
- 使用
ViewGroup
類別註冊資產檢視畫面。
- 註冊
MediaView
敬上 廣告版面配置內含大型媒體素材資源。 - 使用
ViewGroup
類別註冊廣告物件。
以下為顯示 NativeAd
的函式範例:
Java
private void displayNativeAd(ViewGroup parent, NativeAd ad) {
// Inflate a layout and add it to the parent ViewGroup.
LayoutInflater inflater = (LayoutInflater) parent.getContext()
.getSystemService(Context.LAYOUT_INFLATER_SERVICE);
NativeAdView adView = (NativeAdView) inflater
.inflate(R.layout.ad_layout_file, parent);
// Locate the view that will hold the headline, set its text, and call the
// NativeAdView's setHeadlineView method to register it.
TextView headlineView = adView.findViewById<TextView>(R.id.ad_headline);
headlineView.setText(ad.getHeadline());
adView.setHeadlineView(headlineView);
...
// Repeat the above process for the other assets in the NativeAd
// using additional view objects (Buttons, ImageViews, etc).
...
// If the app is using a MediaView, it should be
// instantiated and passed to setMediaView. This view is a little different
// in that the asset is populated automatically, so there's one less step.
MediaView mediaView = (MediaView) adView.findViewById(R.id.ad_media);
adView.setMediaView(mediaView);
// Call the NativeAdView's setNativeAd method to register the
// NativeAdObject.
adView.setNativeAd(ad);
// Ensure that the parent view doesn't already contain an ad view.
parent.removeAllViews();
// Place the AdView into the parent.
parent.addView(adView);
}
Kotlin
fun displayNativeAd(parent: ViewGroup, ad: NativeAd) {
// Inflate a layout and add it to the parent ViewGroup.
val inflater = parent.getContext().getSystemService(Context.LAYOUT_INFLATER_SERVICE)
as LayoutInflater
val adView = inflater.inflate(R.layout.ad_layout_file, parent) as NativeAdView
// Locate the view that will hold the headline, set its text, and use the
// NativeAdView's headlineView property to register it.
val headlineView = adView.findViewById<TextView>(R.id.ad_headline)
headlineView.text = ad.headline
adView.headlineView = headlineView
...
// Repeat the above process for the other assets in the NativeAd using
// additional view objects (Buttons, ImageViews, etc).
...
val mediaView = adView.findViewById<MediaView>(R.id.ad_media)
adView.mediaView = mediaView
// Call the NativeAdView's setNativeAd method to register the
// NativeAdObject.
adView.setNativeAd(ad)
// Ensure that the parent view doesn't already contain an ad view.
parent.removeAllViews()
// Place the AdView into the parent.
parent.addView(adView)
}
以下是個別工作:
加載版面配置
Java
LayoutInflater inflater = (LayoutInflater) parent.getContext() .getSystemService(Context.LAYOUT_INFLATER_SERVICE); NativeAdView adView = (NativeAdView) inflater .inflate(R.layout.ad_layout_file, parent);
Kotlin
val inflater = parent.getContext().getSystemService(Context.LAYOUT_INFLATER_SERVICE) as LayoutInflater val adView = inflater.inflate(R.layout.ad_layout_file, parent) as NativeAdView
這個程式碼會加載 XML 版面配置,其中包含用於顯示原生原生的檢視畫面 廣告,然後找出
NativeAdView
的參照。請注意,您也可以 重複使用現有的NativeAdView
(如果片段或活動中有現有的片段) 甚至可在不使用版面配置檔案的情況下動態建立執行個體填入及登錄資產檢視畫面
這個範例程式碼會找出用於顯示標題的檢視畫面,並使用廣告物件提供的字串素材資源設定文字,然後將其註冊至
NativeAdView
物件:Java
TextView headlineView = adView.findViewById<TextView>(R.id.ad_headline); headlineView.setText(ad.getHeadline()); adView.setHeadlineView(headlineView);
Kotlin
val headlineView = adView.findViewById<TextView>(R.id.ad_headline) headlineView.text = ad.headline adView.headlineView = headlineView
這個程序要找出檢視區塊、設定其值,並向其註冊 對於 廣告物件。
處理點擊
請勿在 原生廣告檢視如要自行觀察點擊事件,請使用廣告 接聽程式。
只要您正確填入及註冊素材資源檢視畫面 (如前一個部分所述),SDK 就會處理廣告檢視畫面素材資源的點擊次數。
我們舉個例子,說明使用廣告 事件監聽器 點擊事件:
Java
AdLoader adLoader = new AdLoader.Builder(context, "ca-app-pub-3940256099942544/2247696110") ... .withAdListener(new AdListener() { @Override public void onAdFailedToLoad(LoadAdError adError) { // Handle the failure by logging, altering the UI, and so on. } @Override public void onAdClicked() { // Log the click event or other custom behavior. } }) .build();
Kotlin
val adLoader = AdLoader.Builder(this, "ca-app-pub-3940256099942544/2247696110") ... .withAdListener(object : AdListener() { override fun onAdFailedToLoad(adError: LoadAdError) { // Handle the failure by logging, altering the UI, and so on. } }) .build()
註冊 MediaView
您必須使用
MediaView
敬上 而非ImageView
如要在原生廣告版面配置中加入主要圖片素材資源,則會傳回素材資源 廣告。MediaView
是特殊的View
,用於顯示主要媒體素材資源。 影片或圖片MediaView
可在 XML 版面配置中定義,或是以動態方式建構。這項服務 應置於NativeAdView
的檢視區塊階層中,就像任何 其他資產檢視畫面使用「MediaView
」的應用程式必須向NativeAdView
:Java
MediaView mediaView = adView.findViewById(R.id.ad_media); adView.setMediaView(mediaView);
Kotlin
adView.mediaView = adView.findViewById<MediaView>(R.id.ad_media)
如同所有素材資源檢視畫面,媒體檢視畫面也需要填入內容。方法是使用
getMediaContent()
敬上 擷取媒體內容的擷取方法,MediaView
。以下程式碼片段是設定媒體的媒體內容 檢視表:Java
mediaView.setMediaContent(nativeAd.getMediaContent());
Kotlin
mediaView.mediaContent = nativeAd.mediaContent
ImageScaleType
MediaView
類別顯示時具有ImageScaleType
屬性 所以映像檔較小如要變更圖片在MediaView
中的縮放方式,請使用MediaView
的setImageScaleType()
方法設定對應的ImageView.ScaleType
:Java
mediaView.setImageScaleType(ImageView.ScaleType.CENTER_CROP);
Kotlin
mediaView.imageScaleType = ImageView.ScaleType.CENTER_CROP
MediaContent
MediaContent
類別會保留與 原生廣告,其中使用MediaView
類別顯示。當MediaView
mediaContent
屬性是透過MediaContent
例項設定:如果有可用的影片資產,系統會進行緩衝處理,並開始在
MediaView
。如要確認影片資產是否可用,請查看hasVideoContent()
。如果廣告不包含影片素材資源,系統就會下載
mainImage
素材資源 並改為放在MediaView
中
根據預設,
mainImage
是第一個下載的圖片素材資源。如果 使用setReturnUrlsForImageAssets(true)
,mainImage
為null
,您必須 將mainImage
屬性設為手動下載的圖片。請注意,此 只有在沒有可用的影片素材資源時,系統才會使用圖片。註冊原生廣告物件
在最後一個步驟中,系統會以 負責展示:
Java
adView.setNativeAd(ad);
Kotlin
adView.setNativeAd(ad)
刪除廣告
原生廣告顯示完畢後,請銷毀 確實進行垃圾收集
Java
nativeAd.destroy();
Kotlin
nativeAd.destroy()
GitHub 上的範例
原生廣告導入完成範例:
後續步驟
請參閱下列主題: