Please refer to our Quickstart Guide.
This library can be installed using the unity package manager system with git. We support Unity 2018.3 and above. For older versions of Unity, you need to have .NET 4.x Equivalent selected as the scripting runtime version in your editor settings.
- In your unity project root open ./Packages/manifest.json
- Add the following line to the dependencies section "com.mixpanel.unity": "https://github.com/mixpanel/mixpanel-unity.git#master (opens in a new tab)",
- Open Unity and the package should download automatically Alternatively you can go to the releases page (opens in a new tab) and download the .unitypackage file and have unity install that.
To start tracking with the Mixpanel Unity library, you must first initialize it with your project token. You can find your token by clicking your name in the upper righthand corner of your Mixpanel project and selecting Settings from the dropdown.
To initialize the library, first open the unity project settings menu for Mixpanel. (Edit -> Project Settings -> Mixpanel) Then, enter your project token into the Token and Debug Token input fields within the inspector.
Once you've initialized the library with your project token, you can import Mixpanel into your code using the mixpanel namespace.
using mixpanel; // Then, you can track events with Mixpanel.Track("Plan Selected");
Once you've initialized the library, you can track an event using
Mixpanel.Track() (opens in a new tab) with the event name and properties.
var props = new Value(); props["Gender"] = "Female"; props["Plan"] = "Premium"; Mixpanel.Track("Plan Selected", props);
To preserve battery life and customer bandwidth, the Mixpanel library doesn't send the events you record immediately. Instead, it sends batches to the Mixpanel servers periodically while your application is running. On Unity, you can configure the interval at which data is flushed to Mixpanel. The default time is that data gets flushed every 60 seconds.
You can track the time it took for an action to occur, such as an image upload or a comment post, using
Mixpanel.StartTimedEvent (opens in a new tab) This will mark the "start" of your action, which you can then finish with a track call. The time duration is then recorded in the "Duration" property.
Mixpanel.StartTimedEvent("Image Upload"); Mixpanel.Track("Image Upload");
It's very common to have certain properties that you want to include with each event you send. Generally, these are things you know about the user rather than about a specific event—for example, the user's age, gender, or source.
To make things easier, you can register these properties as super properties. If you do, we will automatically include them with all tracked events. Super properties are saved to device storage, and will persist across invocations of your app.
To set super properties, call
Mixpanel.Register. (opens in a new tab)
// Send a "User Type: Paid" property will be sent // with all future track calls. Mixpanel.Register("User Type", "Paid");
Going forward, whenever you track an event, super properties will be included as properties. For instance, if you call
var props = new Value(); props["signup_button"] = "test12"; Mixpanel.Track("signup", props);
after making the above call to Mixpanel.Register, it is just like adding the properties directly:
var props = new Value(); props["signup_button"] = "test12"; props["User Type"] = "Paid"; Mixpanel.Track("signup", props);
If you want to store a super property only once (often for things like ad campaign or source), you can use
Mixpanel.RegisterOnce (opens in a new tab). This function behaves like
Mixpanel.Register (opens in a new tab) and has the same interface, but it doesn't override super properties you've already saved.
This means that it's safe to call
Mixpanel.RegisterOnce with the same property on every app load, and it will only set it if the super property doesn't exist.
Mixpanel's server-side libraries do not automatically append "super properties" to their events. You are more than welcome to roll your own system to append whatever properties you'd like to events for a given user. The most important thing to note when dealing with appending properties server side is that you must include a value for the (traditionally super) property "distinct_id" in order to use the events in most Mixpanel reports. The distinct_id property ties an event to a specific user.
You can handle the identity of a user using the
alias methods. Proper use of these methods can connect events to the correct user as they move across devices, browsers, and other platforms.
Identify a user with a unique ID to track user activity across devices, tie a user to their events, and create a user profile. If you never call this method, unique visitors are tracked using a UUID that generates the first time they visit the site.
identify when you know the identity of the current user, typically after log-in or sign-up. We recommend against using
identify for anonymous visitors to your site.
// Associate all future events sent from // the library with the distinct_id 13793 Mixpanel.Identify('13793');
Reset (opens in a new tab) generates a new random distinct_id and clears super properties. Call reset to clear data attributed to a user when that user logs out. This allows you to handle multiple users on a single device. For more information about maintaining user identity, see the Identifying Users article.
Note: Calling reset frequently can lead to users quickly exceeding the 500 distinct_id per identity cluster limit. Once the 500 limit is reached you will no longer be able to add additional distinct_ids to the users identity cluster.
In addition to events, you can store user profiles in Mixpanel's User Analytics (opens in a new tab) product. Profiles are persistent sets of properties that describe a user—things like name, email address, and signup date. You can use profiles to explore and segment users by who they are, rather than what they did. You can also use profiles to send messages, such as emails, SMS, or push notifications.
You can set properties on a user profile with
Mixpanel.people.Set (opens in a new tab).
// mixpanel identify: must be called before // user profile properties can be set Mixpanel.Identify("13793"); // Sets user 13793's "Plan" attribute to "Premium" Mixpanel.People.Set("Plan", "Premium");
This will set a "Plan" property, with a value "Premium," on user 13793's profile. If there isn't a profile with distinct_id 13793 in Mixpanel already, a new profile will be created. If user 13793 already has a property named "Plan" in their profile, the old value will be overwritten with "Premium."
You can use
Mixpanel.people.Increment (opens in a new tab) to change the current value of numeric properties. This is useful when you want to keep a running tally of things, such as games played, messages sent, or points earned.
// Here we increment the user's point count by 500. Mixpanel.People.Increment("point count", 500);
There are a few other types of profile updates. To learn more, please see the full API reference (opens in a new tab).
Mixpanel makes it easy to analyze the revenue you earn from individual customers. By associating charges with user profiles, you can compare revenue across different customer segments and calculate things like lifetime value.
You can track a single transaction with
Mixpanel.people.TrackCharge (opens in a new tab). This call will add transactions to the individual user profile, which will also be reflected in the Mixpanel Revenue report.
// Make sure identify has been called before making revenue // updates Mixpanel.Identify("13793"); // Tracks $100 in revenue for user 13793 Mixpanel.People.TrackCharge(100); // Refund this user 50 dollars Mixpanel.People.TrackCharge(-50); // Tracks $25 in revenue for user 13793 on the 2nd of // January var props = new Value(); props["time"] = "2012-01-02T00:00:00"; Mixpanel.People.TrackCharge(25, props);
Was this page useful?