Application Analytics for Conviva Roku SceneGraph Sensor

Use Application Analytics to autocollect events and track application specific events and state changes.

Updated 2026-05-29 roku, application, analytics, sensor developer center, sensor integration, application analytics

Use Application Analytics to autocollect events and track application specific events and state changes.

Download

Video Sensor

Description Version File Updated
Conviva_Roku_3.3.1 v3.3.1 Download Conviva_Roku_3.3.1.zip 21/MAR/2022

Application Sensor

Description Version File Updated
Conviva_Roku_AT_0.1.0 v0.1.0 Download Conviva_Roku_AT_0.1.0.zip 21/MAR/2022

To install the application sensor:

  1. Copy the Contents of source into your source directory.

  2. Contents of components into your components directory.

Initialization

Install the Conviva Roku SceneGraph application sensor

m.global.AddField("appTracker", "node", false) 
m.global.appTracker = CreateObject("roSGNode", "CAT")
m.global.appTracker.init = {
		subject: {
			appId: "<APP_ID AS ADVISED BY CONVIVA>",
			convivaCustomerKey: "<CUSTOMER KEY AS ADVISED BY CONVIVA>",
		},
		namespace: "convivaAppTrackerNameSpace", ' Use a unique string to identify the namespace for tracker
		network: {
			collector: "https://appgw.conviva.com",
		}
}

Track the screen views

'Use name space to report the tracking events'
m.global.appTracker.convivaAppTrackerNameSpace.screenView = {
	id: "vgallery1", 'Optional' ' A unique ID to identify the screen'
    name: "Video Gallery Screen" ' Name. / Description of the screen'
}

Extend tracking to track your application specific events and state changes

Use Structured event type to track all kinds of events. This event type provides 5 fields to describe the tracked events. The semantics of the values for these 5 fields are flexible and could be customized.

  • 'category' (se_ca) - Define a broad classification of categories for various types of events, such as button, user actions, state, etc.

  • 'action' (se_ac) - Define the type of action. For example, click, scroll, submit, add to cart, etc.

  • 'label' (se_la) - Label the item under the action or subject of the action.

  • 'property' (se_pr) - Define the properties associated with the event.

  • 'value' (se_va) - Define the value (float number). For example, scroll position, total number of items added to a cart, etc.

The following example shows the implementation of the 'onClick' event listener to any element on the web page. The category is button, label is the rendered text of the clicked button, and property is a list of classes.

m.global.appTracker.structured = {
    se_ca: "shop",
    se_ac: "add-to-basket",
    se_pr: "pcs",
    se_la: "vip",
    se_va: 2
}