InStream ads

Warning.

This is an archived version of the documentation. Actual documentation for all platforms can be found here.

InStream is an ad format that lets you monetize your app by serving ads while video content is playing.

An InStream ad consists of a scenario with multiple video units. The type of video unit in an InStream scenario determines how the video ad should be played relative to the main video content.

  1. About InStream
  2. API for working with InStream ads

About InStream

To set up an InStream scenario, create a video resource in the Partner interface. Once created, the video resource is assigned a unique identifier (Page ID). This ID should be used in the Mobile Ads SDK.

To increase ad revenue, you can set up playing multiple ads within a single ad placement: an AdPod. You can set up the AdPod for an ad placement in the Partner interface.

Types of video units supported by the Mobile Ads SDK:
  • Pre-Roll — A video ad is played before the main content.
  • Mid-Roll — A video ad is played at a certain time within the main content.
  • Post-Roll — A video ad is played after the main content.
  • Pause-Roll — A video ad is played when the user clicks the pause button.
  • In-Roll — A video ad is played anywhere in the video when a certain point is reached.

API for working with InStream ads

An API for integrating InStream ads lets you support playing any type of ad break : Pre-Roll, Mid-Roll, Post-Roll, In-Roll , and Pause-Roll.

Pre-Roll, Mid-Roll, and Post-Roll ad breaks are played using the InstreamAdBinder API. To play In-Roll and Pause-Roll ad breaks, use the In-Roll API and Pause-Roll API, respectively.

Note.
You can also use the InstreamAdBinder API, In-Roll API, and Pause-Roll API concurrently if you:
  1. Use different instances of the ad player.
  2. Don't start the Pause-Roll and In-Roll APIs for playing ads if the main video was paused using the InStreamAdBinder API.