Chrome extension adding external javascript to current page's html
Content scripts do not run in the scope of the page (see also), they run in a context between your extension and the web page.
Since the trackers are of the type "Injected script", these fully run in the context of the web page. But the _gaq
and Hasync
variables don't. As a result, the track scripts cannot read the configuration variables.
There are two (three) ways to fix it.
- Inject your code (as posted in the question) using this method. Using this method for your purpose is discouraged, because your script overwrites a commonly used global variable. Implementing your script using this method will break the tracking on many websites - do not use it.
- Fully run the code within the scope of a content script:
Two options:- Include the external files in the extension
- Include the external files in the extension, plus implement an auto-update feature.
Method 1: Fully local copy
manifest.json
(only the relevant parts are shown):
{
"name": "Website Safety",
"version": "1.0",
"manifest_version": 2,
"description": "The Website Safety Extension.",
"permissions": [
"tabs", "http://*/*", "https://*/*"
],
"content_scripts": [
{
"matches": ["<all_urls>"],
"js": ["ga-config.js", "ga.js", "js15_as.js"]
}
]
}
In ga-config.js
, define the variables as follows:
var _gaq = _gaq || [];
_gaq.push(['_setAccount', 'UA-31046309-1']);
_gaq.push(['_setAllowLinker', true]);
_gaq.push(['_trackPageview']);
var _Hasync= _Hasync|| [];
_Hasync.push(['Histats.start', '1,1342541,4,0,0,0,00000000']);
_Hasync.push(['Histats.fasi', '1']);
_Hasync.push(['Histats.track_hits', '']);
Download https://ssl.google-analytics.com/ga.js, and save it as ga.js
.
Download http://s10.histats.com/js15_as.js, and save it as js15_as.js
.
Method 2: Injecting a Up-to-date GA
If you want to have an up-to-date version of GA, a convoluted way of injecting the code has to be used, because Content scripts cannot be included from an external URL.
An old version of this answer relied on the background page and chrome.tabs.executeScript
for this purpose, but since Chrome 20, a better method has become available: Use the chrome.storage
API to cache the JavaScript code.
To keep the code updated, I will store a "last updated" timestamp in the storage; you can also use the chrome.alarms
API instead.
Note: Do not forget to include a local copy of the external file in your extension, in case the user does not have an internet connection, etc. Without an internet connection, Google Analytics wouldn't work anyway.
Content script, activate-ga.js
.
var UPDATE_INTERVAL = 2 * 60 * 60 * 1000; // Update after 2 hour
// Retrieve GA from storage
chrome.storage.local.get({
lastUpdated: 0,
code: ''
}, function(items) {
if (Date.now() - items.lastUpdated > UPDATE_INTERVAL) {
// Get updated file, and if found, save it.
get('https://ssl.google-analytics.com/ga.js', function(code) {
if (!code) return;
chrome.storage.local.set({lastUpdated: Date.now(), code: code});
});
}
if (items.code) // Cached GA is available, use it
execute(items.code);
else // No cached version yet. Load from extension
get(chrome.extension.getURL('ga.js'), execute);
});
// Typically run within a few milliseconds
function execute(code) {
try { window.eval(code); } catch (e) { console.error(e); }
// Run the rest of your code.
// If your extension depends on GA, initialize it from here.
// ...
}
function get(url, callback) {
var x = new XMLHttpRequest();
x.onload = x.onerror = function() { callback(x.responseText); };
x.open('GET', url);
x.send();
}
Minimum manifest file:
{
"name": "Website Safety",
"version": "1.0",
"manifest_version": 2,
"permissions": [
"tabs", "http://*/*", "https://*/*"
],
"content_scripts": [
{
"matches": ["<all_urls>"],
"js": ["activate-ga.js"]
}
],
"web_accessible_resources": ["ga.js"]
}
The same method can be used for other trackers. The minimum permission requirements:
https://ssl.google-analytics.com/ga.js
, so that should be added at the permissions section.https://*/*
or<all_urls>
is also sufficient.- optional:
unlimitedStorage
- If you want to store a large piece of data withchrome.storage
.
2015 Update
The new Universal Analytics snippet can definitely handle multiple trackers, so assuming you give yours a unique name and run all Analytics code in the page's context, you should be good to go.
// add Universal Analytics to the page (could be made conditional)
runFunctionInPageContext(function () {
(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);
a.async=1;a.src=g;document.documentElement.appendChild(a)
})(window,document,'script','//www.google-analytics.com/analytics.js','ga');
});
// all Google Analytics calls should use our tracker name
// and be run inside the page's context
runFunctionInPageContext(function () {
ga('create', 'UA-12345-6', 'auto', {'name': 'myTracker'});
ga('myTracker.send', 'pageview'); // note the prefix
});
// simple helper function
function runFunctionInPageContext(fn) {
var script = document.createElement('script');
script.textContent = '(' + fn.toString() + '());';
document.documentElement.appendChild(script);
document.documentElement.removeChild(script);
}
Note, there's one slight modification in the analytics snippet to use document.documentElement
instead of the first <script>
element. It is because google assumes you add analytics in an inline script block, whereas here you add it from a content script.
I read through this thread: https://groups.google.com/a/chromium.org/forum/#!topic/chromium-extensions/yc-ouDqfMw0 and found that there's an official chrome method for adding the analytics script to the page, and it's not in the official docs.
you can refer to this extension for reference: https://github.com/GoogleChrome/chrome-app-samples/tree/master/samples/analytics and it uses this lib: https://github.com/GoogleChrome/chrome-platform-analytics
basically you manually include the script locally:
<script src="your_path/google-analytics-bundle.js"></script>
<script src="main.js"></script>
then you call some library functions:
var service, tracker, out;
function initAnalyticsConfig(config) {
document.getElementById('settings-loading').hidden = true;
document.getElementById('settings-loaded').hidden = false;
var checkbox = document.getElementById('analytics');
checkbox.checked = config.isTrackingPermitted();
checkbox.onchange = function() {
config.setTrackingPermitted(checkbox.checked);
};
}
note: apparently, you have to have an opt out function https://github.com/GoogleChrome/chrome-platform-analytics/wiki#add-privacy-support-aka-opt-out
function startApp() {
// Initialize the Analytics service object with the name of your app.
service = analytics.getService('ice_cream_app');
service.getConfig().addCallback(initAnalyticsConfig);
// Get a Tracker using your Google Analytics app Tracking ID.
tracker = service.getTracker('UA-XXXXX-X');
// Record an "appView" each time the user launches your app or goes to a new
// screen within the app.
tracker.sendAppView('MainView');
}
window.onload = startApp;