adjg_flutter

Description:

adjg flutter

ad_jg_flutter_sdk #
[TOC]
1.1 概述 #
尊敬的开发者朋友，欢迎您使用极光广告Flutter插件。通过本文档，您可以在几分钟之内轻松完成广告的集成过程。
操作系统： iOS 9.0 及以上版本，Android 4.4 及以上版本，
运行设备：iPhone （iPad上可能部分广告正常展示，但是存在填充很低或者平台不支持等问题，建议不要在iPad上展示广告），Android
2.1 SDK导入 #
首先需要导入主SDK
dependencies:
adjg_flutter: {library version}
copied to clipboard
然后需要导入各平台SDK，
2.1.1 iOS在项目的podfile中增加如下内容，可以根据实际需要选择性导入平台 #
pod 'ADJgSDK','~> 3.9.0.01302' # 主SDK 必选
pod 'ADJgSDK/ADJgSDKPlatforms/tianmu' # 天目 必选
pod 'ADJgSDK/ADJgSDKPlatforms/jgads' # 极光Ads
pod 'ADJgSDK/ADJgSDKPlatforms/gdt' # 优量汇(广点通）
pod 'ADJgSDK/ADJgSDKPlatforms/bu' # 穿山甲(头条)
pod 'ADJgSDK/ADJgSDKPlatforms/ks' # 快手
pod 'ADJgSDK/ADJgSDKPlatforms/baidu' # 百度
pod 'ADJgSDK/ADJgSDKPlatforms/mtg' # 汇量
pod 'ADJgSDK/ADJgSDKPlatforms/beizi' # 倍孜
copied to clipboard
2.1.2 Android在项目中增加如下内容，可以根据实际需要选择性导入平台 #
2.1.2.1. 在android根目录build.gradle中添加天目仓库
allprojects {
repositories {
...
google()
jcenter()
mavenCentral()
//天目渠道maven地址
maven { url "https://maven.admobile.top/repository/maven-releases/" }
//未导入汇量渠道可不加maven地址
maven { url "https://dl-maven-android.mintegral.com/repository/mbridge_android_sdk_support/" }
}
}
copied to clipboard
2.1.2.2. OAID支持
导入安全联盟的OAID支持库 oaid_sdk_1.0.25.aar，可在Demo的libs目录下找到，强烈建议使用和Demo中一样版本的OAID库（包括项目中已存在的依赖的oaid版本）；
将Demo中assets文件夹下的supplierconfig.json文件复制到自己的assets目录下并按照supplierconfig.json文件中的说明进行OAID的 AppId 配置，supplierconfig.json文件名不可修改；
2.1.2.3. 在android/app目录build.gradle中添加相关依赖
// support支持库，如果是AndroidX请使用对应的支持库
implementation 'com.android.support:appcompat-v7:28.0.0'
implementation 'com.android.support:support-v4:28.0.0'
implementation 'com.android.support:design:28.0.0'

// ADJg主SDK，必须的
implementation "cn.jiguang.sdk.ad:core:3.9.0.01311"

// OAID1.0.25版本适配器不支持其它版本，ADJgSdk获取oaid使用
implementation "cn.jiguang.sdk.ad:oaid:1.0.25.12122"
// OAID库1.0.25
implementation(name: 'oaid_sdk_1.0.25', ext: 'aar')

// 极光Ads，必须的
implementation "cn.jiguang.sdk.ad.adapter:jgads:2.2.0.03062"

// 天目 ，必须的
implementation "cn.jiguang.sdk.ad.adapter:tianmu:2.2.0.03063"

// 优量汇AdapterSdk，可选的
implementation "cn.jiguang.sdk.ad.adapter:gdt:4.562.1432.01261"

// 头条AdapterSdk，可选的
implementation "cn.jiguang.sdk.ad.adapter:toutiao:5.9.0.8.02041"

// 百度增强版AdapterSdk，可选的
implementation "cn.jiguang.sdk.ad.adapter:baidu-enhanced:9.332.02041"

// 快手AdapterSdk，可选的
implementation "cn.jiguang.sdk.ad.adapter:ksadbase:3.3.57.02191"

