Install Mixpanel

Overview

Installing Mixpanel is easy. This guide will show you how to do it with our SDKs.

Already collect product data? Connect your Data Warehouse or via 3rd Party Integrations.

Code

Mixpanel’s Autocapture alpha for web is live! To join, email us.

Choose from the methods below. Not sure how to choose? Read our guide.

Install the SDK

<!-- Paste this right before your closing </head> tag -->
<script type="text/javascript">
  (function (f, b) { if (!b.__SV) { var e, g, i, h; window.mixpanel = b; b._i = []; b.init = function (e, f, c) { function g(a, d) { var b = d.split("."); 2 == b.length && ((a = a[b[0]]), (d = b[1])); a[d] = function () { a.push([d].concat(Array.prototype.slice.call(arguments, 0))); }; } var a = b; "undefined" !== typeof c ? (a = b[c] = []) : (c = "mixpanel"); a.people = a.people || []; a.toString = function (a) { var d = "mixpanel"; "mixpanel" !== c && (d += "." + c); a || (d += " (stub)"); return d; }; a.people.toString = function () { return a.toString(1) + ".people (stub)"; }; i = "disable time_event track track_pageview track_links track_forms track_with_groups add_group set_group remove_group register register_once alias unregister identify name_tag set_config reset opt_in_tracking opt_out_tracking has_opted_in_tracking has_opted_out_tracking clear_opt_in_out_tracking start_batch_senders people.set people.set_once people.unset people.increment people.append people.union people.track_charge people.clear_charges people.delete_user people.remove".split( " "); for (h = 0; h < i.length; h++) g(a, i[h]); var j = "set set_once union unset remove delete".split(" "); a.get_group = function () { function b(c) { d[c] = function () { call2_args = arguments; call2 = [c].concat(Array.prototype.slice.call(call2_args, 0)); a.push([e, call2]); }; } for ( var d = {}, e = ["get_group"].concat( Array.prototype.slice.call(arguments, 0)), c = 0; c < j.length; c++) b(j[c]); return d; }; b._i.push([e, f, c]); }; b.__SV = 1.2; e = f.createElement("script"); e.type = "text/javascript"; e.async = !0; e.src = "undefined" !== typeof MIXPANEL_CUSTOM_LIB_URL ? MIXPANEL_CUSTOM_LIB_URL : "file:" === f.location.protocol && "//cdn.mxpnl.com/libs/mixpanel-2-latest.min.js".match(/^\/\//) ? "https://cdn.mxpnl.com/libs/mixpanel-2-latest.min.js" : "//cdn.mxpnl.com/libs/mixpanel-2-latest.min.js"; g = f.getElementsByTagName("script")[0]; g.parentNode.insertBefore(e, g); } })(document, window.mixpanel || []);
</script>

npm install --save mixpanel-browser

yarn add mixpanel-browser

Configure the SDK

Replace YOUR_TOKEN with your project token. You can find your token here.

//Import Mixpanel SDK
import mixpanel from "mixpanel-browser";
 
// Near entry of your product, init Mixpanel
mixpanel.init("YOUR_TOKEN", {
  debug: true,
  track_pageview: true,
  persistence: "localStorage",
});

Install the SDK

pip install mixpanel

Configure the SDK

Replace YOUR_TOKEN with your project token. You can find your token here.

from mixpanel import Mixpanel
 
mp = Mixpanel("YOUR_TOKEN")

Install the SDK

Install with Composer

Add mixpanel/mixpanel-php as a dependency and run composer update:

"require": {
    ...
    "mixpanel/mixpanel-php" : "2.*"
    ...
}

Install Manually

Download the Mixpanel PHP Library
Extract the zip file to a directory called “mixpanel-php” in your project root

Configure the SDK

Replace YOUR_TOKEN with your project token. You can find your token here.

<?php
// import Mixpanel
require 'mixpanel-php/lib/Mixpanel.php';
 
// get the Mixpanel class instance, replace with your project token
$mp = Mixpanel::getInstance("YOUR_TOKEN");
 
?>

Install the SDK

npm install mixpanel

Configure the SDK

Replace YOUR_TOKEN with your project token. You can find your token here.

// Grab the Mixpanel factory
var Mixpanel = require("mixpanel");
 
// Create an instance of the mixpanel client
var mixpanel = Mixpanel.init("YOUR_TOKEN");

Install the SDK

go get github.com/mixpanel/mixpanel-go

Configure the SDK

Replace YOUR_TOKEN with your project token. You can find your token here.

package main
 
import (
	"context"
	"github.com/mixpanel/mixpanel-go"
)
 
func main() {
ctx := context.Background()
mp := mixpanel.NewApiClient("YOUR_TOKEN")
}

Install the SDK

gem install mixpanel-ruby

Configure the SDK

Replace YOUR_TOKEN with your project token. You can find your token here.

require 'mixpanel-ruby'
 
mp = Mixpanel::Tracker.new(YOUR_TOKEN)

Install the SDK

<!--Include the following in your project's pom.xml-->
<dependency>
  <groupId>com.mixpanel</groupId>
  <artifactId>mixpanel-java</artifactId>
  <version>1.4.4</version>
</dependency>

Configure the SDK

Replace YOUR_TOKEN with your project token. You can find your token here.

//Import Mixpanel API
import com.mixpanel.mixpanelapi.MessageBuilder;
import com.mixpanel.mixpanelapi.MixpanelAPI;
 
// Set up an instance of MixpanelAPI
MixpanelAPI mixpanel = new MixpanelAPI();
 
MessageBuilder messageBuilder = new MessageBuilder('YOUR_TOKEN');

Install the SDK

Under your app’s root directory, run:


npm install mixpanel-react-native

Under your application’s iOS folder, run:


pod install

Note: For XCode 12.5+, there is a known compile issue, please refer to this workaround.

Configure the SDK

Replace YOUR_TOKEN with your project token. You can find your token here.

//Import Mixpanel API
import { Mixpanel } from "mixpanel-react-native";
 
// Set up an instance of Mixpanel
const trackAutomaticEvents = false;
const mixpanel = new Mixpanel("YOUR_TOKEN", trackAutomaticEvents);
mixpanel.init();

Install the SDK

Add mixpanel_flutter: ^2.0.0 to your package’s pubspec.yaml file and run:

flutter pub get

Configure the SDK

Replace YOUR_TOKEN with your project token. You can find your token here.

import 'package:mixpanel_flutter/mixpanel_flutter.dart';
class _YourClassState extends State<YourClass> {
  Mixpanel mixpanel;
 
  @override
  void initState() {
    super.initState();
    initMixpanel();
  }
 
  Future<void> initMixpanel() async {
    // Once you've called this method once, you can access `mixpanel` throughout the rest of your application.
    mixpanel = await Mixpanel.init("YOUR_TOKEN", trackAutomaticEvents: false);
  }
}

Install the SDK

Note: Swift Package Manager requires Xcode 12+ 1. In Xcode, select File > Swift Packages > Add Package Dependency. 2. Follow the prompts using the URL for this repository and must select a version greater than or equal to v4.0.0

Create a Podfile in your Xcode project directory by running pod init in your terminal, edit the Podfile generated, and add the following line: pod 'Mixpanel'. 2. Run pod install in your Xcode project directory. CocoaPods should download and install the Mixpanel library, and create a new Xcode workspace. Open up this workspace in Xcode or typing open *.xcworkspace in your terminal.

Add github "mixpanel/mixpanel-iphone" to your Cartfile.

Configure the SDK

Replace YOUR_TOKEN with your project token. You can find your token here.

#import "Mixpanel/Mixpanel.h"
 
- (BOOL)application:(UIApplication _)application
  didFinishLaunchingWithOptions:(NSDictionary _)launchOptions {
  ...
  Mixpanel \*mixpanel = [Mixpanel sharedInstanceWithToken:@"YOUR_TOKEN"
  trackAutomaticEvents: NO];
  ...
  }

Install the SDK

Note: Swift Package Manager requires Xcode 12+

In Xcode, select File > Swift Packages > Add Package Dependency.
Paste the URL https://github.com/mixpanel/mixpanel-swift and a minimum semantic version of v2.8.0.

Create a Podfile in your Xcode project directory by running pod init in your terminal, edit the Podfile generated, and add the following line: pod 'Mixpanel-swift'.
Run pod install in your Xcode project directory. CocoaPods should download and install the Mixpanel library, and create a new Xcode workspace. Open up this workspace in Xcode or typing open *.xcworkspace in your terminal.

Add github "mixpanel/mixpanel-swift" to your Cartfile.

Configure the SDK

Import Mixpanel into AppDelegate.swift
Initialize Mixpanel within application:didFinishLaunchingWithOptions as seen below

Replace YOUR_TOKEN with your project token. You can find your token here.

import Mixpanel
 
func application(_ application: UIApplication,
                 didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool {
    ...
    // Replace with your Project Token
    Mixpanel.initialize(token: "YOUR_TOKEN", trackAutomaticEvents: false)
    ...
}

Install the SDK

Add implementation 'com.mixpanel.android:mixpanel-android:7.+' as a dependency to your build.gradle file.

Once you’ve updated build.gradle, you can force Android Studio to sync with your new configuration by clicking the Sync Project with Gradle Files icon at the top of the window: Sync Android With Gradle

If it cannot find the dependency, you should make sure you’ve specified mavenCentral() as a repository in build.gradle.

Next, add the following permissions in your AndroidManifest.xml:

<!--Required to allow the application to send events to Mixpanel.-->
<uses-permission android:name="android.permission.INTERNET" />
 
<!--Optional, but recommended so we can send data intelligently based on network conditions -->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
 
<!-- Optional, but recommended so events will contain information about bluetooth state-->
<uses-permission android:name="android.permission.BLUETOOTH" />

Configure the SDK

Replace YOUR_TOKEN with your project token. You can find your token here.

import com.mixpanel.android.mpmetrics.MixpanelAPI;
 
public class MainActivity extends ActionBarActivity {
  private MixpanelAPI mp;
 
  @Override
  protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
 
    trackAutomaticEvents = false;
    // Replace with your Project Token
    mp = MixpanelAPI.getInstance(this, "YOUR_TOKEN", trackAutomaticEvents);
  }
}

Install the SDK

Add https://github.com/mixpanel/mixpanel-unity.git#master to the dependencies section of com.mixpanel.unity.

Alternatively, you can download and install the .unitypackage file from our releases page.

Configure the SDK

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. You can find your token here.

unity_screenshots

Note: If you prefer to initialize Mixpanel manually, you can select the Manual Initialization in the settings and call Mixpanel.Init() to initialize.

To use mixpanel, add the following sample code to a part of your application:

using mixpanel;

You’re

Next: Identify Your Users

With Mixpanel installed, you’re now ready to identify the users who use your product.

FAQ

Does Mixpanel automatically track page views?

Yes, if you pass track_pageview: true in the mixpanel.init() call, Mixpanel will automatically track a “Page View” event every time a new page is loaded. Learn more here.

What are the recommended web configuration options?

When tracking on web, we recommend using localStorage, as this is more reliable:

mixpanel.set_config({ persistence: "localStorage" });

Please note that cross-subdomain tracking is not possible when using local storage. If your implementation requires cross-subdomain tracking, remove the persistence flag and use the default “cookie” persistence option.

Does Mixpanel use third-party cookies?

No, our Mixpanel JavaScript SDK does not set or use any third-party cookies. If you wish to disable cookies entirely, you can set the disable_persistence option to true when initializing your Mixpanel JS instance. Note that disabling persistence will disable the use of super properties and anonymous -> identified user tracking.

How can I track in a privacy compliant way?

If a user opts out of tracking, you can call the .optOutTracking() method on any of our client-side SDKs; this prevents any subsequent data being tracked from that user’s device. Learn more here.

For iOS specifically: Mixpanel does not use IDFA, so it does not require user permission through the AppTrackingTransparency(ATT) framework. For more details, refer to our Apple App Developer Privacy Guidance.

Quickstart Identify Users

Was this page useful?