自适应粘性横幅

这是一个自动更新的小广告，放置在应用屏幕的顶部或底部。它与主要应用内容不重叠，常用于游戏应用中。

自适应粘性横幅通过优化每个设备上的广告尺寸，实现最大效率。这种广告类型允许开发者设置广告的最大允许宽度，但最佳广告尺寸仍然是自动确定的。自适应粘性横幅的高度不应超过屏幕高度的 15%。

本指南展示了如何将自适应粘性横幅集成到 iOS 应用中。除了代码示例和说明之外，它还包含特定格式的建议和其他资源的链接。

前提条件

请按照快速入门中描述的 SDK 集成步骤进行操作。
提前初始化您的广告 SDK。
确保您运行的是最新的 Yandex Mobile Ads SDK 版本。如果您使用聚合，请同时确保您运行的是最新版本的统一构建。

实施

集成自适应粘性横幅的关键步骤：

创建一个 AdView 类实例。
实施委托方法。
加载广告。
如果您使用 Adfox，请传递其他设置。
在委托方法中接收广告并进行呈现。

自适应粘性横幅集成的特点

所有调用 Yandex Mobile Ads SDK 方法的操作必须在主线程中完成。
我们强烈建议您不要在 func adViewDidFailLoading(_ adView: AdView, error: Error) 委托方法中收到错误时尝试加载新广告。如果您需要从 func adViewDidFailLoading(_ adView: AdView, error: Error)，加载广告，请限制广告加载重试，以避免由于网络连接限制而重复出现失败的广告请求。
为了确保您的自适应粘性横幅正常工作，请使用自动布局。对视图使用固定大小的框架可能会导致广告呈现不正确。
自适应粘性横幅在使用所有可用宽度时效果最佳。通常情况下，这是设备屏幕的全宽度。确保包括适用于您的应用的所有填充和安全显示区域。
自适应粘性横幅设计用于放置在可滚动内容中。广告的高度可以与设备屏幕相同，也可以限制为最大高度，具体取决于 API。
要获取广告尺寸，请使用 BannerAdSize.stickySize(withContainerWidth: CGFloat) 方法，将可用的广告容器宽度作为参数传递。
BannerAdSize 对象是使用 BannerAdSize.stickySize(withContainerWidth: CGFloat) 方法计算的，其中包含相同设备的广告宽度和高度的常量值。在特定设备上测试应用布局后，您可以确定广告尺寸将保持不变。
自适应粘性横幅的高度不应超过屏幕高度的 15%，并且应至少为 50 dp。

创建 AdView 类实例

要显示横幅广告，请创建一个 AdView 类实例，并将广告尺寸和广告 ID 传递给它。您还需要通过为您的类实施 AdViewDelegate 协议来定义 AdView 的委托。

设备适用的广告是使用 BannerAdSize.stickySize(withContainerWidth:) SDK 方法计算的。作为参数，传递广告容器的最大允许宽度。我们建议使用设备屏幕的整个宽度或父容器的宽度。确保包括适用于您的应用的所有填充和安全显示区域。

您还需要在合作伙伴界面中接收到的广告位 ID (adUnitId)。

在视图控制器中创建 AdView 实例的示例：

final class StickyBannerViewController: UIViewController {
        private lazy var adView: AdView = {
        let width = view.safeAreaLayoutGuide.layoutFrame.width
        let adSize = BannerAdSize.stickySize(withContainerWidth: width)

        let adView = AdView(adUnitID: "R-M-XXXXX-YY", adSize: adSize)
        adView.delegate = self
        adView.translatesAutoresizingMaskIntoConstraints = false
        return adView
    }()
}

extension StickyBannerViewController: AdViewDelegate {
    func adViewDidLoad(_ adView: AdView) {
        // 加载成功后将调用该方法
    }

    func adViewDidFailLoading(_ adView: AdView, error: Error) {
        // 加载广告时出现任何错误后将调用此方法
    }
}

