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
Choose from the methods below. Not sure how to choose? Read our guide.
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:
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 (opens in a new tab).
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);
}
}
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" });
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 (opens in a new tab).
Was this page useful?