Skip to main content
Version: 6.x.x

Release Notes

[6.0.0] - 2026-05-21​

This is a major release. Several public APIs have been renamed or have shape changes. See the Breaking changes section below before upgrading.

tip

See the dedicated v3.x → v6.0.0 migration guide for a step-by-step walkthrough with full code examples, event-rename tables, and a removed-APIs reference.

Native SDK upgrades​

  • Android: BlueStack Core SDK upgraded to 6.0.1
  • Android: In-App Bidding mediation adapter upgraded to 6.0.0.1
  • Android: Google Mobile Ads mediation adapter upgraded to 6.0.0.1
  • Android: Equativ mediation adapter upgraded to 6.0.0.2
  • iOS: BlueStack Core SDK upgraded to 6.0.0
  • iOS: In-App Bidding mediation adapter upgraded to 6.0.2
  • iOS: Google Mobile Ads mediation adapter upgraded to 6.0.0
  • iOS: Equativ mediation adapter upgraded to 6.0.0

Added​

  • BlueStackAds.SetDebugMode(bool) for toggling native SDK debug logging at any time, plus BlueStackAds.IsDebugModeEnabled to read the cached state.
  • BlueStackAds.IsInitialized property to check native-side readiness.
  • InterstitialAd.IsReady and RewardedAd.IsReady properties.
  • BannerAd anchor-based positioning — new constructor BannerAd(string placementId, Transform anchor, Camera camera = null). The banner follows the anchor's screen position automatically via the new AdPlacementHandler component.
  • BannerAd custom screen-space position constructor — BannerAd(string placementId, Vector2 position).
  • Optional useSafeArea parameter on BannerAd(string, AdPosition, bool useSafeArea = true) to opt out of safe-area insets for sticky Top/Bottom banners. Custom-positioned banners always ignore the safe area.
  • Banner masking — BannerAd.SetMask(RectTransform, Camera) / BannerAd.RemoveMask() clip the banner to a UI region. The mask follows the RectTransform as it animates or resizes.
  • BannerAd.OnAdResized event delivers a PreferredBannerSize (Width, Height) whenever the SDK reports a post-load size change.
  • BannerAd.OnAdLoaded payload changed to PreferredBannerSize carrying the SDK-preferred dimensions (was EventArgs).
  • RewardedAd.OnAdRewardEarned (renamed from OnRewardEarned) delivers a RewardedItem.
  • UpdateInterval API on AdMaskHandler and AdPlacementHandler, clamped to [0, 5] seconds (0 = every frame).

Changed​

  • Breaking — BlueStackAds.Initialize signature simplified:
    • Before: Initialize(string appId, Settings settings, Action<SDKInitializationStatus> sdkCallback, Action<IInitializationStatusClient> adaptersCallback)
    • After: Initialize(string appId, Action<InitializationStatus> initializationCompleteAction = null)
    • The Settings-based debug toggle is replaced by BlueStackAds.SetDebugMode(bool).
    • The separate success/fail SDKInitializationStatus callback is removed. The single completion callback now delivers InitializationStatus.AdapterStatusMap (per-adapter AdapterStatus).
    • The initialization callback is now consistently dispatched to the Unity main thread on both iOS and Android.
  • Breaking — RewardedVideoAd class renamed to RewardedAd.
  • Breaking — Banner event names renamed:
    • OnBannerDidLoad → OnAdLoaded (payload changed to PreferredBannerSize)
    • OnBannerDidFailed → OnAdFailedToLoad
    • OnBannerDisplay → OnAdDisplayed
    • OnBannerHide → OnAdHidden
    • OnBannerDidRefresh → OnAdRefreshed
    • OnBannerDidFailToRefresh → OnAdFailedToRefresh
  • Breaking — Interstitial event names renamed:
    • OnInterstitialDidLoaded → OnAdLoaded
    • OnInterstitialDidFail → OnAdFailedToLoad
    • OnInterstitialClicked → OnAdClicked
    • OnInterstitialDidShown → OnAdDisplayed
    • OnInterstitialDisappear → OnAdDismissed
  • Breaking — Rewarded event names renamed:
    • OnRewardedVideoAdLoaded → OnAdLoaded
    • OnRewardedVideoAdError → OnAdFailedToLoad
    • OnRewardedVideoAdAppeared → OnAdDisplayed
    • OnRewardedVideoAdClicked → OnAdClicked
    • OnRewardedVideoAdClosed → OnAdDismissed
    • OnUserRewardEarned → OnAdRewardEarned
  • Banner ads now show automatically on load (auto-refresh handling moved to the BlueStack console).
  • Banner container view now wraps the loaded ad's actual rendered size (previously used the requested AdSize), reducing layout-padding artifacts for dynamic-width banners.
  • iOS bridge routes init and SDK-config calls through a BSUInitializer Swift façade that caches the debug-mode flag for bridge-side diagnostics.
  • Android bridge routes init and SDK-config calls through a UnityMobileAds Kotlin singleton mirroring the iOS façade.

