storyteq-connector-jw-player v1.0.21

storyteq-connector-jw-player

A JWPlayer connector for the StoryTEQ API to simplify the loading of video data and tracking video analytics. The connector uses the unique hash generated by StoryTEQ API when creating a video as a reference to load video data and generate analytics.

The analytics are visible in the StoryTEQ dashboard which is currently in beta. Please contact us if you haven't received a login yet.

Dependencies

Loading the connector into your page is fairly easy, you can include the script directly from our CDN. Make sure to include the script in the head of your page like this:

<script  type="text/javascript"  src="https://storage.googleapis.com/storyteq/platform/connector/storyteq-connector-jw-player.min.js"></script>

Otherwise you can install the connector as an npm package using the following command:

npm install storyteq-connector-jw-player

Or manually import the connector by downloading this repository.

<script  type="text/javascript"  src="storyteq-connector-jw-player.js"></script>

Altough JW player is included in the connector, it's possible to use your own JW player license (version 8). In that case please include the StoryTEQ connector after loading your own JW player.

<script type="text/javascript" src="https://content.jwplatform.com/libraries/aBC1DEf2.js"></script>
<script type="text/javascript" src="https://storage.googleapis.com/storyteq/platform/connector/storyteq-connector-jw-player.min.js"></script>

Usage

After loading the script into your page, the connector needs to be configured. This is done by defining values for a few parameters in the following fashion:

var connector = new StoryteqConnectorJwPlayer({
	videoPlayerId : 'jwplayer',
	videoParameterName : 'key'
});

Not all parameters are required. Please check out the table below and example.html in this repository for an example of a fully specced connector.

Testing

If everything is set up correctly, you can test the connector. To create a valid URL, attach the videoParameterName as a GET parameter to your base URL, then add the video's unique hash as a value. For example:

https://domain.com?key=9e0627ae3c707b451c9ac8e1408563a1

When you visit your page, the generated video should automatically be loaded.

Support

If you run into trouble using the connector, please contact us.