react-ga

library3.3.1jsnpmunverified

react-ga is a JavaScript module designed for integrating Google Universal Analytics (UA-xxxxxx-x properties) tracking into React applications. It provides a React-friendly wrapper around the core Google Analytics library, offering an opinionated API to standardize instrumentation. The current stable version is 3.3.1, released in June 2022. However, this library is now considered deprecated because Google Universal Analytics ceased processing new hits on July 1, 2023, in favor of Google Analytics 4 (GA4). react-ga does not support GA4's `G-` measurement IDs, making it unsuitable for new analytics implementations or existing ones that have migrated to GA4. For GA4 integration, users should consider `react-ga4` or direct `gtag.js` implementations.

observability

npm install react-ga

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · REACT-GA

react-ga

observabilityjavascriptv3.3.1

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

ReactGA

✓ import ReactGA from 'react-ga';

✗ const ReactGA = require('react-ga');

This is the standard named import for the main ReactGA object, providing all tracking methods. CommonJS `require` works but ESM is preferred in modern React projects.

ReactGA

✓ import ReactGA from 'react-ga/core';

Use this path to import the core non-React specific analytics functionalities, if you don't need the React components (like OutboundLink) or want to avoid React as a direct dependency.

OutboundLink

✓ import { OutboundLink } from 'react-ga';

✗ import OutboundLink from 'react-ga';

OutboundLink is a named export for a React component that handles tracking outbound clicks. It requires React to be a peer dependency.

This quickstart demonstrates how to initialize `react-ga` with a Universal Analytics tracking ID and send a pageview and a custom event. It includes a warning for users attempting to use GA4 IDs.

import ReactGA from 'react-ga'; import React, { useEffect } from 'react'; const GA_TRACKING_ID = process.env.REACT_APP_GA_UA_ID ?? 'UA-000000-01'; // Use a Universal Analytics ID function App() { useEffect(() => { if (GA_TRACKING_ID.startsWith('UA-')) { ReactGA.initialize(GA_TRACKING_ID, { debug: process.env.NODE_ENV === 'development' }); ReactGA.pageview(window.location.pathname + window.location.search); console.log('ReactGA initialized and pageview sent for UA ID:', GA_TRACKING_ID); } else { console.warn('GA_TRACKING_ID is not a Universal Analytics ID (UA-). react-ga only supports Universal Analytics. Please use react-ga4 for GA4 (G-) IDs.'); } }, []); const handleButtonClick = () => { if (GA_TRACKING_ID.startsWith('UA-')) { ReactGA.event({ category: 'User', action: 'Clicked Button', label: 'Demo Button' }); console.log('GA Event sent: Clicked Demo Button'); } }; return ( <div> <h1>Welcome to React-GA Demo</h1> <p>This demo uses react-ga for Universal Analytics tracking.</p> <button onClick={handleButtonClick}>Track Me</button> <p>Check your Universal Analytics dashboard for data.</p> <p>Note: Universal Analytics is deprecated. For GA4, use react-ga4.</p> </div> ); } export default App;

Debug

Known issues

breakingGoogle Universal Analytics (UA) has been officially deprecated and stopped processing new hits on July 1, 2023. This means `react-ga`, which is built exclusively for UA properties, no longer collects data for standard UA properties.

fix

Migrate your analytics implementation to Google Analytics 4 (GA4). `react-ga` does not support GA4's `G-` measurement IDs. Consider using `react-ga4` (a separate library) or integrating the native `gtag.js` directly for GA4 tracking.

affects: >=1.0.0

gotchaThe default `siteSpeedSampleRate` for Universal Analytics is 1%, meaning only a small fraction of page timing hits are sent. This can lead to insufficient data for performance analysis.

fix

When initializing, include `siteSpeedSampleRate: 100` in the `gaOptions` object to send 100% of page timing hits. Example: `ReactGA.initialize('UA-XXXXXXXXX-X', { gaOptions: { siteSpeedSampleRate: 100 } });`

affects: >=1.0.0

gotchaUsing the `debug: true` option in `ReactGA.initialize` will log analytics calls to the console, which is useful during development but should be avoided in production environments to prevent unnecessary console output and potential performance overhead.

fix

Ensure `debug: true` is only enabled in non-production environments. A common pattern is `ReactGA.initialize('UA-XXXXXXXXX-X', { debug: process.env.NODE_ENV === 'development' });`

affects: >=1.0.0

gotchaThe `ReactGA.initialize` function must be called exactly once before any other tracking functions are invoked. Calling it multiple times or after other tracking calls can lead to inconsistent or lost data.

fix

Call `ReactGA.initialize` early in your application's lifecycle, typically within a `useEffect` hook in your root component or in your application's entry file, ensuring it runs only once.

affects: >=1.0.0

Errors

Common errors & fixes

Error: `gaTrackingID` is required to initialize Google Analytics

The `ReactGA.initialize` method was called without a Universal Analytics (UA-XXXXXX-X) tracking ID, or with an invalid format like a GA4 (G-XXXXXX) measurement ID.

fix

Provide a valid Universal Analytics tracking ID (e.g., 'UA-12345-1') to `ReactGA.initialize`. If you intend to use GA4, you must switch to a GA4-compatible library like `react-ga4` as `react-ga` does not support GA4 measurement IDs.

No data appearing in Google Analytics Realtime/Standard Reports

This usually indicates incorrect initialization, an invalid tracking ID, an active ad-blocker, or that you are using a GA4 `G-` measurement ID instead of a Universal Analytics `UA-` tracking ID. Additionally, the `siteSpeedSampleRate` default of 1% can make it seem like no data is being collected.

fix

1. Verify `ReactGA.initialize` is called once with a correct `UA-` tracking ID. 2. Disable ad-blockers for testing. 3. Add `debug: true` to `initialize` options to see console logs. 4. If using GA4, migrate to `react-ga4`. 5. Set `siteSpeedSampleRate: 100` in `gaOptions` for more comprehensive data collection.

Upgrade

Version history

3.3.1latest on npm

Audit

Dependencies

prop-typesrequiredRequired for type checking React component props, particularly for the OutboundLink component.

reactrequiredPeer dependency for React components, specifically for the OutboundLink component. Supports React versions 15.6.2 through 18.

Agent activity

16 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/react-ga/react-ga ↗

packagehttps://www.npmjs.com/package/react-ga ↗

homepagehttps://react-ga.dev ↗