We're moving to the new documentation portal: developers.bidmachine.io
Documentation
Log In
Documentation

Changelog

Suggest Edits

Version 3.3.0 (May 26, 2025)

Features:

  • Added AdPlacementConfig
  • Added public API methods: 
    BidMachine.getBidToken(context, adPlacementConfig)
BidMachine.getBidToken(context, adPlacementConfig, callback)
  • Removed public API methods: 
    BidMachine.getBidToken(context)
BidMachine.getBidToken(context, callback)
  • Deprecated public API methods: 
    BidMachine.getBidToken(context, adsFormat)
BidMachine.getBidToken(context, adsFormat, callback)
  • Changed to @NonNull AdsFormat in deprecated getBidToken methods: 
    BidMachine.getBidToken(context, adsFormat)
BidMachine.getBidToken(context, adsFormat, callback)
  • BidMachineInitProvider performance improvements

Version 3.2.1 (March 21, 2025)

Features:

  • Removed mraid.resize and mraid.expand support
  • Updated OM SDK to 1.5.4
  • Restricted ad ids for COPPA traffic

Bug fixes:

  • Fixed BidMachineInitProvider ANR
  • Fixed User-Agent related ANR

Version 3.2.0 (February 12, 2025)

Features:

  • Added support for ERID requirements
  • Added Deep Links support
  • Added User-Agent to trackers
  • Removed image aspect ratio checker from Native Ad
  • Improved Referrer HTTP header field for MRAID ad

Bug fixes:

  • Fixed SessionManager crash
  • Fixed possible loss of networks during initialization

Version 3.1.1 (November 19, 2024)

Features:

  • Rollback compatibility with Gradle 7.2+ and AGP 7.1+
  • Extend MRAID features support

Bug fixes:

  • Fix InstallReferrer ANR
  • Internal changes and stability improvements

Version 3.1.0 (October 30, 2024)

Features:

  • Internal changes and stability improvements
  • Increased target API version to 35
  • Updated OM SDK to 1.5.2
  • Updated r8 rules
  • Locked all dependencies versions
  • Increased min Gradle version to 8.0
  • Increased min Android Gradle Plugin version to 8.0.2

Version 3.0.1 (September 12, 2024)

Features:

  • Get rid of orientation in ad unit
  • All views in native ads are clickable by default if no list is passed explicitly

Version 3.0.0 (July 23, 2024)

🚧

Increased minSdk to 21 (5.0, Lollipop)

Features:

  • Removed deprecated RichMedia ad type
  • Deprecated SessionPlacementData
  • Deprecated getBidToken methods without AdsFormat: 
    BidMachine.getBidToken(context)
BidMachine.getBidToken(context, callback)
  • Updated OM SDK version to 1.5.0
  • Added API method to get extras parameters: 
    BidMachine.getExtrasParam(context, key)

Bug fixes:

  • Fixed ANR io.bidmachine.core.Logger.log
  • Fixed IAB StackOverflowError when calling Utils.findEndpoint

Version 2.7.0 (May 8, 2024)

Features:

  • Added GAM dynamic version range support from 21.0.0 to 23.0.0

Bug fixes:

  • Fixed ClassCastException with ExoPlayer

Version 2.6.0 (April 5, 2024)

Features:

  • Increased target API version to 34
  • Updated OM SDK version to 1.4.12. Passed certification by OM SDK.

Bug fixes:

  • Fixed ANR Utils.getCacheDir
  • Fixed ANR UserAgentProvider

Version 2.5.2 (March 7, 2024)

Features:

  • Small internal dependency improvements. Excluded Multidex.

Version 2.5.1 (March 1, 2024)

Features:

  • Deprecated RichMedia ad type
  • Improved processing WebViewClient#onRenderProcessGone (fix for possible WebView crashes)

Version 2.5.0 (February 16, 2024)

Features:

  • Improvements with internal modules
  • Minor optimisation and fixes
  • Optimised token fetch mechanism

Version 2.4.2 (January 26, 2024)

Features:

  • Internal improvements

Version 2.4.1 (January 4, 2024)

Features:

  • Minor improvements for enhanced internal functionality

Version 2.4.0 (November 9, 2023)

Features:

  • Added GPP Support
  • Improved integration with Google

Bug fixes:

  • Fixed Context memory leak
  • Fixed OnClose callback

Version 2.3.4 (November 9, 2023)

Features:

  • Improved visibility tracking logs

Bug fixes:

  • Fixed impression tracking with some networks

Version 2.3.3 (September 4, 2023)

