此页面由 Cloud Translation API 翻译。

自定义的原生广告格式

除了系统定义的原生广告格式之外，Ad Manager 发布商还可以通过自行指定一系列素材资源来创建自己的原生广告格式。这类格式称为自定义原生广告格式，可以用于预定型广告。这样，发布商就可以将任意结构化数据传递给应用。这些广告由 NativeCustomFormatAd 对象表示。

加载自定义原生广告格式

本指南介绍了如何加载和展示自定义原生广告格式。

加载自定义原生广告

如需加载自定义原生广告，请执行以下操作：

在 NativeAdRequest 中添加 NativeAdType.CUSTOM_NATIVE 类型作为广告类型。
设置自定义原生广告的格式 ID。

Kotlin

val adRequest =
  NativeAdRequest.Builder("AD_UNIT_ID", listOf(NativeAdType.CUSTOM_NATIVE))
    .setCustomFormatIds(listOf("CUSTOM_NATIVE_FORMAT_ID"))
    .build()

// Load the native ad with the ad request and callback.
NativeAdLoader.load(
  adRequest,
  object : NativeAdLoaderCallback {
    override fun onCustomNativeAdLoaded(customNativeAd: CustomNativeAd) {
      // TODO: Store the custom native ad.
    }

    override fun onAdFailedToLoad(adError: LoadAdError) {}
  },
)

Java

NativeAdRequest adRequest =
    new NativeAdRequest.Builder("AD_UNIT_ID", List.of(NativeAd.NativeAdType.CUSTOM_NATIVE))
        .setCustomFormatIds(Arrays.asList("CUSTOM_NATIVE_FORMAT_ID"))
        .build();

// Load the native ad with the ad request and callback.
NativeAdLoader.load(
    adRequest,
    new NativeAdLoaderCallback() {
      @Override
      public void onCustomNativeAdLoaded(@NonNull CustomNativeAd customNativeAd) {
        // TODO: Store the custom native ad.
      }

      @Override
      public void onAdFailedToLoad(@NonNull LoadAdError adError) {}
    });

自定义原生广告格式 ID

在 Ad Manager 界面的投放下拉菜单中，前往原生部分，即可找到用于标识自定义原生广告格式的格式 ID：

每个自定义原生广告格式 ID 都显示在格式名称旁边。点击其中一个名称可以转到详细信息界面，该界面中会显示相应格式中各个字段的信息：

您可以在此处添加、修改和移除个别字段。请注意每种素材资源的名称。在显示自定义原生广告格式时，名称是获取每种素材资源的数据的关键。

展示自定义原生广告格式

自定义原生广告格式与系统定义的原生广告格式的不同之处在于：发布商有权定义自己用来制作广告的素材资源列表。因此，与系统定义的格式相比，自定义原生广告的展示过程会在以下方面有所不同：

文字和图片素材资源可通过 getText() 和 getImage() getter 获取，这些 getter 会将字段名称作为参数。
由于没有专用的 ViewGroup 类可向 Google 注册，因此您需要手动记录展示次数和点击次数。
如果自定义原生广告不包含视频素材资源，则会包含 null 媒体内容。

此示例展示了如何显示 CustomNativeAd：

Kotlin

private fun displayCustomNativeAd(customNativeAd: CustomNativeAd, context: Context) {
  // Render the text elements.

  // The `customNativeAdBinding` is the layout binding for the ad container that
  // contains all `CustomNativeAd` assets.
  customNativeAdBinding.headline.text = customNativeAd.getText("Headline")
  customNativeAdBinding.caption.text = customNativeAd.getText("Caption")

  // If the main asset is an image, render it with an ImageView.
  val imageView = ImageView(context)
  imageView.adjustViewBounds = true
  imageView.setImageDrawable(customNativeAd.getImage("MainImage")?.drawable)
  imageView.setOnClickListener { customNativeAd.performClick("MainImage") }
  customNativeAdBinding.mediaPlaceholder.addView(imageView)

  // Render the ad choices icon.
  renderAdChoices(customNativeAd)

  // Record an impression.
  customNativeAd.recordImpression()
}

Java