// Mintegral(汇量) AdapterSdk，可选的
implementation "cn.jiguang.sdk.ad.adapter:mintegral:16.5.41.11221"

//倍孜
implementation 'cn.jiguang.sdk.ad.adapter:beizi:4.90.2.55.08171'

//章鱼
implementation 'cn.jiguang.sdk.ad.adapter:octopus:1.5.9.13.03281'

copied to clipboard
2.1.2.4. 广告位创建注意事项
由于使用flutter方式对接，信息流广告可能存在无法展示广告问题，需要在创建优量汇、百度、快手渠道时，创建接近10：9比例的广告样式，可以达到最好的展示效果，否则会出现留白情况。
3.1 工程环境配置 #
3.1.1 IOS 工程环境配置 #
3.1.1.1. info.plist 添加支持 Http访问字段
<key>NSAppTransportSecurity</key>
<dict>
<key>NSAllowsArbitraryLoads</key>
<true/>
</dict>
copied to clipboard
3.1.1.2. Info.plist 添加定位权限字段（使用ADMobGenLocation可不设置）
NSLocationWhenInUseUsageDescription
NSLocationAlwaysAndWhenInUseUsageDeion
copied to clipboard
3.1.1.3. Info.plist 添加获取本地网络权限字段
<key>Privacy - Local Network Usage Description</key>
<string>广告投放及广告监测归因、反作弊</string>
<key>Bonjour services</key>
<array>
<string>_apple-mobdev2._tcp.local</string>
</array>
copied to clipboard
3.1.1.4. Info.plist推荐设置白名单，可提高广告收益
<key>LSApplicationQueriesSchemes</key>
<array>
<!-- 电商及生活 -->
<string>com.suning.SuningEBuy</string> <!-- 苏宁 -->
<string>openapp.jdmobile</string> <!-- 京东 -->
<string>openjd</string> <!-- 京东 -->
<string>jdmobile</string> <!-- 京东 -->
<string>vmall</string>
<string>vipshop</string> <!-- 维品汇 -->
<string>suning</string> <!-- 苏宁 -->
<string>yohobuy</string> <!-- 有货 -->
<string>kaola</string> <!-- 网易考拉 -->
<string>yanxuan</string> <!-- 网易严选 -->
<string>wbmain</string> <!-- 58同城 -->
<string>dianping</string> <!-- 大众点评 -->
<string>imeituan</string> <!-- 美团 -->
<string>beibeiapp</string> <!-- 贝贝 -->
<string>taobao</string> <!-- 淘宝 -->
<string>tmall</string> <!-- 天猫 -->
<string>wireless1688</string> <!-- 阿里巴巴1688 -->
<string>tbopen</string> <!-- 淘宝 -->
<string>taobaolite</string> <!-- 淘特 -->
<string>taobaoliveshare</string> <!-- 淘宝直播 -->
<string>koubei</string> <!-- 口碑 -->
<string>eleme</string> <!-- 饿了么 -->
<string>alipays</string> <!-- 支付宝 -->
<string>kfcapplinkurl</string> <!-- KFC -->
<string>pddopen</string> <!-- 拼多多 -->
<string>pinduoduo</string> <!-- 拼多多 -->
<string>mogujie</string> <!-- 蘑菇街 -->
<string>lianjiabeike</string> <!-- 链家贝壳 -->
<string>lianjia</string> <!-- 链家 -->
<string>openanjuke</string> <!-- 安居客 -->
<string>zhuanzhuan</string> <!-- 转转 -->
<string>farfetchCN</string> <!-- 发发奇全球时尚购物 -->
<!-- 社交社区 -->
<string>weibo</string> <!-- 微博 -->
<string>xhsdiscover</string> <!-- 小红书 -->
<string>uclink</string> <!-- uc浏览器 -->
<string>momochat</string> <!-- 陌陌 -->
<string>blued</string> <!-- Blued -->
<string>zhihu</string> <!-- 知乎 -->
<string>baiduboxapp</string> <!-- 手机百度 -->
<string>yidui</string> <!-- 伊对 -->
<!-- 资讯及阅读 -->
<string>sinanews</string> <!-- 新浪新闻 -->
<string>snssdk141</string> <!-- 今日头条 -->
<string>newsapp</string> <!-- 网易新闻 -->
<string>igetApp</string> <!-- 得到 -->
<string>kuaikan</string> <!-- 快看漫画 -->
<!-- 短视频及音乐 -->
<string>youku</string> <!-- 优酷 -->
<string>snssdk1128</string> <!-- 抖音 -->
<string>gifshow</string> <!-- 快手 -->
<string>snssdk1112</string> <!-- 火山 -->
<string>miguvideo</string> <!-- 咪咕视频 -->
<string>iqiyi</string> <!-- 爱奇艺 -->
<string>bilibili</string> <!-- B站 -->
<string>tenvideo</string> <!-- 腾讯视频 -->
<string>baiduhaokan</string> <!-- 百度好看 -->
<string>yykiwi</string> <!-- 虎牙直播 -->
<string>qqmusic</string> <!-- qq音乐 -->
<string>orpheus</string> <!-- 网易云音乐 -->
<string>kugouURL</string> <!-- 酷狗 -->
<string>qmkege</string> <!-- 全民K歌 -->
<string>changba</string> <!-- 唱吧 -->
<string>iting</string> <!-- 喜马拉雅 -->
<!-- 出行 -->
<string>ctrip</string> <!-- 携程 -->
<string>QunarAlipay</string> <!-- 去哪儿旅行 -->
<string>diditaxi</string> <!-- 滴滴出行 -->
<string>didicommon</string> <!-- 滴滴出行 -->
<string>taobaotravel</string> <!-- 飞猪 -->
<string>OneTravel</string> <!-- 海南航空 -->
<string>kfhxztravel</string> <!-- 花小猪 -->
<!-- 医美 -->
<string>gengmei</string> <!-- 更美 -->
<string>app.soyoung</string> <!-- 新氧医美 -->
</array>
copied to clipboard
3.1.2 Android 工程环境配置 #
3.1.2.1 权限配置
<!-- 广告必须的权限 -->
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.REQUEST_INSTALL_PACKAGES" />

