Global site tag (gtag.js) - Google Analytics
ES module for the Google Analytics Global Site Tag.
Install
$ npm install --save ga-gtag
Usage
import { gtag, install } from 'ga-gtag';
install('G-##########');
install()
adds the Global Site Tag script element into <head>
. It only needs to be called once, but can safely be called multiple times (the script won't be re-added).
install()
also has a second, optional argument that can be used to specify additional config info for the initialization (for instance to disable pageview measurement):
install('G-##########', { 'send_page_view': false });
From there, gtag()
can be used as specified in Google's documentation:
gtag('event', 'login', { 'method': 'Google' });
If you need to call gtag()
before the Global Site Tag script is installed (for instance, to manage consent settings in consent mode), import and call initDataLayer()
first:
import { gtag, initDataLayer, install } from 'ga-gtag';
initDataLayer();
gtag('consent', 'default', {
'ad_storage': 'denied',
'analytics_storage': 'denied'
});
install('G-##########');