Mixpanel

Mixpanel 是一款功能强大的产品分析服务。其基于事件驱动的追踪解决方案帮助产品团队深入了解跨平台用户获取、转化和留存的最优策略。

通过此集成，您可以将所有 Adapty 事件导入 Mixpanel，从而更全面地洞察您的订阅业务和用户行为。Adapty 提供完整的数据集，让您可以在一处追踪来自各应用商店的订阅事件。借助 Adapty，您可以轻松了解订阅者的行为习惯和偏好，并据此进行精准有效的用户沟通。

如何设置 Mixpanel 集成

在 Adapty 看板中打开 Integrations -> Mixpanel 页面。
启用开关并输入您的 Mixpanel Token。您可以为所有平台指定同一个 Token，也可以针对特定平台单独设置，以仅接收来自特定平台的数据。

获取您的 Mixpanel Token

获取 Mixpanel Token 的步骤：

登录您的 Mixpanel 看板。
打开 Settings 并选择 Organization Settings。

在左侧边栏中，转到 Projects 并选择您的项目。

集成工作原理

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

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

事件与标签

在凭据下方，有三组事件可供您从 Adapty 发送至 Mixpanel。只需开启您需要的事件即可。您可以在此处查看 Adapty 提供的完整事件列表。

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

SDK 配置

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

如果您使用第三方用户 ID 作为 Customer User ID，请不要在 activate() 时传入——第三方 SDK 可能尚未生成该 ID。请先不带 CUID 调用 activate()，然后调用 setIntegrationIdentifier()，最后再使用 CUID 调用 identify()。

import Mixpanel

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

import Mixpanel

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
    }
}

import 'package:mixpanel_flutter/mixpanel_flutter.dart';

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
  });
}

import { adapty } from 'react-native-adapty';
import { Mixpanel } from 'mixpanel-react-native';

// If you already have a shared Mixpanel instance in your app, use that instance instead.
const trackAutomaticEvents = true;
const mixpanel = new Mixpanel('YOUR_PROJECT_TOKEN', trackAutomaticEvents);
await mixpanel.init();

// This is Mixpanel's current distinct_id (auto-generated, or set via mixpanel.identify(...))
const mixpanelUserId = await mixpanel.getDistinctId();

try {
    await adapty.setIntegrationIdentifier("mixpanel_user_id", mixpanelUserId);
} catch (error) {
    // handle `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"
  }
}

各字段说明：

参数	类型	描述
`event`	String	事件名称（由 Adapty 事件映射而来）。
`properties`	Object	事件属性。
`properties.ip`	Integer	IP 地址（服务器到服务器发送时为 0）。
`properties.time`	Long	事件的 UNIX 时间戳（秒）。
`properties.$insert_id`	String	用于去重的唯一事件 ID（UUID）。
`properties.vendor_product_id`	String	应用商店中的产品 ID。
`properties.original_transaction_id`	String	原始交易 ID。
`properties.currency`	String	货币代码。
`properties.store`	String	商店名称（如 “app_store”）。
`properties.environment`	String	环境（“Sandbox” 或 “Production”）。

用户画像更新

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

参数	类型	描述
`subscription_state`	String	当前订阅状态（如 “subscribed”）。
`subscription_product_id`	String	当前有效订阅产品的 ID。