angular-google-tag-manager-sham
v18.0.4
Published
A service library for integrate google tag manager in your angular project
Downloads
332
Readme
Angular Google Tag Manager Service
A service library for integrate google tag manager in your angular project This library was generated with Angular CLI For more info see this how to install google tag manager article
Getting Started
After installing it you need to provide your GTM id in app.module.ts
providers: [
...
{provide: 'googleTagManagerId', useValue: YOUR_GTM_ID}
],
Or use the module's forRoot
method
import { GoogleTagManagerModule } from 'angular-google-tag-manager';
imports: [
...
GoogleTagManagerModule.forRoot({
id: YOUR_GTM_ID,
})
]
Or use the APP_INITIALIZER
import { GoogleTagManagerConfiguration } from 'angular-google-tag-manager-config.service';
imports: [
...
GoogleTagManagerModule.forRoot()
]
providers: [
{
...
provide: APP_INITIALIZER,
useFactory: configInitializer,
deps: [
HttpBackend,
GoogleTagManagerConfiguration,
],
multi: true,
},
],
set the config in the method assigned to useFactory
googleTagManagerConfiguration.set(googleTagManagerConfiguration);
inject the gtmService in your controller
constructor(
...
private gtmService: GoogleTagManagerService,
) { }
then you can start pushing events on your gtm
this.router.events.forEach(item => {
if (item instanceof NavigationEnd) {
const gtmTag = {
event: 'page',
pageName: item.url
};
this.gtmService.pushTag(gtmTag);
}
});
if you want to recive tags without pushing events simply call the function to enable it
this.gtmService.addGtmToDom();
Installing
In your Angular project run
npm i --save angular-google-tag-manager
Custom configuration and GTM environments
You can pass gtm_preview and gtm_auth optional variables to your GTM by providing them in app.module.ts
In case you'll need to fetch your gtm.js resource trough a first party proxy ( so to bypass any ad-blocker interference in on the client browser ) you can use the gtm_resource_path parameter. In that case the resource will be fetched from the specified path instead that from 'https://www.googletagmanager.com/gtm.js' (all of the other queryparams will be mantained)
providers: [
...
{provide: 'googleTagManagerId', useValue: YOUR_GTM_ID},
{provide: 'googleTagManagerAuth', useValue: YOUR_GTM_AUTH},
{provide: 'googleTagManagerPreview', useValue: YOUR_GTM_ENV},
{provide: 'googleTagManagerResourcePath', useValue: YOUR_GTM_RESOURCE_PATH}
],
Or using forRoot
import { GoogleTagManagerModule } from 'angular-google-tag-manager';
imports: [
...
GoogleTagManagerModule.forRoot({
id: YOUR_GTM_ID,
gtm_auth: YOUR_GTM_AUTH,
gtm_preview: YOUR_GTM_ENV,
gtm_resource_path: YOUR_GTM_RESOURCE_PATH
})
]
Authors
- Marco Zuccaroli - Initial work - Marco Zuccaroli
See also the list of contributors who participated in this project.
License
This project is licensed under the MIT License
Acknowledgments
- Thanks to PurpleBooth for the Readme Template