GroMore 广告插件

GroMore 广告插件基于穿山甲（Pangle）GroMore 聚合能力，为 Flutter 应用提供开屏、插屏、横幅、激励、信息流等多种广告形式。

📖 完整文档

💬 作者是一位经验丰富的互联网从业人员，深耕互联网多年。如果您在使用过程中遇到问题，或者想交流广告变现、短剧APP等相关话题，欢迎添加作者微信 light_core 交流探讨。

---

🔗 Flutter 穿山甲广告变现套件系列

本插件是 Flutter 穿山甲系列插件 的核心广告组件，提供完整的 GroMore 聚合广告能力。

插件	说明	文档
gromore_ads	GroMore 聚合广告（当前插件）	查看文档
pangrowth_content	穿山甲内容（短剧/小视频/故事）	查看文档
gromore_adspark	穿山甲 AdSpark 智能广告投放（规划中）	-
pangle_ecommerce	穿山甲电商联盟 - 抖音电商CPS（规划中）	-
pangle_global	Pangle Global 穿山甲国际版（规划中）	-

---

✨ 功能亮点

• 🚀 支持开屏、插屏、Banner、激励视频、信息流、Draw Feed
• 🎯 内置事件监听与奖励回调
• 📱 iOS 与 Android 双端统一 API
• 🧱 提供 Banner/Feed Widget，快速落地
• 🔐 提供授权与个性化配置接口

🛠️ 环境要求

• Flutter: >=3.3.0
• Dart: ^3.9.0
• Android: minSdkVersion 24
• iOS: iOS 10.0+

📦 安装

dependencies:
  gromore_ads: ^latest_version

🚀 快速开始

import 'dart:io';
import 'package:gromore_ads/gromore_ads.dart';

// 初始化SDK并预加载广告
Future<void> _bootstrapAds() async {
  try {
    // 1) 可选隐私权限
    if (Platform.isIOS) {
      await GromoreAds.requestIDFA;
    } else if (Platform.isAndroid) {
      await GromoreAds.requestPermissionIfNecessary;
    }

    // 2) 注册事件监听器
    _adEventSubscription = GromoreAds.onEvent(
      onEvent: (event) {
        debugPrint('📌 广告事件: ${event.action} (posId: ${event.posId})');
      },
      onError: (event) {
        debugPrint('❌ 广告错误 ${event.code}: ${event.message}');
      },
      onReward: (event) {
        if (event.verified) {
          debugPrint('✅ 奖励验证成功: ${event.rewardType ?? ''} x${event.rewardAmount ?? 0}');
        }
      },
    );

    // 3) 初始化 SDK
    final success = await GromoreAds.initAd(
      'your_app_id',
      useMediation: true,
      debugMode: true,
    );

    if (success) {
      // 4) 可选：预加载常用广告位
      await GromoreAds.preload(
        configs: const [
          PreloadConfig.rewardVideo(['reward_pos_id']),
          PreloadConfig.interstitial(['interstitial_pos_id']),
          PreloadConfig.feed(['feed_pos_id']),
          PreloadConfig.banner(['banner_pos_id']),
        ],
      );
    } else {
      debugPrint('SDK初始化失败，请检查配置');
    }
  } catch (e) {
    debugPrint('广告SDK启动异常: $e');
  }
}

📺 广告类型

开屏广告

await GromoreAds.showSplashAd(
  SplashAdRequest(
    posId: 'splash_pos_id',
    timeout: Duration(seconds: 4),
    logo: SplashAdLogo.asset('assets/logo.png', heightRatio: 0.15),
  ),
);

插屏广告

// 先加载
await GromoreAds.loadInterstitialAd('interstitial_pos_id');

// 后展示
await GromoreAds.showInterstitialAd('interstitial_pos_id');

Banner 广告（Widget）

AdBannerWidget(
  posId: 'banner_pos_id',
  width: 375,
  height: 60,
  onAdLoaded: () => print('Banner加载成功'),
)

激励视频

// 加载
await GromoreAds.loadRewardVideoAd('reward_pos_id');

// 展示
await GromoreAds.showRewardVideoAd('reward_pos_id');

// 监听奖励
GromoreAds.onRewardVideoEvents(
  'reward_pos_id',
  onRewarded: (event) {
    if (event.verified) {
      print('🎁 获得奖励: ${event.rewardAmount}');
    }
  },
);

信息流广告

// 加载广告（返回广告ID列表）
final adIds = await GromoreAds.loadFeedAd(
  'feed_pos_id',
  width: 375,
  height: 300,
  count: 3,
);

// 在列表中渲染
AdFeedWidget(
  posId: 'feed_pos_id',
  adId: adIds[0],
  width: 375,
  height: 300,
)

Draw 信息流

// 加载
final drawIds = await GromoreAds.loadDrawFeedAd(
  'draw_pos_id',
  width: 375,
  height: 300,
  count: 3,
);

// 渲染
AdDrawFeedWidget(
  posId: 'draw_pos_id',
  adId: drawIds[0],
  width: 375,
  height: 300,
)

📊 事件监听

全局监听

_subscription = GromoreAds.onEvent(
  onEvent: (event) => print('事件: ${event.action}'),
  onError: (event) => print('错误: ${event.message}'),
  onReward: (event) => print('奖励: ${event.rewardAmount}'),
  onEcpm: (event) => print('eCPM: ${event.ecpm}'),
);

按广告位监听

_subscription = GromoreAds.onAdEvents(
  'your_pos_id',
  onEvent: (event) => print('事件: ${event.action}'),
);

按类型监听

// 激励视频
GromoreAds.onRewardVideoEvents('pos_id',
  onLoaded: (e) => print('加载成功'),
  onRewarded: (e) => print('奖励发放'),
);

// 开屏广告
GromoreAds.onSplashEvents('pos_id',
  onClosed: (e) => print('广告关闭'),
);

// 插屏广告
GromoreAds.onInterstitialEvents('pos_id',
  onClosed: (e) => print('广告关闭'),
);

记得取消订阅：

@override
void dispose() {
  _subscription?.cancel();
  super.dispose();
}

⚡ 预加载

await GromoreAds.preload(
  configs: [
    PreloadConfig.rewardVideo(['reward_id_1', 'reward_id_2']),
    PreloadConfig.interstitial(['interstitial_id']),
    PreloadConfig.feed(['feed_id'], count: 3),
    PreloadConfig.drawFeed(['draw_id'], count: 3),
    PreloadConfig.banner(['banner_id']),
  ],
  maxConcurrent: 3,        // 最大并发数
  intervalMillis: 500,     // 请求间隔(毫秒)
);

🧪 测试工具

// 启动GroMore官方测试工具（仅测试环境）
await GromoreAds.launchTestTools();

📄 许可证

MIT License - 详见 LICENSE 文件。

🔗 支持与联系

• 作者：Xlxinxi
• 邮箱：369620805@qq.com
• 微信：light_core
• 📖 完整文档
• 🐛 Issue 反馈