Codevoid.Utilities.Mixpanel 1.2.0

MixpanelCppCX

Introduction

MixpanelCppCX is a client for the Mixpanel analytics service. It has been built to handle the common situations of uploading events to the service. It supports batching, persisting-to-storage-before-uploading, and super properties. It's intended to be consumed by any UWP app — but the original motivation was to support JavaScript applications.

How to get it

MixpanelCppCX is published as a NuGET package (Codevoid.Utilities.Mixpanel) to the NuGET.org feed — just add it to your UWP Project in Visual Studio, and it'll be available for use in your code.

Things to note

• Items awaiting to upload are stored in a folder in your applications private data folder with in local settings. (%LOCALAPPDATA%\Packages\<PackageIdentity>\LocalState\MixpanelUploadQueue)
• Items awaiting upload are written to disk after 500ms of idle time, or when there are 10 or more items in the queue — whichever comes first.
• Items are uploaded in batches of 50, unless one item in the batch fails, then they're uploaded 1 at a time.
• The queue is paused automatically when being suspended, and resumed when... resumed.
• This library does automatic session tracking — it starts tracking the session duration on start, and will automatically end/resume the session based on suspend/resume events.

Usage

Sending a simple event

1. Create an instance of Codevoid.Utilities.Mixpanel, and hold on to it.

var mixpanelClient = new Codevoid.Utilities.Mixpanel(<Mixpanel API Token>)

2. Call, and wait for, .InitializeAsync()
3. Call .Start() on that instance to start processing the queue.
4. Call .Track("MyEvent", null) to log a single event

If you need to send properties with your event you can use Windows.Foundation.Collections.PropertySet, and insert your properties as needed, passing it as the second parameter to Track:

var properties = new Windows.Foundation.Colllections.PropertySet();
properties.add("MyProperty", "MyValue");
properties.add("MyOtherProperty", 9);

mixpanelClient.Track("MyOtherEvent", properties);

For full documentation see here