Mixpanel

Mixpanel 是一款功能强大的产品分析服务。其基于事件驱动的追踪方案，帮助产品团队深入了解不同平台上用户获取、转化和留存的最优策略。 通过此集成，您可以将所有 Adapty 事件导入 Mixpanel。这样，您将对订阅业务和用户行为获得更全面的洞察。Adapty 提供完整的数据集，让您能够在一处追踪来自各应用商店的订阅事件。借助 Adapty，您可以轻松了解订阅者的行为规律，掌握他们的偏好，并将这些信息用于精准、有效的用户沟通。

如何设置 Mixpanel 集成

1. 在 Adapty 看板中打开 Integrations -> Mixpanel 页面。
2. 启用开关并输入您的 Mixpanel Token。您可以为所有平台指定一个 Token，也可以限定到特定平台，仅接收来自特定平台的数据。
3. 将 Mixpanel Data Residency 设置为与您的 Mixpanel 项目一致。该字段为必填项，默认值为 US。若使用 api.mixpanel.com 端点，请选择 US；若使用 api-eu.mixpanel.com，请选择 Europe。

查找 Mixpanel Token

获取 Mixpanel Token 的步骤：

1. 登录 Mixpanel 看板。
2. 打开 Settings，选择 Organization Settings。

3. 在左侧边栏中，进入 Projects 并选择你的项目。

集成工作原理

Adapty 会自动将相关事件属性（如用户 ID 和收入）映射到 Mixpanel 原生属性，确保订阅相关事件的追踪和报告准确无误。

此外，Adapty 会按用户累积收入数据，并更新其用户画像属性，包括 subscription state 和 subscription product ID。一旦收到事件，Mixpanel 将实时更新对应字段。

事件与标签

在凭据下方，有三组事件可以从 Adapty 发送到 Mixpanel。直接开启你需要的事件即可。点击此处查看 Adapty 提供的完整事件列表。

我们建议使用 Adapty 提供的默认事件名称。但您也可以根据需要修改事件名称。

SDK 配置

使用 .setIntegrationIdentifier() 方法设置 mixpanelUserId。如果未设置，Adapty 将使用您的用户 ID（customerUserId），若该值为 null，则使用 Adapty ID。请确保您在应用中向 Mixpanel 发送数据所用的用户 ID 与发送给 Adapty 的一致。

do {
    try await Adapty.setIntegrationIdentifier(
        key: "mixpanel_user_id",
        value: Mixpanel.mainInstance().distinctId
    )
} catch {
    // handle the error
}

let builder = AdaptyProfileParameters.Builder()
            .with(mixpanelUserId: Mixpanel.mainInstance().distinctId)

Adapty.updateProfile(params: builder.build())

Adapty.setIntegrationIdentifier("mixpanel_user_id", mixpanelAPI.distinctId) { error ->
    if (error != null) {
        // handle the error
    }
}

final mixpanel = await Mixpanel.init("Your Token", trackAutomaticEvents: true);
final distinctId = await mixpanel.getDistinctId();

try {
    await Adapty().setIntegrationIdentifier(
        key: "mixpanel_user_id",
        value: distinctId,
    );
} on AdaptyError catch (adaptyError) {
    // handle the error
} catch (e) {
    // handle the error
}

using AdaptySDK;

var distinctId = Mixpanel.DistinctId;

if (distinctId != null) {
  Adapty.SetIntegrationIdentifier(
    "mixpanel_user_id",
    distinctId,
    (error) => {
    // handle the error
  });
}

// 如果你的应用中已有共享的 Mixpanel 实例，请直接使用该实例。
const trackAutomaticEvents = true;
const mixpanel = new Mixpanel('YOUR_PROJECT_TOKEN', trackAutomaticEvents);
await mixpanel.init();

// 这是 Mixpanel 当前的 distinct_id（自动生成，或通过 mixpanel.identify(...) 设置）
const mixpanelUserId = await mixpanel.getDistinctId();

try {
    await adapty.setIntegrationIdentifier("mixpanel_user_id", mixpanelUserId);
} catch (error) {
    // 处理 `AdaptyError`
}

Mixpanel 事件结构

Adapty 使用 track 方法向 Mixpanel 发送事件。事件属性的结构如下：

{
  "event": "subscription_renewed",
  "properties": {
    "ip": 0,
    "time": 1709294400,
    "$insert_id": "123e4567-e89b-12d3-a456-426614174000",
    "vendor_product_id": "yearly.premium.6999",
    "original_transaction_id": "GPA.3383...",
    "currency": "USD",
    "environment": "Production",
    "store": "app_store",
    "purchase_date": "2024-03-01T12:00:00.000000+0000"
  }
}

其中：

用户画像更新

Adapty 还会使用 people_set 更新 Mixpanel 用户画像，包含以下属性：