JW Player 8.0+ Player Plugin

Owned by Bellamy Smith (Unlicensed)
Last updated: May 28, 2019 by Zachary Stockton
4 min read

This IRIS.TV Adaptive plugin documentation is specific for the JWPlayer 8.0+ video players. This install requires placing plugins within the page HTML and sending in the specific information for the client and video.

1. Add the IRIS.TV plugin to your plugin section. Then add an event listener to initialize the plugin on the jw "play" event. Example:

	var player1 = jwplayer('YOUR PLAYER ID').setup({
        primary: 'html5',
        autostart: 'true',
        width: 620,
        height: 400,
        file: '/videos/IYi8sWkK-GftQFOjv.mp4',
        preload: 'none',
        plugins: {
          "https://ovp.iris.tv/plugins/jwplayer/v2/iris-jwplayer8.adaptive.min.js": {
            settings: {
              player_id: 'YOUR PLAYER ID',
              client_token: 'YOUR CLIENT TOKEN',
              platform_id: 'YOUR INITIAL VIDEO ID',
              player_version: 'jwplayer8',
              ssl: true,
              start_up_next: true,
              end_up_next: true,
              disable_mobile_upnext: false,
            },
            global: "iris",
            jwCMS: true,
            iris_buttons: {}
          }
        }
    });

    player1.once("ready", function(){
      loadIrisPlugin(player1, player1.getConfig().plugins["https://ovp.iris.tv/plugins/jwplayer/v2/iris-jwplayer8.adaptive.min.js"])
    })


If the player page will be loaded via HTTPS then an additional parameter will be required, "ssl": true.

settings: {
				'client_token':<CLIENT_TOKEN>, 
            	'platform_id':<PLATFORM_ID>,
				'player_id':<PLAYER_ID>,
				'ssl': true
				},


Any additional IRIS.TV Adaptive plugin settings should be added to the “settings” object. More information about those can be found here: https://iristv.atlassian.net/wiki/x/gxpTAw. 

The following are required:

<client_token> is a value provided by IRIS.TV after the publisher’s content has been imported. This token is used to authenticate the asset library.

<jwCMS> boolean value to indicate whether you are using the JW CMS to store video files.

<platform_id> is the GUID of the initial asset. The GUID is taken from the publisher’s content feed and is the initial video's unique ID.

<player_id> HTML element ID of the player div used to instantiate the JWplayer. it is the ID for the player.

Once the above is complete you are ready to test your player.


Configuration

For more information about customizable settings and features, please see: Adaptive Plugin Customizations

Setting Up Contextual Ad Targeting 

Contextual Ad Targeting sends contextual segments for a specific video into the pre-roll ad call, which can then be used for direct and programmatic advertising targeting. Contextual data needs to be added by IRIS.TV's Asset IQ system. Please contact your Programming Strategist if you are interested in activating Contextual Ad Targeting for your current JW Player / IRIS.TV integration.

Contextual Ad Targeting requires the use of the IMA3 ad plugin.  

If the player is set-up with autoplay, the first video will not receive context in a pre-roll ad call.

Contextual Ad Targeting can be configured to send context segments in either the "cust_params" or the "categories" parameter on the ad tag. The below documentation will walk through the requirements for both workflows.

To Send Contextual segments through "cust_params":

  • Add “cust_params” macro to their DFP ad tag

  • In Player Builder, Advertising settings for the player should have Ad Preloading disabled:

  • Add the following in the HTML config for your JW Player implementation:
"enable_context_ads" : true,
"carousel_recs" : true
  • The publisher must then set up targets to the different “context” values provided by IRIS.TV

To Send Contextual segments through "categories":

  • Add “categories” macro to their DFP ad tag

  • In Player Builder, Advertising settings for the player should have Ad Preloading disabled:

  • Add the following in the HTML config for your JW Player implementation:
"enable_category_ads" : true,
"carousel_recs" : true
  • The publisher must then set up targets to the different “categories” values provided by IRIS.TV

IRIS.TV