Google Tag Manager is a powerful tool from Google for manage tags (like cookies, pixels, scripts, etc...) on your app/website from a single entry point and without editing your codebase!

The GTM is an awesome tool for marketers and developers for adding external libs, handling events and analytics tags without affecting the codebase and, above all, give to the marketing team some working autonomy without deploy a new version of the app/website.

Why?

Why I wrote this Hook?

Basically because we are in the Hook era and, at the moment of writing, there was not any hook to handle it.

Overview

The Hook will inject the GTM scripts to the document and you don't have to edit your index.html anymore.

You can also pass as parameters a custom dataLayer name (it will replace the default dataLayer) and custom values/variables to it.

There is also a method to send custom data/events to the GTM (is a wrapper for the dataLayer.push())

Example Snippets

Basic/Default usage

import { useEffect } from 'react'
import useGTM from '@elgorditosalsero/react-gtm-hook'

const App = () => {
  const { init } = useGTM()

  useEffect(() => init({ id: 'GTM-ID' }), [])

  return <p>My awesome app</p>
}

Send event (after initialization)

const MyAwesomeComp = () => {
  const { sendDataToGTM } = useGTM()

  const handleClick = () => sendDataToGTM({ 
    event: 'awesomeButtonClicked', 
    value: 'imAwesome' 
  })

  return (
    <div>
      <p>My Awesome Comp</p>
      <button onClick={handleClick}>My Awesome Button</button>
    </div>
  )
}

So, what do you think? Will you try it?

If you think would be useful an article with more example and/or screenshot also from the Tag Manager, let me know in the discussion section

Pull Request, contributions and issue are welcome!

If this Hook was useful to you and you like it, please add a reaction and/or leave a comment and star on GitHub!

Repo

$ yarn add @elgorditosalsero/react-gtm-hook
# or
$ npm install @elgorditosalsero/react-gtm-hook

import { GTMProvider } from '@elgorditosalsero/react-gtm-hook'

const App = () => {
  const gtmParams = { id: 'GTM-ID' }

  return (
    <GTMProvider state={gtmParams}>
      <p>My awesome app</p>
    </GTMProvider>
  )
}

import { GTMProvider } from