Mixpanel

将 OneSignal 与 Mixpanel 集成，以实现跨推送、应用内、电子邮件和短信的实时行为定向。此应用级集成支持两种数据流：

• 消息事件 → Mixpanel：跟踪所有渠道的传递、点击、失败等信息。
• 群组 → OneSignal：将基于行为的 Mixpanel 群组同步为 OneSignal 中的定向过滤器。

---

​

要求

• Mixpanel Account
• OneSignal 付费计划
• 设置了外部 ID 的 OneSignal 应用。

---

​

设置

​

将 Mixpanel 添加到 OneSignal（出站）

将 OneSignal 消息事件发送到您的 Mixpanel 项目。

1. 在 OneSignal 中，导航到 数据 > 集成 > Mixpanel 并点击 激活。

​

在 Mixpanel 中

1. 找到您的 Project Token，然后将其复制粘贴到 OneSignal 中。
2. 检查您的 Data Residency。如果使用 Mixpanel 的欧盟服务器，请勾选 仅将事件发送到 Mixpanel 的欧盟数据驻留服务器 复选框。

​

选择消息事件

选择您要发送到 Mixpanel 的 OneSignal 消息事件。完成后，点击激活。

​

将 OneSignal 添加到 Mixpanel（入站）

在您的 Mixpanel 集成中，添加 OneSignal。 将连接器名称设置为可识别的名称，如 OneSignal - APP_NAME，其中 APP_NAME 是 OneSignal 中应用的名称。 您需要在 OneSignal 设置 > 密钥和 ID 中提供以下数据：

1. App ID
2. API Key

​

用户 ID 映射

OneSignal 中的**外部 ID**必须与您选择的 Mixpanel 用户 ID 属性（如 user_id）匹配。请验证此属性在两个系统中均已填充——群组同步和事件跟踪依赖于精确匹配。 验证您选择的用户 ID 属性在您的 Mixpanel 用户配置文件属性中可用。 Mixpanel 中用户配置文件属性的相同值必须与 OneSignal 中的外部 ID 匹配。

---

​

将 Mixpanel 群组导出到 OneSignal

使用上面配置的匹配外部 ID 将 Mixpanel 群组同步到 OneSignal。导出不会创建用户——每个用户必须已存在于 OneSignal 中。

1. 在 Mixpanel 中，创建一个群组。
2. 点击 选项 > 导出到… > OneSignal 连接名称。

3. 选择同步频率并按 开始同步。

​

OneSignal 细分创建

同步的群组在 OneSignal 中显示为 Mixpanel 细分过滤器。如果满足以下条件，OneSignal 将自动为群组创建细分：

• Mixpanel 群组中的用户也在 OneSignal 中存在并具有匹配的外部 ID。
• 您不能超过 OneSignal 中的细分限制。

---

​

在 Mixpanel 中追踪消息事件

OneSignal 实时向 Mixpanel 发送以下消息事件。在 数据 > 集成 > Mixpanel 中选择要发送的事件。 要测试，请从 OneSignal 向自己发送消息，然后导航到 Mixpanel 中的用户配置文件页面。在活动源中，您应该看到事件填充。

​

消息事件

​

事件属性

从 OneSignal 发送到 Mixpanel 的每个事件都包含以下属性：

---

​

自定义事件（第三方）

Mixpanel 集成不原生支持将自定义事件从 Mixpanel 发送到 OneSignal。与 Amplitude 不同，Mixpanel 到 OneSignal 没有内置的事件目标。 如果您需要将 Mixpanel 行为事件作为自定义事件路由到 OneSignal 以触发旅程或细分，可以使用第三方连接器，如 Vendo。Vendo 将选定的 Mixpanel 事件作为自定义事件流式传输到 OneSignal，用于活动触发。

---

​

常见问题

​

为什么我的群组和细分数量不匹配？

1. 缺失或不匹配的外部 ID 只有具有匹配的 OneSignal 外部 ID 和 Mixpanel 用户 ID 的用户才被包含。此集成不会创建用户或订阅。
2. 未订阅用户 OneSignal 细分仅显示已订阅订阅的数量。未订阅的订阅可用于旅程或应用内消息。

例如，如果 Mixpanel 群组有 10 个用户，但 OneSignal 细分显示 8 个订阅，缺失的 2 个用户可能：

• 在 OneSignal 中不存在或具有不正确的外部 ID。
• 具有未订阅的订阅。

要验证，请检查 OneSignal 中的受众 > 用户选项卡，查看用户是否存在并具有活动订阅。

​

未订阅用户是否从 Mixpanel 同步？

是的，但目前它们被排除在 OneSignal 细分计数之外。如果他们有其他订阅或其订阅类型支持，您仍可以通过旅程或应用内消息向他们发送消息。

​

为什么传递数据不匹配？

单个用户可能有多个订阅（推送设备、电子邮件地址、电话号码）。每个订阅都会生成自己的投递事件。例如：

• 1 个用户 = 2 个 Android + 1 个 iOS + 2 个网页 = 5 个推送订阅
• 1 条推送消息 = 最多 5 个已发送/已接收/已点击事件

使用事件属性中的 subscription_id 来追踪确切来源。 要排除缺失事件：

• 确保在识别用户时调用 OneSignal.login 以设置外部 ID。
• 验证 OneSignal.logout 没有移除外部 ID。
• 检查可能更改外部 ID 的 API 请求或 CSV 上传。

​

我可以从 Mixpanel 向 OneSignal 发送自定义事件吗？

不能原生支持。Mixpanel 集成支持消息事件（OneSignal → Mixpanel）和群组同步（Mixpanel → OneSignal），但不包括内置的自定义事件目标。要将 Mixpanel 事件作为自定义事件路由到 OneSignal，请使用第三方连接器，如 Vendo。

​

我如何发送用户/订阅事件？

用户和订阅级别的事件（如权限授予、用户登录/注销）不会自动发送。 OneSignal SDK 具有事件监听器，可用于跟踪这些事件以便您发送到 Mixpanel：

• User State Observer: Mobile SDK, Web SDK
• Permission Observer: Mobile SDK, Web SDK

---

​

相关页面

---