一套 API 接入 Banner、插屏、激励、激励插屏、原生和开屏广告让广告初始化、预加载、展示回调和收益统计更加简单。适用版本ads_manager 1.2.2技术栈Flutter、Dart、Google Mobile Ads、AdMob【一、为什么需要 ads_manager】在 Flutter 项目中直接接入 Google Mobile Ads最开始可能只需要几行代码。但随着项目功能增加广告逻辑通常会逐渐分散• 每个页面重复处理广告初始化和广告位 ID• 插屏、激励广告需要重复编写预加载逻辑• 广告加载、展示和关闭回调分散在不同页面• 激励奖励和广告收益埋点难以统一• 开屏广告在嵌套路由中容易出现误展示• 页面销毁后容易忘记释放广告资源ads_manager 的作用就是把这些通用逻辑统一封装让业务代码只关注广告展示时机和奖励业务。【二、核心功能】◆ 统一初始化 Google Mobile Ads SDK◆ 支持 Banner、插屏、激励、激励插屏、原生和开屏广告◆ 按广告位缓存并复用 service 实例◆ 支持全屏广告预加载◆ 统一处理广告加载、展示、关闭、点击和失败回调◆ 支持激励奖励回调◆ 支持广告收益事件统一监听◆ 支持开屏广告开关和固定展示间隔◆ 支持嵌套路由下的页面级开屏广告控制◆ 支持日志开关和 Ad Inspector 调试【三、安装方式】在 Flutter 项目的 pubspec.yaml 中添加依赖dependencies: ads_manager: ^1.2.2然后执行flutter pub get使用前请按照 Google Mobile Ads 官方文档完成 Android 和 iOS 平台的 App ID 配置。开发和测试阶段请使用官方测试广告位避免误点击真实广告。【四、快速开始】初始化广告 SDKimport package:ads_manager/ad_manager_lib.dart;Futurevoid initAds() async {final initialized await AdsManager.initAdmob(testDeviceIds: const [YOUR_TEST_DEVICE_ID],);if (!initialized) {// 根据业务需要执行降级处理}}声明广告位并获取 serviceconst rewardedUnit AdUnit(AdsType.rewarded,ca-app-pub-xxx/rewarded,);final rewardedService AdsManager.getAdmobService(rewardedUnit);预加载并展示激励广告await rewardedService.preloadAds(1);await rewardedService.showAdIfAvailable(options: const AdOptions(userId: user_1001,customData: order_2002,),adCallBack: AdCallBack(onRewardEarned: (type) {// 发放用户奖励},onAdDismissed: (type, {isEarnedReward}) {// 广告关闭},),);【五、Banner 广告示例】const bannerUnit AdUnit( AdsType.banner, ca-app-pub-xxx/banner, ); final bannerService AdsManager.getAdmobService(bannerUnit); final bannerAd await bannerService.loadBannerAd( context: context, options: const AdOptions(), ); if (bannerAd ! null) { final bannerWidget AdWidget(ad: bannerAd); }【六、插屏广告示例】const interstitialUnit AdUnit( AdsType.interstitial, ca-app-pub-xxx/interstitial, ); final interstitialService AdsManager.getAdmobService(interstitialUnit); await interstitialService.preloadAds(1); await interstitialService.showAdIfAvailable();【七、开屏广告示例】const appOpenUnit AdUnit( AdsType.appOpenAd, ca-app-pub-xxx/app-open, ); final appOpenService AdsManager.getAdmobService(appOpenUnit); appOpenService.appOpenAdEnabled( true, fixedInterval: 10, enableAutoCache: true, );【八、嵌套路由下的开屏广告控制】当应用存在多个页面或嵌套路由时可以为页面设置独立的开屏广告展示策略。final pageOwner Object(); override void initState() { super.initState(); appOpenService.setOpenAppAdVisibility( false, owner: pageOwner, ); } override void dispose() { appOpenService.clearOpenAppAdVisibility(pageOwner); super.dispose(); }页面退出时清除自己的 owner不会影响其他页面的展示策略。【九、统一监听广告收益事件】final subscription AdsManager.onAdRevenueChange.listen((event) { // 将收益事件交给埋点或归因系统 }); override void dispose() { subscription.cancel(); super.dispose(); }通过全局收益流可以统一接入数据分析、广告归因和商业化平台。【十、适合哪些项目】• 工具类 Flutter 应用• 内容类和资讯类应用• 游戏类应用• 社交和社区类应用• 需要激励广告奖励的业务• 需要统一广告收益埋点的项目• 存在启动页和嵌套路由的应用【十一、接入注意事项】调用 AdsManager.initAdmob 前请先完成 Android 和 iOS 原生配置。开发阶段请使用 Google 官方测试广告位。全屏广告建议提前调用 preloadAds。展示广告时可以使用 showAdIfAvailable广告不可用时不会阻塞业务流程。奖励发放应以 onRewardEarned 回调为准并结合服务端幂等机制避免重复发奖。页面销毁或账号切换时请及时释放广告 service。【十二、项目地址】GitHubGitHub - akumaCN/ads_manager · GitHubPub.devads_manager | Flutter packageIssueIssues · akumaCN/ads_manager · GitHub【结语】广告接入不应该成为每个页面都要重复解决的问题。使用 ads_manager可以统一管理广告初始化、广告缓存、预加载、展示回调和收益事件让业务代码更加简洁也让后续的广告策略调整更加容易。如果你正在开发 Flutter 商业化应用欢迎试用 ads_manager并通过 GitHub 提交 Issue 或 PR。
一套 API 接入 Banner、插屏、激励、激励插屏、原生和开屏广告让广告初始化、预加载、展示回调和收益统计更加简单。适用版本ads_manager 1.2.2技术栈Flutter、Dart、Google Mobile Ads、AdMob【一、为什么需要 ads_manager】在 Flutter 项目中直接接入 Google Mobile Ads最开始可能只需要几行代码。但随着项目功能增加广告逻辑通常会逐渐分散• 每个页面重复处理广告初始化和广告位 ID• 插屏、激励广告需要重复编写预加载逻辑• 广告加载、展示和关闭回调分散在不同页面• 激励奖励和广告收益埋点难以统一• 开屏广告在嵌套路由中容易出现误展示• 页面销毁后容易忘记释放广告资源ads_manager 的作用就是把这些通用逻辑统一封装让业务代码只关注广告展示时机和奖励业务。【二、核心功能】◆ 统一初始化 Google Mobile Ads SDK◆ 支持 Banner、插屏、激励、激励插屏、原生和开屏广告◆ 按广告位缓存并复用 service 实例◆ 支持全屏广告预加载◆ 统一处理广告加载、展示、关闭、点击和失败回调◆ 支持激励奖励回调◆ 支持广告收益事件统一监听◆ 支持开屏广告开关和固定展示间隔◆ 支持嵌套路由下的页面级开屏广告控制◆ 支持日志开关和 Ad Inspector 调试【三、安装方式】在 Flutter 项目的 pubspec.yaml 中添加依赖dependencies: ads_manager: ^1.2.2然后执行flutter pub get使用前请按照 Google Mobile Ads 官方文档完成 Android 和 iOS 平台的 App ID 配置。开发和测试阶段请使用官方测试广告位避免误点击真实广告。【四、快速开始】初始化广告 SDKimport package:ads_manager/ad_manager_lib.dart;Futurevoid initAds() async {final initialized await AdsManager.initAdmob(testDeviceIds: const [YOUR_TEST_DEVICE_ID],);if (!initialized) {// 根据业务需要执行降级处理}}声明广告位并获取 serviceconst rewardedUnit AdUnit(AdsType.rewarded,ca-app-pub-xxx/rewarded,);final rewardedService AdsManager.getAdmobService(rewardedUnit);预加载并展示激励广告await rewardedService.preloadAds(1);await rewardedService.showAdIfAvailable(options: const AdOptions(userId: user_1001,customData: order_2002,),adCallBack: AdCallBack(onRewardEarned: (type) {// 发放用户奖励},onAdDismissed: (type, {isEarnedReward}) {// 广告关闭},),);【五、Banner 广告示例】const bannerUnit AdUnit( AdsType.banner, ca-app-pub-xxx/banner, ); final bannerService AdsManager.getAdmobService(bannerUnit); final bannerAd await bannerService.loadBannerAd( context: context, options: const AdOptions(), ); if (bannerAd ! null) { final bannerWidget AdWidget(ad: bannerAd); }【六、插屏广告示例】const interstitialUnit AdUnit( AdsType.interstitial, ca-app-pub-xxx/interstitial, ); final interstitialService AdsManager.getAdmobService(interstitialUnit); await interstitialService.preloadAds(1); await interstitialService.showAdIfAvailable();【七、开屏广告示例】const appOpenUnit AdUnit( AdsType.appOpenAd, ca-app-pub-xxx/app-open, ); final appOpenService AdsManager.getAdmobService(appOpenUnit); appOpenService.appOpenAdEnabled( true, fixedInterval: 10, enableAutoCache: true, );【八、嵌套路由下的开屏广告控制】当应用存在多个页面或嵌套路由时可以为页面设置独立的开屏广告展示策略。final pageOwner Object(); override void initState() { super.initState(); appOpenService.setOpenAppAdVisibility( false, owner: pageOwner, ); } override void dispose() { appOpenService.clearOpenAppAdVisibility(pageOwner); super.dispose(); }页面退出时清除自己的 owner不会影响其他页面的展示策略。【九、统一监听广告收益事件】final subscription AdsManager.onAdRevenueChange.listen((event) { // 将收益事件交给埋点或归因系统 }); override void dispose() { subscription.cancel(); super.dispose(); }通过全局收益流可以统一接入数据分析、广告归因和商业化平台。【十、适合哪些项目】• 工具类 Flutter 应用• 内容类和资讯类应用• 游戏类应用• 社交和社区类应用• 需要激励广告奖励的业务• 需要统一广告收益埋点的项目• 存在启动页和嵌套路由的应用【十一、接入注意事项】调用 AdsManager.initAdmob 前请先完成 Android 和 iOS 原生配置。开发阶段请使用 Google 官方测试广告位。全屏广告建议提前调用 preloadAds。展示广告时可以使用 showAdIfAvailable广告不可用时不会阻塞业务流程。奖励发放应以 onRewardEarned 回调为准并结合服务端幂等机制避免重复发奖。页面销毁或账号切换时请及时释放广告 service。【十二、项目地址】GitHubGitHub - akumaCN/ads_manager · GitHubPub.devads_manager | Flutter packageIssueIssues · akumaCN/ads_manager · GitHub【结语】广告接入不应该成为每个页面都要重复解决的问题。使用 ads_manager可以统一管理广告初始化、广告缓存、预加载、展示回调和收益事件让业务代码更加简洁也让后续的广告策略调整更加容易。如果你正在开发 Flutter 商业化应用欢迎试用 ads_manager并通过 GitHub 提交 Issue 或 PR。