<!-- 广点通广告必须的权限 -->
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

<!-- 影响广告填充，强烈建议的权限 -->
<uses-permission android:name="android.permission.READ_PHONE_STATE" />

<!-- 为了提高广告收益，建议设置的权限 -->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />

<!-- 如果有视频相关的广告播放请务必添加-->
<uses-permission android:name="android.permission.WAKE_LOCK" />
copied to clipboard
3.1.2.2 FileProvider配置
适配Anroid7.0以及以上，请在AndroidManifest中添加如下代码：
如果支持库是support
<provider
android:name="android.support.v4.content.FileProvider"
android:authorities="${applicationId}.fileprovider"
android:exported="false"
android:grantUriPermissions="true">
<meta-data
android:name="android.support.FILE_PROVIDER_PATHS"
android:resource="@xml/adjg_file_paths" />
</provider>
copied to clipboard
如果支持库为androidx
<provider
android:name="androidx.core.content.FileProvider"
android:authorities="${applicationId}.fileprovider"
android:exported="false"
android:grantUriPermissions="true">
<meta-data
android:name="android.support.FILE_PROVIDER_PATHS"
android:resource="@xml/adjg_file_paths" />
</provider>
copied to clipboard
在res/xml目录下(如果xml目录不存在需要手动创建)，新建xml文件adjg_file_paths，在该文件中加入如下配置，如果存在相同android:authorities的provider，请将paths标签中的路劲配置到自己的xml文件中：
<?xml version="1.0" encoding="utf-8"?>
<paths xmlns:android="http://schemas.android.com/apk/res/android">
<external-path name="external_path" path="." />
<external-files-path name="external_files_path" path="." />
</paths>
copied to clipboard
3.1.2.3 网络配置
需要在 AndroidManifest.xml 添加依赖声明uses-library android:name="org.apache.http.legacy" android:required="false"， 且 application标签中添加 android:usesCleartextTraffic="true"，适配网络http请求，否则 SDK可能无法正常工作，接入代码示例如下：
<application
android:name=".MyApplication"
... ...
android:usesCleartextTraffic="true">

