跳到内容
All articles
Setup

产品分析:Mixpanel、Amplitude 和 Segment

将 CRM 中的产品事件(例如“交易赢单”“新建线索”)发送到你的 Mixpanel、Amplitude 或 Segment,并将事件反向接收为联系人下的活动记录(BYO 模式,账户归你所有)。

产品分析集成使用你自己的 Mixpanel、Amplitude 或 Segment 账户(BYO 模式:自带账户)。CRM 会向你的分析平台发送产品事件(例如交易赢单或新建线索时),并接收反向事件,这些事件会成为对应联系人下的活动记录。我们这边不产生任何成本、加价或中间环节:事件直接发往你的账户,也直接从你的账户返回。

集成一开始处于未激活状态:在你填写凭据并启用之前不会发生任何事。所有密钥(project token、API key、write key)都会以加密方式存储在 CRM 中,且永远不会再次显示出来。每个平台在“设置 → 集成”中都有各自的卡片;webhook 网址是唯一的(/api/inbound/analytics/…),CRM 通过该网址中的令牌识别是哪个平台。

前提条件

  • 拥有可查看接入凭据权限的 Mixpanel、Amplitude 或 Segment 账户。
  • Mixpanel:Project Token(设置 → Project Settings)。Amplitude:项目 API Key(设置 → Projects)。Segment:HTTP API 数据源的 Write Key(Connections → Sources)。
  • 要接收反向事件,需要能够将服务商的导出/webhook 指向一个网址。
  • 在 Sellio 中拥有管理员权限,以便在“设置 → 集成”中保存凭据并启用集成。

工作原理

  • 出站(CRM → 服务商):每个事件都会携带一个人员标识符(distinct id / user id,默认使用记录的邮箱)和属性一起发送。发送是按服务商的去重键幂等的:Mixpanel 使用 $insert_id,Amplitude 使用 insert_id,Segment 使用 messageId,因此重复发送同一事件不会产生重复。
  • 入站(服务商 → CRM):当服务商向 webhook 网址 POST 一个事件时,CRM 会记录一条活动,并将其关联到对应邮箱的联系人。如果该邮箱在 CRM 中不存在,活动会保持未关联状态(不会丢失)。
  • 推荐的发送事件方式是自动化动作“发送事件(分析)”(见下文)。卡片上的“发送测试事件”按钮可端到端验证配置是否正确。

“发送事件(分析)”自动化动作

在“设置 → 自动化”中,新建或编辑一条规则并添加“发送事件(分析)”动作。选择服务商(Mixpanel/Amplitude/Segment)、事件名称(例如“Deal won”;可使用 {{field}} 插入记录数据),以及可选的人员标识符(distinct id,默认使用 {{email}})。规则触发时,事件会在提交后以尽力而为的方式发送。如果集成未激活,该动作不会做任何事(受门控保护)。

💡 示例:在商机上创建一条条件为“阶段 = 赢单”的规则,并添加事件名为“Deal Won”的“发送事件(分析)”动作,即可在每笔成交时向 Mixpanel/Amplitude 中的漏斗填充数据。

Mixpanel

  1. 打开“设置 → 集成”,找到“产品分析(Mixpanel)”卡片。
  2. 粘贴 Project Token(Mixpanel → 设置 → Project Settings → Project Token)并选择区域(仅当你的项目使用欧洲数据驻留时选择 EU)。点击“保存分析设置”。
  3. 点击“激活”。使用任意 distinct id 点击“发送测试事件”进行确认。
  4. 要接收事件,请将 Mixpanel 的 webhook/导出指向“Webhook 网址”。Mixpanel 不会对导出 webhook 进行签名:安全性依赖于不可预测的网址令牌,因此请将其视为机密。

Amplitude

  1. 在 CRM 中找到“产品分析(Amplitude)”卡片。
  2. 粘贴 API Key(Amplitude → 设置 → Projects → API Key)并选择区域。点击“保存分析设置”,然后点击“激活”。
  3. 出站事件会发往 /2/httpapi。要接收事件,请将 Amplitude 的导出/webhook 指向“Webhook 网址”(Amplitude 不签名:网址令牌就是防护手段)。

Segment

  1. 在 CRM 中找到“产品分析(Segment)”卡片。
  2. 在 Segment 中创建一个 HTTP API 数据源(Connections → Sources)并粘贴 Write Key。可选地设置一个 webhook 密钥(用于要求对入站事件进行签名验证)。点击“保存分析设置”并“激活”。
  3. 出站:事件发往 /v1/track,使用 write key 的 Basic 认证。入站:在 Segment 中创建一个 Webhook 目标(或函数),指向“Webhook 网址”。默认情况下 Segment 不签名;如果你设置了密钥,CRM 会校验 x-signature 请求头(HMAC-SHA1);否则,网址令牌就是防护手段。

请将 webhook 网址和凭据视为机密。如果在没有必要凭据的情况下尝试激活,集成会保持未生效状态,一切就绪之前不会发送或接收任何内容。

如何测试

  1. 出站:在卡片上使用任意 distinct id 点击“发送测试事件”,并在你的 Mixpanel/Amplitude/Segment 中确认事件已到达(Live View / Debugger)。
  2. 自动化:创建一条包含“发送事件(分析)”动作的规则并触发它;在服务商处检查该事件。
  3. 入站:让服务商向“Webhook 网址”发送一个事件,邮箱需对应一个已存在的联系人,然后在该联系人下检查活动记录。

故障排查

  • 401 错误 / 事件未出现:凭据错误。Mixpanel → Project Token;Amplitude → API Key;Segment → Write Key(通过 Basic 认证)。请重新粘贴正确的凭据。
  • 区域错误:如果你的项目使用 EU 数据驻留,请勾选 EU 区域。否则事件会发往错误的端点而不会出现。
  • 自动化未发送:“发送事件(分析)”动作受门控保护:如果集成未激活,该动作不会做任何事。请激活集成,并确认动作中选择的服务商是否正确。
  • 入站未变成活动记录:如果事件邮箱在 CRM 中不存在,活动会保持未关联状态(不会丢失)。Segment:如果你设置了密钥,请校验 x-signature 请求头(HMAC-SHA1)。
  • webhook 网址返回 404:集成已停用或令牌已更改。请重新激活并重新复制网址。

Open this article inside the system

Read it and want to see it working?

The account is free and the whole manual is available inside the system, with an assistant that answers from this very content.

免费创建账户
产品分析:Mixpanel、Amplitude 和 Segment · Sellio