自定义的原生广告格式

自定义广告格式

与系统定义的原生广告格式一样，自定义的原生广告格式也是使用 GADAdLoader 对象加载的。初始化 GADAdLoader 时，在 adTypes 数组中包含 GADAdLoaderAdTypeCustomNative 常量会将其配置为在加载广告时请求自定义的原生广告格式。

注意 ：如果您的广告单元配置为投放多种广告格式，您就可以使用一个 GADAdLoader 同时请求自定义的原生格式和系统定义的广告素材。 Ad Manager 会选择与您请求的其中一种格式相关联的最佳原生广告素材。

GADCustomNativeAdLoaderDelegate

加载自定义格式的协议有两种方法。第一种供 GADAdLoader 使用，用于找出它应请求的格式 ID：

Swift

public func customNativeAdFormatIDs(for adLoader: GADAdLoader) -> [Any]

Objective-C

- (NSArray *)customNativeAdFormatIDsForAdLoader:(GADAdLoader *)adLoader;

每个自定义原生广告格式都有一个用于标识它的相应格式 ID。调用此方法时，您的应用应返回一个数组，其中包含准备展示的广告的格式 ID。

第二条消息在自定义原生广告加载后发送，这与系统定义的格式非常相似：

Swift

public func adLoader(_ adLoader: GADAdLoader,
    didReceive customNativeAd: GADCustomNativeAd)

Objective-C

- (void)adLoader:(GADAdLoader *)adLoader
    didReceiveCustomNativeAd:(GADCustomNativeAd *)customNativeAd;

格式 ID

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

每个自定义原生广告的格式 ID 显示在其名称旁边。点击其中一个名称可以转到详细信息屏幕，其中显示了有关格式字段的信息：

在这里，可以添加、修改和删除各个字段。记下每项资源的名称。名称是用于在显示自定义原生广告格式时获取每个素材资源的数据的键。

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

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

1. 由于 GADCustomNativeAd 用于处理您创建的任何自定义原生广告格式，因此它没有已命名的素材资源存取器，而是提供了 imageForKey: 和 stringForKey: 等将字段名称作为参数的方法。
2. 没有 GADNativeAdView 等可用于 GADCustomNativeAd 的专用广告视图类。您可以随意使用任何有助于改善用户体验的视图。
3. 由于没有专用的广告视图类，因此您无需注册任何用于展示广告素材资源的视图。

以下是一个能够展示简单的自定义原生广告的广告视图示例：

MySimpleNativeAdView.h

Swift

import UIKit
import GoogleMobileAds

/// Custom native ad view class with format ID 10063170.
class MySimpleNativeAdView: UIView {

  /// Weak references to this ad's asset views.
  @IBOutlet weak var headlineView: UILabel!
  @IBOutlet weak var mainImageView: UIImageView!
  @IBOutlet weak var captionView: UILabel!

  ...

  /// Populates the ad view with the custom native ad object.
  func populateWithCustomNativeAd(_ customNativeAd: GADCustomNativeAd) {
    ...
  }
}

Objective-C

@import UIKit;
@import GoogleMobileAds;

/// View representing a custom native ad format with format ID 10063170.
@interface MySimpleNativeAdView : UIView

// Weak references to this ad's asset views.
@property(weak, nonatomic) IBOutlet UILabel *headlineView;
@property(weak, nonatomic) IBOutlet UIImageView *mainImageView;
@property(weak, nonatomic) IBOutlet UILabel *captionView;

/// Populates the ad view with the custom native ad object.
- (void)populateWithCustomNativeAd:(GADCustomNativeAd *)customNativeAd;

@end

MySimpleNativeAdView.m（节选）

Swift

...
func populateWithCustomNativeAd(_ customNativeAd: GADCustomNativeAd) {
  self.customNativeAd = customNativeAd

  // Populate the custom native ad assets.
  headlineView.text = self.customNativeAd.stringForKey("Headline")
  mainImageView.image = self.customNativeAd.imageForKey("MainImage")?.image
  captionView.text = self.customNativeAd.stringForKey("Caption")
}
...

Objective-C

...
- (void)populateWithCustomNativeAd:(GADCustomNativeAd *)customNativeAd {
  self.customNativeAd = customNativeAd;

  // Populate the custom native ad assets.
  self.headlineView.text = [customNativeAd stringForKey:@"Headline"];
  self.mainImageView.image = [customNativeAd imageForKey:@"MainImage"].image;
  self.captionView.text = [customNativeAd stringForKey:@"Caption"];
}
...

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

创建自定义格式时，您可以选择使该格式适用于视频。

在您的应用实现中，可以使用 GADCustomNativeAd.mediaView 属性获取视频的视图。然后将此视图添加到视图层次结构中。如果广告没有视频内容，则需要制定备用方案，以便在没有视频的情况下也能展示广告。

注意 ：原生广告在没有视频时会在媒体视图中包含图片，但自定义原生广告与此不同，在不包含视频的情况下，其媒体视图中不会有任何内容。

以下示例会检查广告是否包含视频内容，如果没有视频，则会在原位置显示图片：

Swift