<uses-library
android:name="org.apache.http.legacy"
android:required="false" />
... ...
</application>
copied to clipboard
3.1.2.4 混淆配置
# ADJgSdk混淆
-dontwarn cn.jiguang.jgssp.**
-dontwarn org.apache.commons.**
-keep class cn.jiguang.jgssp.**{public *;}
-keep class com.android.**{*;}
-keep class com.ciba.**{ *; }
-keep class org.apache.**{*;}

# okhttp
-dontwarn okhttp3.**
-keep class okhttp3.**{*;}

# OAID混淆
-keep class com.bun.miitmdid.core.** {*;}
-keep class XI.CA.XI.**{*;}
-keep class XI.K0.XI.**{*;}
-keep class XI.XI.K0.**{*;}
-keep class XI.vs.K0.**{*;}
-keep class XI.xo.XI.XI.**{*;}
-keep class com.asus.msa.SupplementaryDID.**{*;}
-keep class com.asus.msa.sdid.**{*;}
-keep class com.bun.lib.**{*;}
-keep class com.bun.miitmdid.**{*;}
-keep class com.huawei.hms.ads.identifier.**{*;}
-keep class com.samsung.android.deviceidservice.**{*;}
-keep class org.json.**{*;}
-keep public class com.netease.nis.sdkwrapper.Utils {public <methods>;}

# 广点通广告平台混淆
-keep class com.qq.e.** {public protected *;}
-keep class MTT.ThirdAppInfoNew {*;}
-keep class com.tencent.** {*;}

# 百度广告SDK混淆
-keepclassmembers class * extends android.app.Activity { public void *(android.view.View);}
-keepclassmembers enum * {
public static **[] values();
public static ** valueOf(java.lang.String);
}
-keep class com.baidu.mobads.** { *; }
-keep class com.baidu.mobad.** { *; }

# 头条广告平台混淆
-keepattributes Exceptions,InnerClasses,Signature,Deprecated,SourceFile,LineNumberTable,*Annotation*,EnclosingMethod
-keep class com.bytedance.sdk.openadsdk.** {*;}
-keep public interface com.bytedance.sdk.openadsdk.downloadnew.** {*;}
-keep class com.pgl.sys.ces.* {*;}
-keep class com.bytedance.embed_dr.** {*;}
-keep class com.bytedance.embedapplog.** {*;}

# mintegral广告平台混淆
-dontwarn com.mintegral.**
-keepattributes Signature
-keepattributes *Annotation*
-keep class com.mbridge.** {*; }
-keep interface com.mbridge.** {*; }
-keep class android.support.v4.** { *; }
-dontwarn com.mbridge.**
-keep class **.R$* { public static final int mbridge*; }

# 快手广告平台混淆
-keep class org.chromium.** { *; }
-keep class aegon.chrome.** { *; }
-keep class com.kwai.**{ *; }
-keep class com.kwad.**{ *; }
-dontwarn com.kwai.**
-dontwarn com.kwad.**
-dontwarn com.ksad.**
-dontwarn aegon.chrome.**
-keep class com.kwad.sdk.** { *;}
-keep class com.ksad.download.** { *;}
-keep class com.kwai.filedownloader.** { *;}
-keepclasseswithmembernames class * { native <methods>;}

# 极光Ads混淆
-keep class com.junion.**{ *; }

# 天目广告
-keep class com.tianmu.**{ *; }

# Jgid的混淆规则
-keep class jgssp.com.** { *; }
-keep interface jgssp.com.** { *; }
-keep interface cn.jiguang.jgssp.oaid.IGetter{public *;}

