Release notes for the IMA Android SDK

1,651 views
Skip to first unread message

Bret McGowen

unread,
May 7, 2014, 5:49:19 PM5/7/14
to ima...@googlegroups.com
Hi all,

We'll post in this thread every time a new version of the IMA Android SDK is released. If you wish to receive these updates by e-mail, click the Topic Options arrow at the top of this thread and click E-mail updates to me.


If you have any questions regarding a particular release, please post a new topic in this forum and let us know that you are using the Android version of the IMA SDK. If you're experiencing an error, please also include a link to a test page where we can see the issue.

Thanks,
IMA SDK Team

Shawn Busolits (IMA SDK Team)

unread,
May 28, 2014, 1:12:58 PM5/28/14
to ima...@googlegroups.com
5/27/2014 - Beta v7

Fixes an issue with Google Play Services. The SDK now requires that Google Play Services be built into your app. For more information, see Set Up Google Play Services SDK.

Bret McGowen

unread,
Jun 24, 2014, 4:47:38 PM6/24/14
to ima...@googlegroups.com
6/12/2014 - Beta v8
  • Fixes an issue with the ad UI not clearing for skippable ads.
  • Documents the error code for media file load timeouts.

Bret McGowen

unread,
Oct 17, 2014, 6:07:24 PM10/17/14
to ima...@googlegroups.com
10/17/2014 - Beta 9
  • Adds the Ad APIs getTitle, getDescription, and getContentType.
  • Adds information about ad pod position to the ad UI, for example, "Ad 1 of 4: (0:13)".
  • You should no longer directly control the pause/play/resume of ads via your video player. Instead, use AdsManager.pause() and AdsManager.resume(). 
  • Stay tuned for an upgrade guide for Beta 9 on the blog at http://googleadsdeveloper.blogspot.com. The guide will be also be linked from the IMA Android SDK release notes page.

Shawn Busolits (IMA SDK Team)

unread,
May 22, 2015, 9:49:37 AM5/22/15
to ima...@googlegroups.com, ima-sdk-ad...@google.com
5/21/2015 - 3.b11.4
  • Adds the following to the API:
    • AdError.AdErrorCode.VAST_EMPTY_RESPONSE
    • AdError.getErrorNumber()
    • AdsRequest.setAdWillAutoPlay(Boolean)
    • CompanionAdSlot.isFilled()
    • ImaSdkSettings.setPlayerType(String)
    • ImaSdkSettings.setPlayerVersion(String)

3/24/2015 - 3.b10.3
  • Added ImaSdkSettings.getMaxRedirects and ImaSdkSettings.setMaxRedirects.
  • IMA API classes are now final.
  • SDK version numbers are now in the format 3.bX.Y with b to indicate the SDK's beta status.
  • The following AdError.AdErrorCode values have been removed:
    • API_ERROR - instead use UNKNOWN_AD_RESPONSE.
    • PLAYLIST_MALFORMED_RESPONSE - instead use UNKNOWN_AD_RESPONSE.
    • REQUIRED_LISTENERS_NOT_ADDED - was not being raised by the SDK.
    • VAST_INVALID_URL - instead use VAST_LOAD_TIMEOUT.

Shawn Busolits (IMA SDK Team)

unread,
Jul 21, 2015, 4:38:30 PM7/21/15
to Interactive Media Ads SDK, ima-sdk-ad...@google.com, ima-sdk-ad...@google.com
7/20/2015 - 3.b12.1

  • Allows the user to customize ad UI elements via AdsRenderingSettings.setUiElements.
  • Adds ability to play ad breaks manually instead of automatically. See Manual Ad Break Playback.
  • Adds the restriction that ContentProgressProvider.getContentProgress should never return null.
  • Adds AdEvent.TAPPED which will fire when the user taps on any non-clickable region of a video ad.

Yury Pavlotsky (IMA SDK Team)

unread,
Sep 10, 2015, 4:45:29 PM9/10/15
to Interactive Media Ads SDK
9/10/2015 - 3.b13.3
  • Service release, no new features.

Yury Pavlotsky (IMA SDK Team)

unread,
Dec 16, 2015, 11:56:56 AM12/16/15
to Interactive Media Ads SDK
12/16/2015 - 3.1.3

