unified_ads_ironsource 1.1.0

ironSource / Unity LevelPlay adapter for unified_ads. Add it to link only the LevelPlay SDK into your Android and iOS app.

unified_ads_ironsource 📱

ironSource / Unity LevelPlay adapter for unified_ads: banner, interstitial and rewarded ads. Adding this package links only the LevelPlay SDK into your app.

✨ Features

• 🎯 No hardcoding: App Keys and ad unit IDs live in your AdConfig (or ads_config.json).
• 🧩 Three formats, one API: BannerAd + UnifiedBannerWidget (including adaptive), InterstitialAd and RewardedAd. Every ad reports the network that served it (servedBy).
• 🌊 Waterfall fallback: combine LevelPlay with other unified_ads networks; if one has no fill, the next is tried.
• ⏱️ Pacing and frequency caps: set a cooldown between interstitials, show one every N user actions, skip the first seconds after launch, and cap shows per time window.
• 👑 Pro users and ad-free mode: UnifiedAds.setAdFree(true) collapses banners and blocks interstitials.
• 🆕 LevelPlay 9.x ad-unit APIs only: 9.0 removed every legacy IronSource.* API.
• 🪶 Opt-in linking: only the LevelPlay SDK is added to your APK / IPA.

	Android	iOS
SDK	com.unity3d.ads-mediation:mediation-sdk:9.7.0 (+ play-services-appset 16.1.0, play-services-ads-identifier 18.3.0)	IronSourceSDK 9.7.0
Minimum	API 19 (package: 24)	iOS 12 per the vendor (package: 13); Xcode 16+
Distribution	Gradle (Maven Central)	Swift Package Manager (ironsource-mobile/LevelPlay-Swift-Package, product UnityMediationSDK)

ironSource Ads direct demand was sunset on 30 April 2026. LevelPlay mediation (what this adapter uses) continues, but fill comes only from the networks enabled in LevelPlay (Unity recommends Unity Ads bidding), and each enabled network's LevelPlay adapter must be added to your app (Gradle / Swift package on the Runner target).

🚀 Getting Started

1. Add the dependency

dependencies:
  unified_ads: ^1.1.0
  unified_ads_ironsource: ^1.1.0

2. Platform setup

Android

The AAR ships its ProGuard rules and merges its activities and providers. Declare com.google.android.gms.permission.AD_ID when targeting API 33+:

<uses-permission android:name="com.google.android.gms.permission.AD_ID"/>

The SDK pulls adquality-sdk with an open version range; pin it in the app for reproducible builds.

iOS (ios/Runner/Info.plist)

<key>NSUserTrackingUsageDescription</key>
<string>This identifier will be used to deliver personalized ads to you.</string>
<key>SKAdNetworkItems</key>
<array>
  <dict><key>SKAdNetworkIdentifier</key><string>su67r6k2v3.skadnetwork</string></dict>
  <!-- + each mediated network's IDs -->
</array>
<!-- optional -->
<key>NSAdvertisingAttributionReportEndpoint</key>
<string>https://postbacks-is.com/</string>

• Add -ObjC to Runner → Build Settings → Other Linker Flags. LevelPlay requires it, and its own Swift package can't set it (the adapter's Package.swift passes it too).
• The LevelPlay docs set NSAllowsArbitraryLoads = YES; flag it for App Store review (not required by this plugin).

📖 Usage

1. Initialize at app launch

import 'package:flutter/material.dart';
import 'package:unified_ads/unified_ads.dart';

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();

  await UnifiedAds.setAdFree(await isProUser());    // optional, see step 5
  await UnifiedAds.requestTrackingAuthorization();  // iOS prompt; Android: notApplicable
  await UnifiedAds.init(AdConfig(
    networks: {
      AdNetwork.ironsource: NetworkConfig(
        appId: PlatformValue.select(android: '<Android App Key>', ios: '<iOS App Key>'),
        bannerAdUnitId: '…', interstitialAdUnitId: '…', rewardedAdUnitId: '…',
        extras: {'userId': 'optional-user-id'},
      ),
    },
    pacing: {
      AdFormat.interstitial: AdPacing(
        initialDelay: Duration(seconds: 30),
        minInterval: Duration(seconds: 15),
        showEveryActions: 3,
      ),
    },
  ));

  runApp(const MyApp());
}

2. Display a banner ad

final banner = BannerAd(size: const BannerSize.adaptiveAnchored());
// build():   UnifiedBannerWidget(ad: banner, anchored: true)
// dispose(): banner.dispose();

3. Show paced interstitial ads

final interstitial = InterstitialAd(onClosed: (ad) => goToNextScreen());
await interstitial.load();

await UnifiedAds.recordAction();                 // after each user action
if (await interstitial.canShow()) {
  await interstitial.show();
} else {
  goToNextScreen();                              // paced, capped or ad-free: skip
}

4. Show rewarded video ads

