Google Analytics for your Angular application
npm install googleanalytics-angular
$ npm install --save googleanalytics-angular
`
Usage
$3
The Google Analytics tracking script is not included in this module. Make sure to add it to your page.
`js
import { BrowserModule } from '@angular/platform-browser';
import { NgModule } from '@angular/core';
import { GoogleAnalyticsModule, GA_TOKEN } from 'googleanalytics-angular';
import { AppComponent } from './app.component';
@NgModule({
imports: [
BrowserModule,
GoogleAnalyticsModule.forRoot()
],
declarations: [
AppComponent
],
bootstrap: [AppComponent],
providers: [
{ provide: GA_TOKEN, useValue: 'UA-TOKEN-1' }
]
})
export class AppModule { }
`
It's also possible to leave the configuration empty and configure the library later on through the service.
`js
@NgModule({
imports: [
BrowserModule,
GoogleAnalyticsModule.forRoot()
],
declarations: [
AppComponent
],
bootstrap: [AppComponent]
})
export class AppModule { }
`
$3
Inject the GoogleAnalyticsService into your components or services.
`js
import { Component, OnInit } from '@angular/core';
import { GoogleAnalyticsService } from 'googleanalytics-angular';
@Component({
templateUrl: 'app.component.html'
})
export class AppComponent implements OnInit {
constructor(
private gaService: GoogleAnalyticsService
) { }
ngOnInit() {
this.gaService.event.emit({
category: 'app',
action: 'bootstrap'
});
}
}
`
#### Configuration
`js
import { Component, OnInit } from '@angular/core';
import { GoogleAnalyticsService } from 'googleanalytics-angular';
@Component({
templateUrl: 'app.component.html'
})
export class AppComponent implements OnInit {
constructor(
private gaService: GoogleAnalyticsService
) { }
ngOnInit() {
this.gaService.configure('UA-TOKEN-1');
}
}
`
#### Named Tracker
More information about named trackers can be found here.
`js
import { Component, OnInit } from '@angular/core';
import { GoogleAnalyticsService } from 'googleanalytics-angular';
@Component({
templateUrl: 'app.component.html'
})
export class AppComponent implements OnInit {
constructor(
private gaService: GoogleAnalyticsService
) { }
ngOnInit() {
var options = {
clientId: 'clientId',
cookieDomain: 'auto',
name: 'trackerName',
namedTracker: true
}
this.gaService.configure('UA-TOKEN-1', options);
}
}
`
API
$3
#### trackingId
Type: string
Tracking Id.
#### options
Type: Object string
Default: auto
Any of the Create Only Fields.
The ability to send to named tracker with option namedTracker
Type: boolean
Default: false
$3
Emit a Google Analytics event.
#### event
##### category
Type: string
Typically the object that was interacted with (e.g. Video)
##### action
Type: string
The type of interaction (e.g. play)
##### label
Optional
Type: string
Useful for categorizing events (e.g. Fall Campaign)
##### value
Optional
Type: number
A numeric value associated with the event (e.g. 42)
$3
Emit a Google Analytics page view.
#### pageview
##### page
Type: string
The path portion of a URL. This value should start with a slash (/) character.
##### title
Optional
Type: string`