Google IMA SDK for QuickBrick TV Apps

Google IMA SDK for QuickBrick TV Apps

Introduction

Google IMA Ad support is available by using the “Google Interactive Media Ads QuickBrick” plugin (NOT “Google IMA Video Ads”, the mobile plugin)

When installing the plugin, please select the "TvOS For Quickbrick" / "Android Tv For Quickbrick" Version.

Device support

Supported:

Platforms: The IMA plugin is currently supported ONLY on tvOS for the native tvOS player.

• Tags: VMAP and VAST tags are supported.

NOT Supported:

• The IMA plugin is NOT supported on Samsung, LG, Android, Amazon or Roku. 
• The IMA plugin is NOT supported on Mobile (iOS or Android)

Note that Google IMA will never be supportable on Samsung - they have not supported in the past and at their October 2019 developer conference announced (but with no details) their own proprietary ad-serving solution to be launched.

Other platforms are to be developed (Android, Amazon) or investigated (LG). [Contact Product for latest information]

Advertisement Configuration on a Feed Level

You can configure an advertisement of type Preroll / Midroll / Postroll on a specific Entry Level (specific video).

This can be done by adding the "offset" and "ad_url" parameters to the "extensions" section of eah entry in your JSON feed.

For example:

extensions": {
"video_ads": Array[2][
{
"offset": "preroll",
"ad_url": "https://pubads.g.doubleclick.net/gampad/ads?sz=640x480&iu=/124319096/external/single_ad_samples&ciu_szs=300x250&impl=s&gdfp_req=1&env=vp&output=vast&unviewed_position_start=1&cust_params=deployment%3Ddevsite%26sample_ct%3Dredirectlinear&correlator="
},

{
"offset": "30",
"ad_url": "https://pubads.g.doubleclick.net/gampad/ads?sz=640x480&iu=/19489716/pre-roll&impl=s&gdfp_req=1&env=vp&output=vast&unviewed_position_start=1&url=[referrer_url]&description_url=[description_url]&correlator=[timestamp]"
},

{
"offset": "postroll",
"ad_url": "https://pubads.g.doubleclick.net/gampad/ads?sz=640x480&iu=/19489716/pre-roll&impl=s&gdfp_req=1&env=vp&output=vast&unviewed_position_start=1&url=[referrer_url]&description_url=[description_url]&correlator=[timestamp]"
}

Here is an Example of a JSON with the Different Types of Video Advertisements on an Item-level, configured via the Extensions:

https://assets-production.applicaster.com/applicaster-employees/support_team/yona/Examples/Ads/video_ads.json

Plugin Fallback properties

Should you not have Ad URLs on a Feed level, you Insert the VMAP or VAST URLs as required into the relevant fields on the plugin level.

The flow that the system goes through is the following:

i- Feed - First check if there is an Ad on an entry level in the JSON feed, and present it for this particular entry (video).

ii- Plugin as Fallback - If the entry does not have a feed, check if there is an Ad URL on a plugin level [see screenshot below]

*Note: This Ad URL configured on a Plugin level will present the advertisement on an App level (unless there is a promotion of a specific ad per video via the feed, as mentioned above)

The Midroll option contains two fields:

• Tag Midroll URL - You will need to insert the entire Ad URL
  • For Example: https://pubads.g.doubleclick.net/gampad/ads?sz=640x480&iu=/124319096/external/single_ad_samples&ciu_szs=300x250&impl=s&gdfp_req=1&env=vp&output=vast&unviewed_position_start=1&cust_params=deployment%3Ddevsite%26sample_ct%3Dskippablelinear&correlator=
• Midroll Offset - You will need to insert the offset time in Seconds
  • For example: If you want the Advertisement to appear after 300 seconds, simply insert the value 300 in the field.