此页面由 Cloud Translation API 翻译。

原生广告

原生广告是通过平台原本就有的界面组件向用户呈现的广告素材资源。这种广告使用您在构建布局时已经采用的同类视图进行展示，而且能以和应用视觉设计相称的形式呈现。

加载原生广告时，您的应用会收到一个包含其素材资源的广告对象，然后由应用（而不是 Google 移动广告 SDK [Beta 版]）负责展示它们。

一般而言，要成功植入原生广告，就需要完成两步：通过 SDK 加载广告，然后在您的应用中展示广告内容。

本页介绍了如何使用 SDK 加载原生广告。

前提条件

通读入门指南。
Google 移动广告 SDK（Beta 版）0.6.0-alpha01 或更高版本。

务必用测试广告进行测试

在构建和测试应用时，请确保使用的是测试广告，而不是实际投放的广告。否则，可能会导致您的账号被中止。

对于原生广告，加载测试广告最简便的方法就是使用我们的专用测试广告单元 ID：

广告格式	示例广告单元 ID
原生	`/21775744923/example/native`
原生视频广告	`/21775744923/example/native-video`

加载广告

如需加载原生广告，请调用 NativeAdLoader.load() 方法，该方法接受 NativeAdRequest 和 NativeAdLoaderCallback。

import com.google.android.libraries.ads.mobile.sdk.common.LoadAdError
import com.google.android.libraries.ads.mobile.sdk.nativead.NativeAd
import com.google.android.libraries.ads.mobile.sdk.nativead.NativeAdLoader
import com.google.android.libraries.ads.mobile.sdk.nativead.NativeAdLoaderCallback
import com.google.android.libraries.ads.mobile.sdk.nativead.NativeAdRequest

class NativeFragment : Fragment() {

  private var nativeAd: NativeAd? = null

  override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
    super.onViewCreated(view, savedInstanceState)
    loadAd()
  }

  private fun loadAd() {
    // Build an ad request with native ad options to customize the ad.
    val adRequest = NativeAdRequest
      .Builder(AD_UNIT_ID, listOf(NativeAd.NativeAdType.NATIVE))
      .build()

    val adCallback =
      object : NativeAdLoaderCallback {
        override fun onNativeAdLoaded(nativeAd: NativeAd) {
          // Called when a native ad has loaded.
        }
        override fun onAdFailedToLoad(adError: LoadAdError) {
          // Called when a native ad has failed to load.
        }
      }

    // Load the native ad with our request and callback.
    NativeAdLoader.load(adRequest, adCallback)
  }

  companion object {
    // Sample native ad unit ID.
    const val AD_UNIT_ID = "/21775744923/example/native"
  }
}

设置原生广告事件回调

处理 onNativeAdLoaded 时，请使用 NativeAdEventCallback 设置接收到的 NativeAd，以定义用于接收原生广告生命周期事件的函数：

  nativeAd.adEventCallback =
    object : NativeAdEventCallback {
      override fun onAdShowedFullScreenContent() {
        // Native ad showed full screen content.
      }
      override fun onAdDismissedFullScreenContent() {
        // Native ad dismissed full screen content.
      }
      override fun onAdFailedToShowFullScreenContent {
        // Native ad failed to show full screen content.
      }
      override fun onAdImpression() {
        // Native ad recorded an impression.
      }
      override fun onAdClicked() {
        // Native ad recorded a click.
      }
    }

可选：加载多个广告

如需加载多个广告，请使用可选的 numberOfAds 参数调用 load()。您可以设置的最大值为 5，表示广告数量。 Google 移动广告 SDK（Beta 版）可能不会完全按您的请求返回固定数量的广告。

private fun loadAd() {
  // Build an ad request with native ad options to customize the ad.
  val adRequest = NativeAdRequest
    .Builder(AD_UNIT_ID, listOf(NativeAd.NativeAdType.NATIVE))
    .build()

  val adCallback =
    object : NativeAdLoaderCallback {
      override fun onNativeAdLoaded(nativeAd: NativeAd) {
        // Called when a native ad has loaded.
      }
      override fun onAdFailedToLoad(adError: LoadAdError) {
        // Called when a native ad has failed to load.
      }
      override fun onAdLoadingCompleted() {
        // Called when all native ads have loaded.
      }
    }

  // Load the native ad with our request and callback.
  NativeAdLoader.load(adRequest, 3, adCallback)
}

Google 移动广告 SDK（Beta 版）返回的广告都各不相同，但预订型广告资源或第三方买方提供的广告可能并非如此。

如果您使用中介，请勿调用 load() 方法。涉及多个原生广告的请求不适用于配置为使用中介功能的广告单元 ID。

最佳做法

加载广告时，请遵循以下规则。

在列表中使用原生广告的应用应预缓存广告列表。
预缓存广告时，请在 1 小时后清除缓存并重新加载。

请仅缓存所需的原生广告内容。例如，在预缓存时，仅缓存屏幕上立即可见的广告。原生广告的内存占用量高，缓存原生广告而不销毁会导致占用过多内存。
不再使用原生广告时，请将其销毁。

针对视频广告启用硬件加速

为了确保视频广告在原生广告视图中成功展示，必须启用硬件加速。

硬件加速默认处于启用状态，但有些应用可能会选择将其停用。如果您的应用停用了硬件加速，我们建议您为使用广告的 activity 类启用硬件加速。

启用硬件加速

如果您的应用在全局启用硬件加速时无法正常运行，您也可以针对个别 activity 启用或停用硬件加速。如需启用或停用硬件加速，请针对 AndroidManifest.xml 中的 <application> 和 <activity> 元素使用 android:hardwareAccelerated 属性。以下示例展示了如何为整个应用启用硬件加速，但为一个 activity 停用硬件加速：

<application android:hardwareAccelerated="true">
    <!-- For activities that use ads, hardwareAcceleration should be true. -->
    <activity android:hardwareAccelerated="true" />
    <!-- For activities that don't use ads, hardwareAcceleration can be false. -->
    <activity android:hardwareAccelerated="false" />
</application>
HardwareAccelerationSnippet.xml

如需详细了解用于控制硬件加速的选项，请参阅硬件加速指南。请注意，如果针对 activity 停用了硬件加速，那么将无法针对单个广告视图启用，因此必须针对 activity 本身启用硬件加速。

展示您的广告

加载广告后，剩下的工作就是将其展示给您的用户。请参阅我们的原生高级广告指南，了解具体方法。

示例

下载并运行示例应用，该应用演示了如何使用 Google 移动广告 SDK（Beta 版）。