unified_ads

One Dart API for banner, interstitial and rewarded ads across AdMob, AppLovin MAX, Unity Ads, ironSource LevelPlay, InMobi, Start.io and Facebook Audience Network. Each network is a separate adapter package, so only the SDKs you add are linked into your app.

Install

dependencies:
  unified_ads: ^1.0.0
  # add only the networks you want:
  unified_ads_admob: ^1.0.0
  unified_ads_unity: ^1.0.0

Use

await UnifiedAds.requestTrackingAuthorization();              // iOS ATT prompt
await UnifiedAds.gatherConsent(const AdmobConsentProvider()); // Google UMP
await UnifiedAds.init(AdConfig(
  testMode: true,
  waterfall: [AdNetwork.admob, AdNetwork.unity],
  networks: {
    AdNetwork.admob: NetworkConfig(appId: '…', interstitialAdUnitId: '…', rewardedAdUnitId: '…'),
    AdNetwork.unity: NetworkConfig(appId: '…', interstitialAdUnitId: '…', rewardedAdUnitId: '…'),
  },
));

final ad = InterstitialAd(onClosed: (ad) => debugPrint('served by ${ad.servedBy}'));
if ((await ad.load()).isSuccess) await ad.show();

Banners: UnifiedBannerWidget(ad: BannerAd(size: const BannerSize.adaptiveAnchored()), anchored: true). Also RewardedInterstitialAd and AppOpenAd (AdMob; MAX for app open), with the same waterfall and callbacks. Tests: package:unified_ads/testing.dart (FakeAdNetworkAdapter).

Declarative config

Instead of building AdConfig in code, you can keep the same settings in pubspec.yaml:

unified_ads:
  testMode: true
  waterfall: [admob, unity]
  networks:
    admob:
      appId: {android: 'ca-app-pub-…~…', ios: 'ca-app-pub-…~…'}
      interstitialAdUnitId: '…'
    unity:
      appId: '…'
      interstitialAdUnitId: '…'

flutter:
  assets:
    - assets/ads_config.json

Generate the asset with dart run unified_ads:generate_config, then load it with AdConfigLoader.fromAsset('assets/ads_config.json'). The generator validates the section and reports errors with a JSON path. In CI, --set-exit-if-changed fails the build when the JSON is out of date. You can also write assets/ads_config.json by hand. The schema is in the AdConfigLoader docs.

Getting your ad IDs

Step-by-step dashboard instructions and public test credentials: see doc/getting_ids.md in the repository.

Status

Android: every adapter compiles against its pinned SDK. AdMob, Unity Ads, Start.io and Facebook have been verified serving test ads on a device. iOS compiles only in CI (pending its first run) and has not yet run on a device.

Requirements: Android minSdk 24; iOS 13, or iOS 15 with unified_ads_facebook; Flutter 3.44+. See the repository README.md, SDK_STATUS.md and IMPLEMENTATION.md.