Flutter广告集成插件flutter_ironsource_x的使用

Banner

插屏广告/激励视频

优惠墙

在下一版本中，版本格式将如下所示：

xx.xx.xxxx
 🠕  🠕  🠕
 |  |  发布修订版
 |  IronSource SDK 主要版本
 Dart 主要版本

 示例：
 2.7.1
 ------------------------------
 2 是 Dart 主要版本
 7 是 IronSource 主要版本
 1 是 发布修订版

IronSource 广告插件 Flutter 使用说明

初始化

void init() async {
  var userId = await IronSource.getAdvertiserId();
  await IronSource.validateIntegration();
  await IronSource.setUserId(userId);
  await IronSource.initialize(appKey: "appKey", listener: this,
                    gdprConsent: true, ccpaConsent: false);
  rewardeVideoAvailable = await IronSource.isRewardedVideoAvailable();
  offerwallAvailable = await IronSource.isOfferwallAvailable();
  setState(() {});
}

默认情况下 gdprConsent 和 ccpaConsent 均为 true。

插屏广告

IronSource.loadInterstitial();

void showInterstitial() async {
  if (await IronSource.isInterstitialReady()) {
    IronSource.showInterstitial();
  } else {
    print(
      "插屏广告未准备好。请使用 'Ironsource.loadInterstial' 加载后再展示。",
    );
  }
}

@override
void onInterstitialAdClicked() {
  print("onInterstitialAdClicked");
}

@override
void onInterstitialAdClosed() {
  print("onInterstitialAdClosed");
}

@override
void onInterstitialAdLoadFailed(IronSourceError error) {
    print("onInterstitialAdLoadFailed : ${error.toString()}");
}

@override
void onInterstitialAdOpened() {
  print("onInterstitialAdOpened");
  setState(() {
    interstitialReady = false;
  });
}

@override
void onInterstitialAdReady() {
  print("onInterstitialAdReady");
  setState(() {
    interstitialReady = true;
  });
}

@override
void onInterstitialAdShowFailed(IronSourceError error) {
  print("onInterstitialAdShowFailed : ${error.toString()}");
  setState(() {
    interstitialReady = false;
  });
}

@override
void onInterstitialAdShowSucceeded() {
  print("nInterstitialAdShowSucceeded");
}

激励视频

void showRewardedVideo() async {
  if (await IronSource.isRewardedVideoAvailable()) {
    IronSource.showRewardedVideol();
  } else {
    print("激励视频不可用");
  }
}

@override
void onRewardedVideoAdClicked(Placement placement) {
  print("onRewardedVideoAdClicked");
}

@override
void onRewardedVideoAdClosed() {
  print("onRewardedVideoAdClosed");
}

@override
void onRewardedVideoAdEnded() {
  print("onRewardedVideoAdEnded");
}

@override
void onRewardedVideoAdOpened() {
  print("onRewardedVideoAdOpened");
}

@override
void onRewardedVideoAdRewarded(Placement placement) {
  print("onRewardedVideoAdRewarded: ${placement.placementName}");
}

@override
void onRewardedVideoAdShowFailed(IronSourceError error) {
  print("onRewardedVideoAdShowFailed : ${error.toString()}");
}

@override
void onRewardedVideoAdStarted() {
  print("onRewardedVideoAdStarted");
}

@override
void onRewardedVideoAvailabilityChanged(bool available) {
  print("onRewardedVideoAvailabilityChanged : $available");
  setState(() {
    rewardeVideoAvailable = available;
  });
}

Banner 广告

IronSourceBannerAd(keepAlive: true, listener: BannerAdListener());

Banner 尺寸类型

• BANNER

IronSourceBannerAd(keepAlive: true, listener: BannerAdListener(), size: BannerSize.BANNER);

• LARGE

IronSourceBannerAd(keepAlive: true, listener: BannerAdListener(), size: BannerSize.LARGE);

• LEADERBOARD

IronSourceBannerAd(keepAlive: true, listener: BannerAdListener(), size: BannerSize.LEADERBOARD);

• RECTANGLE

IronSourceBannerAd(keepAlive: true, listener: BannerAdListener(), size: BannerSize.RECTANGLE);

• SMART

IronSourceBannerAd(keepAlive: true, listener: BannerAdListener(), size: BannerSize.SMART);

• CUSTOM

