google-analytics-ga4 v1.0.0

This is very first test Run Will be completing it within 1 month.

React Google Analytics 4

Migrate from old react-ga

import GA4 from "google-analytics-ga4";

Install

Usage

import GA4 from "google-analytics-ga4";

GA4.initialize("your GA measurement id");
GA4.send("pageview");

Example

// Multiple products (previously known as trackers)
GA4.initialize([
  {
    trackingId: "your GA measurement id",
    gaOptions: {...}, // optional
    gtagOptions: {...}, // optional
  },
  {
    trackingId: "your second GA measurement id",
  },
]);

// Send pageview with a custom path
GA4.send({ hitType: "pageview", page: "/my-path" });

// Send a custom event
GA4.event({
  category: "your category",
  action: "your action",
  label: "your label", // optional
  value: 99, // optional, must be a number
  nonInteraction: true, // optional, true/false
  transport: "xhr", // optional, beacon/xhr/image
});

Reference

GA4.initialize(GA_MEASUREMENT_ID, options)

GA4.set(fieldsObject)

GA4.event(name, params)

This method signature are NOT for UA-XXX

GA4.event(options)

GA4.send(fieldsObject)

ReactGA.gtag(...args)

ReactGA.ga(...args)

GA4.pageview(path, _, title)

Deprecated Use .send("pageview") instead

GA4.outboundLink({ label }, hitCallback)

Deprecated Use enhanced measurement feature in Google Analytics.

Extending

import { ReactGAImplementation } from "google-analytics-ga4";

class MyCustomOverriddenClass extends ReactGAImplementation {}

export default new MyCustomOverriddenClass();

Debugging

Use Google Analytics Debugger Chrome Extension to see logs

Maintainer

pcprashant99

License

MIT