Removed​

  • Breaking — Settings parameter removed from BlueStackAds.Initialize. The Settings class is retained for source compatibility only and is no longer used by the SDK.

[3.4.1] - 2026-02-27​

Changed​

  • Android: BlueStack Core SDK version upgraded to 5.4.1
  • Android: In-App Bidding mediation adapter upgraded to 5.4.0.0
  • Android: Google Mobile Ads mediation adapter upgraded to 5.4.1.0
  • Android: Equativ mediation adapter upgraded to 5.2.1.1
  • iOS: BlueStack Core SDK version upgraded to 5.4.1
  • iOS: In-App Bidding mediation adapter upgraded to 5.4.0
  • iOS: Google Mobile Ads mediation adapter upgraded to 5.4.0
  • iOS: Equativ mediation adapter upgraded to 5.1.8

[3.3.1] - 2025-12-10​

Note: This release includes functional changes originally intended for 3.4.0, without requiring unreleased native dependencies.

Changed​

  • Android: Equativ mediation adapter upgraded to 5.2.1.0
  • Android: Updated Unity bridge calls to execute on the UI thread to prevent crashes and improve stability.
  • iOS: BlueStack Core SDK upgraded to 5.3.1
  • iOS: Removed linker flag -ld64 from PostProcessBuild script, previously added as a temporary fix for Xcode 15.0+ build issue.
  • iOS: Adjusted banner position to properly respect safe area.
  • Moved ad prefabs from Resources to Editor folder to avoid loading when not needed.

Fixed​

  • Android: Fixed extra banner spacing when system already reserves nav bar area (non edge-to-edge).
  • iOS: Fixed banner view constraint issue caused by height mismatch between UIView and MNGContainerView.
  • Replaced deprecated FindObjectsOfType with FindObjectsByType for Unity 6+ compatibility.

[3.4.0] – 2025-12-05 (Deprecated)​

⚠️ This version is deprecated. It depends on unreleased native SDKs and should not be used.

Changed​

  • Android: BlueStack Core SDK upgraded to 5.4.0
  • Android: In-App Bidding mediation adapter upgraded to 5.4.0.0
  • Android: Updated Unity bridge calls to execute on the UI thread to prevent crashes and improve stability.
  • iOS: BlueStack Core SDK upgraded to 5.3.1
  • iOS: Removed linker flag -ld64 from PostProcessBuild script.
  • iOS: Adjusted banner position to properly respect safe area.
  • Moved ad prefabs from Resources to Editor folder to avoid loading when not needed

Fixed​

  • Android: Fixed extra banner spacing when system already reserves nav bar area (non edge-to-edge).
  • iOS: Fixed banner view constraint issue caused by height mismatch between UIView and MNGContainerView.
  • Replaced deprecated FindObjectsOfType with FindObjectsByType for Unity 6+ compatibility.

[3.3.0] - 2025-10-09​

Changed​

  • BlueStack Android Core SDK version upgraded to 5.3.0
  • BlueStack iOS Core SDK version upgraded to 5.3.0
  • Removed BlueStack core dependency handling from Settings
  • Updated SDK to ensure compatibility with Unity 6.
  • Implemented a custom CrossPlatformInput system in Unity to support both the legacy Input Manager and the new Input System
  • Upgraded Texture loading process for Native ads in Unity by improving URL validation, network and texture creation error handling.
  • Improved native ad impression validation.

Fixed​

  • Fixed wrong Android bluestack-sdk-core dependency version
  • Fixed an issue where the banner ad sat under the bottom navigation bar on Android by updating BannerAdUtils.getSafeInsets to use WindowInsetsCompat systemBars, ensuring banners clear the navigation bar.
  • Fixed Android Native Ad load method to use MNGPreference instead of new RequestOptions

[3.2.1] - 2025-06-18​

Changed​

  • BlueStack Android Core SDK version upgraded to 5.1.5
  • BlueStack iOS Core SDK version upgraded to 5.1.5

[3.2.0] - 2025-06-16​

Changed​

  • BlueStack Android Core SDK version upgraded to 5.1.3
  • BlueStack iOS Core SDK version upgraded to 5.1.4
  • Implemented API changes of native core SDK v5
  • iOS dependency management has been updated in the Unity Editor, mediation adapters are now added as separate pods in the Podfile.
  • A single source of truth is now used for dependency management, removing the need for separate dependency XML files for Mediation networks.

[3.1.10] - 2024-11-15​

Changed​

  • Updated the iOS Post Processor to include AdMob App IDs based on the inclusion of AdMob mediation adapters.
  • onIOSMediationNetworksUpdateEvent will trigger after changes to Settings serializedObject properties are applied.

Fixed​

  • Fixed the subspec inclusion process in the Podfile to ensure the full subspec string is removed when no adapters are selected and the subspec array is empty.
  • Fixed a Null Reference issue by updating the Destroy and distractor methods for Native Ads.

[3.1.9] - 2024-11-07​

Fixed​

  • Removed unused namespaces and fixed assembly reference missing issue.

[3.1.8] - 2024-11-07​

Changed​

  • BlueStackSettings Initialization on AssetPostProcess.

