Forwards analytics events and identification to various marketing & analytics platforms.
You can send events to Forwardlytics, and it will forward it to the configured services like Intercom or Drip.
Looking for a Forwardlytics client library? There is one for Ruby just here.
Where are we at? Can you use it in production?
[DEPRECATED] This project is not maintained anymore nor used by the original author.
-
go get github.com/jipiboily/forwardlytics -
set
FORWARDLYTICS_API_KEY=SOMETHING_YOU_DECIDE_AND_NO_ONE_CAN_GUESS
To send to Intercom:
- set
INTERCOM_APP_ID=456
To send to Drip:
- set
DRIP_ACCOUNT_ID=234(when you log in Drip, you see it in the URL here: https://www.getdrip.com/{drip_account_id}/dashboard) - set
DRIP_API_TOKEN=432(found here: https://www.getdrip.com/user/edit under "API-token")
Please note that you need to send an "email" property to be able to get the Drip integration working.
To send to Drift:
- set
DRIFT_ORG_ID=456(ATM only possible to find by contacting the drift support dept)
Mixpanel is probably going to be next.
Forwardlytics can be deployed to Heroku. You can setup the port it starts on by setting the PORT environment variable.
Right now Forwardlytics supports tracking error via Bugsnag. Thanks to Logrus, it's pretty easy to add any other bug tracker. PRs welcome.
Forwardlytics has a built-in retry-mechanism than can be enabled
should calls to a provider fail. To enable this, set the environment
variable NUM_RETRIES_ON_ERROR=X where X is the number of retries
to attempt before giving up. This is implemented as an
exponential backoff algorithm.
To enable Bugsnag, set those environment variables:
BUGSNAG_API_KEY=your-api-key-123
ENVIRONMENT=development
If the environment is not set, it'll work but defaults to development.
You have two options:
- send a PR adding it.
- get in touch to have it added by the author (for a fee).
To add a new integration you need to add a package that implements the
Integration interface to a separate
folder in the integrations/ subfolder of this
project, usually named after the integration. The integration should
be toggled by adding an ENV-variable that is picked up by the
Enabled()-function in the intexgration and that is passed to
forwardlytics on startup. To activate the new integration, add the
path to the new integration in the import-statement in
main.go. Remember to add an init() function to the new
package that registers the new integration using
integrations.RegisterIntegration(<integration-name>, integration). For examples, see the different integrations in the
integrations/ subfolder
(eg. the drip-integration). Don't forget
to add tests for all endpoints and for other integration spesific
stuff.
cURL example:
curl --request POST \
--header "Content-Type: application/json" \
--header "Forwardlytics-Api-Key: 123ma" \
-d '{"userID":"123", "userTraits":{"number_of_things":"42"},"timestamp":1459532831}' http://localhost:3000/identify
See ./integration/integration.go for details of what is accepted by the API.
Note that you should install Godep if you are going to add any dependency to this project.
FORWARDLYTICS_API_KEY=somevalue go run main.go
If you want auto reloading, install codegangsta/gin and run:
FORWARDLYTICS_API_KEY=somevalue gin -a 8080 -t .
You need to set environment variables for the integrations you want to work with.
go test -v ./...
Read "Self-hosted Segment equivalent?" on Medium
Thanks to my friend Julian for the logo! 😀
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent
