Contents

Insights & Analytics

Introduction

Twitch Insights provides game and extension developers with analytics data about how the Twitch community interacts with their products, to leverage Twitch and support data-driven decisions about future development. As a developer, you can use this data to enhance the experience of broadcasters and viewers and optimize how they engage with your games and extensions on Twitch.

Game Developer Analytics

To download this data:

  1. On your Twitch developer dashboard, go to the Games tab.

  2. Under the game for which you want data, click Export CSV Data.

    If the button does not appear, the game does not meet the minutes-watched threshold for report generation. A report is available only if the game was broadcast for at least 300 minutes (5 hours) over the time period covered by the report.

Data is provided as one CSV file per game. The file contains one row of data per day, for the past 365 days (Overview V2) or 90 days (Overview V1). The file contains all data fields in the latest version of game analytics.

Also see the Get Game Analytics endpoint in the New Twitch API. The endpoint returns a URL that you can use to download the CSV files. The endpoint can be used to return any report type of game analytics data. (Currently, two report types are supported: overview_v1 and overview_v2. Additional report types will be supported in the future.)

Terminology

Term Definition
Live Live broadcast or premiere.
Not-Live Rerun or VOD.
Premiere Live, first-viewing event that combines uploaded videos with live chat.
Rerun Subsequent (not live) streaming of any past broadcast, including past premieres.
VOD Video on Demand. VODs are asynchronous pieces of content that viewers can watch whenever they like. A VOD may be a past broadcast, a highlight of a past broadcast, an uploaded video, or a clip (short, non-live streams created by viewers).

Clips are not included in the developer analytics data described in this document. Clips data is available via the clips-discovery API.
Vodcast An old term, which at Twitch comprises what are now known as premieres and reruns.

Data Fields

Column Name V1 V2 Description
Date UTC timestamp for the data in each row.
Game Name of the game.
Game ID   ID of the game.
Total Views   Sum of Live Views + Not-Live Views.
Live Views Number of times any stream of this game was viewed on Twitch, live. This includes live streams and Premieres. If someone watches a game 5 separate times in a day, that counts as 5 views here.
Not-Live Views Number of times any stream of this game was viewed on Twitch, not live. This includes Reruns and VODs.
Total Unique Viewers   Number of unique viewers who watched this game on Twitch live or not-live. Specifically this measures unique device IDs. For example, if someone watches a game on 2 devices, that counts here as 2 unique viewers. (Note that for non-mobile devices, since device IDs refresh every 30 days or so, a single device is likely to have multiple device IDs over time.)
Live Unique Viewers Number of unique viewers who watched this game live on Twitch. Specifically this measures unique device IDs. For example, if someone watches a game on 2 devices, that counts here as 2 unique viewers. (Note that for non-mobile devices, since device IDs refresh every 30 days or so, a single device is likely to have multiple device IDs over time.)
Not-Live Unique Viewers Number of different viewers who watched this game not-live on Twitch. As above, this measures unique device IDs.
Average Concurrent Viewers   Average number of concurrent CCUs of this game, across Twitch.
Peak Concurrent Viewers   Peak number of concurrent viewers of this game, across Twitch.
Peak Time - Concurrent Viewers   UTC timestamp that corresponds to Peak Concurrent Viewers.
Total Hours Watched   Sum of Live Hours Watched + Not-Live Hours Watched.
Live Hours Watched Number of hours this game was watched live on Twitch.
Not-Live Hours Watched Number of hours this game was watched not-live on Twitch.
Unique Broadcasters Number of unique broadcasters who live-streamed this game on Twitch. Specifically, this measures unique channel IDs.
Hours Broadcast Number of hours of this game that were broadcast on Twitch live.
Average Concurrent Broadcasters   Average number of broadcasters simultaneously streaming this game.
Peak Concurrent Broadcasters   Peak number of broadcasters simultaneously streaming this game.
Peak Time - Concurrent Broadcasters   UTC timestamp that corresponds to Peak Concurrent Broadcasters.
Live Unique Chat Participants   Number of live unique chat participants for this game, across Twitch.
Total Live Chat Messages Sent   Number of chat messages for this game, across Twitch.
Unique Active Channels with Extensions   Number of unique broadcaster channel IDs streaming your game, which had at least one render while an extension was active. This can be interpreted as the number of unique broadcasters that used an extension on their channel and received at least one render while streaming your game. If a broadcaster streams with an extension but the extension does not render for any viewers, that is not captured here.
Unique Active Extensions   Number of unique extensions related to Unique Active Channels with Extensions. Note that while the report is game-specific, some of the extensions may not be specific to the game.
Clips Created   Number of Clips created from this game.

