Skip to main content
Version: 7.6.0


This guide explains how to set up THEOplayer in combination with FreeWheel, an advertisement vendor.


Web SDKAndroid SDKiOS SDKtvOS SDKAndroid TV SDKChromecast SDK


There are prerequisites when using FreeWheel through THEOplayer.

  1. You must enable the freewheel module when building your THEOplayer SDK through the THEOplayer Development Portal.
  2. This guide expects that you are a FreeWheel client and that you have ad campaigns ready for use. Information on FreeWheel can be found at
  3. You must have access to the FreeWheel SDK, as explained further in this guide.

How to integrate FreeWheel

Code Examples

This example explains how you do a basic implementation of FreeWheel in THEOplayer.


The FreeWheel integration is currently only available on the Web SDK.

After setting up your basic page containing THEOplayer, you need to add the FreeWheel MRM client SDK to the page:

<script type='text/javascript' src=''></script>

Next, you add a FreeWheelAdDescription to your source that specifies the FreeWheel tokens. An example sourceDescription could look like this:

<!-- make sure to link to a valid version number -->
... player.source = { sources : [{ src : 'your.m3u8', type :
'application/x-mpegurl' }], ads: [{ integration: 'freewheel', networkId: 96749,
assetId: 'DemoVideoGroup.01', profile: 'global-js', assetDuration: 22,
adServerUrl: '', siteSectionId:
'DemoSiteGroup.01', cuePoints: [{ adUnit: 'preroll' }] }] };

We configure cuePoints in this example. This is needed for some set-ups or completely optional for others. THEOplayer will create a FreeWheel temporalSlot behind the screens, which is a request to schedule an advertisement at said point. It is up to FreeWheel (and the campaign settings) to decide whether it will insert an advertisement at this requested time. Not all campaigns need it and for some campaigns the requested cuePoints might even be ignored by FreeWheel.

Android SDK

This API is currently not available on the Android (TV) SDK.

iOS/tvOS SDK and Legacy iOS/tvOS SDK (4.12.x)

This API is currently not available on the iOS (/tvOS) SDK.


The following resources provide more information:

  1. THEOplayer Getting Started Guide

  2. FreeWheelAdDescription

  3. FreeWheel website