@keiko-app/react-google-analytics

🧐 Features

Here're some of the project's best features:

• Easily integrate Google Analytics tracker
• Track the page views
• Track the user's events throughout the ReactJS application

🛠️ Installation Steps

Install the module from NPM registry

npm:

npm install --save @keiko-app/react-google-analytics

yarn:

yarn add @keiko-app/react-google-analytics

Set the config and add the provider to you App.tsx page:

import { AnalyticsProviderConfig } from "@keiko-app/react-google-analytics";

const config: AnalyticsProviderConfig = {
  measurementId: "G-XXXXXXX",
};

const App = () => {
  <AnalyticsProvider config={config}>
    <YourComponents />
  </AnalyticsProvider>;
};

export { App };

📝 Usage

Every child component of the AnalyticsProvider has access to the useAnalytics() hook. This hook exports the tracker instance.

const { tracker } = useAnalytics();

Then, you will have access to the tracking methods.

Tracking Page View

Method: tracker.trackPageView(parameters?: TrackPageViewParams)

Some parameters can be provided (none of them are required):

Option	Type	Description	Default Value
page_title	String	Sets the page title	Value of window.document.title
page_location	String / Location	Sets the page URL	Value of window.location.href
client_id	String	The client ID	none
language	String	The client language. Please see here for all available codes	none
page_encoding	String	The encoding used on the page (e.g. UTF-8)	none
user_agent	String	The client's user agent	none

These parameters are based on the official list supported by Google Analytics.

Tracking Custom Events

Method: tracker.trackEvent(name: string, parameters: Record<string,any>)

🔧 Options

Option	Type	Required?	Description	Example
measurementId	String	✅	The measurement ID provided by Google when you created your property.	G-XXXXXXXXX
disableTracking	Boolean	-	When set to true, tracking will be stopped. Useful for GDPR🇪🇺 compliance or development websites	false
urlTransformer	Function (see below)	-	Transform function that will modify the URL and set it as a custom URL. Usefull to remove sensitive informations (ids...) from URLs	See below

Transform URLs using urlTransformer

There is an option to modify URLs before sending them to the Google Analytics instance. This is particularly useful to remove sensitive informations such as IDs from the URLs. This method accepts one parameter (string) and must return a string.

Example use case - removing UUIDs from the URL:

const urlTransformer: (url: string) => {
	const UUIDV4_REGEX = new RegExp(/[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}/, "g");
	return url.replaceAll(UUIDV4_REGEX, "**MASKED**");
};

const config: AnalyticsProviderConfig = {
	measurementId: "G-XXXXXXX",
	urlTransformer
};

💖 What is keiko?

keiko is an online service available on the Web and as mobile applications to simply manage home inventories and better deal with home insurers. It was proudly built in 🇫🇷 France and is currently only avaialble in this country.

➡️ Discover more about keiko on our website: https://keiko-app.fr

🛡️ License

This project is licensed under the MIT