如何集成 StopChurn

了解如何将 StopChurn 连接到 B2CORE，以同步客户数据和关键客户事件，支持客户留存及 CRM 工作流程

通过与 StopChurn 集成，自动将客户数据和关键客户事件从 B2CORE 发送到 StopChurn。StopChurn 是一个客户留存和 CRM 平台，可利用这些数据对客户进行分群并开展留存活动。

该集成仅支持从 B2CORE 向 StopChurn 单向传输数据。B2CORE 是唯一的数据来源：StopChurn 只接收数据，不会将任何数据回传至 B2CORE。

继续之前，请确保您有权访问 StopChurn 后台，并已从 StopChurn 获取 API 密钥和 Brand ID。如有疑问，请联系 StopChurn 团队。

准备 StopChurn

在 B2CORE 中启用连接之前，请在 StopChurn 中完成以下步骤。

检查联系人表字段

在 StopChurn 后台，前往 数据库 > 表定义，打开用户（联系人）表。B2CORE 会为每位 StopChurn 联系人填充以下字段：

身份信息：ID、电子邮箱、电话号码、名字、姓氏、出生日期
地区和资料：国家（名称）、国家代码、货币、司法管辖区、语言、客户类型（个人或企业）、注册日期、验证级别
KYC：KYC 状态、KYC 提交日期、KYC 批准日期
入金：首次和最近一次入金的日期及金额、入金总额、净入金
交易：首次和最近一次交易日期、交易总次数、交易账户开立日期
营销归因：UTM 来源、UTM 媒介、UTM 活动、联盟 ID
营销偏好（电子邮件和电话）：当客户取消订阅营销信息或未同意接收营销信息时关闭
系统偏好（电子邮件和电话）：始终开启

日期以时间戳形式发送。联系人的货币始终为 USD，联系人记录中的所有入金金额均以 USD 计。

创建自定义事件

B2CORE 会向 StopChurn 发送六个自定义事件。请在 数据库 > 表定义 中点击 新建自定义事件，逐一创建：

名称 — 必须与下表中的值完全一致。
标签 — 可填写任意文本。
值类型 — 必填；必须与下表中的值一致。

事件	名称	值类型	值
注册完成	`REGISTRATION_COMPLETED`	`BOOLEAN`	始终为 `true`
验证级别变更	`VERIFICATION_LEVEL_CHANGED`	`NUMBER`	客户的新验证级别
KYC 已批准	`KYC_APPROVED`	`BOOLEAN`	始终为 `true`
KYC 已拒绝	`KYC_REJECTED`	`STRING`	拒绝原因（可能为空）
入金完成	`DEPOSIT_COMPLETED`	`JSON`	入金详情（参见入金事件字段）
首次入金	`FIRST_DEPOSIT`	`JSON`	入金详情（参见入金事件字段）。仅在客户首次成功入金时发送

启用连接前，请创建全部六个事件。如果 StopChurn 中缺少某个事件，或其值类型错误，StopChurn 将拒绝该事件，且该事件会丢失。被拒绝的事件不会重新发送。

入金事件字段

入金完成和首次入金事件包含以下字段：

amount — 以入金币种计的入金金额。
currency — 入金币种，例如 EUR。
amountInUSD — 按入金完成时的汇率换算为 USD 的入金金额，四舍五入保留两位小数。如果 B2CORE 当时没有该入金币种兑 USD 的汇率，此字段为空，但事件仍会发送。
paymentSystem — 客户使用的入金方式名称，与系统 > 入金系统 中该方式的名称字段完全一致，例如 b2binpay_enterprise。

如果您在 StopChurn 中将入金事件用作转化目标，请将 amountInUSD 设为目标值，以便统一使用一种货币衡量所有入金。

请为入金方式设置清晰、稳定的名称。如果重命名入金方式，StopChurn 收到的此后通过该方式完成的所有入金都会使用新名称，因此按旧名称筛选的 StopChurn 客户分群和客户旅程将不再匹配这些入金。

在 B2CORE 后台配置 StopChurn 连接

要配置 StopChurn 连接：

前往系统 > 外部连接。

点击页面右上角的 +创建。

在创建连接页面，填写以下字段：

