Platform DocsPlayers DocsRelease Notes
Developer Guides
System StatusSubmit a CaseDashboard LoginCompany Site

Schedule Google IMA ads (Android)

Add advertising breaks to your content when using the Google IMA ad client in an Android app.

Suggest Edits


According to Google, "Interactive Media Ads (IMA) is a suite of SDKs that make it easy to integrate multimedia ads into your websites and apps."

In addition to requesting ads from VAST-compliant ad servers and managing playback, IMA ads offer benefits such as the following:

  • Display companion ads
  • Report metrics to ad servers
  • Incorporate IDFA/ADID signals

After adding the Google IMA SDK to your app and acquiring the required items listed in the Requirements section, you can schedule Google IMA ads in your Android app.


Requirements


Scheduling Ad Breaks

📱
ANDROID | FIRE TV: Schedule a Pre-roll Ad Break (IMA)
Open Recipe
📱
ANDROID | FIRE TV: Schedule Multiple Ad Breaks (IMA)
Open Recipe
📱
ANDROID | FIRE TV: Schedule a VMAP Ad Schedule (IMA)
Open Recipe

IMA SDK Settings

You can configure the IMA SDK settings by creating a new instance of ImaSdkSettings. Developers can then assign it to an ImaAdvertisingConfig or ImaVmapAdvertisingConfig instance by passing it to the Builder().


📱
ANDROID | FIRE TV: Configure IMA SDK Settings
Open Recipe

Unsupported Features

The following table lists and describes the features that are unsupported.

Unsupported Feature Description
Ad Skip Offset The ad skip offset is always set within the ad response of a Google IMA ad tag and we do not override the value. To configure your skip offset please contact your ad network.
Ad Tag Variables The ad tag variables specified in our VAST documentation are not supported when using the IMA SDK. Instead, we suggest contacting Google IMA to provide you with a list of ad tag variables supported in the Google IMA SDK.
Ad Tag Waterfalls When using the IMA SDK you do not have the ability to define an ad tag waterfall in your code. An ad tag waterfall analog is instead defined in your Google Dashboard.
Non-linear Overlay Ads Non-linear ads are not currently supported via the IMA SDK. This is a limitation of the Google IMA SDK for Android.
Relative Paths When using IMA on the JWP Android SDK, the ClickThrough tag in an ads XML must not use a relative path.

...  
<ClickThrough>
  <![CDATA[ //jwplayer.com/ ]]>
</ClickThrough>
...
VPAID The Google IMA SDK does not support VPAID 1.0 or VPAID 2.0 ads. This is a limitation of the Google IMA SDK for Android.

Updated 7 months ago