- 🔨 接入简单快速（封装原生端配置，仅需引入即可）
- 📡 事件统一返回（将原生端各种重要回调事件统一返回，方便业务处理和埋点统计等需求）
- 🎁 注重优化体验（无闪烁 Logo 开屏、权限申请、隐私跟踪申请等、信息流自动适配宽高）
- 🏆 极客代码封装（原生端代码不凑合，两端统一基础框架、广告事件封装抽象、易扩展新广告形式、方便开发个性化需求）
- 【Gromore】可进行多家广告瀑布流竞价，让您拥有更高的广告收益，发挥最大的用户价值
回复
优量汇体验
- 插件问题解答
- 变现玩法交流
- 收益提升探讨
- 大盘趋势推送
- 版本更新推送
因微信群入群限制，请添加个人微信备注：
变现群，我拉你进群。
dependencies:
flutter_qq_ads: ^2.7.0/// [appId] 应用媒体ID
FlutterQqAds.initAd(appId);- 半屏广告 + Logo
/// [posId] 广告位 id
/// [logo] 如果传值则展示底部logo，不传不展示，则全屏展示
/// [fetchDelay] 拉取广告的超时时间，默认值 3 秒，取值范围[1.5~5]秒
FlutterQqAds.showSplashAd(
AdsConfig.splashId,
logo: 'flutterads_logo',
fetchDelay: 3,
);-
全屏广告
FlutterQqAds.showSplashAd(posId);- 插屏半屏
/// [posId] 广告位 id
/// [showPopup] Popup 形式显示（仅 Android）
/// [autoPlayOnWifi] 是否仅在 WiFi 网络下自动播放
/// [autoPlayMuted] 自动播放是否静音
/// [detailPageMuted] 详情页是否静音
FlutterQqAds.showInterstitialAd(
posId,
showPopup: false,
autoPlayMuted: false,
autoPlayOnWifi: false,
detailPageMuted: false,
);- 插屏全屏视频
/// [posId] 广告位 id
/// [showFullScreenVideo] 插屏全屏视频形式显示
FlutterQqAds.showInterstitialAd(
posId,
showFullScreenVideo: true,
);- 插屏激励视频
/// [posId] 广告位 id
/// [showRewardVideo] 插屏激励视频形式显示
/// [customData] 设置服务端验证的自定义信息
/// [userId] 设置服务端验证的用户信息
FlutterQqAds.showInterstitialAd(
posId,
showRewardVideo: true,
customData: 'customData',
userId: 'userId',
);/// [posId] 广告位 id
/// [playMuted] 是否静音播放
/// [customData] 设置服务端验证的自定义信息
/// [userId] 设置服务端验证的用户信息
FlutterQqAds.showRewardVideoAd(
posId,
playMuted: false,
customData: 'customData',
userId: 'userId',
);/// [posId] 广告位 id
/// [width] 宽度
/// [height] 高度
/// [interval] 广告刷新间隔，0 或[30~120]之间的数字，单位为 s,默认 30s
/// Android:0 表示不自动轮播
/// iOS:0 表示关闭轮播动画，因为 iOS 没有不轮播
/// [show] 是否显示广告
AdBannerWidget(
posId: AdsConfig.bannerId02,
width: 375,
height: 100,
interval: 120,
show: true,
)
v1.4.0开始不再需要外部嵌套，如果需要按比例设置，可以看如下示例：
- 嵌套宽高比约束布局
AspectRatio
AspectRatio(
aspectRatio: 6.4 / 1, // 6.4:1 的比例
child: AdBannerWidget(
posId: AdsConfig.bannerId02,
width: double.maxFinite,
height: double.maxFinite,
interval: 120,
),
),- 获取信息流广告列表
/// [posId] 广告位 id
/// [width] 宽度
/// [height] 高度，0：代表自适应广告高度
/// [count] 获取广告数量，建议 1~3 个
List<int> feedAdList = await FlutterQqAds.loadFeedAd(
AdsConfig.feedId,
width: 375,
height: 0,
count: 3,
);- 清除信息流广告列表
当你的广告不再需要时，请一定执行清除操作
/// [list] 信息流广告 id 列表
bool result = await FlutterQqAds.clearFeedAd(feedAdList);- 页面中展示信息流广告
/// Feed 信息流广告组件
/// [posId]返回的广告 id，这里不是广告位id
/// [width]组件的宽度
/// [height]组件的高度
/// [show]是否显示
AdFeedWidget(
posId: '${feedAdList[0]}',
width: 375,
height: 128,
show: true,
)
width和height只是展示 widget 组件宽高，最终会自动适配实际广告的宽高，不可设置为 0
FlutterQqAds.onEventListener((event) {
// 普通广告事件
String _adEvent = 'adId:${event.adId} action:${event.action}';
if (event is AdErrorEvent) {
// 错误事件
_adEvent += ' errCode:${event.errCode} errMsg:${event.errMsg}';
} else if (event is AdRewardEvent) {
// 激励事件
_adEvent +=
' transId:${event.transId} customData:${event.customData} userId:${event.userId}';
}
print('onEventListener:$_adEvent');
});| 事件 | 说明 |
|---|---|
| onAdLoaded | 广告加载成功 |
| onAdPresent | 广告填充 |
| onAdExposure | 广告曝光 |
| onAdClosed | 广告关闭（开屏计时结束或者用户点击关闭） |
| onAdClicked | 广告点击 |
| onAdSkip | 广告跳过 |
| onAdComplete | 广告播放或计时完毕 |
| onAdError | 广告错误 |
| onAdReward | 获得广告激励 |
这里做了统一的抽象，iOS 和 Android 原生 SDK 名称不同，如果觉得对应不上，可以提 Issues（一定要加上 log 截图）
苹果公司在iOS9中升级了应用网络通信安全策略，默认推荐开发者使用HTTPS协议来进行网络通信，并限制HTTP协议的请求。为了避免出现无法拉取到广告的情况，我们推荐开发者在info.plist文件中增加如下配置来实现广告的网络访问
- 修改
info.plist
<key>NSAppTransportSecurity</key>
<dict>
<key>NSAllowsArbitraryLoads</key>
<true/>
</dict>
此步骤必须要做，不然上架审核时候会被拒绝
bool result = await FlutterQqAds.requestIDFA;- 修改
info.plist
<key>NSUserTrackingUsageDescription</key>
<string>为了向您提供更优质、安全的个性化服务及内容，需要您允许使用相关权限</string>
- 效果
如果是大版本，我会第一时间适配更新，小版本可以自己更新，方法如下：
-
Android
方法1：可以给我提 Issues 提示我更新，版本号
x.y.z，会更新z版本迭代方法2：可以自己指定版本，方法如下:
// build.gradle(android.app)
android{
configurations.all {
resolutionStrategy {
force 'com.qq.e.union:union:版本号'
}
}
}-
iOS
自己手动更新，自己的项目根目录下执行即可
// 可在 ios/Podfile.lock 中查看 SDK 当前版本
cd ios
rm -rf Podfile.lock
pod repo update
pod install| 插件 | 描述 |
|---|---|
| flutter_gromore_pro | 🏆🏆🏆 帮你大幅提升广告收益，发挥出最大的用户价值 |
| flutter_gromore_ads | 字节跳动、穿山甲、GroMore 聚合 Flutter 广告开源版插件 |
| flutter_pangle_ads | 字节跳动、穿山甲 Flutter 广告插件 |
| flutter_qq_ads | 腾讯广告、广点通、优量汇 Flutter 广告插件 |
| flutter_adspark | 巨量广告/穿山甲的广告监测、增长分析、归因上报、事件管理 Flutter 版插件 |
| flutter_adcontent | 穿山甲内容输出，支持「短剧」和「小视频」的 Flutter 版插件 |
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent