Node's Pretty Magical


    1.4.0 • Public • Published


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


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


    cordova plugin add cordova-plugin-ga

    The plugin.xml file will add the Google Analytics SDK files for Android and/or iOS. Make sure to review the Google Analytics terms and SDK Policy

    JavaScript Usage

    In your 'deviceready' handler, set up your Analytics tracker:

    •'UA-XXXX-YY') where UA-XXXX-YY is your Google Analytics Mobile App property

    To track a Screen (PageView):

    •'Screen Title')

    To track a Screen (PageView) w/ campaign details:

    •'Screen Title', 'my-scheme://content/1111?utm_source=google&utm_campaign=my-campaign')

    To track a Screen (PageView) and create a new session:

    •'Screen Title', '', true)

    To track an Event:

    •'Category', 'Action', 'Label', Value) Label and Value are optional, Value is numeric

    To track custom metrics:

    •'key', Value) Value is optional

    To track an Exception:

    •'Description', Fatal) where Fatal is boolean

    To track User Timing (App Speed):

    •'Category', IntervalInMilliseconds, 'Variable', 'Label') where IntervalInMilliseconds is numeric

    To add a Transaction (Ecommerce)

    •'ID', 'Affiliation', Revenue, Tax, Shipping, 'Currency Code') where Revenue, Tax, and Shipping are numeric

    To add a Transaction Item (Ecommerce)

    •'ID', 'Name', 'SKU', 'Category', Price, Quantity, 'Currency Code') where Price and Quantity are numeric

    To add a Custom Dimension

    •'Key', 'Value', success, error)
    • Key should be integer index of the dimension i.e. send 1 instead of dimension1 for the first custom dimension you are tracking.
    • e.g., 'Value', success, error)

    To set a UserId:


    To set a specific app version:


    To set a anonymize Ip address:


    To set Opt-out:


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


    To enable verbose logging:


    To enable/disable automatic reporting of uncaught exceptions

    •, success, error) where Enable is boolean

    Why fork

    This is a fork of cordova-plugin-google-analytics, which was not active maintained before. Since the project is more active, this fork is less relevant now.

    Difference from upstream

    • Remove
    • Export window.GA, but the newly added is recommended.


    npm i cordova-plugin-ga

    DownloadsWeekly Downloads






    Last publish


    • ratson