V2 Sample File (Partial)

For brevity, in this sample file we show data for only 10 days.

Date,Game,Game ID,Total Views,Live Views,Not-Live Views,Total Unique Viewers,Live Unique Viewers,Not-Live Unique Viewers,Average Concurrent Viewers,Peak Concurrent Viewers,Peak Time - Concurrent Viewers,Total Hours Watched,Live Hours Watched,Not-Live Hours Watched,Unique Broadcasters,Hours Broadcast,Average Concurrent Broadcasters,Peak Concurrent Broadcasters,Peak Time - Concurrent Broadcasters,Live Unique Chat Participants,Total Live Chat Messages Sent,Unique Active Channels with Extensions,Unique Active Extensions,Clips Created
1/1/18,TestGame,123456,30000,10000,20000,25893,19990,25550,12345,5103,6:41 AM,23234.09,1000.01,2000.04,100,213.18,23,12,12:00 AM,1675,10000,54,20,149
1/2/18,TestGame,123456,30001,10001,20000,24239,19991,25551,14932,6018,12:00 AM,21093.45,1000.02,2012.34,92,199.34,45,21,12:00 AM,2345,10001,79,54,200
1/3/18,TestGame,123456,30002,10002,20000,25552,19992,25552,13467,8012,12:00 AM,23234.09,1000.03,2024.64,40,220.09,10,34,12:00 AM,1321,10010,23,19,145
1/4/18,TestGame,123456,30003,10003,20000,26789,19993,25553,12345,4521,12:00 AM,21093.45,1000.04,2036.94,55,79.08,23,12,12:00 AM,1234,10090,234,167,233
1/5/18,TestGame,123456,30004,10004,20000,28908,19994,25554,14932,5103,12:00 AM,23234.09,1000.05,2049.24,65,213.18,45,21,12:00 AM,990,10000,54,20,50
1/6/18,TestGame,123456,30005,10005,20000,28992,19995,25555,13467,6018,12:00 AM,21093.45,1000.06,2061.54,110,199.34,10,34,12:00 AM,1675,10001,79,54,149
1/7/18,TestGame,123456,30006,10006,20000,24239,19996,25556,12345,8012,12:00 AM,23234.09,1000.07,2073.84,89,220.09,23,12,12:00 AM,2345,10010,23,19,200
1/8/18,TestGame,123456,30007,10007,20000,25552,19997,25557,14932,5103,12:00 AM,21093.45,1000.08,2086.14,77,213.18,45,21,12:00 AM,1321,10090,234,167,145
1/9/18,TestGame,123456,30008,10008,20000,26789,19998,25558,13467,6018,12:00 AM,23234.09,1000.09,2098.44,100,199.34,10,34,12:00 AM,1234,10000,54,40,233
1/10/18,TestGame,123456,30009,10009,20000,28908,19999,25559,12345,8012,12:00 AM,21093.45,1000.1,2110.74,130,220.09,21,12,12:00 AM,990,10001,79,56,50
...

V1 Sample File (Partial)

For brevity, in this sample file we show data for only 10 days.

Date,Game,Live Views,Not-Live Views,Live Unique Viewers,Not-Live Unique Viewers,Live Hours Watched,Not-Live Hours Watched,Unique Broadcasters,Hours Broadcast
12/17/17,TestGame,175230,11372,20729,27639,7332.9,177.88,3907,4483.47
12/18/17,TestGame,170217,10652,19561,26082,8059.86,178.55,3594,4064.85
12/19/17,TestGame,199464,10972,20480,27306,8699.1,175.64,3730,4157.24
12/20/17,TestGame,258799,10072,18330,24440,9510.77,169.99,3699,4190.89
12/21/17,TestGame,142495,9260,16703,22271,7795.94,153.38,3781,3907.54
12/22/17,TestGame,452406,17808,16190,21587,14206.11,301.91,3663,7929.28
12/23/17,TestGame,103300,8852,16236,21647,6296.13,143.44,3581,3541.66
12/24/17,TestGame,316201,18544,27629,36838,7939.11,146.87,3098,3231.01
12/25/17,TestGame,142155,31780,58273,77697,7029.13,192.66,2923,2941.71
12/26/17,TestGame,160491,11948,25041,33388,8257.73,150.8,3401,3340.47
...

