Miss any of our Open RFC calls?Watch the recordings here! »

ng2-google-analytics

1.0.3 • Public • Published

Ng2GoogleAnalytics

Add Google Analytics to your Angular2+ or Ionic2+ projects

version 1.0.3 Tested on Angular 6+

For Angular 2 - 5 projects use version 0.2.0

Read my article: Enable Google Analytics in Angular2+ Projects

Features:

  1. Easy installation
  2. Angular 2+ and Ionic 2+ compatible
  3. Track traditional Ionic 2 Pages with no URL Change (use setPage(pageName) function )
  4. Track Custom Events with trackEvent function
  5. Add multiple tracker IDs

steps to integrate

Add Ng2GoogleAnalytics in app.module.ts

imports: [
   ...,
   ...,
   Ng2GoogleAnalyticsModule
  ],

initialize Ng2GoogleAnalytics

// add Ng2GoogleAnalyticsService in app.component.ts
import {Ng2GoogleAnalyticsService} from 'ng2-google-analytics';
 
// add in constructor
constructor(
    public ga: Ng2GoogleAnalyticsService
    ...
  ) {
    //initialize service with your GA Token
    ga.initialize('UA-XXXXXXX-1');
 
  }

call setPage(pageName) function to track pages

// add in constructor
constructor(
    public ga: Ng2GoogleAnalyticsService
    ...
  ) {
  }
 
 ngOnInit() {
   this.ga.setPage('register.html');
 }

call trackEvent() or trackEventV2() function to track events

    this.ga.trackEvent('Register', 'Submit');
 
    // or call trackEvent2 which takes first param as object
    this.ga.trackEventV2({
      eventCategory: 'Register', 
      eventAction: 'Submit', 
    });
    
    // or call like this 
    this.ga.trackEventV2({
      eventCategory: 'Register', 
      eventAction: 'Submit', 
      eventLabel: 'Register Button',
      eventValue: 1
    });
 

Additional Features

to disable GA while development

send second parameter of initialize function to false. It may be driven from environment.ts file. See https://angular.io/guide/build#configuring-application-environments

    ga.initialize('UA-XXXXXXX-1', environment.production);

set additional tracker ID

Sometimes you need to set more than one tracking ID with your project. This can be done with setAdditionalTraker function. See https://developers.google.com/analytics/devguides/collection/analyticsjs/creating-trackers#working_with_multiple_trackers

  //call this function to set additional tracker
  this.ga.setAdditionalTraker('UA-XXXXXX-2', 'myCustomTrackerName')
 
  // if you want to send page to different tacking id
  this.ga.setPage('register.html', 'myCustomTrackingName');
 
  //if you want to send event to different tacking id
  this.ga.trackEventV2({
    eventCategory: 'Register', 
    eventAction: 'Submit', 
    eventLabel: 'Register Button',
    eventValue: 1
  }, 'myCustomTrackingName');

set additional tracker ID

Set auto tracking of pages This can be done with setAutoMode function.

  //call this function in app.component.ts
  //right after initialize function.
  ga.setAutoMode();

Tested on Angular 7

Install

npm i ng2-google-analytics

DownloadsWeekly Downloads

1

Version

1.0.3

License

MIT

Unpacked Size

129 kB

Total Files

23

Last publish

Collaborators

  • avatar