Yury Pavlotsky (IMA SDK Team)

unread,
Apr 8, 2016, 3:30:43 PM4/8/16
to Interactive Media Ads SDK
4/7/2016 - 3.2.1

Shawn Busolits (IMA SDK Team)

unread,
Jun 7, 2016, 2:25:42 PM6/7/16
to Interactive Media Ads SDK
6/7/2016 - 3.3.3

Yury Pavlotsky (IMA SDK Team)

unread,
Jul 11, 2016, 3:19:59 PM7/11/16
to Interactive Media Ads SDK
7/11/2016 - 3.3.2

Correction: the previous release was 3.3.0, not 3.3.2.

Yury Pavlotsky (IMA SDK Team)

unread,
Sep 13, 2016, 10:20:33 AM9/13/16
to Interactive Media Ads SDK
9/13/2016 - 3.4.0
  • Fixes a duplicate files error when using Google Play Services version 9.0.0 and up.

Yury Pavlotsky (IMA SDK Team)

unread,
Nov 14, 2016, 1:52:03 PM11/14/16
to Interactive Media Ads SDK
11/14/2016 - 3.5.2
  • Adds an SDK-owned video player that optionally handles ad playback.
  • Adds CompanionAdSlot.ClickListener and methods to add and remove a listener.
  • Fixes an issue with invalid getViewability() error logs.
  • Fixes an issue with icons' clickthrough behavior and not rendering correctly.

Yury Pavlotsky (IMA SDK Team)

unread,
Mar 24, 2017, 3:59:23 PM3/24/17
to Interactive Media Ads SDK

3/24/2017 - 3.7.1
  • Moves all classes in the jar to the com/google directory. Jar size reduced by around 30KB.
  • SDK version 3.7.0 will be deprecated on 3/24/2018. See the Deprecation Schedule for more details.

Yury Pavlotsky (IMA SDK Team)

unread,
May 25, 2017, 5:16:02 PM5/25/17
to Interactive Media Ads SDK
5/25/2017 - 3.7.2

  • Adds setDebugMode to ImaSdkSettings.
  • SDK version 3.7.1 will be deprecated on 5/25/2018. See the Deprecation Schedule for more details.

Yury Pavlotsky (IMA SDK Team)

unread,
Jun 29, 2017, 1:51:08 PM6/29/17
to Interactive Media Ads SDK
6/29/2017 - 3.7.4
  • Adds setVastLoadTimeout to AdsRequest.
  • Adds getSkipTimeOffset to Ad.
  • SDK version 3.7.2 will be deprecated on 6/29/2018. See the Deprecation Schedule for more details.

Yury Pavlotsky (IMA SDK Team)

unread,
Jan 25, 2018, 10:54:23 AM1/25/18
to Interactive Media Ads SDK
1/24/2017 - 3.8.2
  • Adds setLiveStreamPrefetchSeconds to AdsRequest.
  • Various documentation fixes.
  • SDK version 3.7.4 will be deprecated on 1/24/2019. See the Deprecation Schedule for more details.

Yury Pavlotsky (IMA SDK Team)

unread,
Apr 10, 2018, 10:34:55 AM4/10/18
to Interactive Media Ads SDK
4/9/2018 - 3.8.5
  • Fixes an issue with ImaSdkSettings being ignored.
  • Fixes an issue where there were build conflicts with com.android.support version files.
  • Adds setAdWillPlayMuted to AdsRequest.
  • Adds setLoadVideoTimeout to AdsRenderingSettings.
  • SDK version 3.8.2 will be deprecated on 4/9/2019. See the Deprecation Schedule for more details.

Yury Pavlotsky (IMA SDK Team)

unread,
May 23, 2018, 3:29:00 PM5/23/18
to Interactive Media Ads SDK
4/23/2018 - 3.8.7

Yury Pavlotsky (IMA SDK Team)

unread,
May 23, 2018, 3:29:51 PM5/23/18
to Interactive Media Ads SDK
Correction: 3.8.7 was released on 5/23/2018

Yury Pavlotsky (IMA SDK Team)