# 倍孜Beizi广告混淆
-dontwarn android.app.**
-dontwarn android.support.**
-keepattributes Exceptions,InnerClasses,Signature,Deprecated,SourceFile,LineNumberTable,*Annotation*,EnclosingMethod
-dontwarn org.apache.**
-keepclassmembers enum * {
public static **[] values();
public static ** valueOf(java.lang.String);
}
-dontwarn com.beizi.fusion.**
-dontwarn com.beizi.ad.**
-keep class com.beizi.fusion.** {*; }
-keep class com.beizi.ad.** {*; }
copied to clipboard
3.1.2.5 注册java与flutter交互代码
参考资料
public class MainActivity extends FlutterActivity {
...
@Override
public void configureFlutterEngine(FlutterEngine flutterEngine) {
super.configureFlutterEngine(flutterEngine);
...
Log.d("configureFlutterEngine", "init");
flutterEngine.getPlugins().add(new ADJgMobileAdsPlugin());
ADJgMobileAdsPlugin.registerNativeAdFactory(flutterEngine, "adFactoryExample");
...
}

@Override
public void cleanUpFlutterEngine(FlutterEngine flutterEngine) {

}
...
}
copied to clipboard
3.1.2.6 导入插件后的异常处理
Q：Plugin project :xxx not found. Please update settings.gradle
A：可参考demo中的settings.gradle，将配置拷贝到项目中
3.2 iOS14适配 #
由于iOS14中对于权限和隐私内容有一定程度的修改，而且和广告业务关系较大，请按照如下步骤适配，如果未适配。不会导致运行异常或者崩溃等情况，但是会一定程度上影响广告收入。敬请知悉。

应用编译环境升级至 Xcode 12.0 及以上版本；
升级ADJgSDK 3.6.2及以上版本；
设置SKAdNetwork和IDFA权限；

3.2.1 获取App Tracking Transparency授权（弹窗授权获取IDFA） #
从 iOS 14 开始，在应用程序调用 App Tracking Transparency 向用户提跟踪授权请求之前，IDFA 将不可用。


更新 Info.plist，添加 NSUserTrackingUsageDescription 字段和自定义文案描述。
弹窗小字文案建议：

获取标记权限向您提供更优质、安全的个性化服务及内容，未经同意我们不会用于其他目的；开启后，您也可以前往系统“设置-隐私 ”中随时关闭。
获取IDFA标记权限向您提供更优质、安全的个性化服务及内容；开启后，您也可以前往系统“设置-隐私 ”中随时关闭。



<key>NSUserTrackingUsageDescription</key>
<string>获取标记权限向您提供更优质、安全的个性化服务及内容，未经同意我们不会用于其他目的；开启后，您也可以前往系统“设置-隐私 ”中随时关闭</string>
copied to clipboard

向用户申请权限。

#import <AppTrackingTransparency/AppTrackingTransparency.h>
#import <AdSupport/AdSupport.h>
...
- (void)requestIDFA {
[ATTrackingManager requestTrackingAuthorizationWithCompletionHandler:^(ATTrackingManagerAuthorizationStatus status) {
// 无需对授权状态进行处理
}];
}
// 建议启动App用户同意协议后就获取权限或者请求广告前获取
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
// 针对iOS15中不弹窗被拒解决方案，方案1：经测试可能无效
//dispatch_after(dispatch_time(DISPATCH_TIME_NOW, (int64_t)(1.0 * NSEC_PER_SEC)), dispatch_get_main_queue(), ^{
// 用户同意协议后获取
//[self requestIDFA];
//});
}
// 方案2：根据官方文档调整权限申请时机
// 根据官方开发文档选择在此方法中进行权限申请
- (void)applicationDidBecomeActive:(UIApplication *)application {
// 用户同意协议后获取
[self requestIDFA];
}
// 建议方案1与2一起使用，可正常通过审核。
copied to clipboard
3.2.2 SKAdNetwork #
SKAdNetwork 是接收iOS端营销推广活动归因数据的一种方法。

将下列SKAdNetwork ID（供参考，需以穿山甲和汇量官网为准）添加到 info.plist 中，以保证 SKAdNetwork 的正确运行。根据对接平台添加相应SKAdNetworkID，若无对接平台SKNetworkID则无需添加。

