Apache-2.0 licensed by Domen Kožar
Maintained by [email protected]
This version can be pinned in stack with:mixpanel-client-0.2.1@sha256:d8ec243308ecc26431d4bcebeb18cfa2e5833b6f4248a4fc149dc9bb58ff9b9e,2665

Module documentation for 0.2.1

MixPanel client for Haskell

Build Status Hackage

Implements major features of MixPanel HTTP API:

  • [x] track
  • [x] alias
  • [x] engage
  • [ ] import
  • [ ] export

Getting started

import Data.Aeson      ( (.=) )
import Data.Time.Clock ( getCurrentTime )
import GHC.Exts        ( fromList )
import MixPanel        ( Operation(Set), engage, track, alias
                       , AuthToken(..), mkEnv
                       -- reexports
                       , newManager, tlsManagerSettings)


main :: IO ()
main = do
  -- setup
  manager <- newManager tlsManagerSettings
  let env = mkEnv (AuthToken "foobar") manager

  -- track a simple event
  Right () <- track env "Played Video" mempty

  -- track an event with extra properties
  Right () <- track env "Played Video Unique per user"
    $ fromList [ "distinct_id" .= ("generated-id" :: String)
               , "customProperty" .= True ]

  -- alias the user
  Right () <- alias env "generated-id" "[email protected]"

  -- profile engagement
  now <- getCurrentTime
  Right () <- engage env "[email protected]"
    $ Set (fromList [ "$created" .= now])

  putStrLn "All good!"

Design questions

a) Why does it use Object/Array intemediate values from Data.Aeson?

TODO

  • batch requests
  • expose extra url query paramerers
  • engage special properties more type safe?
  • filter out null values in requests to mixpanel
  • api support for tracking revenue

Changes

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog and this project adheres to Semantic Versioning.

[Unreleased]

[0.2.1] - 2019-08-26

Fixed

  • 0.2.0 was a brown-paper-bag release

[0.2.0] - 2019-03-13

Changes

  • #4 add servant 0.16 support @domenkozar

[0.1.1] - 2018-11-28

Changes

  • ditch hpack @domenkozar
  • add Show instance for MixpanelError

[0.1.0.0] - 2018-08-25

  • Intial release @domenkozar