Global site tag (gtag.js) - Google Analytics
ES module for the Google Analytics Global Site Tag.
Install
$ npm install --save ga-gtagUsage
import { gtag, install } from 'ga-gtag';
// Substitute your tracking ID (begins with "G-", "UA-", "AW-" or "DC-")
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-##########');