NPAW Analytics#

The NPAW Analytics module integrates NPAW (Nice People At Work) analytics with KWIKplayer to provide detailed playback insights and monitoring.

Initialization#

To enable the NPAW Analytics plugin, provide the following options during player initialization:

window.initPlayer('my-video', {
  npawAnalyticsPlugin: {
    debug: true,
    'content.channel': 'Sports Channel',
    'content.contractedResolution': '1080p',
    'content.cost': '9.99',
    'content.customDimension.1': '1',
    'content.customDimension.2': 'CDN Title',
    'content.episodeTitle': 'Episode 1',
    'content.genre': 'Drama, Thriller',
    'content.id': '12345',
    'content.price': '1.99',
    'content.season': '2',
    'content.title': 'Great Series - Episode 1',
    'content.tvShow': 'Great Series',
    'content.type': 'episode',
    'user.name': 'user123',
  }
})

Options#

Mandatory Options#

The following options should be provided to ensure the plugin works correctly:

Option	Type	Description
`content.channel`	`string`	Title of the content's channel.
`content.title`	`string`	Compound title (e.g., "Asset Title - Video Title").
`content.id`	`string`	Unique ID of the content (equivalent to mediaId).
`user.name`	`string`	User ID or 0 for guests.

Optional Options#

You can enhance the analytics tracking by including the following metadata:

Option	Type	Description
`debug`	`boolean`	Enables debug mode on window.NpawPlugin.
`content.contractedResolution`	`string`	Video resolution based on user subscription.
`content.cost`	`string`	Cost associated with SVOD packages.
`content.customDimension.1`	`'0' \| '1'`	Indicates monetization presence (AVOD, SVOD, TVOD, FVOD).
`content.customDimension.2`	`string`	CDN title for the content.
`content.episodeTitle`	`string`	Title of the episode or video.
`content.genre`	`string`	Video genres as a comma-separated list.
`content.price`	`string`	Price associated with TVOD packages.
`content.season`	`string`	Season ID of the content.
`content.tvShow`	`string`	Title of the asset or TV show.
`content.type`	`'promo'\| 'trailer'\| 'episode'`	Type of video.
`content.isLive`	`boolean`	Live content state.

DRM Support#

The plugin detects and adapts to DRM configurations automatically. If DRM is enabled, the content.drm option is set to 'drm'; otherwise, it defaults to 'no drm'.

Ads Tracking#

The NPAW Analytics module integrates with ads through the following:

IMA Adapter: Tracks Google IMA ad events.
DAI Adapter: Tracks Dynamic Ad Insertion (DAI) events.