Technical quick start guide (AFV)

A getting started guide for engineers using the Google IMA SDK to serve ads on HTML5 web, Android or iOS video players.

Brief overview

AdSense for Video operates using the Google Interactive Media Ads Software Development Kit (IMA SDK). This SDK allows you to request AdSense ads in order to more closely combine video content and advertising. These products are subject to the AdSense Terms & Conditions, AdSense Program policies, and product-specific usage guidelines. Remember that inadvertent clicks originating from overly aggressive or faulty implementations will result in action up to (and including) account termination.

Requesting and rendering ads through the IMA SDK is a matter of setting up an ad request, loading the resultant ad, and playing it at the right time. You can test using the default publisher ID "ca-video-pub-4968145218643279". You will need to provide your account manager with an example of your integration before you are allowed to deploy ads to your site(s).

Integration options

Third-party video player

One of the easiest ways to monetize using AdSense for Video is to select a third-party video player that already has the IMA SDK integrated.

The partners listed in the table below have the Google IMA SDK integrated that is required to monetize using AdSense for Video, either directly or via Google Ad Manager.

Please reach out to the third-party video player partners for further information on using their services.

Proprietary video player

Publishers who wish to monetize with AdSense for Video and have their own custom or proprietary video player will need to directly integrate the IMA SDK. The IMA SDK is available for multiple platforms:

• IMA HTML5 SDK for web-based video players:
  • Getting started guide
  • Downloadable sample code
  • API reference
• IMA Android SDK for video players in native Android apps:
  • Getting started guide
  • Downloadable sample code
  • API reference
• IMA iOS SDK for video players in native iOS apps:
  • Getting started guide
  • Downloadable sample code
  • API reference

Should you encounter technical issues during your integration of the IMA SDK, then the IMA SDK Technical Forum provides support for each SDK, as well as serving as a place to report bugs or SDK feature requests.

VAST and VPAID JS compliant video player

For publishers who have video players that aren't integrated with the IMA SDK, video content may still be monetized using the IMA Adapter tag if the player is compatible with VAST 2 or 3, as well as VPAID 2 JS standards. Note: the IMA Adapter is supported for web only.

Once you have a chosen integration option, follow the AdSense for Video setup guidelines to submit your implementation for review.