fast_ads 1.1.0

本地 Flutter 广告封装包，集成 google_mobile_ads，支持 Banner、插屏、激励、原生广告，内置广告池、优先级兜底、重试等高级特性。

fast_ads

本地 Flutter 广告封装包，集成 google_mobile_ads，支持 Banner、插屏、激励、原生广告，内置广告池、优先级兜底、重试等高级特性。

功能特性

• 多类型广告：开屏、插屏、激励视频、原生、Banner、Feed 流
• 广告池：预加载、多单元优先级、自动重试
• 兜底与高价值池：主池 → 高价值池 → 兜底池展示优先级
• 频控与冷却：按广告位配置冷却时间、每日展示上限
• UMP：支持 GDPR 等隐私同意流程

安装

在 pubspec.yaml 中添加：

dependencies:
  fast_ads: ^1.0.0

使用

初始化

import 'package:fast_ads/fast_ads.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await FastAds.initialize();
  runApp(MyApp());
}

配置广告位并预加载

// 定义广告位（名称、是否启用、广告单元列表、冷却/频次等）
final placement = FastPlacement(
  name: 'ad_interstitial',
  enabled: true,
  adUnits: [
    FastAdUnit(adType: FastAdsType.interstitial, unitId: 'ca-app-pub-xxx/yyy'),
  ],
  cooldown: 60,
  dailyCap: 5,
);

// 预加载到主池
FastAds.preload(placement);
// 可选：预加载兜底、高价值池
FastAds.preloadFallback(fallbackPlacement);
FastAds.preloadHighValue(highValuePlacement);

展示广告

// 按优先级展示：高价值池 → 主池 → 兜底池
await FastAds.show(placement, preferHighValue: true);

// 直接加载并展示（不走缓存）
await FastAds.showDirect(placement);

Banner / Feed

// Banner
final banner = FastAds.showBanner(placement, index: 0);

// Feed 流原生广告
final nativeAd = FastAds.showFeed(feedPlacement, index: 0);

链接

• GitHub
• pub.dev

License

见项目根目录 LICENSE 文件。