加载广告

创建 AdView 后，需要加载广告。

要在广告加载或加载失败时发出通知并跟踪自适应粘性横幅的生命周期，您需要为 AdView 类对象设置委托属性并实施 AdViewDelegate 协议。

您可以通过 AdRequest 传递用户兴趣、上下文页面数据、位置详细信息或其他信息来扩展广告请求参数。在请求中提供额外的上下文数据可以显著提高您的广告质量。请参阅广告定位版块了解更多信息。

以下示例展示了如何加载自适应粘性横幅。加载成功后，将调用 AdViewDelegate 委托的 func adViewDidLoad(_ adView: AdView) 方法。

final class StickyBannerViewController: UIViewController {
    private lazy var adView: AdView = {
        let width = view.safeAreaLayoutGuide.layoutFrame.width
        let adSize = BannerAdSize.stickySize(withContainerWidth: width)

        let adView = AdView(adUnitID: "R-M-XXXXX-YY", adSize: adSize)
        adView.delegate = self
        adView.translatesAutoresizingMaskIntoConstraints = false
        return adView
    }()

    func loadAd() {
        adView.loadAd()
    }
}

展示广告

成功加载广告后，您需要对其进行呈现。为此，有两种方法：

使用自动布局约束

使用 displayAtTop(in:) 和 displayAtBottom(in:) 方法

获取从委托方法获得的 adView 并将其添加到容器中。然后添加自动布局约束，以便横幅显示在您想要的位置。

final class StickyBannerViewController: UIViewController {
  private lazy var adView: AdView = {
      let width = view.safeAreaLayoutGuide.layoutFrame.width
      let adSize = BannerAdSize.stickySize(withContainerWidth: width)

      let adView = AdView(adUnitID: "R-M-XXXXX-YY", adSize: adSize)
      adView.delegate = self
      adView.translatesAutoresizingMaskIntoConstraints = false
      return adView
  }()

  func showAd() {
      view.addSubview(adView)
      NSLayoutConstraint.activate([
          adView.topAnchor.constraint(equalTo: loadButton.bottomAnchor, constant: 100),
          adView.centerXAnchor.constraint(equalTo: view.centerXAnchor)
      ])
  }
}

横幅将添加到所有控制器视图的顶部，水平居中，并分别放置在容器的顶部或底部。

final class StickyBannerViewController: UIViewController {
  private lazy var adView: AdView = {
      let width = view.safeAreaLayoutGuide.layoutFrame.width
      let adSize = BannerAdSize.stickySize(withContainerWidth: width)

      let adView = AdView(adUnitID: "R-M-XXXXX-YY", adSize: adSize)
      adView.delegate = self
      adView.translatesAutoresizingMaskIntoConstraints = false
      return adView
  }()

  func showAd() {
      adView.displayAdBottom(in: view)
  }
}

测试自适应粘性横幅集成

使用演示广告单元进行广告测试

我们建议使用测试广告来测试您的广告集成和应用本身。

为了保证为每个广告请求返回测试广告，我们创建了一个特殊的演示广告版位 ID。用它来检查您的广告集成。

演示广告单元 ID：demo-banner-yandex.

重要

在将您的应用发布到商店之前，请确保将演示广告单元 ID 替换为从 Partner Interface 获取的真实 ID。

您可以在用于测试的演示广告单元部分找到可用的演示广告版位 ID 列表。

测试广告集成

您可以使用本机控制台工具测试广告集成。

要查看详细日志，请调用 YMAMobileAds 类的 enableLogging 方法。

YMAMobileAds.enableLogging()

要查看 SDK 日志，请前往控制台工具并设置 sybsystem = com.yandex.mobile.ads.sdk。您还可以按类别和错误级别过滤日志。

如果您在集成广告时遇到问题，您将获得有关问题的详细报告以及如何解决这些问题的建议。

其他资源

GitHub 链接。

这篇文章是否有用？

自适应内联横幅

插屏广告