此页面由 Cloud Translation API 翻译。

自定义原生广告格式

除了系统定义的原生广告格式之外，Ad Manager 发布商还可以可让您通过在 Google Analytics 中资源。这类广告称为自定义原生广告格式，并且可与预留广告。这样，发布商就可以将任意结构化数据传递给应用。这些广告由 NativeCustomFormatAd 对象。

加载自定义原生广告格式

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

构建 AdLoader

与原生广告一样自定义原生广告格式是使用 AdLoader 类加载的：

Java

AdLoader adLoader = new AdLoader.Builder(context, "/21775744923/example/native")
    .forCustomFormatAd("10063170",
      new NativeCustomFormatAd.OnCustomFormatAdLoadedListener() {
          @Override
          public void onCustomFormatAdLoaded(NativeCustomFormatAd ad) {
              // Show the custom format and record an impression.
          }
      },
      new NativeCustomFormatAd.OnCustomClickListener() {
          @Override
          public void onCustomClick(NativeCustomFormatAd ad, String s) {
              // Handle the click action
          }
      })
    .withAdListener( ... )
    .withNativeAdOptions( ... )
    .build();

Kotlin

val adLoader = AdLoader.Builder(this, "/21775744923/example/native")
        .forCustomFormatAd("10063170",
            { ad ->
                // Show the custom format and record an impression.
            },
            { ad, s ->
            // Handle the click action
            })
        .withAdListener( ... )
        .withNativeAdOptions( ... )
        .build()

forCustomFormatAd 方法将 AdLoader 配置为请求自定义原生广告格式有三个参数传递到该方法中：

AdLoader 应请求的自定义原生广告格式的 ID。每个自定义原生广告格式具有与其相关联的 ID这个参数指示您的应用希望 AdLoader 请求哪种格式。
一个 OnCustomFormatAdLoadedListener 在广告成功加载后调用。
可选的 OnCustomClickListener 。如需详细了解请参阅“处理点击次数和展示次数”部分。

由于可以将单个广告单元设置为投放多个广告素材格式，因此可以使用唯一值多次调用 forCustomFormatAd 以便广告加载程序为多种可能的自定义原生广告格式

自定义的原生广告格式 ID

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

每个自定义的原生广告格式 ID 都会显示在其名称旁边。点击可让您转到详情屏幕字段：

在这里，可以添加、修改和移除各个字段。请注意每项资产的名称。名称是用于获取在展示自定义原生广告格式时逐一列出每个素材资源

展示自定义的原生广告格式

自定义原生广告格式与系统定义的原生广告格式的不同之处在于有权定义自己的素材资源列表。因此，显示自定义广告的过程与系统定义的广告格式：

由于 NativeCustomFormatAd 类用于处理在 Ad Manager 中定义的自定义原生广告格式， “getters”。而是提供了 getText 和将字段名称作为参数的 getImage。
没有 NativeAdView 等专用广告视图类可用于 NativeCustomFormatAd。您可以随意使用有助于改善用户体验
由于没有专用的 ViewGroup 类，因此您无需注册您用来显示广告素材资源的任何视图。这样就省去了但这也意味着您需要执行以处理点击。

以下是一个显示 NativeCustomFormatAd 的示例函数：

Java

public void displayCustomFormatAd (ViewGroup parent,
                                     NativeCustomFormatAd customFormatAd) {
    // Inflate a layout and add it to the parent ViewGroup.
    LayoutInflater inflater = (LayoutInflater) parent.getContext()
            .getSystemService(Context.LAYOUT_INFLATER_SERVICE);
    View adView = inflater.inflate(R.layout.custom_format_ad, parent);

    // Locate the TextView that will hold the value for "Headline" and
    // set its text.
    TextView myHeadlineView = (TextView) adView.findViewById(R.id.headline);
    myHeadlineView.setText(customFormatAd.getText("Headline"));

    // Locate the ImageView that will hold the value for "MainImage" and
    // set its drawable.
    Button myMainImageView = (ImageView) adView.findViewById(R.id.main_image);
    myMainImageView.setImageDrawable(
            customFormatAd.getImage("MainImage").getDrawable());

    ...
    // Continue locating views and displaying assets until finished.
    ...
}

Kotlin

