Google Analytics for Roku Channels

Google Analytics can be used to track page views, content playback, and button clicks for any channel developed with Instant TV Channel. Page views and events that occur on Roku players with your channel installed will generate report data within your Google Analytics account.

Prerequisites:

  1. An Instant TV Channel account with Developer Mode set to "Advanced".
  2. A Google Analytics account with a Property set up in "Web" mode, not "App" mode.

To set up Instant TV Channel to use Google Analytics follow these easy steps:

  1. Log into your Instant TV Channel account.
  2. If your Developer Mode is not already set to "Advanced", select Account from the navigation links along the left side of the page, change Developer Mode to "Advanced", then click Save.
  3. Select Channels from the navigation links along the left side of the page.
  4. Select the channel that you want to track.
  5. Enter the Theme Editor by selecting Theme from the navigation links along the left side of the page.
  6. Scroll down towards the bottom of the parameter list until you see GATrackerEnabled, GATrackerAccount, and GATrackerHostName.
  7. Change GATrackerEnabled to yes.
  8. Enter your Google Analytics Tracking ID into GATrackerAccount. If you are tracking several channels, you will probably want to use a separate Tracking ID for each channel.
  9. Enter a name into GATrackerHostName. This name appears on the Google Analytics reports as the "Hostname".
  10. Google Analytics tracking is now enabled for all installed copies of the channel. It is not necessary to re-package or re-upload to the Roku channel store.

The following tables illustrate how Google Analytics reports are populated based on Page Views and Events occuring in your Roku channel. In order to improve reporting accuracy, items marked with a "*" are no longer available as of Update 276.

Pages Viewed (Roku Player Screens) Page Title Page URL Event Label (Screen Type)
Main screen of Classic channel type Top Screen Top Screen Horizontal List
Main screen of Vertical channel type Top Screen Top Screen Vertical List
Main screen of Grid channel type Top Screen Top Screen Grid
Episode List of Series channel type Top Screen Top Screen Series
Grid SDL1 SDL1 Grid
Horizontal List SDL1 SDL1 Horizontal List
Vertical List SDL1 SDL1 Vertical List
MRSS Feed SDL1 SDL1 MRSS Feed
Series Episode List SDL1 SDL1 Series
Springboard Title Content URL Springboard
Registration Title or SDL1 Content URL or SDL1 Registration
Password Title or SDL1 Content URL or SDL1 Password
Video Title Content URL Video
AutoPlay Title Content URL AutoPlay
Picture SDL1 SDL1 Picture
Text SDL1 SDL1 Text
Italics = Literal Text Constant, SDL1 = Content ShortDescriptionLine1

Events Page Title Page URL Event Label Event Category Event Action User Defined Value Event Value
Channel Start Channel Start Version Roku Model . Display Type Channel Model.Display Serial  
* Channel Enter Channel Enter Channel Enter Version Channel Enter Serial  
* Roku Player Display Channel Display Channel Display Display Type Channel Display Type Serial  
* Roku Player Model Channel Model Channel Model Model Name Channel Model Name Serial  
* Roku Player Firmware Channel Firmware Channel Firmware Firmware Version Channel Firmware Version Serial  
Channel Exit Channel Exit Channel Exit Version Channel Exit Serial
Video Playback Start/Restart Title Content URL ContentId Button Video Start Serial Position
Video Playback Resume Title Content URL ContentId Button Video Resume Serial Position
Video Playback Pause Title Content URL ContentId Button Video Pause Serial Position
Video Playback Stop/Incomplete Title Content URL ContentId Button Video Stop Serial Position
Video Playback Stop (Live) Title Content URL ContentId Status Video Stop Serial 0
Video Playback Complete Title Content URL ContentId Status Video Complete Serial Position
Video Play All Title Content URL ContentId Button Video Play All Serial  
Video Heartbeat (if enabled) Title Content URL ContentId Button Video Heartbeat Serial Position
Audio Playback Start Title Content URL ContentId Button Audio Start Serial  
Audio Playback Restart Title Content URL ContentId Button Audio Restart Serial  
Audio Playback Resume Title Content URL ContentId Button Audio Resume Serial  
Audio Playback Complete Title Content URL ContentId Status Audio Complete Serial  
Audio Playback Pause Title Content URL ContentId Button Audio Pause Serial  
Audio Play All Title Content URL ContentId Button Audio Play All Serial  
AutoPlay Start SDL1 SDL1 AutoPlay Start Status AutoPlay Start Serial  
AutoPlay Resume (Pause/Play key) Title Content URL ContentId Button AutoPlay Resume Serial Position
AutoPlay Replay (Replay key - replay current pgm) Title Content URL ContentId Button AutoPlay Replay Serial Position
AutoPlay Restart (Back key - restart 1st pgm) Title Content URL ContentId Button AutoPlay Restart Serial  
AutoPlay Pause (Pause/Play key) Title Content URL ContentId Button AutoPlay Pause Serial Position
AutoPlay Complete (occurs for each item played) Title Content URL ContentId Status AutoPlay Complete Serial Position
AutoPlay Stop (Up key) Title Content URL ContentId Button AutoPlay Stop Serial  
AutoPlay Skip Ahead (FF key) Title Content URL ContentId Button AutoPlay Skip Ahead Serial  
AutoPlay Skip Back (Rew key) Title Content URL ContentId Button AutoPlay Skip Back Serial  
Ad Click (Banner) Title Ad URL Ad Click Button Ad Click Serial  
Ad Complete (Video) Title Ad URL ContentId Status Ad Complete Serial Position
Ad Partial (Video) Title Ad URL ContentId Status Ad Partial Serial Position
Ad No-Fill (LiveRail) Title Publisher ID ContentId Status No LiveRail ads available for this ad request Serial  
Ad No-Fill (VAST) Title Ad URL ContentId Status No VAST ads available for this ad request Serial  
Ad No-Fill (Vidillion) Title Ad URL ContentId Status No Vidillion ads available for this ad request Serial  
Ad Request (LiveRail) Title Publisher ID ContentId Status LiveRail ad request Serial  
Ad Request (VAST) Title Ad URL ContentId Status VAST ad request Serial  
Ad Request (Vidillion) Title Ad URL ContentId Status Vidillion ad request Serial  
Password Check (if enabled) Title or SDL1 Content URL or SDL1 Pass or Fail Status Password Check Serial  
Registration Check (if enabled) Title or SDL1 Content URL or SDL1 Pass or Fail Reason Status Registration Check Serial  
Registration Command Title or SDL1 Content URL or SDL1 Command Description Status Registration Check Serial  
Schedule Start SDL1 SDL1 Schedule Start Status Schedule Start Serial  
Schedule Stop (Up/Back key) SDL1 SDL1 Schedule Stop Button Schedule Stop Serial  
Search Search Search Search Query Button Search Query Serial  
Various Error Events Title or SDL1 Content URL if applicable ContentId or Error Message Error Error Message Serial  
Italics = Literal Text Constant, SDL1 = Content ShortDescriptionLine1, Serial = Player Serial Number

Please see this short guide for more information about how to build a Roku channel using Instant TV Channel.

Your comments, suggestions or criticisms about this Roku developer information can be emailed to .

Instant TV Channel is a cloud-based tool for Roku developers and content providers that shortens development time and eases maintenance after deployment.



Private Channel Code: ITVC
Check out Instant TV Channel by adding our demonstration channel to your Roku player, or watch the YouTube video.

Need help with your Roku?

We are unable to provide technical support for your Roku device or for channels not created using Instant TV Channel.

Please visit www.roku.com for assistance.



Instant TV Channel is not affiliated with nor endorsed by Roku Inc.