从 Klaviyo 导入 Profile、Segment 与 List 到 SmartPush – SmartPush

本文将说明如何通过 Klaviyo 数据同步（Klaviyo Data Sync）集成功能，将 Klaviyo 中的 Profile（联系人）、Segment 与 List 迁移至 SmartPush，帮助您以最少的设置成本与数据损失，顺利从 Klaviyo 过渡到 SmartPush。

本文内容

概览
支持的数据范围
Klaviyo 数据如何迁移到 SmartPush
同步时机与频率
如何设置 Klaviyo 数据同步
集成状态与错误处理
订阅状态同步规则
注意事项与限制
常见问题（FAQ）

概览

SmartPush 支持与 Klaviyo 的主动集成。通过授权 Klaviyo Private API Key，SmartPush 可自动同步 Klaviyo 中的联系人及其相关属性、Segment 与 List 数据。

此导入机制旨在：

降低 Klaviyo 用户的迁移成本
保留既有受众结构
让您可立即在 SmartPush 中使用这些数据进行营销活动、自动化与人群细分

注意:

此功能适用于标准版及以上付费套餐。试用版商家可在试用期间使用该功能；免费版商家将被引导升级套餐。
此功能目前仅对白名单用户开放。如您有兴趣使用该功能，请联系团队协助将您的商店加入白名单。

支持的数据范围

目前 SmartPush 支持迁移以下 Klaviyo 数据：

联系人（Profile）数据

邮箱地址
手机号
Profile 属性（标准属性与自定义属性）
订阅状态（邮件与短信，受同步规则限制）

群组归属

Segment 名称
List 名称

本阶段不支持迁移 Segment 条件、Flow 逻辑、模板、营销活动、弹窗或自动化流程。

Klaviyo 数据如何迁移到 SmartPush

1. 联系人（Profile）

SmartPush 会获取您 Klaviyo 账号下的所有 Profile，并在 SmartPush 中创建对应的联系人。

每位导入的联系人都会被分配一个 SmartPush UID
从 Klaviyo 导入的联系人仅存储于 SmartPush 中
不会通过 Open API 在主站创建联系人

2. Profile 属性映射规则

SmartPush 会按照以下规则映射 Klaviyo 的 Profile 属性：

默认属性

Klaviyo 属性	SmartPush 属性	说明
email	email	已加密
phone_number	kla_phone_number	已加密
country	country	已加密
first_name + last_name	name	合并为一个字段

自定义属性

SmartPush 未原生支持的 Klaviyo 属性，将以自定义属性形式导入
所有自定义属性都会自动加上 kla_ 前缀
- 例如：kla_$source、kla_locale
这些属性可用于：
- Segment 条件筛选
- Flow 条件设置
- 联系人列表展示

3. Segment > SmartPush 标签（Tag）

Klaviyo 的 Segment 会以标签（Tag）的形式迁移到 SmartPush。

每个 Segment 名称都会转换为一个 Tag，并加上前缀：
kla_segment_
命名规则：
- 全部转为小写
- 空格转为下划线（_）

示例：

Klaviyo Segment：Repeat Purchasers
SmartPush Tag：kla_segment_repeat_purchasers

标签位置：Segment > 其他 > 自定义用户标签

4. List > SmartPush 标签（Tag）

Klaviyo 的 List 也会以标签形式迁移到 SmartPush。

每个 List 名称都会转换为 Tag，并加上前缀：
kla_list_

示例：

Klaviyo List：Newsletter
SmartPush Tag：kla_list_newsletter

这些标签可用于人群细分与营销定向。

同步时机与频率

SmartPush 支持 手动同步 与 自动同步 两种方式：

手动同步：当您主动开始联系人同步时触发
自动同步：每日执行一次增量同步，包括：
- 新增或更新的联系人
- Segment 与 List 归属变更

如何设置 Klaviyo 数据同步

步骤一：打开 Klaviyo 数据迁移

在 SmartPush 中：

前往 联系人 或 应用集成 页面，进入 Klaviyo 数据迁移入口
选择 同步 Klaviyo 联系人

或

前往应用 > 应用集成 > Klaviyo 数据迁移

步骤二：创建 Klaviyo Private API Key

在 Klaviyo 中：

前往 Account > Settings > API Keys
创建一个 Private API Key
确保该 Key 已开启以下权限：
- Profiles（联系人）
- Segments
- Lists

步骤三：在 SmartPush 中输入 API Key

将 Klaviyo Private API Key 粘贴至 SmartPush
点击集成
SmartPush 会验证 API Key，并开始同步数据

集成状态与错误处理

集成状态说明

待集成：尚未添加 API Key
同步中：已添加 API Key，数据同步进行中
同步暂停：
- API Key 失效或过期
- 同步发生错误
- 套餐降级

状态恢复

更换有效 API Key 后，同步将自动恢复
升级至付费套餐后，当检测到新增数据时将恢复同步

订阅状态同步规则

从 Klaviyo 同步联系人时：

已订阅的联系人会覆盖 SmartPush 中的订阅状态
未订阅的联系人仅在 SmartPush 内维护，不会覆盖

SmartPush 会自动处理不同平台之间的订阅状态优先级，您无需手动管理。

注意事项与限制

Segment 与 List 的条件规则不会被迁移
同步生成的标签名称无法在同步过程中自定义或重命名
部分 Klaviyo 属性因 API 限制为只读或不支持，将无法同步

常见问题（FAQ）

Q：同步 Klaviyo 数据会覆盖现有的 SmartPush 联系人吗？
A：SmartPush 会通过最新的 ID Mapping 逻辑安全合并联系人数据。

Q：可以停止同步 Klaviyo 数据吗？
A：可以，您可随时点击取消集成。

Q：SmartPush 会把数据同步回 Klaviyo 吗？
A：不会。该集成为单向同步，仅从 Klaviyo 同步至 SmartPush。