<key>SKAdNetworkItems</key>
<array>
// 穿山甲广告（ADJgBU）
<dict>
<key>SKAdNetworkIdentifier</key>
<string>238da6jt44.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>22mmun2rn5.skadnetwork</string>
</dict>
// 汇量广告（ADJgMTG）
<dict>
<key>SKAdNetworkIdentifier</key>
<string>KBD757YWX3.skadnetwork</string>
</dict>
// 汇量广告 合作伙伴（ADJgMTG）
<dict>
<key>SKAdNetworkIdentifier</key>
<string>wg4vff78zm.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>737z793b9f.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>ydx93a7ass.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>prcb7njmu6.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>7UG5ZH24HU.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>44jx6755aq.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>2U9PT9HC89.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>W9Q455WK68.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>YCLNXRL5PM.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>TL55SBB4FM.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>8s468mfl3y.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>GLQZH8VGBY.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>c6k4g5qg8m.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>mlmmfzh3r3.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>4PFYVQ9L8R.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>av6w8kgt66.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>6xzpu9s2p8.skadnetwork</string>
</dict>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>hs6bdukanm.skadnetwork</string>
</dict>
</array>
copied to clipboard
4.1 主SDK初始化 #
AdJgFlutterSdk.initSdk(appid: "appid");
copied to clipboard
4.2 开屏广告 #
4.2.1 开屏广告（跳转至原生页面加载并展示） #
class SplashPage extends StatefulWidget {
@override
State<StatefulWidget> createState() => _SplashState();
}
class _SplashState extends State<SplashPage> {
ADJgSplashAd _splashAd;
@override
Widget build(BuildContext context) {
showSplashAd();
return Scaffold(
appBar: AppBar(
title: Text("Splash"),
),
body: Center(
),
);
}
// 开屏
// 显示开屏广告请保证当时app内没有其他地方显示开屏广告，否则会有冲突
void showSplashAd() {
if(_splashAd != null) {
return;
}
// posId：广告位id，
// imgName：背景名称，
// imgLogoName：底部logo名称，
// isRepeatApplyPermission：用户拒绝权限后是否允许重复读取：true允许，false禁止，
// isApplyPermission：动态申请权限：true允许，false禁止，
_splashAd = ADJgSplashAd(posId: "posid", imgName: "splash_placeholder", imgLogoName: "splash_bottom_icon", isRepeatApplyPermission: false, isApplyPermission:true);
_splashAd.onClosed = () {
print("开屏广告关闭了");
// 在加载失败和关闭回调后关闭广告
releaseSplashAd();
};
_splashAd.onFailed = () {
print("开屏广告失败了");
// 在加载失败和关闭回调后关闭广告
releaseSplashAd();
};
_splashAd.onExposed = () { print("开屏广告曝光了"); };
_splashAd.onSucced = () { print("开屏广告成功了"); };
_splashAd.onClicked = () { print("开屏广告点击了"); };
_splashAd.loadAndShow();
}

void releaseSplashAd() {
_splashAd?.release();
_splashAd = null;
}

@override
void dispose() {
releaseSplashAd();
super.dispose();
}
}
copied to clipboard
4.2.2 开屏广告（flutter原生加载展示分离） #
class _SplashLoadShowSeparateState extends State<SplashLoadShowSeparatePage> {
ADJgSplashAdLoadShowSeparate? _adJgFlutterSplashAd;
bool _hasInitBanner = false;

@override
Widget build(BuildContext context) {
if (_adJgFlutterSplashAd == null && _hasInitBanner == false) {
MediaQueryData queryData = MediaQuery.of(context);
_hasInitBanner = true;
var width = queryData.size.width;
var height = queryData.size.height;
_adJgFlutterSplashAd = ADJgSplashAdLoadShowSeparate(
posId: KeyManager.splashPosid(), width: width, height: height);
// 加载广告
_adJgFlutterSplashAd!.load();
_adJgFlutterSplashAd!.onSucced = () {
print("开屏广告加载成功");
// 展示广告
_adJgFlutterSplashAd!.show();
};
_adJgFlutterSplashAd!.onFailed = () {
releaseSplashAd();
print("开屏广告加载失败");
toHome();
};
_adJgFlutterSplashAd!.onClicked = () {
print("开屏广告点击");
};
_adJgFlutterSplashAd!.onExposed = () {
print("开屏广告渲染成功");
};
_adJgFlutterSplashAd!.onClosed = () {
releaseSplashAd();
print("开屏广告关闭成功");
toHome();
};
}

return Scaffold(
body: Center(
child: (_adJgFlutterSplashAd == null
? Text("开屏广告已关闭")
: ADJgWidget(adView: _adJgFlutterSplashAd!))));
}

void toHome() {
Navigator.pushAndRemoveUntil(
context,
new MaterialPageRoute(builder: (context) => new MyApp()),
(route) => route == null,
);
}

void removeSplashAd() {
setState(() {
releaseSplashAd();
});
}

void releaseSplashAd() {
_adJgFlutterSplashAd?.release();
_adJgFlutterSplashAd = null;
}

@override
void dispose() {
releaseSplashAd();
super.dispose();
}
}
copied to clipboard
// 加载广告
_adJgFlutterSplashAd!.load();
copied to clipboard
// 展示广告（请在onSucced回调后使用，目前安卓端快手存在异常，请勿添加快手广告源）
_adJgFlutterSplashAd!.show();
copied to clipboard
4.3 横幅广告（banner） #
class BannerPage extends StatefulWidget {
@override
State<StatefulWidget> createState() => _BannerState();
}

