Skip to content

Migrate to Unity LevelPlay 2.0.0

Latest
Latest

Choose a tag to compare

View all tags
@AGulev AGulev released this 29 Jul 14:33
2.0.0
3d7993d
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Replace the legacy IronSource integration with Unity LevelPlay SDK 9 on Android and iOS. This release introduces LevelPlay’s object-based ad lifecycle, adds complete banner and manual rewarded-ad support, updates mediated networks, and modernizes privacy and attribution configuration.

This is a breaking release with no backward compatibility. Projects upgrading from 1.x must replace the ironsource Lua API and [iron_source] configuration with levelplay and [levelplay].

Release notes

  • Depends on LevelPlay Android SDK 9.5.0, iOS SDK 9.5.0.0, and Ad Quality SDK 9.8.0.
  • Renames the Lua module from ironsource to levelplay.
  • Introduces reusable ad objects for interstitial, rewarded, and banner ads.
  • Adds complete banner APIs, including adaptive sizes, safe-area positioning, visibility controls, and auto-refresh controls.
  • Adds explicit rewarded-ad loading on Android and iOS.
  • Allows each ad object to use its own ad-unit ID and optional bid floor.
  • Supports per-show placements, placement capping, and rewarded-placement information.
  • Adds structured callbacks containing ad-unit, placement, network, revenue, reward, size, and error information.
  • Adds GDPR, CCPA, COPPA, Meta Limited Data Use, and iOS App Tracking Transparency APIs.
  • Adds integration validation and the LevelPlay Integration Test Suite.
  • Adds opt-in mediated network adapters and automatic platform dependency configuration.
  • Migrates Android dependencies to Maven Central where supported.
  • Fixes Android banner visibility and positioning.
  • Requires Defold 1.13.0+, Android API 24+, and iOS 15+.
  • Resolves banner API support and manual rewarded-ad loading.
  • See the Unity LevelPlay SDK 9 migration guide when upgrading from 1.x.

Technical changes

  • Replaces the Android and iOS bridges with implementations based on LevelPlay SDK 9 object APIs.
  • Adds lifecycle-safe native ownership, reusable handles, asynchronous callbacks, and cleanup for every ad format.
  • Updates Android manifests, Maven dependencies, iOS pods, privacy settings, ATS configuration, and SKAdNetwork integration.
  • Adds deterministic Android and iOS dependency generators backed by a shared network catalog.
  • Updates the Lua API reference, integration documentation, and interactive example project.
  • Adds CI checks for generated manifests, migration contracts, and Android and iOS Bob builds.
  • Validated with 16 passing migration contract tests and both platform dependency-generator checks.
Assets 2
Loading