unread,
Jul 9, 2018, 4:48:50 PM7/9/18
to Interactive Media Ads SDK
7/9/2018 - 3.9.0
  • Adds focusSkipButton() to AdsManager. This will only work on Android TV.
  • Adds getFocusSkipButtonWhenAvailable() to AdsRenderingSettings, defaulting to true. This will only work on Android TV.
  • Adds setFocusSkipButtonWhenAvailable() to AdsRenderingSettings. This will only work on Android TV.
  • VideoAdPlayer now extends the VolumeProvider interface. Implementing this interface is now required for custom playback.
  • SDK version 3.8.7 will be deprecated on 7/9/2019. See the Deprecation Schedule for more details.

Yury Pavlotsky (IMA SDK Team)

unread,
Aug 2, 2018, 1:47:51 PM8/2/18
to Interactive Media Ads SDK
8/1/2018 - 3.9.4
  • Adds getCompanionAds() to Ad. This retuns companion ads while using DAI only.
  • Adds new CompanionAd class.
  • Adds new SKIPPABLE_STATE_CHANGED event to AdEvent.
  • Fixes an issue where the default setting for focusSkipButtonWhenAvailable wasn't being respected in some cases.
  • SDK version 3.9.0 will be deprecated on 8/1/2019. See the Deprecation Schedule for more details.

Yury Pavlotsky (IMA SDK Team)

unread,
Nov 13, 2018, 1:57:07 PM11/13/18
to ima...@googlegroups.com
8/13/2018 - 3.10.2
  • Fixes a race condition that causes the second ad in a pod to throw a VAST 402 error.
  • Adds frequency capping and competitive exclusion to the DAI Android SDK.
  • Moves getAdProgressInfo() from StreamManager to BaseManager.
  • Adds getVastMediaHeight(), getVastMediaWidth() and getVastMediaBitrate() to Ad.
  • SDK version 3.9.4 will be deprecated on 11/13/2019. See the Deprecation Schedule for more details.

ima-sdk-fo...@google.com

unread,
Mar 18, 2019, 4:30:45 PM3/18/19
to ima...@googlegroups.com
3.10.9
  • Fixed a race condition bug where ad UI sometimes doesn't render on subsequent ads after the first ad is skipped.
  • Fixed a crash that occurred when calling the getCompanionAds() API.

On 11/13/18 10:57:06 ima-sdk-ad...@google.com wrote:
8/13/2018 - 3.10.2
  • Fixes a race condition that causes the second ad in a pod to throw a VAST 402 error.
  • Adds frequency capping and competitive exclusion to the DAI Android SDK.
  • Moves getAdProgressInfo() from StreamManager to BaseManager.
  • Adds getVastMediaHeight(), getVastMediaWidth() and getVastMediaBitrate() to Ad.

--
You received this message because you are subscribed to the Google Groups "Interactive Media Ads SDK" group.
To unsubscribe from this group and stop receiving emails from it, send an email to ima-sdk+unsubscribe@googlegroups.com.
To post to this group, send email to ima...@googlegroups.com.
Visit this group at https://groups.google.com/group/ima-sdk.
For more options, visit https://groups.google.com/d/optout.

ima-sdk-fo...@google.com

unread,
Mar 22, 2019, 7:03:10 PM3/22/19
to ima...@googlegroups.com
3/22/2019 - 3.11.0

On 03/18/19 13:30:42 ima-sdk-fo...@google.com wrote:
3.10.9
  • Fixed a race condition bug where ad UI sometimes doesn't render on subsequent ads after the first ad is skipped.
  • Fixed a crash that occurred when calling the getCompanionAds() API.

Greg Schoppe (IMA SDK Team)

unread,
Sep 6, 2019, 11:59:51 AM9/6/19
to Interactive Media Ads SDK
9/6/2019 - 3.13.1
  • Adds the ability to set the continuous play context for an ads request. See thesetContinuousPlayback() for more details.
  • Adds the getUniversalAdIds() method to the Ad class.
  • Adds the setAuthTokengetAuthTokensetFormatgetFormat and the StreamFormat enum.
  • Fixes an error in nexus 5 devices that occurs when a container is removed before receiving an ad response.
  • Fixes an issue where companion ads would only render once.
  • Fixes an issue where unsupported ad types (nonlinears, VPAID) were not failing gracefully.