在名称字段中，输入连接名称。名称必须唯一。
在显示名称字段中，输入该连接在后台显示的名称。
在提供商下拉列表中，选择 StopChurn。

点击保存以创建连接。

StopChurn 连接将出现在外部连接列表中。

点击编辑以输入连接详情，并填写以下字段：

环境 — 选择 StopChurn 环境：Staging 或 Production。
API 密钥 — 输入 StopChurn 提供的 API 密钥。
Brand ID — 输入接收数据的 StopChurn 品牌 ID。
用户表名称 — 可选。留空则使用 StopChurn 默认的 user 表。
外部 ID 策略 — 选择 B2CORE 在 StopChurn 中用作联系人 ID 的值：
- B2CORE 客户 ID（默认）
- B2CORE 客户电子邮箱
- 随机 UUIDv7
外部 ID 前缀 — 添加在联系人 ID 前的可选文本。允许使用字母、数字及 _ . : -，最多 32 个字符。如果多个品牌或 B2CORE 实例共用一个 StopChurn 账户，请使用前缀，避免联系人 ID 重叠。

点击测试连接，检查 StopChurn 是否接受该 API 密钥。测试不会在 StopChurn 中创建或更改任何数据。

检查连接状态。

如果连接处于停用状态（已启用字段显示 No），请在已启用下拉列表中选择 Yes 以启用连接。

点击保存以应用更改。

客户的 StopChurn 联系人 ID 在首次发送该客户的数据时确定，此后不会改变。如果之后更改外部 ID 策略或外部 ID 前缀，更改仅适用于尚未发送的客户。现有联系人保留原有 ID，因此 StopChurn 不会收到重复的联系人记录。

您可以同时启用多个 StopChurn 连接，例如为每个 StopChurn 品牌启用一个连接。每个已启用的连接都会接收所有客户数据和事件。

要在启用并测试连接后将现有客户发送到 StopChurn，请申请初始加载。

发送到 StopChurn 的数据

B2CORE 会自动向 StopChurn 发送数据。发生以下任一操作约一分钟后，B2CORE 会发送该客户完整的最新联系人记录及相关事件：

B2CORE 中的操作	发送的事件
客户注册	注册完成
客户的电子邮箱、状态、国家、客户类型、验证级别或司法管辖区发生变化	—
客户的名字、姓氏或出生日期发生变化	—
客户的电话号码发生变化	—
客户提交验证申请	验证级别变更
验证申请获批	验证级别变更、KYC 已批准
验证申请被拒绝	验证级别变更、KYC 已拒绝（附拒绝原因）
入金成功完成	入金完成；如果是客户首次成功入金，还会发送首次入金
客户取消订阅或重新订阅营销信息	—

每次发送都会完整更新 StopChurn 中的联系人记录，因此多次发送同一客户的数据不会造成问题。

所有客户的初始加载

自动发送仅涵盖产生新活动的客户。要将所有现有客户发送到 StopChurn，必须执行初始加载。如果您需要初始加载，请在创建并测试 StopChurn 连接后联系 B2BROKER 支持团队寻求协助。

重新同步最近更新的联系人

使用重新同步联系人，将过去一个月内资料有更新的所有客户发送到 StopChurn。发生短暂服务中断或配置错误后，可运行此操作，使 StopChurn 中的数据保持最新。

重新同步联系人不能替代初始加载。过去一个月内没有更新的客户不会包含在内。

要重新同步最近更新的联系人：

前往系统 > 外部连接，打开 StopChurn 连接。

点击操作 > 重新同步联系人。

绿色提示消息表示重新同步已开始。重新同步会在后台运行。

请注意以下事项：

重新同步联系人仅适用于已启用的 StopChurn 连接，且只有具备更新外部连接权限的后台用户才能使用。
每个连接每小时可运行一次重新同步。如果在一小时内再次点击该按钮，系统会显示还需等待多少分钟。
B2CORE 不会自动执行完整重新同步。在两次重新同步之间，联系人数据会通过自动发送保持最新。

注意事项和限制

联系人的货币始终为 USD，联系人记录中的所有入金金额均以 USD 计。入金事件同时包含原始金额和币种，以及以 USD 计的金额（amountInUSD）。
StopChurn 文档未说明在哪里查看收到的事件。请咨询 StopChurn 团队。

如何集成 StopChurn

本页目录