Monaca Docs
Search
K
Comment on page

Cordova Google Analytics Plugin

This Cordova plugin is used to connect to Google's native Universal Analytics SDK.
To check the third party Cordova plugins, you need to create a custom build debugger (Android version or iOS version).

Demo

Enable the plugin in the Monaca IDE

  1. 1.
    From the IDE menu, go to Config → Manage Cordova Plugins .
  2. 2.
    Click the Import Cordova Plugin button. Then, you can choose to import the plugin using a ZIP file or a URL/package name.

Usage

After importing the plugin to your project, you can start by initializing your tracking ID. Make sure to call the plugin API after the Cordova is loaded.
//Replace your app tracking id here
var trackingID="YOUR_APP_TRACKING_ID";
document.addEventListener("deviceready", onDeviceReady, false);
function onDeviceReady(){
console.log('Google analytics is ready now');
window.ga.startTrackerWithId(trackingID);
}

API references

This section describes some of the main functions used in our demo. For complete API references, please refer to the repository.

startTrackerWithId()

Sets up the analytics tracker.
window.ga.startTrackerWithId(trackingId, [interval]);
Parameter
Name
Type
Description
trackingId
String
Your Google Analytics mobile app property
interval
Number
[optional] The dispatch period in seconds (default: 30)
Return Value
  • Promise
Example
window.ga.startTrackerWithId('UA-XXXX-YY', 30);

trackView()

Tracks the screen.
window.ga.trackView(title, campaignUrl, [newSession]);
Parameter
Name
Type
Description
title
String
Screen title
campaignUrl
String
Campaign url for measuring referrals
newSession
Boolean
[optional] Set to true to create a new session
Return Value
  • Promise
Example
//To track a Screen (PageView):
window.ga.trackView('Screen Title')
//To track a Screen (PageView) w/ campaign details:
window.ga.trackView('Screen Title', 'my-scheme://content/1111?utm_source=google&utm_campaign=my-campaign')
//To track a Screen (PageView) and create a new session:
window.ga.trackView('Screen Title', '', true)

trackEvent()

Tracks an event.
window.ga.trackEvent(category, action, [label], [value], [newSession])
Parameter
Name
Type
Description
category
String
Event category (e.g. 'Video')
action
String
Action type (e.g. 'play')
label
String
[optional] Event label (e.g. 'Fall Campaign')
value
Number
[optional] A numeric value associated with the event (e.g. 42)
newSession
Boolean
[optional] Set to true to create a new session
Return Value
  • Promise
Example
//To track an Event
window.ga.trackEvent('Videos', 'play', 'Fall Campaign', 42)
//To track an Event and create a new session:
window.ga.trackEvent('Videos', 'play', 'Fall Campaign', 42, true)

setUserId()

Sets a user id.
window.ga.setUserId(id);
Parameter
Name
Type
Description
id
String
A unique identifier, associated with a particular user, must be sent with every hit
Return Value
  • Promise
Example
//user ID for testing purpose
var myUserId="35009a79-1a05-49d7-b876-2b884d0f825b";
window.ga.setUserId(myUserId);

setAppVersion()

Sets a specific app version.
window.ga.setAppVersion(appVersion)
Parameter
Name
Type
Description
appVersion
String
App version
Return Value
  • Promise
Example
window.ga.setAppVersion('1.33.7');

debugMode()

Enables verbose logging.
window.ga.debugMode()
Return Value
  • Promise
Example
window.ga.debugMode();