Complete Google Analytics, Mixpanel, KISSmetrics (and more) integration for Meteor
OK GROW! analytics uses a combination of the browser History API, Meteor's accounts package and Segment.io's analytics.js to automatically record and send user identity and page view event data from your Meteor app to your analytics platforms.
- Background
- Install
- Usage
- Debugging
- Example React, Flow and Iron Router Apps
- Maintainers
- Contributing
- License
In version 3.X of this package, the automatic page view tracking is handled by our new router-agnostic @okgrow/auto-analytics NPM package, which can be used by any JavaScript application whether using Meteor or not. This package adds automatic user identification by using hooks in the Meteor accounts package and building on Segment.io's analytics package through the @okgrow/auto-analytics package.
Our Analytics package has been rewritten to be router agnostic. You should be able to use this package with any router that you use with Meteor app. We have tested and used our Analytics package with iron-router, flow-router, and react-router. You can view and test this out in our iron-router, flow-router and react-router example apps located in the examples folder.
NOTE: A fundamental change that may affect some applications is that we no longer look for or use the router's route name when logging page views. Instead we use document.title. This may affect applications that do not change or set their document.title for each screen or page of their application. The simplest solution is to simply set document title like this document.title = "My new title"; for each screen or page in your application. If you are using flow router or iron router you can remain at okgrow:analytics@2.0.1 to keep using the name of the route for your analytic events.
For Meteor Apps older than v1.3.1, please use v1.0.9 of this package. Going forward this package will officially only be supporting Meteor Apps >= v1.3.1
In your Meteor project folder, run:
meteor add okgrow:analyticsThis package will automatically configure the underlying @okgrow/auto-analytics package using Meteor.settings.public.analyticsSettings. In Meteor you typically specify your settings using a settings.json file:
{
"public": {
"analyticsSettings": {
// Add your analytics tracking ids here (remove this line before running)
"Google Analytics" : {"trackingId": "Your tracking ID"},
"Amplitude" : {"apiKey": "..."},
"Chartbeat" : {"uid": "..."},
"comScore" : {"c2": "..."},
"HubSpot" : {"portalId": "..."},
"Intercom" : {"appId": "..."},
"Keen IO" : {"projectId": "...", "writeKey": "..."},
"KISSmetrics" : {"apiKey": "..."},
"Mixpanel" : {"token": "...", "people": true},
"Quantcast" : {"pCode": "..."},
"Segment.io" : {"apiKey": "..."}
}
}
}And run your app with that settings file as follows:
meteor --settings settings.json
See the @okgrow/auto-analytics package for more details on configuration.
See the @okgrow/auto-analytics package for up-to-date details of supported analytics services.
See the @okgrow/auto-analytics package for details on page view tracking. In short, that package uses the browser History API to automatically track page views.
Since the History API is used to automatically track page views, document.title is used instead of the router's route name as the default page name.
If you rely on your router's route name for the page name in page view events, you can easily set document.title programming using the router's route name. Here are examples of how to do this with React Router, Flow Router and Iron Router:
This package is router agnostic. It will work with any router, and by default it uses the document.title as the page name for reporting to your analytics service.
In your router setup, add a name property to your routes:
<Router history={ browserHistory }>
<Route path="/" name="Home" component={ App } />
<Route path="/one" name="One" component={ App } />
<Route path="/two" name="Two" component={ App } />
<Route path="/three" name="Three" component={ App } />
</Router>NOTE The current route is passed in as a property named route to your component.
Then, in the render() function of your main layout component, using a package like react-document-title:
render() {
return (
<DocumentTitle title={this.props.route.name}>
...
</DocumentTitle>
);
}Template.mainLayout.onRendered(function() {
Tracker.autorun(() => {
document.title = FlowRouter.getRouteName();
});
});Template.mainLayout.onRendered(function() {
Tracker.autorun(() => {
document.title = Router.current().route.getName();
});
});To disable automatic page view tracking change Meteor.settings as shown below then manually log a page view by calling analytics.page('page name'):
{
"public": {
"analyticsSettings": {
// Disable autorun if you do not want analytics running on every route (remove this line before running)
"autorun" : false
}
}
}If you have the accounts package installed, this package will automatically track when a user logs in and logs out. Logging in will call identify on the user and associate their Meteor.userId to their previous anonymous activities.
See the @okgrow/auto-analytics package for details on event tracking. In short, track any event by calling the analytics.track() function:
analytics.track("Bought Ticket", {
eventName: "Wine Tasting",
couponValue: 50,
});Josh Owens' article, Google Analytics events, goals, and Meteor.js, goes over a great way to capture how far a visitor has scrolled down a page.
If your project uses the Browser Policy package, we've included the Google Analytics and MixPanel domains in our browser policy configuration. Any additional services you add will need to be added to your browser policy config as well.
BrowserPolicy.content.allowOriginForAll("www.google-analytics.com");
BrowserPolicy.content.allowOriginForAll("cdn.mxpnl.com");If your project doesn't use the Browser Policy package, don't worry, it won't affect your usage.
To log package activity to the console for debugging purposes, turn on debugging in the console:
> analytics.debug()
Turn debug logging off with:
> analytics.debug(false)
If your app is running on Android devices you will probably have to add the cordova-plugin-whitelist package and set access rules in your mobile-config.js for all URLs of the platforms that you are using.
Example for Intercom:
App.accessRule('https://js.intercomcdn.com/*');
App.accessRule('https://static.intercomcdn.com/*');
App.accessRule('https://api-iam.intercom.io/*');
App.accessRule('https://widget.intercom.io/*');
App.accessRule('https://nexus-websocket-a.intercom.io/*');
App.accessRule('https://nexus-websocket-b.intercom.io/*');
To find all the necessary URLs for your project, build your production app and install it on your Android device. Then connect it via USB and open the Android Studio Device Monitor (Tools >> Android Device Monitor >> LogCat). Perform a relevant action and then search for "whitelist". It should a show message for each URL that was blocked.
When running your Meteor app in "development mode" ad-blocking web-browser extensions may block the okgrow:analytics package due to the word "analytics" in the package name. This only occurs when running Meteor in "development mode" because files are not bundled together and minified. To work around this issue you can disable your ad-blocker when running in development mode.
To test that application with an ad-blocker, run your Meteor app in production mode with this command:
meteor run --production --settings settings.json
NOTE If an ad-blocker is enabled the expected behavior is that analytic events will not be received. You'll see an error message in your console reporting the events being blocked.
While page view event tracking is router agnostic, the examples directory contains example apps using the three most common routers used in Meteor apps: React Router, Flow Router and Iron Router. These apps can be run from within their respective directories with:
meteor npm startThis is an open source package. We hope to deal with contributions in a timely manner, but that's not always the case. The main maintainers are:
Feel free to ping if there are open issues or pull requests which are taking a while to be dealt with!
Issues and Pull Requests are always welcome.
Please read our contribution guidelines.
If you are interested in becoming a maintainer, get in touch with us by sending an email or opening an issue. You should already have code merged into the project. Active contributors are encouraged to get in touch.
Please note that all interactions in @okgrow's repos should follow our Code of Conduct.
Released under the MIT license © 2015-2017 OK GROW!.