private void displayCustomNativeAd(CustomNativeAd customNativeAd, Context context) {
  // Render the text elements.

  // The `customNativeAdBinding` is the layout binding for the ad container that
  // contains all `CustomNativeAd` assets.
  if (customNativeAdBinding != null) {
    customNativeAdBinding.headline.setText(customNativeAd.getText("Headline"));
    customNativeAdBinding.caption.setText(customNativeAd.getText("Caption"));

    ImageView imageView = new ImageView(context);
    imageView.setAdjustViewBounds(true);
    imageView.setImageDrawable(customNativeAd.getImage("MainImage").getDrawable());
    imageView.setOnClickListener(
        new View.OnClickListener() {
          @Override
          public void onClick(View v) {
            customNativeAd.performClick("MainImage");
          }
        });
    customNativeAdBinding.mediaPlaceholder.addView(imageView);

    // Render the ad choices icon.
    renderAdChoices(customNativeAd);

    // Record an impression.
    customNativeAd.recordImpression();
  }
}

自定义原生广告格式的原生视频

创建自定义广告格式时，您可以选择调整格式，使之适用于视频。

在您的应用实现中，您可以使用 CustomNativeAd.getMediaContent() 获取媒体内容。然后调用 setMediaContent() 在媒体视图上设置媒体内容。如果广告有 null 媒体内容，则需要制定备用方案，以便在没有视频的情况下也能展示广告。

以下示例代码会检查广告是否有视频内容，如果没有视频，则会在视频位置展示图片：

Kotlin

private fun displayVideoCustomNativeAd(customNativeAd: CustomNativeAd, context: Context) {
  // Check whether the custom native ad has video content.
  val mediaContent = customNativeAd.mediaContent
  if (mediaContent != null && mediaContent.hasVideoContent) {
    // Render the media content in a MediaView.
    val mediaView = MediaView(context)
    mediaView.mediaContent = mediaContent
    customNativeAdBinding.mediaPlaceholder.addView(mediaView)
  } else {
    // Fall back to other assets defined on your custom native ad.
    val imageView = ImageView(context)
    imageView.adjustViewBounds = true
    imageView.setImageDrawable(customNativeAd.getImage("MainImage")?.drawable)
    customNativeAdBinding.mediaPlaceholder.addView(imageView)
  }

  // Record an impression.
  customNativeAd.recordImpression()
}

Java

private void displayVideoCustomNativeAd(CustomNativeAd customNativeAd, Context context) {
  // Check whether the custom native ad has video content.
  MediaContent mediaContent = customNativeAd.getMediaContent();
  if (mediaContent != null && mediaContent.getHasVideoContent()) {
    // Render the media content in a MediaView.
    MediaView mediaView = new MediaView(context);
    mediaView.setMediaContent(mediaContent);
    customNativeAdBinding.mediaPlaceholder.addView(mediaView);
  } else {
    // Fall back to other assets defined on your custom native ad.
    ImageView imageView = new ImageView(context);
    imageView.setAdjustViewBounds(true);
    imageView.setImageDrawable(customNativeAd.getImage("MainImage").getDrawable());
    customNativeAdBinding.mediaPlaceholder.addView(imageView);
  }

  // Record an impression.
  customNativeAd.recordImpression();
}

请参阅视频广告，详细了解如何量身定制自定义原生广告的视频体验。

呈现“广告选项”图标

根据《数字服务法案》(DSA)，在欧洲经济区 (EEA) 投放的预订型广告必须包含“广告选项”图标和指向 Google 的“关于此广告”页面的链接。在植入自定义原生广告时，您要负责呈现“广告选项”图标。在呈现主要广告素材资源时，我们建议您采取措施来呈现“广告选项”图标并为其设置点击监听器。

以下示例假设您已在视图层次结构中定义了 <ImageView /> 元素来放置“广告选项”徽标。

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android">
    <ImageView
        android:id="@+id/adChoices"
        android:layout_width="15dp"
        android:layout_height="15dp"
        android:adjustViewBounds="true"
        android:contentDescription="AdChoices icon." />
</LinearLayout>

以下示例会呈现“广告选项”图标并配置相应的点击行为。

Kotlin

private fun renderAdChoices(customNativeAd: CustomNativeAd) {
  // Render the AdChoices image.
  val adChoiceAsset = customNativeAd.getImage(NativeAdAssetNames.ASSET_ADCHOICES_CONTAINER_VIEW)
  if (adChoiceAsset != null) {
    customNativeAdBinding.adchoices.setImageDrawable(adChoiceAsset.drawable)
    customNativeAdBinding.adchoices.visibility = View.VISIBLE
    customNativeAdBinding.adchoices.setOnClickListener {
      // Handle click. See the next section for more details.
      customNativeAd.performClick(NativeAdAssetNames.ASSET_ADCHOICES_CONTAINER_VIEW)
    }
  } else {
    customNativeAdBinding.adchoices.visibility = View.GONE
  }
}

