testpilot-ga
A library for event-driven data collection with Google Analytics for Firefox Test Pilot experiments. Aims to follow Test Pilot standards for reporting, automatically respects Do Not Track settings.
Table of contents
Usage
-
Add the
testpilot-ga
package using your package manager:npm install --save testpilot-ga
or
yarn add testpilot-ga
-
Import and create a singleton instance of the
TestPilotGA
class exported bytestpilot-ga
:;const analytics =aid: 'test-experiment@mozilla.com'an: 'Test Experiment'av: '1.0.0'cd19: 'production'ds: 'addon'tid: 'UA-71632928-4'; -
Use that instance to send events to Google Analytics:
analytics;Which produces this request:
POST /collect HTTP/1.1 Host: www.google-analytics.com v=1&t=event&tid=UA-71632928-4&cid=00a9e969-362b-4cee-b707-c63e17a4e71a&an=Test%20Experi ment&aid=test-experiment%40mozilla.com&aiid=testpilot&aip=1&av=1.0.0&ds=addon&ua=Mozill a%2F5.0%20(Macintosh%3B%20Intel%20Mac%20OS%20X%2010_12_5)%20AppleWebKit%2F537.36%20(KHT ML%2C%20like%20Gecko)%20Chrome%2F59.0.3071.115%20Safari%2F537.36&ul=en-US&z=15004209550 09&ec=catname&ea=eventname&cd1=cd1val1&cm1=cm1val1&cd19=production&cd20=release
More information
- IRC: #testpilot on irc.mozilla.org