Google analytics
Note: This package has moved to @analytics/google-analytics
This library exports the google-analytics
plugin for the analytics
package & standalone methods for any project to use to make it easier to interact with Google Analytics.
For more information see the docs.
Install
npm install analyticsnpm install @analytics/google-analytics
Usage
Import analytics and use the google analytics plugin.
Set the trackingId
of your site.
const analytics = /* Track a page view */analytics /* Track a custom event */analytics /* Identify a visitor */analytics
After initializing analytics
with your Google Analytics trackingId, data will be sent into google analytics whenever analytics.page
, analytics.track
, or analytics.identify
are called.
Sending additional event fields
To send tracking custom events to Google Analytics with eventLabel
, eventCategory
, and eventValue
fields, add the label
, category
, and value
keys to the event properties.
analytics
Standalone Usage
This package exports Google Analytics helper methods for any project to use.
Note: We recommend using the
default
plugin export from this package alongside theanalytics
package.
The standalone methods below will send data to Google Analytics but are not attached to the analytics plugin lifecycle.
Use analytics
+ @analytics/google-analytics
packages together as described above to enable these features:
- automatic library initialization
- offline retries
- middleware functionality
- callbacks
- listeners
- etc.
Install
Using standalone
npm install @analytics/google-analytics
Import and use standalone functions
When using standalone
mode, you will need to initialize the provider javascript and pass in all the fields needed by said provider.
// Stand alone functionality // Load Google Analytics on page // Track page view // Track custom event // Identify the visitor
Platforms Supported
Browser and Node.js
Browser Methods
page
, track
, identify
Node.js Methods
page
, track
, identify