产品分析: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}})。规则触发时,事件会在提交后以尽力而为的方式发送。如果集成未激活,该动作不会做任何事(受门控保护)。
Mixpanel
- 打开“设置 → 集成”,找到“产品分析(Mixpanel)”卡片。
- 粘贴 Project Token(Mixpanel → 设置 → Project Settings → Project Token)并选择区域(仅当你的项目使用欧洲数据驻留时选择 EU)。点击“保存分析设置”。
- 点击“激活”。使用任意 distinct id 点击“发送测试事件”进行确认。
- 要接收事件,请将 Mixpanel 的 webhook/导出指向“Webhook 网址”。Mixpanel 不会对导出 webhook 进行签名:安全性依赖于不可预测的网址令牌,因此请将其视为机密。
Amplitude
- 在 CRM 中找到“产品分析(Amplitude)”卡片。
- 粘贴 API Key(Amplitude → 设置 → Projects → API Key)并选择区域。点击“保存分析设置”,然后点击“激活”。
- 出站事件会发往 /2/httpapi。要接收事件,请将 Amplitude 的导出/webhook 指向“Webhook 网址”(Amplitude 不签名:网址令牌就是防护手段)。
Segment
- 在 CRM 中找到“产品分析(Segment)”卡片。
- 在 Segment 中创建一个 HTTP API 数据源(Connections → Sources)并粘贴 Write Key。可选地设置一个 webhook 密钥(用于要求对入站事件进行签名验证)。点击“保存分析设置”并“激活”。
- 出站:事件发往 /v1/track,使用 write key 的 Basic 认证。入站:在 Segment 中创建一个 Webhook 目标(或函数),指向“Webhook 网址”。默认情况下 Segment 不签名;如果你设置了密钥,CRM 会校验 x-signature 请求头(HMAC-SHA1);否则,网址令牌就是防护手段。
请将 webhook 网址和凭据视为机密。如果在没有必要凭据的情况下尝试激活,集成会保持未生效状态,一切就绪之前不会发送或接收任何内容。
如何测试
- 出站:在卡片上使用任意 distinct id 点击“发送测试事件”,并在你的 Mixpanel/Amplitude/Segment 中确认事件已到达(Live View / Debugger)。
- 自动化:创建一条包含“发送事件(分析)”动作的规则并触发它;在服务商处检查该事件。
- 入站:让服务商向“Webhook 网址”发送一个事件,邮箱需对应一个已存在的联系人,然后在该联系人下检查活动记录。
故障排查
- 401 错误 / 事件未出现:凭据错误。Mixpanel → Project Token;Amplitude → API Key;Segment → Write Key(通过 Basic 认证)。请重新粘贴正确的凭据。
- 区域错误:如果你的项目使用 EU 数据驻留,请勾选 EU 区域。否则事件会发往错误的端点而不会出现。
- 自动化未发送:“发送事件(分析)”动作受门控保护:如果集成未激活,该动作不会做任何事。请激活集成,并确认动作中选择的服务商是否正确。
- 入站未变成活动记录:如果事件邮箱在 CRM 中不存在,活动会保持未关联状态(不会丢失)。Segment:如果你设置了密钥,请校验 x-signature 请求头(HMAC-SHA1)。
- webhook 网址返回 404:集成已停用或令牌已更改。请重新激活并重新复制网址。