共计 7710 个字符,预计需要花费 20 分钟才能阅读完成。
近期我的项目中须要用到穿山甲广告,看了几个插件,发现满足不了本人的需要,我的项目中须要用到的广告都须要应用原生 view 做嵌入。所以本人写了一个插件来实现相干的广告。我的项目仓库 flutter_unionad
集成步骤
1、SDK 初始化
await FlutterUnionad.register(
androidAppId: "5098580",
// 穿山甲广告 Android appid 必填
iosAppId: "5098580",
// 穿山甲广告 ios appid 必填
useTextureView: true,
// 应用 TextureView 控件播放视频, 默认为 SurfaceView, 当有 SurfaceView 抵触的场景,能够应用 TextureView 选填
appName: "unionad_test",
//appname 必填
allowShowNotify: true,
// 是否容许 sdk 展现告诉栏提醒 选填
allowShowPageWhenScreenLock: true,
// 是否在锁屏场景反对展现广告落地页 选填
debug: true,
// 是否显示 debug 日志
supportMultiProcess: true,
// 是否反对多过程,true 反对 选填
directDownloadNetworkType: [
FlutterUnionadNetCode.NETWORK_STATE_2G,
FlutterUnionadNetCode.NETWORK_STATE_3G,
FlutterUnionadNetCode.NETWORK_STATE_4G,
FlutterUnionadNetCode.NETWORK_STATE_WIFI
]); // 容许间接下载的网络状态汇合 选填
2、获取 SDK 版本
await FlutterUnionad.getSDKVersion();
3、申请权限
FlutterUnionad.requestPermissionIfNecessary(
callBack: FlutterUnionadPermissionCallBack(notDetermined: () {print("权限未确定");
},
restricted: () {print("权限限度");
},
denied: () {print("权限回绝");
},
authorized: () {print("权限批准");
},
),
);
Android 获取定位、照片权限,只返回胜利
Android 相干权限为非必须权限,可抉择在 AndroidManifest.xml 中申明
插件 1.2.2 当前不在默认集成权限,需手动配置
<!-- 可选权限 -->
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.REQUEST_INSTALL_PACKAGES"/>
<uses-permission android:name="android.permission.GET_TASKS"/>
<!-- 可选,穿山甲提供“获取地理位置权限”和“不给予地理位置权限,开发者传入地理位置参数”两种形式上报用户地位,两种形式均可不选,增加地位权限或参数将帮忙投放定位广告 -->
<!-- 请留神:无论通过何种形式提供给穿山甲用户地理位置,均需向用户申明地理位置权限将利用于穿山甲广告投放,穿山甲不强制获取地理位置信息 -->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<!-- 穿山甲 3400 版本新增:倡议增加“query_all_package”权限,穿山甲将通过此权限在 Android R 零碎上断定广告对应的利用是否在用户的 app 上装置,防止投放谬误的广告,以此进步用户的广告体验。若增加此权限,须要在您的用户隐衷文档中申明!-->
<uses-permission android:name="android.permission.QUERY_ALL_PACKAGES"/>
<!-- 如果有视频相干的广告且应用 textureView 播放,请务必增加,否则黑屏 -->
IOS 版本 14 及以上获取 ATT 权限,依据返回后果具体操作业务逻辑
4、开屏广告
FlutterUnionad.splashAdView(
// 是否应用个性化模版 设定 widget 宽高
mIsExpress: true,
//android 开屏广告广告 id 必填
androidCodeId: "887367774",
//ios 开屏广告广告 id 必填
iosCodeId: "887367774",
// 是否反对 DeepLink 选填
supportDeepLink: true,
// 冀望 view 宽度 dp 选填 mIsExpress=true 必填
expressViewWidth: 750,
// 冀望 view 高度 dp 选填 mIsExpress=true 必填
expressViewHeight: 800,
// 管制下载 APP 前是否弹出二次确认弹窗
downloadType: FlutterUnionadDownLoadType.DOWNLOAD_TYPE_POPUP,
callBack: FlutterUnionadSplashCallBack(onShow: () {print("开屏广告显示");
},
onClick: () {print("开屏广告点击");
Navigator.pop(context);
},
onFail: (error) {print("开屏广告失败 $error");
},
onFinish: () {print("开屏广告倒计时完结");
Navigator.pop(context);
},
onSkip: () {print("开屏广告跳过");
Navigator.pop(context);
},
onTimeOut: () {print("开屏广告超时");
},
),
),
5、banner 广告
FlutterUnionad.bannerAdView(
//andrrid banner 广告 id 必填
androidCodeId: "945410197",
//ios banner 广告 id 必填
iosCodeId: "945410197",
// 是否应用个性化模版
mIsExpress: true,
// 是否反对 DeepLink 选填
supportDeepLink: true,
// 一次申请广告数量 大于 1 小于 3 必填
expressAdNum: 3,
// 轮播距离事件 30-120 秒 选填
expressTime: 30,
// 冀望 view 宽度 dp 必填
expressViewWidth: 600.5,
// 冀望 view 高度 dp 必填
expressViewHeight: 120.5,
// 管制下载 APP 前是否弹出二次确认弹窗
downloadType: FlutterUnionadDownLoadType.DOWNLOAD_TYPE_POPUP,
// 广告事件回调 选填
callBack: FlutterUnionadBannerCallBack(onShow: () {print("banner 广告加载实现");
},
onDislike: (message){print("banner 不感兴趣 $message");
},
onFail: (error){print("banner 广告加载失败 $error");
},
onClick: (){print("banner 广告点击");
}
),
),
6、信息流广告
FlutterUnionad.nativeAdView(
androidCodeId: "945417699",
//android 信息流广告 id 必填
iosCodeId: "945417699",
//ios banner 广告 id 必填
supportDeepLink: true,
// 是否反对 DeepLink 选填
expressViewWidth: 375.5,
// 冀望 view 宽度 dp 必填,如果设为 0 则依据返回广告宽高做自适应调整
expressViewHeight: 275.5,
// 冀望 view 高度 dp 必填
expressNum: 2,
mIsExpress: true,
// 管制下载 APP 前是否弹出二次确认弹窗
downloadType: FlutterUnionadDownLoadType.DOWNLOAD_TYPE_POPUP,
// 一次申请广告数量 大于 1 小于 3 必填
callBack: FlutterUnionadNativeCallBack(onShow: () {print("信息流广告显示");
},
onFail: (error) {print("信息流广告失败 $error");
},
onDislike: (message) {print("信息流广告不感兴趣 $message");
},
onClick: () {print("信息流广告点击");
},
),
),
7、 插屏广告
不举荐应用,请应用新模版渲染插屏广告
await FlutterUnionad.interactionAd(
androidCodeId: "945417892",
//andrrid 插屏广告 id 必填
iosCodeId: "945417892",
//ios 插屏广告 id 必填
supportDeepLink: true,
// 是否反对 DeepLink 选填
expressViewWidth: 300.0,
// 冀望 view 宽度 dp 必填
expressViewHeight: 450.0,
// 冀望 view 高度 dp 必填
expressNum: 2, // 一次申请广告数量 大于 1 小于 3 必填
// 管制下载 APP 前是否弹出二次确认弹窗
downloadType: FlutterUnionadDownLoadType.DOWNLOAD_TYPE_POPUP,
);
8、激励视频广告
预加载激励视频广告
FlutterUnionad.loadRewardVideoAd(
mIsExpress: true,
// 是否个性化 选填
androidCodeId: "945418088",
//Android 激励视频广告 id 必填
iosCodeId: "945418088",
//ios 激励视频广告 id 必填
supportDeepLink: true,
// 是否反对 DeepLink 选填
rewardName: "100 金币",
// 处分名称 选填
rewardAmount: 100,
// 处分数量 选填
userID: "123",
// 用户 id 选填
orientation: FlutterUnionadOrientation.VERTICAL,
// 管制下载 APP 前是否弹出二次确认弹窗
downloadType: FlutterUnionadDownLoadType.DOWNLOAD_TYPE_POPUP,
// 视屏方向 选填
mediaExtra: null, // 扩大参数 选填
);
显示激励视频广告
await FlutterUnionad.showRewardVideoAd();
监听激励视频后果
FlutterUnionad.FlutterUnionadStream.initAdStream(
// 激励广告
flutterUnionadRewardAdCallBack: FlutterUnionadRewardAdCallBack(onShow: (){print("激励广告显示");
},
onClick: (){print("激励广告点击");
},
onFail: (error){print("激励广告失败 $error");
},
onClose: (){print("激励广告敞开");
},
onSkip: (){print("激励广告跳过");
},
onVerify: (rewardVerify,rewardAmount,rewardName){print("激励广告处分 $rewardVerify $rewardAmount $rewardName");
},
onReady: () async{print("激励广告预加载准备就绪");
// 显示激励广告
await FlutterUnionad.showRewardVideoAd();},
onUnReady: (){print("激励广告预加载未准备就绪");
},
),
);
9、draw 视频广告
FlutterUnionad.drawFeedAdView(
androidCodeId: "945426252",
// Android draw 视屏广告 id 必填
iosCodeId: "945426252",
//ios draw 视屏广告 id 必填
supportDeepLink: true,
// 是否反对 DeepLink 选填
expressViewWidth: 600.5,
// 冀望 view 宽度 dp 必填
expressViewHeight: 800.5,
// 管制下载 APP 前是否弹出二次确认弹窗
downloadType: FlutterUnionadDownLoadType.DOWNLOAD_TYPE_POPUP,
// 冀望 view 高度 dp 必填
callBack: FlutterUnionadDrawFeedCallBack(onShow: () {print("draw 广告显示");
},
onFail: (error) {print("draw 广告加载失败 $error");
},
onClick: () {print("draw 广告点击");
},
onDislike: (message) {print("draw 点击不喜爱 $message");
},
onVideoPlay: () {print("draw 视频播放");
},
onVideoPause: () {print("draw 视频暂停");
},
onVideoStop: () {print("draw 视频完结");
}),
),
10、 全屏视频广告
不举荐应用,请应用新模版渲染插屏广告
FlutterUnionad.fullScreenVideoAd(
androidCodeId: "945491318", //android 全屏广告 id 必填
iosCodeId: "945491318", //ios 全屏广告 id 必填
supportDeepLink: true, // 是否反对 DeepLink 选填
orientation: FlutterUnionadOrientation.VERTICAL, // 视屏方向 选填
// 管制下载 APP 前是否弹出二次确认弹窗
downloadType: FlutterUnionadDownLoadType.DOWNLOAD_TYPE_POPUP,
);
11、新模版渲染插屏广告 分为全屏和插屏
预加载新模版渲染插屏广告
FlutterUnionad.loadFullScreenVideoAdInteraction(
androidCodeId: "946201351", //android 全屏广告 id 必填
iosCodeId: "946201351", //ios 全屏广告 id 必填
supportDeepLink: true, // 是否反对 DeepLink 选填
orientation: FlutterUnionadOrientation.VERTICAL, // 视屏方向 选填
// 管制下载 APP 前是否弹出二次确认弹窗
downloadType: FlutterUnionadDownLoadType.DOWNLOAD_TYPE_POPUP,
);
显示新模版渲染插屏广告
await FlutterUnionad.showFullScreenVideoAdInteraction();
新模版渲染插屏广告后果监听
FlutterUnionad.FlutterUnionadStream.initAdStream(
// 新模板渲染插屏广告回调
flutterUnionadNewInteractionCallBack: FlutterUnionadNewInteractionCallBack(onShow: () {print("新模板渲染插屏广告显示");
},
onSkip: () {print("新模板渲染插屏广告跳过");
},
onClick: () {print("新模板渲染插屏广告点击");
},
onFinish: () {print("新模板渲染插屏广告完结");
},
onFail: (error) {print("新模板渲染插屏广告谬误 $error");
},
onClose: () {print("新模板渲染插屏广告敞开");
},
onReady: () async{print("新模板渲染插屏广告预加载准备就绪");
// 显示新模板渲染插屏
await FlutterUnionad.showFullScreenVideoAdInteraction();},
onUnReady: (){print("新模板渲染插屏广告预加载未准备就绪");
},
),
);
12、Android 隐衷权限管制
注:必须在 FlutterUnionad.register 初始化前应用才失效
if (Platform.isAndroid) {
await FlutterUnionad.andridPrivacy(
isCanUseLocation: false, // 是否容许 SDK 被动应用地理位置信息 true 能够获取,false 禁止获取。默认为 true
lat: 1.0,// 当 isCanUseLocation=false 时,可传入地理位置信息,穿山甲 sdk 应用您传入的地理位置信息 lat
lon: 1.0,// 当 isCanUseLocation=false 时,可传入地理位置信息,穿山甲 sdk 应用您传入的地理位置信息 lon
isCanUsePhoneState: false,// 是否容许 SDK 被动应用手机硬件参数,如:imei
imei: "123",// 当 isCanUsePhoneState=false 时,可传入 imei 信息,穿山甲 sdk 应用您传入的 imei 信息
isCanUseWifiState: false,// 是否容许 SDK 被动应用 ACCESS_WIFI_STATE 权限
isCanUseWriteExternal: false,// 是否容许 SDK 被动应用 WRITE_EXTERNAL_STORAGE 权限
oaid: "111",// 开发者能够传入 oaid
);
}
正文完