Contents

Insights & Analytics

Introduction

Twitch Insights provides game and extension developers with analytics data to help developers make 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

Once a data field is added to a report, it will not be deleted in future versions of the report. New data fields may be added in new versions of the report, anywhere in the sequence of fields (i.e., not necessarily at the end of the CSV).

Counting Device IDs

As explained below, some “unique” data fields (e.g., Unique Viewers) are collected based on device IDs. At a given moment, each device ID to a single hardware device (e.g., laptop, phone, or tablet). For example, if someone loads an extension or watches a game on 2 devices, that involves 2 device IDs and counts as 2 Unique Viewers.

Web browsers store device IDs using cookies. The half-life of a cookie seems to be about 14 days (even if you ask the browser to store the cookie forever). So, on a given day, we can assume that a browser always provides the same device ID for a given device. But over a month, most browsers provide at least 2 device IDs for the same device, one ID initially and another after clearing and refreshing the cookie.

This applies primarily to the web platform. Mobile apps and console platforms have different storage regimes, and device IDs are much more durable in those environments.

How does this affect Insights data collection? On a given day, this has very little impact, as we can expect 1 device to have only 1 device ID. Over time, though, 1 device will have multiple device IDs. As a result, there is a significant impact on Insights data fields that count device IDs over long periods of time (30 days or more). For these fields, the number of “uniques” is likely to be much higher than the number you get by extrapolating from shorter time periods. The major impact is on the “Last 30 Days” data fields, especially if your game or extension is used primarily from web browsers. For example, for Extensions that run only in browsers, the number of Unique Viewers Last 30 Days will be much higher than the number of Unique Viewers times 30.

Extension Developer Analytics (Beta)

To download this data:

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

Data is provided as one CSV file per released extension. The file contains one row of data per day, from January 31, 2018 until the current day (Overview V2) or for the past 90 days (Overview V1). Note that for V2, fields related to minimization are provided only as of June 22, 2018 (as noted in the table below). The file contains all data fields in the latest version of extension analytics.

Data starts being collected after the extension is installed and viewed, subject to a one-day delay. For example, we start calculating the data for January 12th on January 14th at UTC 1:00. Typically the calculations complete within 1 hour. The report is uploaded as soon as the calculations are done.

Also see the Get Extension 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 extension analytics data. (Two report types are supported: overview_v1 and overview_v2. Additional report types will be supported in the future.)

Data Fields (Overview Reports)

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

If there is no data for a day, either that day is missing from the report or it is in the report with all data fields having a value of 0 (i.e., no activity).

Except where noted, all metrics count events from desktop browsers, mobile browsers, and the Twitch app.

