跳转到主要内容

OneSignal + Mixpanel 集成概览

将 OneSignal 与 Mixpanel 集成，以发送详细的消息参与事件并导入行为用户群组。这能够基于用户行为进行实时定向，以改善用户引导、重新参与和转化。

​
主要优势

  • 向 Mixpanel 发送消息事件：跨推送、应用内、电子邮件和短信追踪传递、点击、失败等更多信息。
    • 实时洞察 – 将 Mixpanel 产品分析与 OneSignal 参与指标统一起来。
    • 数据驱动的活动 – 使用 Mixpanel 的行为细分运行更智能的重新参与活动。
  • 从 Mixpanel 导入群组：自动将基于行为的群组同步到 OneSignal 作为定向过滤器。
    • 个性化消息 – 当用户进入或退出 Mixpanel 群组时触发上下文相关的 OneSignal 消息。

​
要求

此集成不会创建用户。它将 Mixpanel 中的用户映射到 OneSignal 中的用户。

​
设置

​
将 Mixpanel 添加到 OneSignal

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

在 OneSignal 中启用 Mixpanel 集成

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

​
选择消息事件

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

OneSignal 中的 Mixpanel 设置

​
将 OneSignal 添加到 Mixpanel

在您的 Mixpanel 集成中，添加 OneSignal。

在 Mixpanel 中添加 OneSignal 集成

将连接器名称设置为可识别的名称，如 OneSignal - APP_NAME，其中 APP_NAME 是 OneSignal 中应用的名称。 您需要在 OneSignal 设置 > 密钥和 ID 中提供以下数据：
  1. App ID
  2. API Key

​
USER ID mapping

此步骤对于群组同步和事件跟踪正常工作至关重要。
要在两个系统中匹配用户：
  • 使用共享标识符：OneSignal 中的**外部 ID**必须与选择的 Mixpanel 用户 ID 属性（如 user_id）匹配。
  • 验证选择的用户属性在您的 Mixpanel 和 OneSignal 用户配置文件中存在。

Mixpanel 用于设置 OneSignal 属性的仪表板。

验证您选择的用户 ID 属性在您的 Mixpanel 用户配置文件属性中可用。

Mixpanel > 用户 > 用户资料属性

Mixpanel 中用户配置文件属性的相同值必须与 OneSignal 中的外部 ID 匹配。

OneSignal > Audience > Users > External ID

如果您基于 Mixpanel $distinct_id 将用户匹配到 OneSignal，那么它只会与顶部值匹配。In below example, only 890ea9b1-9024-4fb9-a92f-152ba67dd21a will work. It cannot match 109768518080488203109 or $device:1880c06821f1b3-052354675cde95-1d525634-1fa400-1880c06821f1b3.

如果用于用户 ID 属性映射，设置 Distinct ID 时请谨慎。

完成后点击继续。
您现在应该能够将群组从 Mixpanel 导出到 OneSignal，并从 OneSignal 收集消息事件到 Mixpanel。

​
将 Mixpanel 群组导出到 OneSignal

只要具有上一步骤中讨论的匹配用户 ID/外部 ID 属性，您就可以将 Mixpanel 群组中的用户同步到 OneSignal 中的用户。 从 Mixpanel 导出用户数据不会在 OneSignal 中创建用户，用户必须已经存在并具有匹配的外部 ID。 从 Mixpanel 导出用户到 OneSignal：
  1. 在 Mixpanel 中，创建一个群组。
  2. 点击 选项 > 导出到… > OneSignal 连接名称。

如何将 Mixpanel 群组导出到 OneSignal。

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

Mixpanel frequency options.

​
OneSignal 细分创建

  • 同步的群组在 OneSignal 中显示为 Mixpanel 细分过滤器。
  • 如果满足以下条件，将自动为群组创建细分：
    • Mixpanel 群组中的用户也在 OneSignal 中存在并具有匹配的外部 ID。
    • 您不能超过 OneSignal 中的细分限制。
如果满足两个条件，OneSignal 将使用 Mixpanel 群组过滤器和群组名称自动生成细分。

如何从 Mixpanel 群组创建细分

常见问题：

​
在 Mixpanel 中追踪消息事件

连接后，OneSignal 将实时向 Mixpanel 发送消息事件。 要测试这一点，请从 OneSignal 向自己发送消息，然后导航到 Mixpanel 中的用户配置文件页面。 在活动源中，您应该看到事件填充：

带有 OneSignal 消息事件的 Mixpanel 活动源示例。

​
消息事件

这些是 OneSignal 发送到 Mixpanel 的消息事件类型。您可以在 OneSignal 集成设置中选择要发送到 Mixpanel 项目的事件。
Message Event Kind (OneSignal)Message Event Name (Mixpanel)Event Description
Push SentMessage Sent推送通知成功发送。
Push ReceivedMessage Received推送通知成功接收。
Push ClickedApp Opened from Push在设备上触摸推送通知。
Push FailedPush Failed推送发送失败。检查 OneSignal 中的失败消息报告。
Push UnsubscribedPush Unsubscribed订阅取消订阅推送。
In-App ImpressionMessage Sent应用内消息成功在设备上显示。
In-App ClickedMessage Opened在设备上点击应用内消息。
In-App Page DisplayedIn-App Page Displayed显示应用内消息页面。
Email SentMessage Sent电子邮件成功发送。
Email ReceivedMessage Received收件人收到电子邮件。
Email OpenedMessage Opened收件人打开电子邮件。
Email Link ClickedApp Opened from Push点击电子邮件链接。
Email UnsubscribedEmail Unsubscribed收件人取消订阅电子邮件。
Email Reported As SpamEmail Reported As Spam收件人将电子邮件报告为垃圾邮件。
Email BouncedEmail Bounced电子邮件因永久性错误返回发送方。
Email FailedEmail Failed无法将电子邮件投递到收件人的收件箱。
Email SuppressedEmail Suppressed电子邮件地址在您的抑制列表中。可能是退回或将您的电子邮件标记为垃圾邮件。
SMS SentApp Opened from Push短信发送给收件人。
SMS FailedSMS Failed短信发送失败。
SMS DeliveredSMS Received短信成功投递。
SMS UndeliveredSMS Undelivered短信无法发送。

​
事件属性

这些是从 OneSignal 发送到 Mixpanel 的任何事件中存在的属性
PROPERTY NAMEDESCRIPTION
Distinct ID与消息相关联的 external_id。
Message ID离散消息的标识符。
Message Name消息名称。
Message Title消息标题。
Message Contents消息内容。
message_type发送的消息类型，推送、应用内、电子邮件、短信。
template_id使用的消息模板（API 和旅程消息）。
subscription_idOneSignal 设置的设备/电子邮件/短信标识符。
device_type接收消息的设备类型。
language设备的两个字符语言代码。
sourceonesignal（被指示为所有事件的来源）
请参阅为什么传递数据不匹配？

​
常见问题

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

  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 上传。

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

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