Install

This guide shows how to add Tealium to your Roku app to track user activity. Before you begin, here’s a video introduction to the platform:

Requirements

• Tealium Customer Data Hub account
• Roku SDK 7.2+
• Active Roku developer account
• Roku Device

Developing in Eclipse with the Roku plugin is recommended.

Sample Apps

To help familiarize yourself with our library, the tracking methods, and best practice implementation, it is recommended to download the Roku sample app.

The code for a sample app is available in the main.brs file. The app provides examples of adding button tracking and defining a callback function.

Install

Watch this video for an overview of the installation and setup of the code:

To install the Tealium library for Roku:

1. Download and install Tealium for Roku from GitHub. The code is organized as a sample app. The Tealium code files are located in sample_app/source/tealium.

We recommend cloning the library (instead of downloading) to make it easier to update to future releases.

2. The following files must be imported into your project’s source folder

   • tealium.brs
   • tealiumCollect.brs
   • tealiumLog.brs

3. If you are using Eclipse, refresh your project to access the Tealium components.

Initialize

Tealium objects initialized with the TealiumBuilder() constructor, as shown in the following example:

builder = TealiumBuilder("ACCOUNT", "PROFILE", LOG_LEVEL)
builder.SetEnvironment("ENVIRONMENT")
builder.SetDatasource("DATASOURCE")
teal = builder.Build()

Be sure to set an appropriate log level when your app is released to production.