尧图网络 高端网站定制 · 原创设计
免费咨询热线
400-888-6620
免费获取方案
Flutter 广告接入不再散落:用 ads_manager 统一管理 AdMob
一套 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。
RELATED

相关推荐

内存为什么越跑越高?从对象回收讲透内存泄漏的原因与预防

内存为什么越跑越高?从对象回收讲透内存泄漏的原因与预防

线上服务有一种问题很让人头疼:刚启动时一切正常。运行几个小时后,内存开始慢慢上涨。再过一段时间,接口变慢、GC 变频繁,最后甚至直接 OOM。很多时候,这背后就是一个很典型的问题:内存泄漏。不少人会把内存…

📅 2026/11/15 14:08:43
KMP 平台差异到底怎么设计?从日志导出重构看扩展函数、interface 与 expect/actual

KMP 平台差异到底怎么设计?从日志导出重构看扩展函数、interface 与 expect/actual

在 KMP 项目里,做到一定阶段后很容易遇到一个问题:同一个功能,Android 和 iOS 的底层实现完全不同,到底应该怎么处理?常见方案似乎有很多。比如:expect / actual或者:commonMain 定义 interface…

📅 2026/11/15 5:27:56
Altium Develop 学习资料整理

Altium Develop 学习资料整理

()引言 Altium Develop 可以理解为 Altium Designer(AD) 与 Altium 365(A365) 能力的结合。它不仅包含传统的原理图设计、PCB 设计和规则检查功能,也进一步结合了工作区、项目协作、版本管理、…

📅 2026/11/14 12:24:23
MORE NEWS

更多资讯

📰

玉林电工证审核怎么报名才靠谱?急需特种作业证才能上岗找工作

玉林电工证审核怎么报名才靠谱?急需特种作业证才能上岗找工作 现在找工作,没有特种作业证,连面试机会都难争取。尤其像电工这类岗位, 玉林电工证审核 是第一道门槛,也是关键。很多人急着问“ 怎么报名…

📰

电工证复审后换证吗?实操考试心里没底怕挂科,含金量还在吗?

电工证复审后换证吗?实操考试心里没底怕挂科,含金量还在吗? 实操考试心里没底怕挂科,尤其是第一次报考电工证的新人,面对各种专业设备和操作流程,真的会紧张到睡不着觉。很多人在考虑要不要考电工证时,第一个问题就是:“ 电工证复审后换证吗…

📰

河南电工证如何查询全国通用考试流程及避坑经验

河南电工证如何查询全国通用考试流程及避坑经验 怕考不过白交培训费?河南电工证如何查询考试成绩、学时和证书信息?作为一名在河南信阳参加电工证培训的学员,我深知大家在备考和报考过程中的焦虑与迷茫。今天就用一个真实案例,从考试流程、查询方式、继续…

📰

能考电工证的专科值不值得考 专科生考电工证真的有出路吗

能考电工证的专科值不值得考 专科生考电工证真的有出路吗 之前考的证在外省能不能转过来?这个问题困扰了不少正在考虑要不要报考电工证的专科生,特别是那些已经在外地工作、打算回老家发展的朋友。很多人担心, 能考电工证的专科…

📰

电工证到那复审怎么操作?通过率揭秘+备考全攻略来了

电工证到那复审怎么操作?通过率揭秘+备考全攻略来了 学历不高怕报不上名?你不是一个人。很多三门峡公路工程从业者都担心自己学历不够,考不了电工证,更别说复审了。但其实,电工证到那复审没你想象中那么难,关键是掌握方法,了解流程。今天就带你从零开…

📰

4级电工证备考资料哪里找?上岗必备的备考干货全在这儿

4级电工证备考资料哪里找?上岗必备的备考干货全在这儿 证书过期了不知道怎么复审延期,这事儿真的不能拖。尤其是像4级电工证这样的上岗必备证件,一旦过期就等于“失业证”,找工作、接项目都会被卡住。别急,今天就来聊聊4级电工证备考资料的那些事,帮…

TODAY

今日更新

THIS WEEK

本周精选

THIS MONTH

本月热门

读完文章,想聊聊您的网站?

告诉我们您的行业与需求,资深顾问一对一梳理方案与报价,全程免费。

📞 💬