Extension Developer Analytics (Beta)

To download this data:

  1. On your Twitch developer dashboard, go to the Extensions tab.
  2. On the line for the extension for which you want data, click Export CSV Data.

Data is provided as one CSV file per extension. The file contains one row of data per day, for the past 90 days.

Data Fields

Note that all counts are for the corresponding day in the CSV file.

Column NameDescription
DateUTC timestamp for the data in each row.
Extension  NameName of the extension.
Extension Client IDAlphanumeric identifier for the extension.
InstallsNumber of install events of the extension.
UninstallsNumber of uninstall events of the extension.
ActivationsNumber of activation events of the extension.
Unique Active ChannelsNumber of unique broadcaster channel IDs that had at least one render while the extension is active. This can be interpreted as the number of unique broadcasters that used your extension on their channel and received at least one render. If a broadcaster streams with your extension but the extension does not render for any viewers, that would not be captured here.
RendersNumber of viewer page loads, for channels with an extension. A page refresh counts as a render.
Unique RenderersNumber of unique viewers with a “renders” event. Specifically, this measures unique device IDs. For example, if someone renders an extension on 2 devices, that counts here as 2 unique renderers. (Note that since device IDs refresh every 30 days or so, a single device is likely to have multiple device IDs over time.)
ViewsNumber of times that more than 75% of the extension iframe was visible in any viewer’s browser. For panel extensions, this may be less than the number of renders, if the extension is rendered but the viewer does not scroll down to view it.
Unique ViewersNumber of different viewers who watched this extension on Twitch, based on the Views definition above. Specifically, this measures unique device IDs. For example, if someone watches an extension on 2 devices, that counts here as 2 unique viewers. (Note that since device IDs refresh every 30 days or so, a single device is likely to have multiple device IDs over time.)
Unique InteractorsNumber of unique viewers who clicked on the extension.
ClicksTotal number of viewer click events in the extension iframe.
Clicks Per InteractorAverage number of click events per interactor (i.e., per viewer who clicked in the extension). Defined as: Clicks / Unique Interactors.
Interaction Rate

Indicates the ratio of interactors (viewers who click on the extension) to viewers. Defined as: Unique Interactors / Unique Viewers.

Sample File (Partial)

For brevity, in this sample file we show data for only 10 days.

Date,Extension Name,Extension Client ID,Installs,Uninstalls,Activations,Unique Active Channels,Renders,Unique Renderers,Views,Unique Viewers,Unique Interactors,Clicks,Clicks Per Interactor,Interaction Rate
2/6/18,test extension,hs5z3fh5dxhshfhazhk4hq38g9hz51,197,65,80,157,97994,3118,19464,973,642,832,1.295950156,0.659815005
2/7/18,test extension,hs5z3fh5dxhshfhazhk4hq38g9hz52,213,45,79,137,101771,3301,18987,949,534,720,1.348314607,0.562697576
2/8/18,test extension,hs5z3fh5dxhshfhazhk4hq38g9hz53,132,36,66,56,130697,3464,23212,1161,645,788,1.221705426,0.555555556
2/9/18,test extension,hs5z3fh5dxhshfhazhk4hq38g9hz54,206,36,67,166,103595,3164,20181,1009,598,796,1.331103679,0.592666006
2/10/18,test extension,hs5z3fh5dxhshfhazhk4hq38g9hz55,188,25,71,112,90614,3217,19696,985,676,864,1.278106509,0.686294416
2/11/18,test extension,hs5z3fh5dxhshfhazhk4hq38g9hz56,219,78,72,143,83773,3468,18521,926,676,848,1.25443787,0.730021598
2/12/18,test extension,hs5z3fh5dxhshfhazhk4hq38g9hz57,254,54,80,178,88220,3298,18810,941,653,836,1.280245023,0.693942614
2/13/18,test extension,hs5z3fh5dxhshfhazhk4hq38g9hz58,156,22,79,80,72350,3457,15465,773,468,720,1.538461538,0.605433376
2/14/18,test extension,hs5z3fh5dxhshfhazhk4hq38g9hz59,189,23,66,149,85855,3535,18804,940,552,780,1.413043478,0.587234043
2/15/18,test extension,hs5z3fh5dxhshfhazhk4hq38g9hz59,179,13,56,139,85845,3525,18794,930,542,740,1.365313653,0.582795699
...