It uses the Google Analytics real-time data API to get the locations of the users acccessing your website, and displays them on a full-screen map as a heatmap (i.e. colors indicating the # of people at given location). Here is a sample of what it will look like in action:
In order to access your Google Analytics data, you need to be logged in to a Google Account that can read the appropriate Google Analytics account/property/view.
Your data is only accessed by the browser, not by the Heatmap.TV server (tech tidbit: it is a static website).
If you are concerned about the security of the PC or TV showing the map, I recommend making a dedicated user in Google Analytics with read-only permission to just the accounts/properties/views that you want to display on the TV.
At my work, for example, we created a new user
[email protected] with rights to GAnalytics views of our production-ready
Note: the logout button only logs you out from Heatmap.TV. It does not log you out of your Google Account.
If you want to revoke GA permissions from Heatmap.TV, you can do so on Google's App Permissions page.
Once per minute.
In theory, yes. In practice, no. Google will occasionally (perhaps once a week) want you to re-login. And there seem to be browser issues (at least in Chrome on Windows) that crash ("Awww Snap") after a few days.
Google has a 10 hits/minute rate-limit on the real-time analytics API. I am considering ways around this that would not increase the refresh interval.
A "stick" computer will work as long as it has a fully-functional browser. The ASUS ChromeBit (which runs Google's ChromeOS) is a good choice. If you prefer Windows, the Intel Compute Stick or similar should work fine. I recommend getting a wireless keyboard as well.
Please see the Credits page! You can see the actual source code at GitHub.
Please Contact me!