此页面由 Cloud Translation API 翻译。

原生高级广告

展示 NativeAd

加载原生广告时，Google 移动广告 SDK 会调用相应广告格式的监听器。然后，就由您的应用负责展示广告了，但不一定要立即展示广告。为了更轻松地展示系统定义的广告格式，该 SDK 提供了一些实用资源，如下所述。

`NativeAdView` 类

对于 NativeAd 格式，有对应的 NativeAdView 类。该类是一个 ViewGroup，发布商应将其用作 NativeAd 的根。一个 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>
         <!--Add remaining assets such as the image and media view.-->
    </LinearLayout>
</com.google.android.gms.ads.nativead.NativeAdView>

下面这个示例创建了一个 NativeAdView，然后用 NativeAd 填充该视图：

Java

AdLoader.Builder builder = new AdLoader.Builder(this, "/21775744923/example/native")
    .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 assets into the ad view.
            populateNativeAdView(nativeAd, adView);
            frameLayout.removeAllViews();
            frameLayout.addView(adView);
        }
});

Kotlin

val builder = AdLoader.Builder(this, "/21775744923/example/native")
    .forNativeAd { nativeAd ->
        // Assumes you have a placeholder FrameLayout in your View layout
        // (with ID fl_adplaceholder) where the ad is to be placed.
        val 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
        val adView = layoutInflater
                .inflate(R.layout.native_ad_layout, null) as NativeAdView
        // This method sets the assets into the ad view.
        populateNativeAdView(nativeAd, adView)
        frameLayout.removeAllViews()
        frameLayout.addView(adView)
    }

请注意，对于指定的原生广告，应在 NativeAdView 布局内呈现所有素材资源。当在原生广告视图布局外呈现原生广告素材资源时，Google 移动广告 SDK 就会尝试在日志中记录一条警告。

广告视图类还提供了注册每项素材资源所用视图时会用到的方法，并提供了一个用于注册 NativeAd 对象本身的方法。如果以这种方式注册视图，该 SDK 就可以自动处理诸如以下任务：

记录点击次数
在第一个像素出现在屏幕上时记录展示次数
为原生补余广告素材显示广告选择叠加层 - 目前仅面向部分发布商提供

“广告选择”叠加层

当返回补余广告时，该 SDK 会向广告视图添加广告选择叠加层。如果您的应用使用原生补余广告，请在原生广告视图中任选您喜欢的一角留出空间，用于展示自动插入的广告选择徽标。此外，广告选择叠加层一定要显眼易见，因此请选择适当的背景颜色和图片。如需详细了解此叠加层的外观和功能，请参阅程序化原生广告植入指南。

程序化原生广告的广告标示

在展示程序化原生广告时，您必须展示广告标示，以指明该视图是广告。请参阅我们的政策指南了解详情。

代码示例

以下是展示原生广告的步骤：

创建 NativeAdView 类的实例。
对于要展示的每个广告素材资源：
1. 使用广告对象中的素材资源填充素材资源视图。
2. 向 NativeAdView 类注册该素材资源视图。
如果您的原生广告布局包含大型媒体素材资源，请注册 MediaView。
向 NativeAdView 类注册广告对象。

以下是一个展示 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 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 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 的引用。请注意，如果您的 fragment 或 activity 中有现成的 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 就会处理广告视图素材资源获得的点击。

如需监听点击，请实现 Google 移动广告 SDK 点击回调：

Java

AdLoader adLoader = new AdLoader.Builder(context, "/21775744923/example/native")
    // ...
    .withAdListener(new AdListener() {
        @Override
        public void onAdFailedToLoad(LoadAdError adError) {
            // Handle the failure by logging.
        }
        @Override
        public void onAdClicked() {
            // Log the click event or other custom behavior.
        }
    })
    .build();

Kotlin

val adLoader = AdLoader.Builder(this, "/21775744923/example/native")
    // ...
    .withAdListener(object : AdListener() {
        override fun onAdFailedToLoad(adError: LoadAdError) {
            // Handle the failure.
        }
        override fun onAdClicked() {
            // Log the click event or other custom behavior.
        }
    })
    .build()

注册 MediaView

如果您要在原生广告的布局中包含主图片素材资源，则需要使用 MediaView 素材资源，而不是 ImageView 素材资源。

MediaView 是一个专门用于展示主媒体素材资源（视频或图片）的 View。

MediaView 可以在 XML 布局中定义，也可以动态构建。就像所有其他素材资源视图一样，它应该放在 NativeAdView 的视图层次结构中。对于使用 MediaView 的应用，必须向 NativeAdView 注册它：
Java
```
 // Populate and register the media asset view.
 nativeAdView.setMediaView(nativeAdBinding.adMedia);
```
Kotlin
```
 // Populate and register the media asset view.
 nativeAdView.mediaView = nativeAdBinding.adMedia
```
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 类展示。使用 MediaContent 实例设置 MediaView 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()

测试原生广告代码

直销广告

如果您想测试直销原生广告的呈现效果，可以使用此 Ad Manager 广告单元 ID：

/21775744923/example/native

它已配置为投放示例应用安装广告、示例内容广告以及包含以下素材资源的自定义原生广告格式：

标题（文字）
主图（图片）
图片说明（文字）

自定义原生广告格式的模板 ID 为 10063170。

原生补余广告

Ad Exchange 补余广告仅面向部分发布商提供。如需测试原生补余广告的行为，请使用此 Ad Manager 广告单元：

/21775744923/example/native-backfill

它投放包含广告选择叠加层的示例应用安装广告和内容广告。

在实际投放前，请务必更新代码，使其引用您的实际广告单元 ID 和模板 ID。

GitHub 上的示例

原生广告示例的完整实现：

Java Kotlin

后续步骤

不妨探索以下主题：

用户隐私

优化了 SDK 初始化和广告加载（Beta 版）

原生高级广告

展示 NativeAd

NativeAdView 类

Java

Kotlin

“广告选择”叠加层

程序化原生广告的广告标示

代码示例

Java

Kotlin

Java

Kotlin

Java

Kotlin

Java

Kotlin

Java

Kotlin

ImageScaleType

Java

Kotlin

MediaContent

Java

Kotlin

销毁广告

Java

Kotlin

测试原生广告代码

直销广告

原生补余广告

GitHub 上的示例

后续步骤

`NativeAdView` 类