public fun displayCustomFormatAd (parent: ViewGroup,
                                customFormatAd: NativeCustomFormatAd) {
    val adView = layoutInflater
            .inflate(R.layout.ad_simple_custom_format, null)

    val myHeadlineView = adView.findViewById<TextView>(R.id.headline)
    myHeadlineView.setText(customFormatAd.getText("Headline"));

    // Locate the ImageView that will hold the value for "MainImage" and
    // set its drawable.
    val myMainImageView = adView.findViewById(R.id.main_image);
    myMainImageView.setImageDrawable(
            customFormatAd.getImage("MainImage").drawable);

    ...
    // Continue locating views and displaying assets until finished.
    ...
}

呈现“广告选项”图标

根据支持《数字服务法案》(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>

以下示例呈现了“广告选择”图标和配置适当的点击行为。

Java

private AdSimpleCustomTemplateBinding customTemplateBinding;

private void populateAdView(final NativeCustomFormatAd nativeCustomFormatAd) {
  // Render the AdChoices icon.
  String adChoicesKey = NativeAdAssetNames.ASSET_ADCHOICES_CONTAINER_VIEW;
  NativeAd.Image adChoicesAsset = nativeCustomFormatAd.getImage(adChoicesKey);
  if (adChoicesAsset == null) {
    customTemplateBinding.adChoices.setVisibility(View.GONE);
  } else {
    customTemplateBinding.adChoices.setVisibility(View.VISIBLE);
    customTemplateBinding.adChoices.setImageDrawable(adChoicesAsset.getDrawable());

    // Enable clicks on AdChoices.
    customTemplateBinding.adChoices.setOnClickListener(
        new View.OnClickListener() {
          @Override
          public void onClick(View v) {
            nativeCustomFormatAd.performClick(adChoicesKey);
          }
        });
  }
  ...
}

Kotlin

private lateinit var customTemplateBinding: AdSimpleCustomTemplateBinding

private fun populateAdView(nativeCustomFormatAd: NativeCustomFormatAd) {
  // Render the AdChoices icon.
  val adChoicesKey = NativeAdAssetNames.ASSET_ADCHOICES_CONTAINER_VIEW
  val adChoicesAsset = nativeCustomFormatAd.getImage(adChoicesKey)
  if (adChoicesAsset == null) {
    customTemplateBinding.adChoices.visibility = View.GONE
  } else {
    customTemplateBinding.adChoices.setImageDrawable(adChoicesAsset.drawable)
    customTemplateBinding.adChoices.visibility = View.VISIBLE

    // Enable clicks on AdChoices.
    customTemplateBinding.adChoices.setOnClickListener {
      nativeCustomFormatAd.performClick(adChoicesKey)
    }
  }
  ...
}

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

创建自定义格式时，您可以选择让此格式符合视频的要求。

在您的应用实现代码中，您可以使用 NativeCustomFormatAd.getMediaContent() 以获取媒体内容。然后调用 setMediaContent() 在媒体视图中设置媒体内容打开媒体视图如果广告没有视频内容，请制定其他展示计划没有视频的广告。

以下示例会检查广告是否包含视频内容，并显示图片将由系统取代：

Java

// Called when a custom native ad loads.
@Override
public void onCustomFormatAdLoaded(final NativeCustomFormatAd ad) {

  MediaContent mediaContent = ad.getMediaContent();

  // Assumes you have a FrameLayout in your view hierarchy with the id media_placeholder.
  FrameLayout mediaPlaceholder = (FrameLayout) findViewById(R.id.media_placeholder);

  // Apps can check the MediaContent's hasVideoContent property to determine if the
  // NativeCustomFormatAd has a video asset.
  if (mediaContent != null && mediaContent.hasVideoContent()) {
    MediaView mediaView = new MediaView(mediaPlaceholder.getContext());
    mediaView.setMediaContent(mediaContent);
    mediaPlaceholder.addView(mediaView);

    // Create a new VideoLifecycleCallbacks object and pass it to the VideoController. The
    // VideoController will call methods on this object when events occur in the video
    // lifecycle.
    VideoController vc = mediaContent.getVideoController();
    vc.setVideoLifecycleCallbacks(
        new VideoController.VideoLifecycleCallbacks() {
          @Override
          public void onVideoEnd() {
            // Publishers should allow native ads to complete video playback before
            // refreshing or replacing them with another ad in the same UI location.
            super.onVideoEnd();
          }
        });
  } else {
    ImageView mainImage = new ImageView(this);
    mainImage.setAdjustViewBounds(true);
    mainImage.setImageDrawable(ad.getImage("MainImage").getDrawable());
    mediaPlaceholder.addView(mainImage);
    mainImage.setOnClickListener(
        new View.OnClickListener() {
          @Override
          public void onClick(View view) {
            ad.performClick("MainImage");
          }
        });
  }
}

Kotlin

// Called when a custom native ad loads.
NativeCustomFormatAd.OnCustomFormatAdLoadedListener { ad ->

  val mediaContent = ad.mediaContent

  // Apps can check the MediaContent's hasVideoContent property to determine if the
  // NativeCustomFormatAd has a video asset.
  if (mediaContent != null && mediaContent.hasVideoContent()) {
    val mediaView = MediaView(mediaPlaceholder.getContest())
    mediaView.mediaContent = mediaContent

    val videoController = mediaContent.videoController

    // Create a new VideoLifecycleCallbacks object and pass it to the VideoController. The
    // VideoController will call methods on this object when events occur in the video
    // lifecycle.
    if (videoController != null) {
      videoController.videoLifecycleCallbacks =
        object : VideoController.VideoLifecycleCallbacks() {
          override fun onVideoEnd() {
            // Publishers should allow native ads to complete video playback before refreshing
            // or replacing them with another ad in the same UI location.
            super.onVideoEnd()
          }
        }
    }
  } else {
    val mainImage = ImageView(this)
    mainImage.adjustViewBounds = true
    mainImage.setImageDrawable(ad.getImage("MainImage")?.drawable)

    mainImage.setOnClickListener { ad.performClick("MainImage") }
    customTemplateBinding.simplecustomMediaPlaceholder.addView(mainImage)
  }
}

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

下载 Ad Manager 自定义呈现示例原生视频广告的实际运用示例

自定义原生广告格式的点击次数和展示次数

使用自定义原生广告格式时，您的应用会负责录制并向 Google 移动广告 SDK 报告点击事件。

记录展示次数

要记录自定义格式广告的展示次数，请调用 recordImpression 方法（针对相应的 NativeCustomFormatAd）：

myCustomFormatAd.recordImpression();

如果您的应用不小心针对同一个广告调用该方法两次，则 SDK 可自动防止系统针对单个广告素材或服务请求。

报告点击次数

要向 SDK 报告在素材资源视图中发生了点击，请调用对相应的 NativeCustomFormatAd 执行 performClick 方法，并传入用户点击的素材资源的名称。例如，如果您在名为“MainImage”的自定义格式并想报告 ImageView 时，您的代码将如下所示：

myCustomFormatAd.performClick("MainImage");

请注意，您不需要为。如果您有另一个名为“Caption”的字段原本的显示但用户并未点击或点按，您的应用就不需要针对该素材资源的视图调用 performClick。

响应自定义点击操作

当用户点击自定义格式的广告时，可能出现以下三种情况响应，按以下顺序进行尝试：

从 AdLoader 调用 OnCustomClickListener（如果已提供）。
对于每个广告的深层链接网址，尝试查找内容解析器然后启动第一个可以解析的订单
打开浏览器并转到广告的传统目标网址。

forCustomFormatAd 方法接受 OnCustomClickListener。如果您传入监听器对象后，SDK 会改为调用其 onCustomClick 方法并且不会采取进一步措施。但是，如果您传递一个 null 值作为监听器， SDK 会回退到在 SDK 中注册的深层链接和/或目标网址，。

借助自定义点击监听器，您的应用可以决定更新界面、启动新活动而只是记录点击。下面的例子只记录了发生点击的地点：

Java

AdLoader adLoader = new AdLoader.Builder(context, "/21775744923/example/native")
    .forCustomFormatAd("10063170",
      new NativeCustomFormatAd.OnCustomFormatAdLoadedListener() {
        // Display the ad.
      },
      new NativeCustomFormatAd.OnCustomClickListener() {
          @Override
          public void onCustomClick(NativeCustomFormatAd ad, String assetName) {
            Log.i("MyApp", "A custom click just happened for " + assetName + "!");
          }
      }).build();

Kotlin

val adLoader = AdLoader.Builder(this, "/21775744923/example/native")
    .forCustomFormatAd("10063170",
        { ad ->
            // Display the ad.
        },
        { ad, assetName ->
                Log.i("MyApp", "A custom click just happened for $assetName!")
    }).build()

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

这种信息流的用处有多个，但最重要的是让 SDK 可以保持对点击响应的控制。它可以系统会自动对为以及在后台处理其他任务，无需任何额外的代码