Name: google-analytics-plugin
Owner: Makina Corpus
Description: Old plugin version with removed dependancy for compatibility
Created: 2015-11-30 16:39:44.0
Updated: 2015-11-30 16:47:25.0
Pushed: 2015-11-30 17:06:47.0
Homepage: null
Size: 32867
Language: Objective-C
GitHub Committers
User | Most Recent Commit | # Commits |
---|
Other Committers
User | Most Recent Commit | # Commits |
---|
Cordova (PhoneGap) 3.0+ Plugin to connect to Google's native Universal Analytics SDK
Prerequisites:
This plugin follows the Cordova 3.0+ plugin spec, so it can be installed through the Cordova CLI in your existing Cordova project:
ova plugin add https://github.com/danwilson/google-analytics-plugin.git
This plugin is also available on npm if you are using Cordova 5.0+:
ova plugin add cordova-plugin-google-analytics
… OR the Cordova Plugin Registry if you are using a version of Cordova before 5.0 (while it remains open, as it is planning to shut down soon due to the move to npm):
ova plugin add com.danielcwilson.plugins.googleanalytics
Important Note If the latest versions (0.8.0+) of this plugin are not working for you with Android on Cordova 5.0+, please try the suggestions in Issues 123. Google Play Services has been very confusing to integrate, but in recent months it has been simplified. This plugin uses the new simpler way (including it as a framework instead of bundling it which can conflict with other plugins bundling it), but if you previously installed this plugin some old files might still be lingering.
The plugin.xml file will add the Google Analytics SDK files for Android and/or iOS. Follow Google's steps if you need to update these later. Also make sure to review the Google Analytics terms and SDK Policy
If you are not using the CLI, follow the steps in the section Installing Without the CLI
In your 'deviceready' handler, set up your Analytics tracker:
window.analytics.startTrackerWithId('UA-XXXX-YY')
where UA-XXXX-YY is your Google Analytics Mobile App propertyTo track a Screen (PageView):
window.analytics.trackView('Screen Title')
To track an Event:
window.analytics.trackEvent('Category', 'Action', 'Label', Value)
Label and Value are optional, Value is numericTo track an Exception:
window.analytics.trackException('Description', Fatal)
where Fatal is booleanTo track User Timing (App Speed):
window.analytics.trackTiming('Category', IntervalInMilliseconds, 'Variable', 'Label')
where IntervalInMilliseconds is numericTo add a Transaction (Ecommerce)
window.analytics.addTransaction('ID', 'Affiliation', Revenue, Tax, Shipping, 'Currency Code')
where Revenue, Tax, and Shipping are numericTo add a Transaction Item (Ecommerce)
window.analytics.addTransactionItem('ID', 'Name', 'SKU', 'Category', Price, Quantity, 'Currency Code')
where Price and Quantity are numericTo add a Custom Dimension
window.analytics.addCustomDimension('Key', 'Value', success, error)
To set a UserId:
window.analytics.setUserId('my-user-id')
To enable verbose logging:
window.analytics.debugMode()
To enable/disable automatic reporting of uncaught exceptions
window.analytics.enableUncaughtExceptionReporting(Enable, success, error)
where Enable is booleanCopy the files manually into your project and add the following to your config.xml files:
ture name="UniversalAnalytics">
aram name="ios-package" value="UniversalAnalyticsPlugin" />
ature>
ture name="UniversalAnalytics">
aram name="android-package" value="com.danielcwilson.plugins.analytics.UniversalAnalyticsPlugin" />
ature>
You also will need to manually add the Google Analytics SDK files:
libGoogleAnalyticsServices.jar
to your Cordova Android project's /libs
directory and build pathThe lavaca
directory includes a component that can be added to a Lavaca project. It offers a way to use the web analytics.js
when the app is running in the browser and not packaged as Cordova.
AnalyticsService.js
to your Lavaca project (I create a directory under js/app
called data
).local.json
, staging.json
, production.js
) create properties called google_analytics_id
(for the Mobile App UA property) and google_analytics_web_id
(for the Web UA property) and set the appropriate IDs or leave blank as needed.analyticsService = require('app/data/AnalyticsService');
yticsService.trackView('Home');