The application uses the Bitmovin video analytics platform to track video usage from Ant Media Server to Bitmovin. Start by creating an analytics account at bitmovin.com.

Prerequisites

You need to have an active Ant Media Server(AMS) license. You can either subscribe to Ant Media Server on different cloud providers’ marketplaces or purchase a license from the Ant Media website if you plan to install Ant Media Server manually.

Login to your Bitmovin account, navigate to the Analytics menu tab and click on the Licenses page. Then  copy the API key for your license.

Deployment

There is a working example of the Bitmovin implementation. Navigate to Github and access the StreamApp repository under the bimovinAnaliticsSample branch.  Then navigate to the  webapp folder to access all the example files.

These are the sample pages:

• Publish:
  https://github.com/ant-media/StreamApp/blob/bimovinAnaliticsSample/src/main/webapp/samples/publish_webrtc.html 
• Play:
  https://github.com/ant-media/StreamApp/blob/bimovinAnaliticsSample/src/main/webapp/play.html

To enable Bitmovin tracking on your current Ant Media Server application, you’ll need to include some additional Javascript files.

On both the publish page and playback page, include the Bitmovin JavaScript file within the head section of the page:

Now import analytics.js file which you can find in the webapps folder along with the WebRTC Adaptor:

import {Analytics} from "../js/analytics.js

Be sure to pick up the necessary URL parameters for customerID and bitmovinKey then initialize the Analytics object:

var analytics =new Analytics(bitmovinKey);

Now Bitmovin is setup to start tracking your video usage.  For instance, send usage data back to Bitmovin when publishing has started by simply calling the analyze() method inside the startPublishing() function.

analytics.analyze(Analytics.publisher,streamId,applicationName,customerId,Analytics.webrtc,"localVideo");

Usage

To send analytics data from Ant Media Server to Bitmovin using this plugin, you’ll need the API key that was copied earlier and pass it into the query string using the parametre bitmovinKey.

Below are examples of how to pass the API key in the query string for both playing and publish pages.

Simply add the bitmovinKey parameter to the query string and append your Bitmovin API key.

Publishing

http://localhost:5080/WebRTCAppEE?id=stream1&bitmovinKey=Your_API_KEY

playing 

http://localhost:5080/WebRTCAppEE/play.html?id=stream1&bitmovinKey=Your_API_KEY

As soon as you start publishing or playing a  live stream, video analytics data will start to be sent from Ant Media Server to your Bitmovin account where you can view all the analytics data in the dashboard.

Track Individual Users

If you’ve integrated the publish and play pages into your application, then you will be able to track individual customers/users of your application.

Simply add an additional parameter of customerId in the query string and pass the customer id.

An example is below:

http://localhost:5080/WebRTCAppEE/play.html?id=stream1&bitmovinKey=Your_API_KEY&customerId=PASS_UNIQUE_ID

Now, you can track the individual customer and view their usage from within the Bitmovin Dashboard.

Support

Our engineers will be available for you. Please contact us if you need technical help. Also, we have some support package offerings here.