MixpanelVapor is a library for tracking events to Mixpanel from your Vapor server-side Swift applications.
Mixpanel recommends using a service account and their /import
endpoint for server-side apps so that's what this package uses.
It allows to add things like batch import of events at a large scale in the future.
import MixpanelVapor
public func configure(_ app: Application) throws {
//...
app.mixpanel.configuration = .init(token: "YOUR_MIXPANEL_TOKEN")
// ...
}
await application.mixpanel.track(distinctId: "<user id>", name: "my_event", params: ["$user_id": profile.id, "a": 123])
await request.mixpanel.track(distinctId: "<user id>", name: "my_event", params: ["$user_id": profile.id, "a": 123])
// enhances the metadata (user agent, country, ...) by parsing the headers and ip from the request
await request.mixpanel.track(distinctId: "<user id>", name: "my_event", request: request, params: ["$user_id": profile.id, "a": 123])
await application.mixpanel.peopleSet(distinctId: "<user id>", request: request, setParams: ["$email": "john@example.com", "num_cats": 5])
await application.mixpanel.peopleDelete(distinctId: "<user id>")
A list of mixpanel properties to assign a name, email, and other properties to a mixpanel identity can be found here.
I'm only implemented very basic feature set that fits my needs at this point. Will extend this package as I have the need for it, but contributions are very welcome.