...
  /// Populates the ad view with the custom native ad object.
  func populate(withCustomNativeAd customNativeAd: GADCustomNativeAd) {
    if customNativeAd.videoController.hasVideoContent(),
      let mediaView = customNativeAd.mediaView {
      updateMainView(mediaView)
    } else {
      // Assumes your native format has an image asset with the name MainImage.
      let image: UIImage? = customNativeAd.image(forKey: "MainImage")?.image
      updateMainView(UIImageView(image: image))
    }
  }

  private func updateMainView(_ mainView:UIView) {
    // Assumes you have a placeholder view for your media content.
    // Remove all the placeholder's subviews.
    for subview: UIView in mainPlaceholder.subviews {
      subview.removeFromSuperview()
    }
    mainPlaceholder.addSubview(mainView)
    // Size the media view to fill our container size.
    mainView.translatesAutoresizingMaskIntoConstraints = false
    let viewDictionary: [AnyHashable: Any] = ["mainView":mainView]
    mainPlaceholder.addConstraints(NSLayoutConstraint.constraints(
      withVisualFormat: "H:|[mainView]|", options: [], metrics: nil,
      views: viewDictionary as? [String : Any] ?? [String : Any]()))
    mainPlaceholder.addConstraints(NSLayoutConstraint.constraints(
      withVisualFormat: "V:|[mainView]|", options: [], metrics: nil,
      views: viewDictionary as? [String : Any] ?? [String : Any]()))
  }
...

Objective-C

...
- (void)populateWithCustomNativeAd:(GADCustomNativeAd *)ad {
  UIView *mainView = nil;
  if (ad.videoController.hasVideoContent) {
    mainView = ad.mediaView;
  } else {
    // Assumes your native format has an image asset with the name MainImage.
    UIImage *image = [ad imageForKey:@"MainImage"].image;
    mainView = [[UIImageView alloc] initWithImage:image];
  }
  // Assumes you have a placeholder view for your media content.
  for (UIView *subview in self.mainPlaceholder.subviews) {
    [subview removeFromSuperview];
  }
  [self.mainPlaceholder addSubview:mainView];

  // Size the main view to fill our container size.
  [mainView setTranslatesAutoresizingMaskIntoConstraints:NO];
  NSDictionary *viewDictionary = NSDictionaryOfVariableBindings(mainView);
  [self.mainPlaceholder
      addConstraints:[NSLayoutConstraint constraintsWithVisualFormat:@"H:|[mainView]|"
                                                             options:0
                                                             metrics:nil
                                                               views:viewDictionary]];
  [self.mainPlaceholder
      addConstraints:[NSLayoutConstraint constraintsWithVisualFormat:@"V:|[mainView]|"
                                                             options:0
                                                             metrics:nil
                                                               views:viewDictionary]];
}
...

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

您可以下载 Ad Manager 自定义呈现示例，以获取实际投放的原生视频广告示例。

处理自定义原生广告的点击次数和展示次数

对于自定义原生广告格式，您的应用负责记录展示次数并向 SDK 报告点击事件。

记录展示次数

要记录自定义原生广告的展示次数，只需在相应 GADCustomNativeAd 上调用 recordImpression 方法：

Swift

myCustomNativeAd.recordImpression()

Objective-C

[myCustomNativeAd recordImpression];

如果您的应用意外为同一广告多次调用该方法，SDK 会阻止系统针对单个请求重复记录展示次数。

报告点击次数

要向 SDK 报告在素材资源视图中发生了点击，请在相应 GADCustomNativeAd 上调用 performClickOnAssetWithKey: 方法，并传入获得点击的素材资源的名称。例如，如果您的自定义格式中有一个名为“MainImage”的素材资源，并且您希望报告与该素材资源对应的视图上的点击，则代码如下所示：

Swift

myCustomNativeAd.performClickOnAsset(withKey: "MainImage")

Objective-C

[myCustomNativeAd performClickOnAssetWithKey:@"MainImage"];

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

响应自定义点击操作

GADCustomNativeAd 具有 customClickHandler 属性，其类型为 GADNativeAdCustomClickHandler

Swift

typealias GADNativeAdCustomClickHandler = (assetID: String) -> Void

Objective-C

typedef void (^GADNativeAdCustomClickHandler)(NSString *assetID);

这是一个可接受 assetID 作为输入参数（用于标识用户点击的素材资源）的块 (Objective-C) / 闭包 (Swift)。

当自定义原生广告上发生点击时，SDK 可能会作出的响应有三种，具体尝试的响应顺序如下：

1. 调用 Objective-C 的 customClickHandler 代码块或 Swift 的闭包（如果已设置）。
2. 循环遍历广告的深层链接网址，并打开第一个可找到匹配应用的网址。
3. 打开浏览器并导航至广告的传统目标网址。

customClickHandler 属性接受 Objective-C 的块和 Swift 的闭包。如果您设置了块或闭包，SDK 将运行它，并且不会采取进一步操作。但是，如果您设置了 nil 值，SDK 将回退到广告中注册的深层链接和/或目标网址。

自定义点击处理程序可让您的应用自行决定响应点击的最佳操作，无论是更新界面、显示其他视图控制器，还是仅记录点击。以下是显示提醒的示例：

Swift

myCustomNativeAd.customClickHandler = { assetID in
  if assetID == "MainImage" {
    let alertView = UIAlertView(title: "Custom Click",
        message: "You just clicked on the image!",
        delegate: self,
        cancelButtonTitle: "OK")
    alertView.alertViewStyle = .default
    alertView.show()
  }
}
myCustomNativeAd.performClickOnAsset(withKey: "MainImage")

Objective-C

[self.customNativeAd setCustomClickHandler:^(NSString *assetID){
  if ([assetID isEqualToString:@"MainImage"]) {
    [[[UIAlertView alloc] initWithTitle:@"Custom Click"
                                message:@"You just clicked on the image!"
                               delegate:self
                      cancelButtonTitle:@"OK"
                      otherButtonTitles:nil] show];
  }
}];
[self.customNativeAd performClickOnAssetWithKey:@"MainImage"];

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

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

测试原生广告代码

直销广告

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

/6499/example/native

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

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

原生补余广告

要测试原生补余广告的行为，请使用此Ad Manager 广告单元：

/6499/example/native-backfill

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

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