Column NameV1V2Description
DateUTC date for the data in each row. For example, data in the row for 2018-08-01 (August 1, 2018) covers the period from 2018-08-01T00:00:00Z to 2018-08-01T23:59:59Z.
Extension  NameName of the extension. Since the name can change and may take a few days to update internally, the Extension Client ID (which does not change) is preferable as an identifier.
Extension Client IDAlphanumeric identifier for the extension.
Extension Details Page Visits Number of visitor page loads of the extension’s Details page (https://www.twitch.tv/ext/<extension_id-version>. Reloading the page counts as multiple visits.
Unique Extension Details Page Visits Number of unique visitor page loads of the extension’s Details page. Specifically this measures unique device IDs (see Counting Device IDs).
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 viewer. If a broadcaster streams with your extension but the extension has no viewers, that is not captured here.

Unique Active Channels Last 7 Days

 Number of Unique Active Channels in the past 7 days. For example, if this metric is provided on July 31, it would cover July 25-31.
Unique Active Channels Last 30 Days Number of Unique Active Channels in the past 30 days. For example, if this metric is provided on July 31, it would cover July 2-31.
Unique Identity Links Number of unique user IDs that granted the extension access to their Twitch user IDs. Users can grant and revoke access multiple times. On any given day, only the first grant is counted.
Unique Identity Unlinks Number of unique users who revoked access to their Twitch user IDs. Users can grant and revoke access multiple times; on any given day, only the first revoke is counted. 
RendersNumber of user page loads, watching channels with the extension. A page refresh counts as a render.
Unique RenderersNumber of unique users with a “renders” event. Specifically, this measures unique device IDs (see Counting Device IDs).
Unique Renderers Last 7 Days Number of Unique Renderers in the past 7 days. For example, if this metric is provided on July 31, it would cover July 25-31.
Unique Renderers Last 30 Days Number of Unique Renderers in the past 30 days. For example, if this metric is provided on July 31, it would cover July 2-31.Note this may be unexpectedly high; see Counting Device IDs.
ViewsNumber of times that 75% or more 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. Scrolling up and down multiple times does not count as multiple views.
Unique Viewers

Number of different viewers who watched this extension on Twitch, based on the Views definition above. Specifically, this measures unique device IDs (see Counting Device IDs).

In the V2 report, if your extension is shown by a given device ID in multiple ways (panel, video overlay, video component), that counts as 2 Unique Viewers (1 for the panel and 1 for the video overlay and/or component). In the V1 report, this scenario counts as 1 Unique Viewer.

Unique Viewers Last 7 Days Number of Unique Viewers in the past 7 days. For example, if this metric is provided on July 31, it would cover July 25-31.
Unique Viewers Last 30 Days Number of Unique Viewers in the past 30 days. For example, if this metric is provided on July 31, it would cover July 2-31. Note this may be unexpectedly high; see Counting Device IDs.
Mouseenters Number of times a mouse pointer enters (hovers over) the extension. This counts only desktop browser events.
Unique Mouseenters Number of unique Mouseenter events. Specifically, this measures unique device IDs (see Counting Device IDs). This counts only desktop browser events.
Unique Mouseenters Last 7 Days Number of Unique Mouseenters in the past 7 days. For example, if this metric is provided on July 31, it would cover July 25-31.
Unique Mouseenters Last 30 Days Number of Unique Mouseenters in the past 30 days. For example, if this metric is provided on July 31, it would cover July 2-31.
Mouseenters Per Viewer Average number of Mouseenter events per viewer. Defined as Mouseenters / Unique Viewers
Mouseenter Rate Indicates the ratio of Unique Viewers who also have mouseenter events. Defined as Unique Mouseenters / Unique Viewers. 
Clicks*Number of click events in the extension iframe.
Unique Interactors*Number of unique click events in the extension iframe. Specifically, this measures unique device IDs (see Counting Device IDs).
Unique Interactors* Last 7 Days Number of Unique Interactors in the past 7 days. For example, if this metric is provided on July 31, it would cover July 25-31.
Unique Interactors* Last 30 Days Number of Unique Interactors in the past 30 days. For example, if this metric is provided on July 31, it would cover July 2-31. Note this may be unexpectedly high; see Counting Device IDs.
Clicks Per Interactor*Average number of click events per interactor. Defined as: Clicks / Unique Interactors.
Interaction Rate*Indicates the ratio of interactors to viewers. Defined as: Unique Interactors / Unique Viewers.
Minimizations Number of times a viewer minimizes (hides) the extension. This field is provided from 6/22/18 on.
Unique Minimizers Number of times a viewer minimizes (hides) the extension. This field is provided from 6/22/18 on.
Minimization Rate Indicates how often viewers minimize the extension. Defined as Unique Minimizers / Unique Viewers. This field is provided from June 22, 2018 on.
Unminimizations Number of times a viewer unhides the extension after it was minimized. Unminimizations can happen for extensions that were minimized in previous days. This field is provided from June 22, 2018 on.
Unique Unminimizers Number of Unique Viewers that unhide the extension after it was minimized. This field is provided from June 22, 2018 on. 
Unminimization Rate Indicates how often viewers unhide the extension after it was minimized. Defined as Unique Unminimizers / Unique Viewers. This field is provided from June 22, 2018 on.

Bits Revenue USD

 (Bits-enabled Extensions only) Revenue share earned by the developer from Bits transactions (in US dollars): this is Bits * 20% share * $.01/bit conversion rate. For more information about Bits in Extensions, see the Extensions Monetization Guide.
Bits Used (Bits-enabled Extensions only) Number of Bits used.
Bits Transactions (Bits-enabled Extensions only) Number of Bits transactions.
Bits Per Transaction (Bits-enabled Extensions only) Average number of Bits per transaction. Defined as Bits Used / Bits Transactions.
Unique Bits Users (Bits-enabled Extensions only) Number of unique users who used Bits in the extension. This is measured by user IDs, not device IDs.
Unique Bits Users Last 7 Days (Bits-enabled Extensions only) Number of unique users who used Bits in the extension in the last 7 days. For example, if this metric is provided on July 31, it would cover July 25-31. This is measured by user IDs, not device IDs.
Unique Bits Users Last 30 Days (Bits-enabled Extensions only) Number of unique users who used Bits in the extension in the last 30 days. For example, if this metric is provided on July 31, it would cover July 2-31. This is measured by user IDs, not device IDs.
Bits Used Per User (Bits-enabled Extensions only) Average number of Bits per user. Defined as Bits Used / Unique Bits Users.

* NOTE: “Click” events will include false positives, as viewers often click into the player to reveal the Extension (or other player controls). This is especially true for Overlay Extensions. You are allowed to implement Google Analytics to further instrument your Extension.

V2 Sample File (Partial)

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

Date,Extension Name,Extension Client ID,Extension Details Page Visits,Unique Extension Details Page Visits,Installs,Uninstalls,Activations,Unique Active Channels,Unique Active Channels Last 7 Days,Unique Active Channels Last 30 Days,Unique Identity Links,Unique Identity Unlinks,Renders,Unique Renderers,Unique Renderers Last 7 Days,Unique Renderers Last 30 Days,Views,Unique Viewers,Unique Viewers Last 7 Days,Unique Viewers Last 30 Days,Mouseenters,Unique Mouseenters,Unique Mouseenters Last 7 Days,Unique Mouseenters Last 30 Days,Mouseenters Per Viewer,Mouseenter Rate,Clicks,Unique Interactors,Unique Interactors Last 7 Days,Unique Interactors Last 30 Days,Clicks Per Interactor,Interaction Rate,Minimizations,Unique Minimizers,Minimization Rate,Unminimizations,Unique Unminimizers,Unminimization Rate,Bits Revenue USD,Bits Used,Bits Transactions,Bits Per Transaction,Unique Bits Users,Unique Bits Users Last 7 Days,Unique Bits Users Last 30 Days,Bits Used Per User
5/31/2018,test extension,hs5z3fh5dxhshfhazhk4hq38g9hz51,42,13,18,5,9,164,462,756,51,8,23954,13084,80730,168982,23954,13084,80730,168982,51796,7564,40166,79960,3.9587,0.5781,6512,1365,6848,15464,4.7707,0.1043,410,369,0.0282,12,10,0.0009,1.08,540,32,16.875,30,132,417,18
6/1/2018,test extension,hs5z3fh5dxhshfhazhk4hq38g9hz52,30,11,14,5,5,124,434,714,37,5,17286,9308,79066,163978,17286,9308,79066,163978,40010,5462,39166,77026,4.2985,0.5868,4412,1182,6926,14972,3.7327,0.127,292,273,0.0293,10,8,0.0011,0.87,435,38,11.4474,15,117,402,29
6/2/2018,test extension,hs5z3fh5dxhshfhazhk4hq38g9hz53,21,8,14,5,5,128,440,694,15,2,7930,5220,84282,163124,7930,5220,84282,163124,10516,2208,42176,75940,2.0146,0.423,1700,411,7636,14716,4.1363,0.0787,60,51,0.0098,4,4,0.0008,0.06,30,4,7.5,6,117,396,5
6/3/2018,test extension,hs5z3fh5dxhshfhazhk4hq38g9hz54,30,11,11,6,5,132,438,678,27,2,28412,21270,87358,165508,28412,21270,87358,165508,33464,7638,44426,76154,1.5733,0.3591,5356,1290,8760,14664,4.1519,0.0606,250,312,0.0147,4,4,0.0002,0.69,345,8,43.125,9,129,405,38.3333
6/4/2018,test extension,hs5z3fh5dxhshfhazhk4hq38g9hz55,31,10,16,4,8,184,442,654,51,6.5,31360,18238,80720,152212,31360,18238,80720,152212,62222,9678,44510,72208,3.4117,0.5307,7754,1986,10142,14124,3.9043,0.1089,466,477,0.0262,18,18,0.001,1.14,570,36,15.8333,33,162,408,17.2727
6/5/2018,test extension,hs5z3fh5dxhshfhazhk4hq38g9hz56,29,11,19,4,7,130,412,616,31,3.5,25562,14628,75620,147288,25562,14628,75620,147288,53390,7916,41896,69244,3.6498,0.5412,6670,1620,9414,13428,4.1173,0.1107,410,405,0.0277,2,2,0.0001,1.08,540,12,45,9,153,405,60
6/6/2018,test extension,hs5z3fh5dxhshfhazhk4hq38g9hz57,35,12,15,4,7,162,388,592,39,5,29130,18574,72038,144320,29130,18574,72038,144320,59696,10256,39912,66560,3.214,0.5522,7512,1884,8876,12836,3.9873,0.1014,458,507,0.0273,26,16,0.0014,1.32,660,58,11.3793,30,165,420,22
6/7/2018,test extension,hs5z3fh5dxhshfhazhk4hq38g9hz58,26,8,12,3,5,124,348,554,31,5,24184,14830,62452,138678,24184,14830,62452,138678,50960,7926,34506,61998,3.4363,0.5345,8434,1860,8056,12108,4.5344,0.1254,552,504,0.034,30,18,0.002,0.72,360,10,36,12,144,411,30
6/8/2018,test extension,hs5z3fh5dxhshfhazhk4hq38g9hz59,20,7,12,4,6,120,330,542,43,6.5,19732,12308,58580,133930,19732,12308,58580,133930,39890,6588,31670,59152,3.241,0.5353,7256,1560,7294,11356,4.6513,0.1267,436,468,0.038,14,14,0.0011,0.81,405,28,14.4643,18,150,411,22.5
6/9/2018,test extension,hs5z3fh5dxhshfhazhk4hq38g9hz60,24,8,12,3,7,134,324,538,41,6.5,30622,17092,56124,129834,30622,17092,56124,129834,63590,9626,29608,56998,3.7205,0.5632,11176,2493,6692,10768,4.483,0.1459,726,624,0.0365,16,14,0.0009,1.89,945,14,67.5,15,141,429,63

V1 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
...

Game Developer Analytics

Game Developer Analytics provides a full spectrum of your game’s performance on Twitch, including aggregate hours watched and number of concurrent streamers. It is available only to users who have registered an organization (AKA “company”) and claimed their game via the Twitch Developer Console. See Organization Management for more information.

To download this data:

  1. On your Twitch developer console, navigate to your Organization console using the top navigation drop down. Then, click on the Games tab.
  2. Under the game for which you want data, click Export Daily CSV.

    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.

Data starts being collected after the game is broadcast and viewed, subject to a one-day delay. For example, we start calculating the data for January 12th on January 14th at UTC 0:00. Typically the calculations complete within 4 hours. The report is uploaded as soon as the calculations are done.

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. (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 (Overview Reports)

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

If there is no data for a day, either that day is missing from the report or it is in the report with all data fields having a value of 0 (i.e., no activity).

Column Name V1 V2 Description
Date UTC date for the data in each row. For example, data in the row for 2018-08-01 (August 1, 2018) covers the period from 2018-08-01T00:00:00Z to 2018-08-01T23:59:59Z.
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 different viewers who watched this game on Twitch live or not-live. Specifically this measures unique device IDs (see Counting Device IDs).
Live Unique Viewers Number of Unique Viewers who watched this game live on Twitch. Specifically this measures unique device IDs (see Counting Device IDs).
Not-Live Unique Viewers Number of Unique Viewers who watched this game not-live on Twitch. As above, this measures unique device IDs (see Counting 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.
Clip Views   Number of times any Clips of this game were watched.
Top Clip URL   URL of the most-watched clip of this game.
Top Clip URL Embed   URL of the most-watched clip of this game, which you can embed in your site or blog. This is the same clip as for Top Clip URL, but the URL here contains additional parameters relevant to embedding clips (see Non-Interactive Frames for Clips). (Note: This URL contains a tt_mediumparameter. Ignore this; it is used only internally by Twitch.)

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,Clip Views,Top Clip URL,Top Clip URL Embed
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,1000,https://clips.twitch.tv/dummyvideo?tt_medium=dx_insights,https://clips.twitch.tv/embed?clip=dummyvideodonotclick&tt_medium=dx_insights
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,2000,https://clips.twitch.tv/dummyvideo?tt_medium=dx_insights,https://clips.twitch.tv/embed?clip=dummyvideodonotclick&tt_medium=dx_insights
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,2001,https://clips.twitch.tv/dummyvideo?tt_medium=dx_insights,https://clips.twitch.tv/embed?clip=dummyvideodonotclick&tt_medium=dx_insights
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,2010,https://clips.twitch.tv/dummyvideo?tt_medium=dx_insights,https://clips.twitch.tv/embed?clip=dummyvideodonotclick&tt_medium=dx_insights
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,2098,https://clips.twitch.tv/dummyvideo?tt_medium=dx_insights,https://clips.twitch.tv/embed?clip=dummyvideodonotclick&tt_medium=dx_insights
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,1999,https://clips.twitch.tv/dummyvideo?tt_medium=dx_insights,https://clips.twitch.tv/embed?clip=dummyvideodonotclick&tt_medium=dx_insights
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,1000,https://clips.twitch.tv/dummyvideo?tt_medium=dx_insights,https://clips.twitch.tv/embed?clip=dummyvideodonotclick&tt_medium=dx_insights
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,2000,https://clips.twitch.tv/dummyvideo?tt_medium=dx_insights,https://clips.twitch.tv/embed?clip=dummyvideodonotclick&tt_medium=dx_insights
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,2001,https://clips.twitch.tv/dummyvideo?tt_medium=dx_insights,https://clips.twitch.tv/embed?clip=dummyvideodonotclick&tt_medium=dx_insights
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,2010,https://clips.twitch.tv/dummyvideo?tt_medium=dx_insights,https://clips.twitch.tv/embed?clip=dummyvideodonotclick&tt_medium=dx_insights
...

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
...

Twitch Quarterly Insights

Twitch Quarterly Insights is a quarterly fact sheet produced on a per-game basis, for each game broadcast on Twitch. To access this:

  1. On your Twitch developer console, navigate to your organization via the top navigation drop down menu. Then click on the Games tab.
  2. Under the game for which you want to view Twitch Quarterly Insights, click View Quarterly Insights.

The view defaults to the latest quarter of data available. To view an older quarter, select it at the top of the sheet.

Using Twitch Quarterly Insights

Twitch Quarterly Insights are available for each quarter of the calendar year, starting with 2018 Q2. There is a fact sheet customized for each game that meets minimum thresholds (described below). The fact sheet organizes information into several sections:

Fact Sheet SectionDescription
6 key metrics about your viewers and broadcasters

hours watched is the same as the Total Hours Watched field in the game analytics CSV (Overview V2), aggregated by quarter instead of by day.

hours broadcast  is the same as the Hours Broadcast field in the game analytics CSV (Overview V2), aggregated by quarter instead of by day.

unique viewers is the same as the Total Unique Viewers field in the game analytics CSV (Overview V2), aggregated by quarter instead of by day.

unique broadcasters is the same as the Unique Broadcasters field in the game analytics CSV (Overview V2), aggregated by quarter instead of by day.

viewing sessions is the number of times this game was watched.

broadcasting sessions is the number of times this game was streamed for at least 90 seconds continuously.

Below each metric, we show quarter-over-quarter (Q/Q) information about the rate of change from the prior quarter to this quarter. Positive Q/Q changes are reflected with a green triangle next to the metric; neutral or negative changes, a yellow triangle.

This section contains custom (game-specific) data if your game was streamed for at least 300 minutes during the quarter; otherwise, it has key metrics for Twitch overall.

What's Trending

Top Broadcaster shows the top broadcaster who streamed your game this quarter. This is based on a combination of hours broadcast, hours watched, and average concurrent viewers.

Dedicated Broadcaster shows the most dedicated non-partnered broadcaster who streamed your game this quarter. This is based on a combination of the number of broadcasting sessions and the number of hours per session during the quarter. “Dedicated” broadcasters are those who devote at least half of their total quarterly stream time to this game.

Rising Star shows the rising star broadcaster who streamed your game this quarter, defined as the broadcaster with the greatest Q/Q growth in hours broadcast.

This section contains custom data if your game had broadcasters during the last quarter that fit Top Broadcaster, Dedicated Broadcaster, and Rising Star, otherwise, you will see a sample of popular channels on Twitch instead of game-specific information.

Social Impact

Statistics on chat messages, audience engagement, and broadcasting by Twitch partners and affiliates.

Click Get Started with Bounty Board to learn more about the Twitch Bounty Board product (where you can sponsor Twitch influencers to stream your game) or contact the Bounty Board team.
Audience Insights

Games Your Community Loves to Stream shows other games your broadcasters stream and the percentage of broadcasters who streamed those games.

Games Your Community Loves to Watch shows other games your viewers watch and the percentage of viewers who watched those games. To be counted here, a device must have watched the game more than 90 minutes over the quarter.

Broadcaster Geo Growth and Viewer Geo Growth highlight Q/Q growth of broadcasters and viewers of your game, in geographic areas with the greatest growth.

This section contains custom data if your game was streamed on Twitch during the quarter, otherwise, this section displays information about popular games the community streams or watches on Twitch.

Drops

Information about your game’s Drops campaigns.

If your game had Drops campaigns during the quarter, this section highlights total drops received, unique viewers who received a drop, and number of active campaigns as well as their Q/Q growth. Click Manage Drops Campaigns for details.

This section contains custom data if your game had active Drops campaigns for the quarter; otherwise, this section highlights success stories from our Drops customers. Click Get Started with Drops to learn more.
Extensions

Information about popular Extensions broadcasters use when streaming your game. If extensions are not used with your game, this section highlights popular extensions on Twitch.

Curious about building an extension? Click Get Started with Extensions to learn more.

At the bottom of the sheet:

Mod Author Analytics

Mod authors on Curseforge can access analytics on their project page and mod statistics using this product.

To download this data:

  1. Log into your author dashboard at authors.curseforge.com/dashboard.
  2. Click on the project list by clicking View Projects.
  3. Click Download CSV. Your browser will download the CSV file.

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

Data starts being collected after a user downloads a mod through CurseForge or the Twitch desktop app, subject to a one-day delay. For example, we start calculating the data for January 12th on January 13th at UTC 0:00. Typically the calculations complete within 4 hours. The report is uploaded as soon as the calculations are done.

Terminology

TermDefinition
CurseForgeThe site where authors go to upload game mods, https://www.curseforge.com/.
ModsGame modifications.
PointsCurseForge Reward Points. For information about the program, see the FAQ.
ProjectA mod which is uploaded to CurseForge.

Data Fields (Overview Report)

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

If there is no data for a day, either that day is missing from the report or it is in the report with all data fields having a value of 0 (i.e., no activity).

Column NameDescription
DateUTC date for the data in each row. For example, data in the row for 2018-08-01 (August 1, 2018) covers the period from 2018-08-01T00:00:00Z to 2018-08-01T23:59:59Z.
Project IDMod ID.
NameProject name.
PointsThe project’s CurseForge Point Rewards.
Historical DownloadTotal downloads to date.
Daily DownloadTotal downloads for the day.
Daily Unique DownloadUnique downloads based on IP address.
Daily Twitch App DownloadTotal downloads from the Twitch app filter on userAgent that starts with curseClient.
Daily CurseForge DownloadTotal downloads not within the Twitch app (i.e., in Curseforge).

Sample File (Partial)

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

Date,Project ID,Name,Points,Historical Download,Daily Download,Daily Unique Download,Daily Twitch App Download,Daily CurseForge Download
2019-01-0100:00:00,123456,mysimplemod,0,421351,2059,1771,1993,66
2018-12-3100:00:00,123456,mysimplemod,0,419292,2256,1944,2149,107
2018-12-3000:00:00,123456,mysimplemod,0,417036,2121,1841,2030,91
2019-12-2900:00:00,123456,mysimplemod,0,414915,2191,1878,2105,86
2018-12-2800:00:00,123456,mysimplemod,0,412724,3474,2961,3378,96
2018-12-2700:00:00,123456,mysimplemod,0,409250,3453,2903,3346,107
2018-12-2600:00:00,123456,mysimplemod,0,405797,2050,1786,1986,64
2018-12-2500:00:00,123456,mysimplemod,0,403747,2174,1856,2119,55
2018-12-2400:00:00,123456,mysimplemod,0,401573,2352,2025,2294,58
2018-12-2300:00:00,123456,mysimplemod,0,399221,2413,2049,2348,65
...