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
GA4.initialize([
{
trackingId: "your GA measurement id",
gaOptions: {...},
gtagOptions: {...},
},
{
trackingId: "your second GA measurement id",
},
]);
GA4.send({ hitType: "pageview", page: "/my-path" });
GA4.event({
category: "your category",
action: "your action",
label: "your label",
value: 99,
nonInteraction: true,
transport: "xhr",
});
Reference
GA4.initialize(GA_MEASUREMENT_ID, options)
Parameter | Notes |
---|
GA_MEASUREMENT_ID | string Required |
options.nonce | string Optional Used for Content Security Policy (CSP) more |
options.testMode | boolean Default false |
options.gaOptions | object Optional Reference |
options.gtagOptions | object Optional |
options.legacyDimensionMetric | boolean Default true |
GA4.set(fieldsObject)
Parameter | Notes |
---|
fieldsObject | object Required |
GA4.event(name, params)
This method signature are NOT for UA-XXX
Parameter | Notes |
---|
name | string Required A recommended event or a custom event |
params | object Optional |
GA4.event(options)
Parameter | Notes |
---|
options | object Required |
options.action | string Required |
options.category | string Required |
options.label | string Optional |
options.value | number Optional |
options.nonInteraction | boolean Optional |
options.transport | 'beacon'|'xhr'|'image' Optional |
options.dimension{1...200} | any Optional |
options.metric{1...200} | any Optional |
GA4.send(fieldsObject)
Parameter | Notes |
---|
fieldsObject | object Required |
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