Google Analytics

Improve this doc

This plugin connects to Google's native Universal Analytics SDK Prerequisites:

• A Cordova 3.0+ project for iOS and/or Android
• A Mobile App property through the Google Analytics Admin Console
• (Android) Google Play Services SDK installed via Android SDK Manager

Repo: https://github.com/danwilson/google-analytics-plugin

Installation

1. Install the Cordova and Ionic Native plugins:
   

   $ ionic cordova plugin add cordova-plugin-google-analytics
   $ npm install --save @ionic-native/google-analytics@4
   

2. Add this plugin to your app's module

Supported platforms

• Android
• Browser
• iOS
• Windows Phone 8

Usage

import { GoogleAnalytics } from '@ionic-native/google-analytics';

constructor(private ga: GoogleAnalytics) { }

...

this.ga.startTrackerWithId('YOUR_TRACKER_ID')
   .then(() => {
     console.log('Google analytics is ready now');
      this.ga.trackView('test');
     // Tracker is ready
     // You can now track pages or set additional information such as AppVersion or UserId
   })
   .catch(e => console.log('Error starting GoogleAnalytics', e));

Instance Members

startTrackerWithId(id, interval)

In your ‘deviceready’ handler, set up your Analytics tracker. https://developers.google.com/analytics/devguides/collection/analyticsjs/

setAllowIDFACollection(allow)

Enabling Advertising Features in Google Analytics allows you to take advantage of Remarketing, Demographics & Interests reports, and more

setUserId(id)

Set a UserId https://developers.google.com/analytics/devguides/collection/analyticsjs/user-id

setAnonymizeIp(anonymize)

Set a anonymize Ip address

setAppVersion(appVersion)

Set the app version

getVar(key)

Get a variable

setVar(key, value)

Set a variable

setOptOut(optout)

Set OptOut

debugMode()

Enable verbose logging

trackMetric(key, value)

Track custom metric

trackView(title, campaignUrl, newSession)

Track a screen https://developers.google.com/analytics/devguides/collection/analyticsjs/screens

addCustomDimension(key, value)

Add a Custom Dimension https://developers.google.com/analytics/devguides/platform/customdimsmets

trackEvent(category, action, label, value, newSession)

Track an event https://developers.google.com/analytics/devguides/collection/analyticsjs/events

trackException(description, fatal)

Track an exception

trackTiming(category, intervalInMilliseconds, variable, label)

Track User Timing (App Speed)

addTransaction(id, affiliation, revenue, tax, shipping, currencyCode)

Add a Transaction (Ecommerce) https://developers.google.com/analytics/devguides/collection/analyticsjs/ecommerce#addTrans

addTransactionItem(id, name, sku, category, price, quantity, currencyCode)

Add a Transaction Item (Ecommerce) https://developers.google.com/analytics/devguides/collection/analyticsjs/ecommerce#addItem

enableUncaughtExceptionReporting(shouldEnable)

Enable/disable automatic reporting of uncaught exceptions

dispatch()

Platforms:Android iOS Windows 

Manually dispatch any data