Jackson Sui (IMA SDK Team)

unread,
Sep 12, 2019, 1:44:22 PM9/12/19
to ima...@googlegroups.com
9/12/2019 - 3.14.0

Jackson Sui (IMA SDK Team)

unread,
Oct 28, 2019, 10:07:43 AM10/28/19
to Interactive Media Ads SDK
10/23/2019 - 3.16.0
  • Adds the replaceAdTagParameters API to the StreamManager to update ad tag parameters during a live stream.
  • Removes support of the following deprecated methods:
    • AdsRequest.getAdDisplayContainer()
    • AdsRequest.setAdDisplayContainer(AdDisplayContainer adDisplayContainer)
    • ImaSdkFactory.createAdsLoader(Context context)
    • ImaSdkFactory.createAdsLoader(Context context, ImaSdkSettings settings)
    • ImaSdkFactory.createLiveStreamRequest(String assetKey, String apiKey, StreamDisplayContainer streamDisplayContainer)
    • ImaSdkFactory.createVodStreamRequest(String contentSourceId, String videoId, String apiKey, StreamDisplayContainer streamDisplayContainer)
    • StreamRequest.getStreamDisplayContainer()

Jackson Sui (IMA SDK Team)

unread,
Nov 11, 2019, 9:51:35 AM11/11/19
to Interactive Media Ads SDK
11/11/12019 - 3.16.1

Jackson Sui (IMA SDK Team)

unread,
Dec 6, 2019, 4:33:02 PM12/6/19
to Interactive Media Ads SDK
11/5/2019 - 3.16.2
  • Adds support for automatic inclusion of consent parameters from IAB TCFv2 and CCPA.
  • Using Android preferences now requires the androidx package.

Jackson Sui (IMA SDK Team)

unread,
Jan 23, 2020, 4:24:10 PM1/23/20
to Interactive Media Ads SDK
1/22/2020 - 3.16.5
  • Reworks support for OMID 1.3 contentUrl with AdsRequest.setContentUrl and StreamRequest.setContentUrl .
  • Reworks support for OMID 1.3 friendly obstructions with FriendlyObstruction .
  • Deprecates the methods BaseDisplayContainer.registerVideoControlsOverlay and BaseDisplayContainer.unregisterAllVideoControlsOverlay in favor of FriendlyObstruction .
  • Fixes an issue with a NullPointerException occurring after calling clear() on CompanionAdSlots.
  • Fixes an issue that was potentially causing memory leaks when calling destroy() during ad playback.
  • SDK version 3.16.5 will be deprecated on 1/22/2021. See the Deprecation Schedule for more details.

Jackson Sui (IMA SDK Team)

unread,
Feb 12, 2020, 10:39:58 AM2/12/20
to ima...@googlegroups.com
2/7/2020 - 3.17.0

Jackson Sui (IMA SDK Team)

unread,
Mar 4, 2020, 5:11:46 PM3/4/20
to Interactive Media Ads SDK
3/4/2020 - 3.18.0

  • Adds pause() and resume() to the VideoStreamPlayer interface. These must be implemented for v3.18.0 and later.

Jackson Sui (IMA SDK Team)

unread,
May 12, 2020, 11:47:58 AM5/12/20
to Interactive Media Ads SDK

5/12/2020 - 3.19.0

Note: v3.18.1 was released on 3/25/2020 but a post here was not made. Notes for 3.18.1 are as follows:
  • Adds scaling for Companion Ads on high-pixel-density devices.
  • Adds support for client-side SIMID ads.

Jackson Sui (IMA SDK Team)

unread,
Jun 22, 2020, 3:47:47 PM6/22/20
to Interactive Media Ads SDK
6/22/2020 - 3.19.2

Jackson Sui (IMA SDK Team)

unread,
Jun 29, 2020, 5:46:10 PM6/29/20
to Interactive Media Ads SDK
6/29/2020 - 3.19.3
  • Fixes an issue with the IAB TCF integration for GDPR.

Jackson Sui (IMA SDK Team)

unread,
Jul 8, 2020, 11:12:25 AM7/8/20