angular-ga

Google Analytics for your Angular application

Install

$ npm install --save angular-ga

Usage

Configuration

The Google Analytics tracking script is not included in this module. Make sure to add it to your page.

import{BrowserModule}from'@angular/platform-browser';import{NgModule}from'@angular/core';import{GoogleAnalyticsModule,GA_TOKEN}from'angular-ga';import{AppComponent}from'./app.component';
@NgModule({imports: [BrowserModule,GoogleAnalyticsModule.forRoot()],declarations: [AppComponent],bootstrap: [AppComponent],providers: [{provide: GA_TOKEN,useValue: 'UA-TOKEN-1'}]})exportclassAppModule{}

It's also possible to leave the configuration empty and configure the library later on through the service.

@NgModule({imports: [BrowserModule,GoogleAnalyticsModule.forRoot()],declarations: [AppComponent],bootstrap: [AppComponent]})exportclassAppModule{}

Service

Inject the GoogleAnalyticsService into your components or services.

import{Component,OnInit}from'@angular/core';import{GoogleAnalyticsService}from'angular-ga';
@Component({templateUrl: 'app.component.html'})exportclassAppComponentimplementsOnInit{constructor(privategaService: GoogleAnalyticsService){}ngOnInit(){this.gaService.event.emit({category: 'app',action: 'bootstrap'});}}

Configuration

import{Component,OnInit}from'@angular/core';import{GoogleAnalyticsService}from'angular-ga';
@Component({templateUrl: 'app.component.html'})exportclassAppComponentimplementsOnInit{constructor(privategaService: GoogleAnalyticsService){}ngOnInit(){this.gaService.configure('UA-TOKEN-1');}}

Service

API

service.configure(trackingId, [options])

trackingId

Type: string

Tracking Id.

options

Type: Objectstring
Default: auto

Any of the Create Only Fields.

service.event.emit(event: Event)

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)

service.pageview.emit(pageview: PageView)

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

The title of the page (e.g. homepage)

License

MIT © Sam Verschueren