Features:

  • Improved integration with Google.
  • Improved internal tracking logic.
  • Improved Native Ads tracking.

Version 2.3.2 (August 2, 2023)

Features:

  • Improved object cleanup during NativeAdObject#unregisterView

Version 2.3.1 (July 21, 2023)

Features:

  • SDK improvement
  • Added onAdShowFailed callback for Banner/Mrec, Native, RichMedia ad types

Version 2.2.0 (May 15, 2023)

Features:

  • Updated the logic for working with BidToken
  • Added API methods:
BidMachine.getBidToken(context, adsFormat)
BidMachine.getBidToken(context, adsFormat, callback)

Bugfixes:

  • Moved UserAgent initialization from preInitialize to initialize

Version 2.1.13 (April 13, 2023)

Features:

  • SDK improvement

Version 2.1.12 (March 24, 2023)

Features:

  • SDK improvement

Version 2.1.11 (March 14, 2023)

Features:

  • Updated SDK events

Version 2.1.10 (March 3, 2023)

Features:

  • SDK improvement

Version 2.1.9 (February 23, 2023)

Features:

  • Improved Utils.onBackgroundThread

Version 2.1.8 (February 15, 2023)

Features:

  • SDK improvement
  • Increased target API version to 33
  • Added more safety for BidMachineImpl.preInitialize
  • Added more information in error events
  • Updated tracking event logic

Bugfixes:

  • Fixed OutOfMemory crashes in NetworkRequest#request
  • Fixed NullPointerException crashes in AdRequest#destroy

Version 2.1.7 (January 26, 2023)

Bugfixes:

  • Fixed ConcurrentModificationException crashes in AdProcessCallbackComposite.executeOnCallback

Version 2.1.6 (January 25, 2023)

Bugfixes:

  • Fixed ConcurrentModificationException crashes in AdProcessCallbackComposite.executeOnCallback
  • Fixed OutOfMemory crashes in NetworkLoadTask#execute
  • Fixed IllegalStateException crashes in MediaView#tryPlayVideo

Version 2.1.5 (November 16, 2022)

Features:

  • SDK improvement

Version 2.1.4 (November 9, 2022)

Features:

  • SDK improvement

Version 2.1.3 (November 8, 2022)

Features:

  • SDK improvement

Version 2.1.2 (November 7, 2022)

Features:

  • Updated analytics

Version 2.1.1 (October 22, 2022)

Bug fixes:

  • Fixed ConcurrentModificationException crashes in AdResponse

Version 2.1.0 (September 29, 2022)

Features:

  • SDK improvement

Version 2.0.0 (September 5, 2022)

Features:

  • SDK improvement
  • Added Java 8
  • Removed AdListener#onAdShown, use AdListener#onAdImpression instead

Version 1.9.10 (August 16, 2022)

Features:

  • SDK improvement

Version 1.9.9 (August 8, 2022)

Features:

  • SDK improvement

Version 1.9.8 (August 1, 2022)

Features:

  • Updated IAB library to 1.0.0

Version 1.9.7 (July 14, 2022)

Features:

  • Deprecated AdListener#onAdShown, use AdListener#onAdImpression instead

Version 1.9.6 (June 30, 2022)

Features:

  • SDK improvement

Version 1.9.5 (June 21, 2022)

Features:

  • SDK improvement

Version 1.9.4 (May 30, 2022)

Features:

  • SDK improvement

Version 1.9.3 (March 31, 2022)

Features:

  • SDK improvement

Version 1.9.2 (March 16, 2022)

Features:

  • SDK improvement
  • Increased minimum API version to 16
  • Increased target API version to 31

Version 1.9.1 (February 11, 2022)

Features:

  • Added API method AdRequest.Builder#setCustomParams to set custom parameters

Version 1.9.0 (February 01, 2022)

Features:

  • SDK improvement
  • Added API method BidMachine.getBidToken to get BidToken for S2S integration

Version 1.8.3 (December 29, 2021)

Features:

  • SDK improvement

Version 1.8.2 (December 23, 2021)

Features:

  • SDK improvement

Version 1.8.1 (November 26, 2021)

Features:

  • SDK improvement

Version 1.8.0 (October 26, 2021)

Features:

  • Added RichMediaView to display video ads into the view

Version 1.7.7 (October 21, 2021)

Features:

  • SDK improvement
  • Added API method AdRequest#notifyMediationLoss with WinnerNetworkName and WinnerNetworkPrice parameters to notify BidMachine of loss if you use BidMachine like in-house mediation
  • Removed AuctionResult#getSeat

