版本 6 迁移指南

重要

确保将您使用的 Yandex 聚合 适配器更新到最新版本。旧版本可能会导致适配器集成错误，从而导致您的广告无法投放。

横幅

将 AdSize 类重命名为 BannerAdSize。移除了 FlexibleSize(int width, int height) 方法。

根据广告类型使用方法：

使用 BannerAdSize.stickySize(int width) 方法创建自适应粘性横幅。

这是一个自动更新的小广告，放置在应用屏幕的顶部或底部。

广告与主要应用内容不重叠，常用于游戏应用中。

粘性横幅的高度是自动确定的，可根据设备的屏幕尺寸调整，并且不占用超过屏幕高度的 15%。

重要

版本 6.0.0 添加了对自适应粘性横幅的自动刷新支持。

如果您之前已为粘性横幅实施了自动刷新，请禁用它。

使用 BannerAdSize.inlineSize(int width, int maxHeight) method 创建自适应内联横幅。

自适应内联横幅是一种灵活的横幅广告格式，通过优化每个设备上的广告尺寸，实现最大效率。

横幅的高度会自动调整，可能会达到设备屏幕的高度。

通常，这种格式在基于内容来源的应用或允许主要关注广告的上下文环境中使用。

激励广告

我们改变了创建和加载广告的方法。我们现在提供 RewardedAdLoader 加载器对象，用于加载广告，以及从 OnAdLoaded 广告加载事件检索的 RewardedAd 广告对象。

广告加载

SDK 5

用于广告加载和呈现的单个对象：

final ad = await RewardedAd.create(
  adUnitId: 'your-ad-unit-id',
  onAdLoaded: () {
    /* Do something */
  },
  onAdFailedToLoad: (error) {
      /* Do something */
  },
);
await ad.load(adRequest: AdRequest());

SDK 6

用于加载多个广告的 RewardedAdLoader：

late final Future<RewardedAdLoader> _adLoader =
      _createRewardedAdLoader();
RewardedAd? _ad;

Future<RewardedAdLoader> _createRewardedAdLoader() {
  return RewardedAdLoader.create(
    onAdLoaded: (RewardedAd rewardedAd) {
      // 广告加载成功。现在您可以显示已加载的广告
      _ad = rewardedAd;
    },
    onAdFailedToLoad: (error) {
      // 广告加载失败，出现 AdRequestError。
      // 强烈建议不要尝试通过 onAdFailedToLoad() 方法加载新广告。
    },
  );
}

Future<void> _loadRewardedAd() async {
  final adLoader = await _adLoader;
  await adLoader.loadAd(adRequestConfiguration: AdRequestConfiguration(adUnitId: 'your-ad-unit-id'));
}

广告呈现

SDK 5

在展示广告之前，请查看广告是否已加载。

RewardedAd? _ad;

Future<void> _showRewardedAd() async {
  final ad = _ad;
  if (ad != null && ad.isLoaded) {
    await ad.show();
    var reward = await ad.waitForDismiss();
  }
}

SDK 6

您无需检查广告是否已加载。广告在通过 onAdLoaded() 回调方法返回后，准备好进行呈现。

RewardedAd? _ad;

Future<void> _showRewardedAd() async {
  final ad = _ad;
  if (ad != null) {
    _setAdEventListener(ad);
    await ad.show();
    var reward = await ad.waitForDismiss();
  }
}

订阅广告生命周期事件

SDK 5

所有事件均到达单个 RewardedAd 对象。

RewardedAd.create(
  onAdLoaded: () {},
  onAdFailedToLoad: (AdLoadError error) {},
  onAdShown: () {},
  onAdDismissed: () {},
  onRewarded: (Reward reward) {},
  onAdClicked: () {},
  onLeftApplication: () {},
  onReturnedToApplication: () {},
  onImpression: (String? impressionData) {},
);

SDK 6

广告加载事件到达 RewardedAdLoader 对象，而广告呈现事件到达 RewardedAdEventListener 对象。

使用 rewardedAd.setAdEventListener 方法设置 RewardedAdEventListener 对象。

统一的事件名称。移除了 OnLeftApplication 和 OnReturnedToApplication 事件。

添加了 onAdFailedToShow 事件。

将 onImpression 事件重命名为 onAdImpression。

RewardedAdLoader.create(
  onAdLoaded: (RewardedAd rewardedAd) {},
  onAdFailedToLoad: (error) {},
);

void _setAdEventListener(RewardedAd ad) {
  ad.setAdEventListener(
      eventListener: RewardedAdEventListener(
          onAdShown: () {},
          onAdFailedToShow: (AdError error) {},
          onAdDismissed: () {},
          onAdClicked: () {},
          onAdImpression: (ImpressionData? data) {},
          onRewarded: (Reward reward) {}
      )
  );
}

