1.2.4 • Published 1 year ago

@tracktor/react-google-tag-manager v1.2.4

Weekly downloads
-
License
ISC
Repository
github
Last release
1 year ago

React Google Tag Manager

npm version

Very light React library for use easily the Google Tag Manager

Installation

yarn add @tracktor/react-google-tag-manager

or

npm install @tracktor/react-google-tag-manager

Usage

import { GoogleTagManagerProvider, useGoogleTagManager } from "@tracktor/react-google-tag-manager";

const App = () => (
  <GoogleTagManagerProvider id="YOUR_GOOGLE_TAG_ID">
    <YourComponent />
  </GoogleTagManagerProvider>
);

const YourComponent = () => {
  const { sendEvent } = useGoogleTagManager();

  return (
    <main>
      <h1>Your Component</h1>
      <button type="button" onClick={() => sendEvent({ event: "eventName", value: "someValue" })}>
        Click me
      </button>
    </main>
  );
};

export default App;

Props and options

Your can provide some props and options to the provider.

import { GoogleTagManagerProvider } from "@tracktor/react-google-tag-manager";

const App = () => (
  <GoogleTagManagerProvider id="YOUR_GOOGLE_TAG_ID" options={{ dataLayerName: "..." }}>
    ...
  </GoogleTagManagerProvider>
);

export default App;
PropsTypeDefaultDescription
idGTM-XXXXXXundefinedDefine the Google Tag Manager ID id. You can create an account to get an ID here : https://tagmanager.google.com/?hl=fr#/home
optionsobjectundefinedProvider options
OptionTypeDefaultDescription
scriptUrlstringhttps://www.googletagmanager.com/gtm.jsSet script url to load
dataLayerNamestringdataLayerSet the data layer name

Hooks

useGoogleTagManager

ExporttypeDescription
sendEventfunctionSend GTM event
idstringThe GTM id