Skip to content
/ gtag-ga Public

๐Ÿ“Š Google Analytics 4 (gtag.js) for NodeJS ES Module. Simple installation to send page views or event tracking.

License

Notifications You must be signed in to change notification settings

jooy2/gtag-ga

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

8 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿ“Š gtag-ga

Google Analytics 4 (gtag.js) for NodeJS ES Module. Simple installation to send page views or event tracking.

license Programming Language Usage Commit Count npm downloads npm latest package minified size github repo size Followers Stars

  • โšก๏ธ Lightweight modules & quick setup & fast performance
  • โšก๏ธ Zero dependency packages. ESM packages available everywhere
  • โšก๏ธ Support for the latest NodeJS, Google Analytics 4
  • โšก๏ธ Support for TypeScript

Installation

gtag-ga requires Node.js 12.x or higher, and the repository is serviced through NPM.

After configuring the node environment, you can simply run the following command.

# via npm
$ npm install gtag-ga

# via yarn
$ yarn add gtag-ga

# via pnpm
$ pnpm install gtag-ga

How to use

Recommend: Using named import (Multiple utilities in a single require)

import { initializeGtag } from 'gtag-ga';

initializeGtag('G-XXXXXXXXXX'); // Your tracking code

Using whole class (multiple utilities simultaneously with one object)

import GtagGA from 'gtag-ga';

GtagGA.initializeGtag('G-XXXXXXXXXX'); // Your tracking code

Methods

initializeGtag (void)

Enable gtag.js in your webpage environment. Ideally, it should only be called once at the start (but multiple calls won't hurt). The first argument value should include your Google Analytics tracking ID, which starts with G-.

  • (Required) trackingId::string
  • config::object
initializeGtag('G-XXXXXXXXXX'); // Your tracking code

gtag (void)

The usage of this function is the same as the gtag functions used in regular gtag.js.

Learn more in the official gtag.js documentation at: https://developers.google.com/tag-platform/gtagjs/configure#step_2_send_data_with_event

gtag('event', 'eventName', { 'key': 'value' });

Contribute

You can report issues on GitHub Issue Tracker. You can also request a pull to fix bugs and add frequently used features.

License

Copyright ยฉ 2023 Jooy2 <[email protected]> Released under the MIT license.

About

๐Ÿ“Š Google Analytics 4 (gtag.js) for NodeJS ES Module. Simple installation to send page views or event tracking.

Topics

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published