igrigorik/ga-beacon is an open-source project on GitHub with 3.5k stars, written primarily in Go. Google Analytics collector-as-a-service (using GA measurement protocol).
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
Sometimes it is impossible to embed the JavaScript tracking code provided by Google Analytics: the host page does not allow arbitrary JavaScript, and there is no Google Analytics integration. However, not all is lost! If you can embed a simple image (pixel tracker), then you can beacon data to Google Analytics. For a great, hands-on explanation of how this works, check out the following guides:
Using a Beacon Image for GitHub, Website and Email Analytics
(also see FAQ below regarding GitHub)
Tracking Google Sheet views with Google Analytics using GA Beacon
Can I use this production?
The ga-beacon.appspot.com instance is a demo instance, good for prototyping and proof of concepts. If you intend to use this in production for your application, you should deploy your own instance of this service, which will allow you to scale the service up and down to meet your capacity needs, introspect the logs, customize the code, and so on.
Deploying your own instance is trivial: fork this repo, modify the project name in app.yaml, and follow the normal GAE deploy instructions. You should be up and running in less than five minutes.
Setup instructions
First, log in to your Google Analytics account and set up a new property:
Select "Website", use new "Universal Analytics" tracking
Website name: anything you want (e.g. GitHub projects)
WebSite URL: https://ga-beacon.appspot.com/
Click "Get Tracking ID", copy the UA-XXXXX-X ID on next page
Next, add a tracking image to the pages you want to track:
insert/any/path is an arbitrary path. For best results specify a meaningful and self-descriptive path. You have to do this manually, the beacon won't automatically record the page path it's embedded on.
If you prefer, you can skip the badge and use a transparent pixel. To do so, simply append ?pixel to the image URL. There are also "flat" style variants available, which are available when appending ?flat or ?flat-gif to the image URL. And that's it, add the tracker image to the pages you want to track and then head to your Google Analytics account to see real-time and aggregated visit analytics for your projects!
You may also auto-calculate the tracking path based in the "referer" information of the image. To activate this simple add ?useReferer to the image URL (or &useReferer if you need to combine this with the ?pixel, ?flat or ?flat-gif parameter). Although they are some odd browsers that don't always send the referer header, the amount of traffic coming from those browsers is usually not relevant at all. Of course that if you need to measure the traffic from those odd browsers you should not use this method.
FAQ
How does this work? Google Analytics provides a measurement protocol which allows us to POST arbitrary visit data directly to Google servers, and that's exactly what GA Beacon does: we include an image request on our pages which hits the GA Beacon service, and GA Beacon POSTs the visit data to Google Analytics to record the visit. As a result, if you can embed an image, you can beacon data to Google Analytics.
Why do we need to proxy? Google Analytics supports reporting of visit data via GET requests, but unfortunately we can't use that directly because we need to generate and report a unique visitor ID for each hit - e.g. some pages do not allow us to run JS on the client to generate the ID. To address this, we proxy the request through ga-beacon.appspot.com, which in turn is responsible for generating the unique visitor ID (server generated UUID), setting the appropriate cookies for repeat hits, and reporting the hits to Google Analytics.
What about referrals and other visitor information? Unfortunately the static tracking pixel approach limits the information we can collect about the visit. For example, referral information can't be passed to the tracking pixel because we can't execute JavaScript. As a result, the available metrics are restricted to unique visitors, pageviews, and the User-Agent and IP address of the visitor.
Do I have to use ga-beacon.appspot.com? You can if you want to - it's free, but there are no capacity or availability promises. For best results, deploy your own instance directly on Google App Engine: clone this repository, change the project name, and deploy your own instance - easy as that. The project is under MIT license.
Can I use this to track visits to my GitHub README and other GitHub-served content? No, you cannot - see https://github.com/igrigorik/ga-beacon/commit/6acd8627bb7be36f24f5516e9873c92719a50e55
The most recent commit recorded on igrigorik/ga-beacon was 3.8 years ago, based on the GitHub push timestamp. The repository has 354 forks — one of the better signals of community interest.
How many stars does igrigorik/ga-beacon have?
igrigorik/ga-beacon has 3.5k GitHub stars — refresh the page for the live number, or check github.com/igrigorik/ga-beacon. TopGit mirrors GitHub's count but does not claim minute-by-minute accuracy.
Is igrigorik/ga-beacon open source?
Yes — igrigorik/ga-beacon ships under the MIT license, which makes its source code freely readable (and, depending on license terms, forkable and reusable). Source: github.com/igrigorik/ga-beacon.
What is igrigorik/ga-beacon?
igrigorik/ga-beacon (igrigorik/ga-beacon) is a Go project on GitHub. From the project's own README: Google Analytics collector-as-a-service (using GA measurement protocol).
What language is igrigorik/ga-beacon written in?
igrigorik/ga-beacon is written primarily in Go. GitHub's language field is based on the largest share of bytes in the default branch.
What license does igrigorik/ga-beacon use?
igrigorik/ga-beacon is released under the MIT license. Always verify the LICENSE file directly on GitHub for the authoritative terms — license strings can be edited out of sync with a project's actual stance.
Where do I read more about igrigorik/ga-beacon?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/igrigorik/ga-beacon is the definitive source.
Read full README in the tab above.
Still deciding about ga-beacon?
One click hands the question to an AI along with this page — see what it says about ga-beacon.