react-server-side-gtm

$3

👋 This is a fork of react-gtm-module which has fallen behind on PR's and support for new GTM features.

You can easily use server-side tagging, custom dataLayer, multiple dataLayers and additional events.

Installation

npm:

``bash
npm install react-server-side-gtm --save
`

Usage

Initializing GTM:

`js
import React from 'react'
import ReactDOM from 'react-dom'
import Router from 'react-router'
import routes from './routes'

...
import TagManager from 'react-server-side-gtm'

const tagManagerArgs = {
gtmId: 'GTM-000000'
}

TagManager.initialize(tagManagerArgs)
...

const app = document.getElementById('app')
ReactDOM.render(, app)

`

DataLayer

$3

`js
import React from 'react'
import ReactDOM from 'react-dom'
import Router from 'react-router'
import routes from './routes'

...
import TagManager from 'react-server-side-gtm'

const tagManagerArgs = {
gtmId: 'GTM-000000',
dataLayer: {
userId: '001',
userProject: 'project'
}
}

TagManager.initialize(tagManagerArgs)
...

const app = document.getElementById('app')
ReactDOM.render(, app)

`

$3

If you need send multiple custom dataLayer you can initialize GTM Module on different components sending different dataLayers

You can initialize it normally:

`js
import React from 'react'
import ReactDOM from 'react-dom'
import Router from 'react-router'
import routes from './routes'

...
import TagManager from 'react-server-side-gtm'

const tagManagerArgs = {
gtmId: 'GTM-000000',
dataLayerName: 'PageDataLayer'
}

TagManager.initialize(tagManagerArgs)
...

const app = document.getElementById('app')
ReactDOM.render(, app)

`

And send your data in each page you want

`js
import React from 'react'

...
import TagManager from 'react-server-side-gtm'

const tagManagerArgs = {
dataLayer: {
userId: '001',
userProject: 'project',
page: 'home'
},
dataLayerName: 'PageDataLayer'
}
...

const Home = () => {
...
TagManager.dataLayer(tagManagerArgs)
...

return (


`

Events

$3

`js
import React from 'react'
import ReactDOM from 'react-dom'
import Router from 'react-router'
import routes from './routes'

...
import TagManager from 'react-server-side-gtm'

const tagManagerArgs = {
gtmId: 'GTM-000000',
events: {
sendUserInfo: 'userInfo'
}
}

TagManager.initialize(tagManagerArgs)
...

const app = document.getElementById('app')
ReactDOM.render(, app)
`

Custom GTM Server Side Container

Configure how Tag Manager will works between development and production server environments.

$3

`js
import React from 'react'
import ReactDOM from 'react-dom'
import Router from 'react-router'
import routes from './routes'

...
import TagManager from 'react-server-side-gtm'

const tagManagerArgs = {
gtmId: 'GTM-000000',
src: 'your-custom-gtm-tagging-server.com
}

TagManager.initialize(tagManagerArgs)

`

Environments

Configure how Tag Manager will works between development and production server environments.

$3

`js
import React from 'react'
import ReactDOM from 'react-dom'
import Router from 'react-router'
import routes from './routes'

...
import TagManager from 'react-server-side-gtm'

const tagManagerArgs = {
gtmId: 'GTM-000000',
auth: '6sBOnZx1hqPcO01xPOytLK',
preview: 'env-2'
}

TagManager.initialize(tagManagerArgs)

`

##### How can I find auth and preview?
Go to Google Tag Manager -> ADMIN -> Environments -> Actions -> Get Snippet.
Look for gtm_auth and gtm_preview

##### Don't know to use GTM environments?
- https://support.google.com/tagmanager/answer/6311518
- https://www.simoahava.com/analytics/better-qa-with-google-tag-manager-environments/

|Value|Type|Required|Notes|
|------|-----|-----|-----|
|gtmId| String| Yes | GTM id, must be something like GTM-000000.|
|dataLayer| Object| No | Object that contains all of the information that you want to pass to Google Tag Manager.|
|dataLayerName| String| No | Custom name for dataLayer object.|
|events| Object| No | Additional events such as 'gtm.start': new Date().getTime(),event:'gtm.js'.|
|auth| String | No | used to set environments. |
|preview| String | No | used to set environments, something like env-00`. |

$3

- Disabling javascript in the browser can prevent the correct operation of this library if React is only being rendered on the client side.

- Before implementing GTM in your application ensure that you have at least one published container, otherwise Google Tag Manager snippet will return 404.