bwt_ad_flutter

Description:

bwt ad flutter

bwt_ad_flutter #
Bwt广告SDK的Flutter插件
[TOC]
1.1 快速集成 #
在Flutter项目的pubspec.yaml中导入插件依赖
dependencies:
bwt_ad_flutter: ^0.0.5
copied to clipboard
1.2 iOS工程环境配置 #

打开项⽬的 app target，查看 Build Settings 中的 Linking-Other Linker Flags 选项，确保含有 -ObjC ⼀值，若没有则添加。
在项⽬的 app target 中，查看 Build Settings 中的 Build options - Enable Bitcode 选项， 设置为NO。
info.plist 添加⽀持 Http访问字段。

<key>NSAppTransportSecurity</key>
<dict>
<key>NSAllowsArbitraryLoads</key>
<true/>
</dict>
copied to clipboard

Info.plist 添加定位权限字段。

NSLocationWhenInUseUsageDescription
NSLocationAlwaysAndWhenInUseUsageDeion
copied to clipboard

Info.plist设置⽩名单（⽆需全部添加，建议添加其中⼴告预算⾜的媒体，例如抖⾳、京东等）。

<key>LSApplicationQueriesSchemes</key>
<array>
<string>dianping</string>
<string>imeituan</string>
<string>com.suning.SuningEBuy</string>
<string>suning</string>
<string>openapp.jdmobile</string>
<string>vipshop</string>
<string>snssdk141</string>
<string>ctrip</string>
<string>qunariphone</string>
<string>QunarAlipay</string>
<string>qunaraphone</string>
<string>yohobuy</string>
<string>kaola</string>
<string>qqnews</string>
<string>openapp.xzdz</string>
<string>beibeiapp</string>
<string>taobao</string>
<string>tmall</string>
<string>openjd</string>
<string>jd</string>
<string>jhs</string>
<string>weixin</string>
<string>yhd</string>
<string>wireless1688</string>
<string>GomeEShop</string>
<string>wbmain</string>
<string>xhsdiscover</string>
<string>douyin</string>
<string>pinduoduo</string>
<string>jdmobile</string>
<string>tbopen</string>
<string>pddopen</string>
<string>mogujie</string>
<string>koubei</string>
<string>eleme</string>
<string>youku</string>
<string>gengmei</string>
<string>airbnb</string>
<string>alipays</string>
<string>alipay</string>
<string>didicommon</string>
<string>OneTravel</string>
<string>farfetchCN</string>
<string>farfetch</string>
<string>snssdk1112</string>
<string>snssdk1128</string>
<string>miguvideo</string>
<string>kfcapplinkurl</string>
<string>iqiyi</string>
<string>uclink</string>
<string>app.soyoung</string>
<string>qqmusic</string>
<string>kwai</string>
<string>ksnebula</string>
<string>taobaolite</string>
<string>lianjiabeike</string>
</array>
copied to clipboard
1.3 iOS14适配 #
#
由于iOS14中对于权限和隐私内容有⼀定程度的修改，⽽且和⼴告业务关系较⼤，请按照如下步骤适配，如果未适
配。不会导致运⾏异常或者崩溃等情况，但是会⼀定程度上影响⼴告收⼊。敬请知悉。

应⽤编译环境升级⾄ Xcode 12.0 及以上版本；
设置IDFA权限；

