Mixpanel Android 库技术文档

1. 安装指南

1.1 添加依赖

首先，您需要在项目的 build.gradle 文件中添加 Mixpanel Android 库的依赖。Mixpanel 库发布在 Maven Central 仓库中，您可以通过以下步骤将其添加到您的项目中：

在 app/build.gradle 文件的 dependencies 部分添加以下代码：

implementation "com.mixpanel.android:mixpanel-android:7.+"

添加完成后，点击 Android Studio 顶部的“Sync Project with Gradle Files”按钮，同步项目配置。

1.2 添加权限

为了确保 Mixpanel 库能够正常工作，您需要在 AndroidManifest.xml 文件中添加以下权限：

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.BLUETOOTH" />

2. 项目使用说明

2.1 初始化 Mixpanel

在您的代码中初始化 Mixpanel 库。您需要使用应用程序上下文、Mixpanel 项目令牌以及自动事件设置来初始化库。您可以在 项目设置 中找到您的项目令牌。

import com.mixpanel.android.mpmetrics.MixpanelAPI;

public class MainActivity extends ActionBarActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        boolean trackAutomaticEvents = false;
        MixpanelAPI mixpanel = MixpanelAPI.getInstance(this, "YOUR_TOKEN", trackAutomaticEvents);
    }
}

2.2 发送数据

您可以在应用程序的任何地方发送事件数据。通过存储与事件相关的详细信息（属性），可以更好地理解用户行为。

JSONObject props = new JSONObject();
props.put("source", "Pat's affiliate site");
props.put("Opted out of email", true);

mixpanel.track("Sign Up", props);

2.3 检查数据发送成功

您可以在 Mixpanel 的“事件报告”中查看传入的事件。通常，数据在发送到 Mixpanel API 后大约 60 秒内会处理、存储并可查询。

3. 项目 API 使用文档

3.1 自动事件收集

Mixpanel 会自动收集一些常见的移动事件。您可以通过 项目设置 启用或禁用自动事件收集。

3.2 用户配置文件数据

除了事件数据，您还可以发送用户配置文件数据。建议在完成快速入门指南后进行此操作。

3.3 调试与日志

如果事件未显示，您可以启用 Mixpanel 调试和日志记录功能。在 AndroidManifest.xml 文件中添加以下权限：

<application>
    <meta-data
      android:name="com.mixpanel.android.MPConfig.EnableDebugLogging"
      android:value="true" />
</application>

4. 项目安装方式

4.1 通过 Gradle 安装

通过在 build.gradle 文件中添加依赖项来安装 Mixpanel Android 库。

4.2 手动安装

您也可以手动下载 .aar 文件并将其添加到项目中。

---

通过以上步骤，您可以成功安装并使用 Mixpanel Android 库。如果在使用过程中遇到任何问题，可以参考官方文档或联系 Mixpanel 支持团队。