You may want to associate your in-page HTML and Flash ad slots with video or overlay ad slots. This relationship between associated ad slots is referred to as the master/companion relationship. In addition to being used for requesting video and overlay master ads, the IMA SDK can be used to display companion HTML and Flash-in-Flash ads. These ads are displayed within an HTML environment, alongside other Flash content, or within a Flash website.
To use companion ads, you must perform the following steps:
1. Book your Companion Ads
You must first book the companion ads that you want to display with your master ads. Companion ads can be trafficked in DFP. You can serve up to six companion ads per master ad. This technique, when a single buyer controls all ads on the page, is also known as "roadblocking".
2. Request your Companion Ads
By default, companion ads are enabled for each ad request. The Flash SDK
allows you to disable companion ads by setting
true. This option
is not available in the HTML5 SDK.
3. Displaying Companion Ads
There are two ways to render companion ads:
Automatically using the Google Publisher Tag (GPT)
- Companion slot awareness
- Companion backfill from the publisher's network, if the VAST response contains fewer companion ads than there are defined slots on the HTML page
- Companion autofill if a video ad is missing
- Preloaded companion ad slots for click-to-play video players
- Automated companion rendering, including
- Manually using the Ad API.