Java

private void renderAdChoices(CustomNativeAd customNativeAd) {
  // Render the AdChoices image.
  Image adChoiceAsset =
      customNativeAd.getImage(NativeAdAssetNames.ASSET_ADCHOICES_CONTAINER_VIEW);
  if (adChoiceAsset != null) {
    if (customNativeAdBinding != null) {
      customNativeAdBinding.adchoices.setImageDrawable(adChoiceAsset.getDrawable());
      customNativeAdBinding.adchoices.setVisibility(View.VISIBLE);
      customNativeAdBinding.adchoices.setOnClickListener(
          new View.OnClickListener() {
            @Override
            public void onClick(View v) {
              // Handle click.
              customNativeAd.performClick(NativeAdAssetNames.ASSET_ADCHOICES_CONTAINER_VIEW);
            }
          });
    }
  } else {
    if (customNativeAdBinding != null) {
      customNativeAdBinding.adchoices.setVisibility(View.GONE);
    }
  }
}

记录展示次数并报告点击事件

您的应用负责记录展示次数，并向 Google 移动广告 SDK（Beta 版）报告点击事件。

记录展示次数

如需记录自定义原生广告的展示次数，请调用广告的 recordImpression() 方法：

Kotlin

// Record an impression.
customNativeAd.recordImpression()

Java

// Record an impression.
customNativeAd.recordImpression();

如果您的应用不小心针对同一个广告调用该方法两次，则 SDK 会自动阻止系统针对单个请求重复记录展示。

报告点击事件

要向 SDK 报告在素材资源视图中发生了点击事件，请调用广告的 performClick() 方法。使用您在 Ad Manager 界面中定义的同一字符串提供被点击的素材资源的名称。

Kotlin

imageView.setOnClickListener { customNativeAd.performClick("MainImage") }

Java

imageView.setOnClickListener(
    new View.OnClickListener() {
      @Override
      public void onClick(View v) {
        customNativeAd.performClick("MainImage");
      }
    });

请注意，您不需要为每个与广告关联的视图都调用此方法。例如，如果您有另一个名为“Caption”的字段，该字段只作展示之用，不会用于接受用户的点击或点按，则您的应用就不需要为该素材资源的视图调用 performClick。

响应自定义点击操作

当用户点击自定义格式的广告时，SDK 可能会作出的响应有三种，具体尝试的响应顺序如下：

调用 OnCustomClickListener（如果已提供）。
对于每个广告的深层链接网址，尝试查找内容解析器，并启动第一个能够解析网址的内容解析器。
打开浏览器并前往广告的目标网址。

如需实现自定义点击操作，请提供 OnCustomClickListener：

Kotlin

customNativeAd.onCustomClickListener =
  object : OnCustomClickListener {
    override fun onCustomClick(assetName: String) {
      // Perform your custom action.
    }
  }

Java

customNativeAd.setOnCustomClickListener(
    new OnCustomClickListener() {
      @Override
      public void onCustomClick(@NonNull String assetName) {
        // Perform your custom action.
      }
    });

乍一看，存在自定义点击监听器似乎很奇怪。毕竟，您的应用刚刚告诉 SDK 发生了一次点击，为什么 SDK 应该反过来向应用报告？

这种信息流动其实有多方面的用处，但最重要的是，它让 SDK 能够保持对点击响应的控制。例如，它可以自动对已为广告素材设置的第三方跟踪网址执行 ping 操作，并在后台处理其他一些任务，而不需要任何额外的代码。

自定义的原生广告格式 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

加载自定义原生广告格式

加载自定义原生广告

Kotlin

Java

自定义原生广告格式 ID

展示自定义原生广告格式

Kotlin

Java

自定义原生广告格式的原生视频

Kotlin

Java

呈现“广告选项”图标

Kotlin

Java

记录展示次数并报告点击事件

记录展示次数

Kotlin

Java

报告点击事件

Kotlin

Java

响应自定义点击操作

Kotlin

Java

自定义的原生广告格式