Overview
NPAW provides analytics capabilities for video streaming applications, including playback analytics and custom in-app event reporting. Within the ION ecosystem, the integration spans player-level instrumentation and application-level analytics for actions such as login, search, playback lifecycle, error reporting, and third-party app launch flows.
The current implementation supports both player analytics and custom event reporting across handheld, 10-foot, web, and TVKey device categories. Integration patterns vary between native and web-based environments, but the overall objective is consistent: provide reliable analytics coverage for playback quality, user interaction, and operational monitoring.
Platforms and device coverage
|
Category |
Device Type |
Examples |
Operating System |
Included |
|---|---|---|---|---|
|
Handheld |
Mobile / Tablet |
Generic Android devices, Apple devices |
Android / iOS |
Yes |
|
10ft |
Streaming device / TV |
Fire TV Stick / Fire TV |
FireOS |
Yes |
|
10ft |
Android TV Launcher |
Operator launcher device class |
Android TV |
Yes |
|
10ft |
Android TV Standalone |
Retail Android TV class |
Android TV |
Yes |
|
10ft |
Smart TV |
Samsung / LG |
Tizen / WebOS |
Yes |
|
Web |
Desktop browser |
Chrome, Safari, Firefox, Opera |
Browser runtime |
Yes |
In-app events
|
Event |
Description |
|---|---|
|
|
User initiates login. |
|
|
Login result is returned. |
|
|
User initiates logout. |
|
|
Logout result is returned. |
|
|
Back-end login error is reported. |
|
|
User performs a search. |
|
|
Search results are received. |
|
|
User selects a search result. |
|
|
Back-end search failure is reported. |
|
|
User initiates playback. |
|
|
Playback URL or playback response is returned. |
|
|
Error presented to the user interface. |
|
|
User attempts to open a third-party app. |
Events not applicable
INAPP_PURCHASE_TRY, INAPP_PURCHASE_RESULT, ERR_PURCHASE_BACKEND, ERR_HEARTBEAT_BACKEND, 3RD_APP_OPEN_RESULT, 3RD_APP_CLOSE_TRY, 3RD_APP_CLOSE_RESULT
Metrics and reporting dimensions
|
Field |
Description |
|---|---|
|
Start |
Timestamp when playback session starts |
|
Join Time |
Time taken from play request until video starts playing (startup time) |
|
Buffer Under Run |
Total buffering duration or count of re-buffering events during playback |
|
Pause |
Playback pause event triggered by user or system |
|
Resume |
Playback resume event after a pause |
|
Seek |
User jumps to a different playback position |
|
Stop |
Playback session ends or user exits playback. |
|
IP |
User's IP address used for geolocation and ISP identification |
|
Title (Channel Name) |
Name of the channel, asset, or content being viewed |
|
Program (Event Name) |
Name of the program, episode, show, or live event |
|
DeviceCode |
Internal device identifier provided by the application or platform |
|
DeviceModel |
Hardware model of the playback device |
|
DeviceBrand |
Manufacturer of the playback device (Samsung, LG, Apple, Amazon, etc.) |
|
DeviceType |
Device category such as TV, Mobile, Tablet, Web, STB, Dongle |
|
DeviceOsName |
Operating system name (Android TV, Android, iOS, tvOS, Tizen, webOS, etc.) |
|
DeviceOsVersion |
Operating system version installed on the device |
|
Username |
User login name or subscriber identifier |
|
Device |
Human-readable device name |
|
Device Vendor |
Manufacturer/vendor of the device |
|
Error Name |
Name or category of playback error encountered |
|
Streaming Protocol |
Protocol used for content delivery (HLS, DASH, Smooth Streaming, etc.) |
|
Streaming Type |
Stream category such aslLive, VOD, catch-up, DVR, etc. |
|
DeviceId |
Unique identifier assigned to the device installation |
|
App Name |
Name of the application generating analytics events |
|
App Version |
Version of the application installed on the device |
|
Media Duration |
Total duration of the video asset |
|
Playback Type / Content Type |
Classification of content such as live, VOD, trailer, recording, catch-up |
|
Resource |
Content identifier, asset ID, manifest URL, or playback source |
|
Player Name |
Name of the video player technology used (Bitmovin, AVPlayer, Shaka, etc.) |