class _BannerState extends State<BannerPage> {
ADJgFlutterBannerAd _adJgFlutterBannerAd;
bool _hasInitBanner = false;

@override
Widget build(BuildContext context) {
if (_adJgFlutterBannerAd == null && _hasInitBanner == false) {
MediaQueryData queryData = MediaQuery.of(context);
_hasInitBanner = true;
var width = queryData.size.width;
var height = queryData.size.width / 320.0 * 50.0;
_adJgFlutterBannerAd = ADJgFlutterBannerAd(posId: KeyManager.bannerPosid(), width: width, height: height);
_adJgFlutterBannerAd.loadAndShow();
_adJgFlutterBannerAd.onSucced = () {
print("横幅广告加载成功");
};
_adJgFlutterBannerAd.onFailed = () {
removeBannerAd();
print("横幅广告加载失败");
};
_adJgFlutterBannerAd.onClicked = () {
print("横幅广告点击");
};
_adJgFlutterBannerAd.onExposed = () {
print("横幅广告渲染成功");
};
_adJgFlutterBannerAd.onClosed = () {
removeBannerAd();
print("横幅广告关闭成功");
};
}

return Scaffold(
appBar: AppBar(
title: Text("BannerPage"),
),
body: Center(child: (_adJgFlutterBannerAd == null ? Text("banner广告已关闭") : ADJgWidget(adView: _adJgFlutterBannerAd) ))
);
}

void removeBannerAd() {
setState(() {
releaseBannerAd();
});
}

void releaseBannerAd() {
_adJgFlutterBannerAd?.release();
_adJgFlutterBannerAd = null;
}

@override
void dispose() {
releaseBannerAd();
super.dispose();
}
}
copied to clipboard
4.4 插屏广告 #
class InterPage extends StatefulWidget {
@override
State<StatefulWidget> createState() => _InterState();
}
class _InterState extends State<InterPage> {
ADJgIntertitialAd _interAd;
@override
Widget build(BuildContext context) {
showInterAd();
return Scaffold(
appBar: AppBar(
title: Text("Intertitial"),
),
body: Center(
),
);
}
// 插屏
// 显示插屏广告请保证当时app内没有其他地方显示插屏广告，否则会有冲突
void showInterAd() {
if(_interAd != null) {
return;
}
_interAd = ADJgIntertitialAd(posId: KeyManager.interPosid());
_interAd.onClicked = () {
print("插屏广告关闭了");
};
_interAd.onFailed = () {
print("插屏广告失败了");
releaseInterAd();
};
_interAd.onExposed = () {
print("插屏广告曝光了");
};
_interAd.onSucced = () {
print("插屏广告成功了");
playInterAd();
};
_interAd.onClicked = () {
print("插屏广告点击了");
};
_interAd.onRewarded = () {
print("插屏广告激励达成");
};
_interAd.onClosed = () {
print("插屏广告关闭");
releaseInterAd();
};
_interAd.load();
}
void releaseInterAd() {
_interAd?.release();
_interAd = null;
}
void playInterAd() {
_interAd.show();
}
@override
void dispose() {
releaseInterAd();
super.dispose();
}
}
copied to clipboard
4.5 信息流广告 #
class NativePage extends StatefulWidget {
@override
State<StatefulWidget> createState() => NativeState();
}