Version 1.7.6 (July 21, 2021)

Features:

  • SDK improvement

Version 1.7.5 (June 30, 2021)

Features:

  • SDK improvement

Version 1.7.4 (May 31, 2021)

Features:

  • SDK improvement
  • Added API method AdRequest.Builder#setPlacementId to set placement id
  • Deprecated AuctionResult#getSeat

Version 1.7.3 (May 18, 2021)

Features:

  • SDK improvement
  • Added TargetingParams#setExternalUserIds to pass external user ids
  • Removed AdRequest.Builder#disableHeaderBidding and AdRequest.Builder#enableHeaderBidding
  • Removed client-side price rounding. At the same time, some deprecated methods were removed that were responsible for the price rounding from BidMachineFetcher

Version 1.7.2 (April 20, 2021)

Features:

  • SDK improvement
  • Added API method AdRequest.Builder#setBidPayload to set BidPayload
  • Added support for OMSDK version 1.3.15

Version 1.7.1 (March 30, 2021)

Features:

  • SDK improvement
  • Added API method AdRequest#destroy to destroy AdRequest
  • Deprecated client-side rounding, use server side rounding
  • Deprecated 3rd party helpers, use adapter helpers

Version 1.6.4 (February 12, 2021)

Features:

  • Improved visibility tracker

Version 1.6.3 (January 18, 2021)

Features:

  • Banner improvement

Version 1.6.2 (December 17, 2020)

Features:

  • Added support TCF 2.0 - IABTCF_TCString and IABTCF_gdprApplies

Version 1.6.1 (November 3, 2020)

Features:

  • SDK improvement

Version 1.6.0 (September 11, 2020)

Features:

  • SDK improvement
  • Added API method BidMachine.setUSPrivacyString to set US privacy string
  • Added API method AdRequest.Builder#setNetworks to set certain networks for AdRequest
  • Added API method AdRequest.Builder#setSessionAdParams to set additional session parameters for AdRequest
  • Updated AdColony adapter version to 1.6.0.5. More info here
  • Updated Amazon adapter version to 1.6.0.3. More info here
  • Updated Facebook adapter version to 1.6.0.4. More info here
  • Updated MyTarget adapter version to 1.6.0.3. More info here
  • Updated Tapjoy adapter version to 1.6.0.4. More info here

Version 1.5.2 (August 3, 2020)

Features:

  • SDK improvement
  • Updated AdColony adapter version to 1.5.2.4. More info here
  • Updated Criteo adapter version to 1.5.2.4. More info here

Version 1.5.1 (July 15, 2020)

Features:

  • Native ad improvement

Version 1.5.0 (July 10, 2020)

Features:

  • SDK improvement
  • Combining BidMachineFetcher and BidMachineHelper. Use BidMachineFetcher instead BidMachineHelper
  • Added API method AdRequest.Builder#setLoadingTimeOut to set loading timeout for AdRequest
  • Added API method AdRequest#notifyMediationWin and AdRequest#notifyMediationLoss to notify BidMachine of win/loss if you use BidMachine like in-house mediation

Version 1.4.4 (May 22, 2020)

Features:

  • Updated Amazon version to 8.3.0
  • Updated Criteo version to 3.5.0

Version 1.4.3 (April 9, 2020)

Features:

  • Added support CCPA based on IAB. More info here
  • Updated AdColony version to 4.1.0
  • Updated Facebook version to 5.7.1
  • Updated Tapjoy version to 12.4.2

Version 1.4.1 (January 21, 2020)

Features:

  • Added API method BidMachine.setPublisher to set publisher information
  • Added API methods Builder#disableHeaderBidding and Builder#enableHeaderBidding to AdRequest to disable/enable header bidding on server side

Version 1.4.0 (November 28, 2019)

Features:

  • Added Native Ad type

Version 1.3.3 (September 20, 2019)

Features:

  • Added Amazon network adapter for Header-Bidding
  • Added Criteo network adapter for Header-Bidding

Version 1.3.2 (September 12, 2019)

Features:

  • Update compatibility with Google's Protobuf libraries

Version 1.3.1 (September 4, 2019)

Features:

  • Added Mintegral network adapter for Header-Bidding
  • Update proguard rules

Version 1.3.0 (August 14, 2019)

Features:

  • Support of 3d party Ad networks adapters for Header-Bidding that work with BidMachine via SDK
  • Possibility to change endpoint
  • Support of GDPR settings exchange with SharedPreferences (you can found more info here)

Updated 5 months ago