mp-cordova-plugin-google-analytics

    0.8.0 • Public • Published

    google-analytics-plugin

    Cordova (PhoneGap) 3.0+ Plugin to connect to Google's native Universal Analytics SDK 3.0

    Prerequisites:

    • A Cordova 3.0+ project for iOS and/or Android
    • A Mobile App property through the Google Analytics Admin Console

    Installing

    This plugin follows the Cordova 3.0+ plugin spec, so it can be installed through the Cordova CLI in your existing Cordova project:

    cordova plugin add https://github.com/Code1Tech/google-analytics-plugin.git

    This plugin is also available on npm if you are using Cordova 5.0+:

    cordova plugin add mp-cordova-plugin-google-analytics

    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 to use an earlier version while the fix is researched via:

    cordova plugin add mp-cordova-plugin-google-analytics@0.7.1

    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

    JavaScript Usage

    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 property

    To 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 numeric

    To track an Exception:

    • window.analytics.trackException('Description', Fatal) where Fatal is boolean

    To track User Timing (App Speed):

    • window.analytics.trackTiming('Category', IntervalInMilliseconds, 'Variable', 'Label') where IntervalInMilliseconds is numeric

    To add a Transaction (Ecommerce)

    • window.analytics.addTransaction('ID', 'Affiliation', Revenue, Tax, Shipping, 'Currency Code') where Revenue, Tax, and Shipping are numeric

    To add a Transaction Item (Ecommerce)

    • window.analytics.addTransactionItem('ID', 'Name', 'SKU', 'Category', Price, Quantity, 'Currency Code') where Price and Quantity are numeric

    To 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()

    Installing Without the CLI

    Copy the files manually into your project and add the following to your config.xml files:

    <feature name="UniversalAnalytics">
      <param name="ios-package" value="UniversalAnalyticsPlugin" />
    </feature>
    <feature name="UniversalAnalytics">
      <param name="android-package" value="com.danielcwilson.plugins.analytics.UniversalAnalyticsPlugin" />
    </feature>

    You also will need to manually add the Google Analytics SDK files:

    • Download the Google Analytics SDK 3.0 for iOS and/or Android
    • For iOS, add the downloaded Google Analytics SDK header files and libraries according to the Getting Started documentation
    • For Android, add libGoogleAnalyticsServices.jar to your Cordova Android project's /libs directory and build path

    Integrating with Lavaca

    The 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.

    • Copy AnalyticsService.js to your Lavaca project (I create a directory under js/app called data).
    • In your config files (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.
    • In any file you want to track screen views or events, require AnalyticsService and use the methods provided.
    var analyticsService = require('app/data/AnalyticsService');
     
    analyticsService.trackView('Home');

    Install

    npm i mp-cordova-plugin-google-analytics

    DownloadsWeekly Downloads

    1

    Version

    0.8.0

    License

    MIT

    Last publish

    Collaborators

    • jwebcat
    • nvisionweb