class NativeState extends State<NativePage> {

ADJgFlutterNativeAd _nativeAd;

List<dynamic> _items = List.generate(10, (i) => i);
ScrollController _scrollController = ScrollController();

@override
void initState() {
super.initState();
_scrollController.addListener(() {
if (_scrollController.position.pixels == _scrollController.position.maxScrollExtent) {
_getAdData();
}
});
}

_getAdData() async {
_nativeAd.load();
}

void createNativeAd(BuildContext context) {
if(_nativeAd == null) {
MediaQueryData queryData = MediaQuery.of(context);
var width = queryData.size.width;
_nativeAd = ADJgFlutterNativeAd(posId: KeyManager.nativePosid(), width: width);
_nativeAd.onReceived = (ADJgFlutterNativeAdView adView) {
setState(() {
var adWidget = ADJgWidget(adView: adView);
adView.onClosed = () {
setState(() {
_items.remove(adWidget);
adView.release();
});
};
adView.onExposed = () {

};

_items.add(adWidget);
_items.addAll(List.generate(1, (i) => i));
});
};
}
}

@override
Widget build(BuildContext context) {
createNativeAd(context);
return Scaffold(
appBar: AppBar(
title: Text("Native"),
),
body: Center(
child: ListView.builder(
itemCount: _items.length,
controller: _scrollController,
itemBuilder: (BuildContext context, int index) {
final item = _items[index];
if (item is Widget) {
return item;
} else {
return Container(
width: 300,
height: 150,
child: Text("Cell", style: TextStyle(fontSize: 75))
);
}
}
),
),
);
}

@override
void dispose() {
for (var item in _items) {
if (item is ADJgFlutterNativeAdView) {
item.release();
}
}
_nativeAd.release();
_nativeAd = null;
super.dispose();
}
}
copied to clipboard
4.6 激励视频广告 #
class RewardPage extends StatefulWidget {

@override
State<StatefulWidget> createState() => _RewardState();

}
class _RewardState extends State<RewardPage> {

ADJgRewardAd _rewardAd;

@override
Widget build(BuildContext context) {
showRewardAd();
return Scaffold(
appBar: AppBar(
title: Text("Reward"),
),
body: Center(
),
);
}

void showRewardAd() {
if(_rewardAd != null) {
return;
}
_rewardAd = ADJgRewardAd(posId: KeyManager.rewardPosid());
_rewardAd.onClicked = () {
print("激励视频广告关闭了");
};
_rewardAd.onFailed = () {
print("激励视频广告失败了");
releaseRewardAd();
};
_rewardAd.onExposed = () {
print("激励视频广告曝光了");
};
_rewardAd.onSucced = () {
print("激励视频广告成功了");
playRewardAd();
};
_rewardAd.onClicked = () {
print("激励视频广告点击了");
};
_rewardAd.onRewarded = () {
print("激励视频广告激励达成");
};
_rewardAd.onClosed = () {
print("激励视频广告关闭");
releaseRewardAd();
};
_rewardAd.load();
}

void releaseRewardAd() {
_rewardAd?.release();
_rewardAd = null;
}

void playRewardAd() {
_rewardAd.show();
}

@override
void dispose() {
releaseRewardAd();
super.dispose();
}
}
copied to clipboard
4.8 个性化化开关 #
AdJgFlutterSdk.setPersonalizedEnabled(personalized: true);
copied to clipboard