How do you integrate Universal Analytics in to Chrome Extensions?
There's an issue for that on Google code: The solution is to pass analytics your own protocol check function or simply null
for no checking, in an official way.
This has to come after ga('create', ...)
:
ga('set', 'checkProtocolTask', null); // Disable file protocol checking.
So you don't need to modify the original analytics.js script. Just include the standard tracking code snippet (dont' forget to add the "https:" prefix) and add "https://www.google-analytics.com" to your Content Security Policy.
A note to ayal gelles' solution:
It is not necessary to add chrome-extension://...
to the Content Security Policy since it's already included in the 'self'
statement. Also, instead of loading the script via hardcoded URL you should use chrome.runtime.getURL("path/to/analytics.js")
. This way you don't need to know your extension's ID, Chrome will fill it in for you.
I wrote up a blog post on this - How to add Google’s Universal Analytics tracking to a Chrome extension
Here's the guts of it:
// Standard Google Universal Analytics code
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','https://www.google-analytics.com/analytics.js','ga'); // Note: https protocol here
ga('create', 'UA-XXXXX-YY', 'auto');
ga('set', 'checkProtocolTask', function(){});
ga('send', 'pageview', '/options.html');
There are 3 points I’d particularly like to highlight:
- Specify “https” at the start of the script address to match with the listing in the manifest.json file
- Override
checkProtocolTask
with an empty function - Send a virtual pageview by specifying the path –
/options.html
– otherwise Google Analytics will reject a URL in the formatchrome-extension://gdocgfhmbfbbbmhnhmmejncjdcbjkhfc/options.html