插屏广告

我们改变了创建和加载广告的方法。我们现在提供 InterstitialAdLoader 加载器对象，用于加载广告，以及从 OnAdLoaded 广告加载事件检索的 Interstitial 广告对象。

广告加载

SDK 5

用于广告加载和呈现的单个对象：

final ad = await InterstitialAd.create(
  adUnitId: 'your-ad-unit-id',
  onAdLoaded: () {
    /* Do something */
  },
  onAdFailedToLoad: (error) {
      /* Do something */
  },
);
await ad.load(adRequest: AdRequest());

SDK 6

用于加载多个广告的 InterstitialAdLoader。

late final Future<InterstitialAdLoader> _adLoader =
      _createInterstitialAdLoader();
InterstitialAd? _ad;

Future<InterstitialAdLoader> _createInterstitialAdLoader() {
  return InterstitialAdLoader.create(
    onAdLoaded: (InterstitialAd interstitialAd) {
      // 广告加载成功。现在您可以显示已加载的广告
      _ad = interstitialAd;
    },
    onAdFailedToLoad: (error) {
      // 广告加载失败，出现 AdRequestError。
      // 强烈建议不要尝试通过 onAdFailedToLoad() 方法加载新广告。
    },
  );
}

Future<void> _loadInterstitialAd() async {
  final adLoader = await _adLoader;
  await adLoader.loadAd(adRequestConfiguration: AdRequestConfiguration(adUnitId: 'your-ad-unit-id'));
}

广告呈现

SDK 5

在展示广告之前，请查看广告是否已加载。

InterstitialAd? _ad;

Future<void> _showInterstitialAd() async {
  final ad = _ad;
  if (ad != null && ad.isLoaded) {
    await ad.show();
    await ad.waitForDismiss();
  }
}

SDK 6

您无需检查广告是否已加载。广告在通过 onAdLoaded() 回调方法返回后，准备好进行呈现。

InterstitialAd? _ad;

Future<void> _showInterstitialAd() async {
  final ad = _ad;
  if (ad != null) {
    _setAdEventListener(ad);
    await ad.show();
    await ad.waitForDismiss();
  }
}

订阅广告生命周期事件

SDK 5

所有事件均到达单个 InterstitialAd 对象。

InterstitialAd.create(
  onAdLoaded: () {},
  onAdFailedToLoad: (AdLoadError error) {},
  onAdShown: () {},
  onAdDismissed: () {},
  onAdClicked: () {},
  onLeftApplication: () {},
  onReturnedToApplication: () {},
  onImpression: (String? impressionData) {},
);

SDK 6

广告加载事件到达 InterstitialAdLoader 对象，而广告呈现事件到达 InterstitialAdEventListener 对象。

使用 interstitialAd.setAdEventListener 方法设置 InterstitialAdEventListener 对象。

统一的事件名称。移除了 OnLeftApplication 和 OnReturnedToApplication 事件。

添加了 onAdFailedToShow 事件。

将 onImpression 事件重命名为 onAdImpression。

InterstitialAdLoader.create(
  onAdLoaded: (InterstitialAd interstitialAd) {},
  onAdFailedToLoad: (error) {},
);

void _setAdEventListener(InterstitialAd ad) {
  ad.setAdEventListener(
      eventListener: InterstitialAdEventListener(
          onAdShown: () {},
          onAdFailedToShow: (AdError error) {},
          onAdDismissed: () {},
          onAdClicked: () {},
          onAdImpression: (ImpressionData? data) {}
      )
  );
}

开屏广告

添加了新的广告格式：开屏广告。如需了解更多信息，请参阅 开屏广告

您可以在此处查找完整的集成示例：

Yandex 聚合

重要

确保将您使用的 Yandex 聚合 适配器更新到最新版本。旧版本可能会导致适配器集成错误，从而导致您的广告无法投放。

将 com.yandex.ads.mediation:mobileads-admob 构件重命名为 com.yandex.ads.mediation:mobileads-google。

如果您使用标准化聚合构建，则无需执行任何操作。如果单独添加适配器，请替换项目中的 gradle 依赖项。

SDK 5

implementation 'com.yandex.ads.mediation:mobileads-admob:<version>'

SDK 6

implementation 'com.yandex.ads.mediation:mobileads-google:<version>'

我们将 AdMobYandexMobileAdsAdapters 适配器重命名为 GoogleYandexMobileAdsAdapters。如果您使用标准化聚合构建，则无需执行任何操作。如果单独添加适配器，则需要编辑项目的 Podfile。

SDK 5

pod 'AdMobYandexMobileAdsAdapters'

SDK 6

pod 'GoogleYandexMobileAdsAdapters'
上一篇
集成插件
下一篇
广告格式