IronSourceBannerAd(
  keepAlive: true,
  listener: BannerAdListener(),
  size: BannerSize.BANNER,
  size: BannerSize(
      type: BannerSizeType.BANNER,
      width: 400,
      height: 50,
    ),
);

Banner 背景颜色

IronSourceBannerAd(
  keepAlive: true,
  listener: BannerAdListener(),
  size: BannerSize.BANNER,
  backgroundColor: Colors.amber, // 背景颜色
);

class BannerAdListener extends IronSourceBannerListener {
  @override
  void onBannerAdClicked() {
    print("onBannerAdClicked");
  }

  @override
  void onBannerAdLeftApplication() {
    print("onBannerAdLeftApplication");
  }

  @override
  void onBannerAdLoadFailed(Map<String, dynamic> error) {
    print("onBannerAdLoadFailed");
  }

  @override
  void onBannerAdLoaded() {
    print("onBannerAdLoaded");
  }

  @override
  void onBannerAdScreenDismissed() {
    print("onBannerAdScreenDismisse");
  }

  @override
  void onBannerAdScreenPresented() {
    print("onBannerAdScreenPresented");
  }
}

优惠墙

void showOfferwall() async {
  if (await IronSource.isOfferwallAvailable()) {
    IronSource.showOfferwall();
  } else {
    print("优惠墙不可用");
  }
}

@override
void onGetOfferwallCreditsFailed(IronSourceError error) {
  print("onGetOfferwallCreditsFailed : ${error.toString()}");
}

@override
void onOfferwallAdCredited(OfferwallCredit reward) {
  print("onOfferwallAdCredited : $reward");
}

@override
void onOfferwallAvailable(bool available) {
  print("onOfferwallAvailable : $available");
  setState(() {
    offerwallAvailable = available;
  });
}

@override
void onOfferwallClosed() {
  print("onOfferwallClosed");
}

@override
void onOfferwallOpened() {
  print("onOfferwallOpened");
}

@override
void onOfferwallShowFailed(IronSourceError error) {
  print("onOfferwallShowFailed ${error.toString()}");
}

更新 AndroidManifest.xml

权限

在 AndroidManifest.xml 文件中添加以下权限（位于 <manifest> 标签内但 <application> 标签外）：

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

活动

在 AndroidManifest.xml 文件的 <application> 标签内添加以下活动：

<activity
  android:name="com.ironsource.sdk.controller.ControllerActivity"
  android:configChanges="orientation|screenSize"
  android:hardwareAccelerated="true" />
<activity
  android:name="com.ironsource.sdk.controller.InterstitialActivity"
  android:configChanges="orientation|screenSize"
  android:hardwareAccelerated="true"
  android:theme="@android:style/Theme.Translucent" />
<activity
  android:name="com.ironsource.sdk.controller.OpenUrlActivity"
  android:configChanges="orientation|screenSize"
  android:hardwareAccelerated="true"
  android:theme="@android:style/Theme.Translucent" />

设置 android/app/build.gradle

在 android/app/build.gradle 中添加以下依赖：

dependencies {
  implementation 'com.ironsource.sdk:mediationsdk:7.2.1'
  ...
}

将 compileSdkVersion 修改为至少 31：

android {
    compileSdkVersion 31
    ...

将 minSdkVersion 修改为至少 21，targetSdkVersion 修改为至少 31：

defaultConfig {
        ...
        minSdkVersion 21
        targetSdkVersion 31
        versionCode flutterVersionCode.toInteger()
        versionName flutterVersionName
    }

设置 android/build.gradle

将 ext.kotlin_version 修改为至少 1.6.10：

buildscript {
    ext.kotlin_version = '1.6.10'
    ...

添加 Google Play 服务

在顶部添加 xmlns:tools="http://schemas.android.com/tools"：

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    package="com.metamorfosis_labs.flutter_ironsource_x_example">

在 <application> 标签内添加 tools:replace="android:label"：

<application
    tools:replace="android:label"
    android:name="io.flutter.app.FlutterApplication"
    android:label="flutter_ironsource_x_example"
    android:networkSecurityConfig="@xml/network_security_config"
    android:usesCleartextTraffic="true"
    android:icon="@mipmap/ic_launcher">

在 <application> 标签内添加以下内容：

<meta-data
  android:name="com.google.android.gms.ads.APPLICATION_ID"
  android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/>

<meta-data android:name="com.google.android.gms.version"
  android:value="[@integer](/user/integer)/google_play_services_version" />