1.3.1 IDFA #
从 iOS 14 开始，在应⽤程序调⽤ App Tracking Transparency 向⽤户提跟踪授权请求之前，IDFA 将不可⽤。
更新 Info.plist，添加 NSUserTrackingUsageDescription 字段和⾃定义⽂案描述。
<key>NSUserTrackingUsageDescription</key>
<string>该标识符将⽤于向您投放个性化⼴告</string>
copied to clipboard
2.1 插件初始化 #
恭喜你，经过以上简单配置之后，现在可以正式开始插件的使用了。在使用广告之前，需要先进行插件初始化，建议在main.dart中完成。
await BwtAdCore.init(
// appId，不同端的appID可能不一致，需要替换成自己相应端的appId
appId: Platform.isAndroid ? '400805' : '310641',
// iOS请求广告前是否先申请IDFA，默认true
isRequestIdfa: true,
// 广告内部日志打印设置，默认为NONE（不打印），正式包建议设置为NONE
logType: BwtAdLogType.NONE,
);
copied to clipboard
2.2 开屏广告 #
加载开屏广告，打开原生界面加载并展示开屏广告。
注意及时release开屏广告加载器对象BwtSplashAdLoader，具体代码请参考开屏示例。
// 构建开屏广告加载器
_splashAdLoader = BwtSplashAdLoader();
// 设置各种监听
_splashAdLoader?.onAdLoad = (bwtAd) {
Log.d('开屏广告加载成功...');
};
_splashAdLoader?.onAdFailed = (msg) {
Log.d('开屏广告加载失败, $msg');
};
_splashAdLoader?.onAdExpose = (bwtAd) {
Log.d('开屏广告展示成功...');
};
_splashAdLoader?.onAdClick = (bwtAd) {
Log.d('开屏广告被点击...');
};
_splashAdLoader?.onAdClose = (bwtAd) {
Log.d('开屏广告被关闭...');
};

// 加载并展示开屏广告，设置logoName和backgroundName时需确认以下两条规则
// Android端应在drawable或者mipmap中有相应文件
// iOS端应有相应名字的imageset
_splashAdLoader?.loadAd(
// 广告位ID，不同端的广告位ID可能不一致，需替换成自己相应端的广告位ID
posId: Platform.isAndroid ? '14303340' : '09785892',
// 底部展示的logo图片名称（不带后缀），不传则没有底部logo组件（高度为156）
logoName: 'splash_ad_logo',
// 加载开屏广告等待过程中的占位背景图（不带后缀），不传则默认是白色背景
backgroundName: 'splash_ad_background',
);
copied to clipboard
2.3 插屏广告 #
加载插屏广告，加载、展示插屏广告，加载和展示时机可区分自行控制。
注意及时release插屏广告加载器对象BwtInterstitialAdLoader，具体代码请参考插屏示例。
// 构造插屏广告加载器
_interstitialAdLoader = BwtInterstitialAdLoader();
// 设置各种监听
_interstitialAdLoader?.onAdLoad = (bwtAd) {
_bwtAd = bwtAd;
Fluttertoast.showToast(msg: "插屏广告加载成功");
Log.d('插屏广告加载成功...');
};
_interstitialAdLoader?.onAdFailed = (msg) {
Fluttertoast.showToast(msg: "插屏广告加载失败");
Log.d('插屏广告加载失败, $msg');
};
_interstitialAdLoader?.onAdExpose = (bwtAd) {
Log.d('插屏广告展示成功...');
};
_interstitialAdLoader?.onAdClick = (bwtAd) {
Log.d('插屏广告被点击...');
};
_interstitialAdLoader?.onAdClose = (bwtAd) {
Log.d('插屏广告被关闭...');
};

// 加载插屏广告
_interstitialAdLoader?.loadAd(
// 广告位ID，不同端的广告位ID可能不一致，需替换成自己相应端的广告位ID
posId: Platform.isAndroid ? '24687946' : '98855071',
// 加载成功后是否立即展示，如果设置为false，请在onAdLoad回调中保存bwtAd对象，在适当时机调用BwtInterstitialAdLoader的showAd方法
loadThenShow: loadThenShow,
);
copied to clipboard
3.1 广告源扩展 #
扩展SDK支持的广告源，可以一定程度的提升广告收益，请根据需要进行添加。

Android端

在app的build.gradle中添加所需的广告源依赖。
// 优量汇
implementation 'com.bwt.top:gdt:1.1.29.1'
implementation 'com.qq.e.union:union:4.570.1440'

// 穿山甲
implementation 'com.bwt.top:csj:1.1.29.1'
implementation 'com.pangle.cn:mediation-sdk:6.2.1.7'
copied to clipboard

iOS端

iOS在项目的podfile中添加所需的广告源依赖。
# 优量汇
pod 'CXHAdSDK/GDT', '1.5.5'

# 穿山甲
pod 'CXHAdSDK/BU', '1.5.5'
copied to clipboard