final rewarded = RewardedAd(
  onEarnedReward: (ad, reward) => grant(reward.amount, reward.type),  // LevelPlayReward(name, amount)
);
if ((await rewarded.load()).isSuccess) await rewarded.show();

5. Pro users / ad-free mode

await UnifiedAds.setAdFree(true);                      // banners + interstitials off
await UnifiedAds.setAdFree(true, blockRewarded: true); // rewarded off too

Blocked calls return AdErrorCode.adsBlocked without contacting LevelPlay.

🔑 Getting the IDs

You need: App Key + ad unit ID per format + at least one demand network.

ironSource Ads direct demand was sunset on 30 April 2026. LevelPlay mediation continues, but fill comes only from the networks you enable in LevelPlay (Unity recommends Unity Ads bidding). An app with no networks enabled gets no fill.

1. Account: platform.ironsrc.com/partners/signup; answer the verification emails.
2. App + App Key: New App → import from the store URL or enter a temporary name → set COPPA / CCPA → the App Key is on the Apps page.
3. Ad units: Ad units → Create ad unit → name → format → Save. The ad unit ID is in the table.
4. Demand: Mediation → Setup → SDK Networks → e.g. Unity Ads (API Key + Organization core ID) → per app Add bidder. Other networks: Instances → Add instance → Active. Each enabled network's LevelPlay adapter must also be added to your app (Gradle / Swift package on the Runner target); LevelPlay's Unity adapter bundles the Unity Ads SDK from 5.15.0.
5. Testing: LevelPlay → Settings → Test devices, or the integration test suite (is_test_suite meta-data).

⚙️ Details

Notes

• Don't enable Unity Ads at the same time. The Unity SDK initializes once per process, so unified_ads skips unity with configConflict. Get Unity demand through LevelPlay.
• Test mode (TestModeSupport.testSuiteOnly): LevelPlay has no test-ads flag. Use the LevelPlay test suite (is_test_suite meta-data) or dashboard test devices. unified_ads logs a reminder.
• Rewarded: LevelPlayReward(name, amount) → RewardItem(amount, name). The reward can arrive after the close event; unified_ads delivers it either way.
• Banner sizes: LevelPlayAdSize.BANNER / LARGE / MEDIUM_RECTANGLE / LEADERBOARD; adaptive uses createAdaptiveAdSize(context, width).
• Ad objects are created only after LevelPlay init succeeds; unified_ads guarantees this ordering.
• LevelPlay's own capping (codes 524/525/526/530) also maps to frequencyCapped, the same code unified_ads' AdPacing and FrequencyCap use.

Privacy

consentGiven → LevelPlayPrivacySettings.setGDPRConsent, ccpaOptOut → setCCPA, coppa → setCOPPA, applied before init. Google UMP / IAB TCF strings are read automatically.

Error mapping (LevelPlay error codes)

Code	AdErrorCode
509, 606, 1024, 1035, 1044, 1158 (no ads / no candidates)	noFill
520 no internet	networkError
524/525/526/530 capped	frequencyCapped
624/626 missing / invalid ad unit	invalidConfig
625 load before init	notInitialized
show: 628 / 630 / 631 (iOS: nil controller)	notReady / alreadyShowing / noActivity

Meta (Facebook) bidding: opt-in

This package declares no Meta dependency. Add LevelPlay's Meta adapter (and, on Android, Audience Network) to your app; the adapter detects it and forwards privacy (ccpaOptOut → Limited Data Use, coppa → mixed audience, also via the LevelPlay metadata Meta_Mixed_Audience) before LevelPlay initializes it.

// android/app/build.gradle.kts
dependencies {
    implementation("com.unity3d.ads-mediation:facebook-adapter:5.6.0") // brings Audience Network 6.22.0
}

iOS (15.0+): File → Add Package Dependencies… → https://github.com/ironsource-mobile/LevelPlay-Facebook-Adapter-Swift-Package, exact 5.6.0, product FacebookAdapter (brings FBAudienceNetwork 6.22.1), on the Runner target. Add Meta's SKAdNetwork IDs and the Android 127.0.0.1 cleartext config. In LevelPlay: Mediation → Setup → SDK Networks → Meta → Login with Facebook, then set the App ID and Placement ID per instance. Meta warns that about 20% of test requests intentionally return no fill. On iOS 15–16 the adapter also sets FBAdSettings.setAdvertiserTrackingEnabled from the ATT status (Meta requires it below iOS 17).

🛠️ Verification & Tests

flutter test                        # adapter unit tests (mocked host API)
cd example && flutter run           # the shared example app: enable LevelPlay in Settings

Android: the SDK initializes and requests round-trip on a device; LevelPlay's demo key returns no fill for this package, so serving needs your own app key and enabled networks. iOS builds in CI and hasn't run on a physical device yet.

---

Part of unified_ads: one Dart API for banner, interstitial and rewarded ads across seven networks, linking only the SDKs you add. Its README is the full guide: configuration, waterfall, consent and ATT, every network's setup, architecture and SDK status.

📄 License

MIT, see LICENSE.