[3.1.7] - 2024-10-23​

Changed​

  • Removed Rewarded namespace
  • Renamed the GetBadge method to GetBadgeText
  • Renamed the GetTitle method to GetTitleText
  • Renamed the RegisterImageGameObject method to RegisterCoverImageGameObject
  • Renamed the RegisterCallToActionGameObject method to RegisterCallToActionTextGameObject

Fixed​

  • Rerestricted interaction with Native ad objects while any overlay view is on top.

[3.1.6] - 2024-07-26​

Changed​

  • BlueStack Android SDK version upgraded to 4.4.0

Added​

  • Manage Android mediation networks from the BlueStack Settings

[3.1.5] - 2024-07-10​

Added​

  • Method added to refresh Banner in the editor
  • Native ad Close method added to trigger OnNativeAdClosed event in the editor

Changed​

  • Unity deprecated methods handled
  • Readme doc update

Fixed​

  • Fixed the BlueStack Settings null exception issue when no settings exist
  • Fixed the issue with saving AdMob App ids
  • Error handled in Native ads, in case of null or empty image urls.

[3.1.4] - 2024-07-04​

Changed​

  • Reward type and amount added in RewardedItem of OnUserRewardEarned event

[3.1.3] - 2024-04-26​

Changed​

  • Automatically update all dependencies when SDK version is updated

[3.1.2] - 2024-04-17​

Changed​

  • BlueStack iOS SDK version updated to 4.4.6

[3.1.1] - 2024-04-09​

Changed​

  • BlueStack Android SDK version updated to 4.3.2

Fixed​

  • iOS runtime error due to Criteo dependency

[3.1.0] - 2024-04-08​

Changed​

  • BlueStack iOS SDK version updated to 4.4.4

Added​

  • Option to add/remove iOS mediation networks from BlueStack Settings

[3.0.4] - 2024-03-06​

Changed​

  • BlueStack Android SDK version updated to 4.3.1

[3.0.3] - 2024-02-23​

Fixed​

  • Platform check in PostProcessBuild

[3.0.2] - 2024-02-14​

Changed​

  • BlueStack iOS SDK version updated to 4.4.0
  • Google-Mobile-Ads-SDK is included in the package dependencies to be added as a subspec in the pod

[3.0.1] - 2024-01-24​

Changed​

  • BlueStack iOS SDK version updated to 4.3.0
  • Native Ad support for iOS
  • Editor Settings: Both iOS and Android admob id fields are together

[3.0.0] - 2023-10-13​

Changed​

  • BlueStack iOS SDK version updated to 4.2.9
  • BlueStack Android SDK version updated to 4.3.0

Added​

  • Native Ad support for Android

[2.0.2] - 2023-09-21​

Changed​

  • BlueStack android SDK version updated to 4.2.10

Fixed​

  • Android Ad loading error immediately after initialization

[2.0.1] - 2023-08-10​

Changed​

  • BlueStack android SDK version updated to 4.2.9

[2.0.0] - 2023-06-26​

Changed​

  • BlueStack android SDK version updated to 4.2.8
  • BlueStack iOS SDK version updated to 4.2.7
  • Restructured the assembly definition files and namespace
  • SDK Initialization complete callback

Added​

  • Adapters Initialization complete callback with status

[1.1.1] - 2023-05-18​

Fixed​

  • AdBehaviour namespace issue fixed.

[1.1.0] - 2023-05-12​

Changed​

  • BlueStack android SDK version updated to 4.2.6
  • BlueStack iOS SDK version updated to 4.2.5
  • Interstitial and RewardedVideo ad placeholders (prefabs) are updated in the Unity Editor
  • Load, Show, Hide methods are improved for the unity editor
  • "setPosition" method renamed to "SetPosition"

Added​

  • Added placeholders (prefabs) for for all kinds of banner ads in the Unity Editor
  • Load, display banner ads based on ad size and display size in the Unity Editor
  • Change banner position at runtime in the Unity Editor (Using SetPosition method)
  • OnBannerDidLoad, OnBannerDidFailed, OnBannerDisplay, OnBannerHide events are now functional in the Unity Editor
  • Added close button actions and Ad click behaviours in the Unity Editor
  • Load and show interstitial and rewarded ads placeholder based on orientation
  • Added timer for the Rewarded ad in the Unity Editor

[1.0.3] - 2023-04-18​

Changed​

  • BlueStack android SDK version updated to 4.2.5
  • BlueStack iOS SDK version updated to 4.2.4

[1.0.2] - 2023-03-27​

Changed​

  • BlueStack android SDK version updated to 4.2.2
  • BlueStack iOS SDK version updated to 4.2.2

[1.0.1] - 2023-03-14​

Changed​

  • BlueStack android SDK version updated to 4.2.1
  • BlueStack iOS SDK version updated to 4.2.1

[1.0.0] 2023-02-23​

Added​

  • Supported Ad Formats - Banner, Interstitial and RewardedVideo.
  • Supported Ad Networks - BlueStack, Improve Digital and AdMob.