Klaviyo 数据导入工具将您的联系人名单和细分（Segment）从 Klaviyo 传输到 Omnisend，包括电子邮件地址、电话号码、订阅状态、自定义属性、同意许可记录和细分（Segment）定义。
联系人以每 5 秒 500 个的速度分批同步，因此一个包含 10,000 个联系人的联系人名单大约需要 2 分钟。支持的细分受众群会自动迁移。请按照本指南连接该工具并同步您的数据。
何时使用此工具
如果您要自行迁移联系人 和 细分（Segment） 数据，请使用 Klaviyo 数据导入工具。
💡 如果您已申请我们的免费的 Kickstart 服务（适用于每月 $250+ 的套餐），我们的团队将为您处理联系人和细分（Segment）导入 – 您无需遵循这些步骤。
此工具传输联系人信息（电子邮件、电话号码、姓名、属性、同意许可）和细分受众群。要迁移工作流、表单和模板，请参阅我们的从 Klaviyo 迁移到 Omnisend指南。
设置流程
第 1 步。在 Omnisend 中，点击右上角的 Apps。
第 2 步。找到使用搜索框找到 Klaviyo Data Import Tool，然后点击Connect now 按钮。
第 3 步。 您需要输入一个私有 API密钥（API Key）在您的 Klaviyo 账户中生成。
要生成一个，请保持 Omnisend 标签页打开，然后：
登录您的 Klaviyo 账户。
前往 Settings → API Keys。或者，点击以下链接：API 密钥。
进入后，点击 "Create Private API Key."
选择 Full Access Key 作为访问级别。为您的API密钥（API Key）命名（例如，'Omnisend 集成'），然后点击 Create。
💡 参阅 Klaviyo 的指南：如何创建私有 API密钥（API Key）。
完成后，复制 API密钥（API Key）。
第 4 步。 返回 Omnisend，粘贴 API密钥（API Key），然后点击连接。
第 5 步。点击Sync contacts & segments。
这将同步：
联系人，每 5 秒约 500 个批次。
细分受众群，自动同步。
注意：此集成不会实时同步联系人。如果您仍在使用 Klaviyo，手动再次启动同步以刷新联系人信息。
验证同步
点击 Sync contacts & segments 后：
您将看到联系人同步进行中在按钮和状态卡上。
完成后，状态将更新为 Completed（绿色徽章），并显示您上次同步的日期。
同步完成后，该工具将显示：
联系人导入
上次同步的联系人：最近一次同步中导入的联系人数量。
标签已更新的联系人：从 Klaviyo 细分受众群和列表中分配了标签的联系人数量。
状态：Completed（绿色）或 In Progress。
上次更新：最近一次同步的时间戳。
所有导入的联系人会立即显示在受众 → Contacts中，并带有标签klaviyo_import_app。
细分受众群迁移
在“联系人导入”卡片下方，您将看到一个包含以下内容的 Segments Migration 表：
Klaviyo 细分（Segment）： Klaviyo 中的细分（Segment）名称。
状态：
已迁移 ✅ – 细分（Segment）已成功同步。
失败 ❌ – 细分（Segment）使用了不受支持的筛选器或属性，无法在 Omnisend 中重新创建。
Omnisend 细分（Segment）： Omnisend 中已同步的细分（Segment）名称，带有可点击链接，可打开该细分（Segment）。
迁移日期： 细分（Segment）同步的最新日期。
提示：
点击已迁移的细分（Segment）名称，以查看其联系人、编辑条件，或在营销活动中使用它。
对于失败的细分受众群，请了解如何在 Omnisend 中手动重新创建它们。
同步了哪些数据
Klaviyo 数据导入工具将 联系人和细分 从 Klaviyo 同步到 Omnisend。
联系人
以下联系人属性已导入：
电子邮件地址
电话号码
名字
姓氏
地址
城市
国家
klaviyo_last_active_date （在 Omnisend 中创建的自定义属性（Custom Property），其值来自 Klaviyo）
所有来自 Klaviyo 的自定义属性，带有 klaviyo_ 前缀（例如，
favorite_color在 Omnisend 中变为klaviyo_favorite_color）标签 klaviyo_import_app 已添加到所有同步联系人
订阅状态
联系人订阅状态映射如下：
在 Klaviyo 中状态为 subscribed 的联系人将作为 Email/SMS subscribers 导入 Omnisend。订阅日期将设置为 Klaviyo 时间戳。
在 Klaviyo 中状态为 never subscribed 的联系人将作为 non-subscribers 导入 Omnisend。
在 Klaviyo 中状态为 unsubscribed 或 suppressed 的联系人将作为 unsubscribers 导入 Omnisend。退订日期将根据 Klaviyo 时间戳添加。
同意许可记录
如果出现以下情况，电子邮件（Email）同意许可记录会添加到 Omnisend 中的联系人资料：
consent timestamp属性存在于 Klaviyo 中，并且以下字段中至少有一个不为空：
$consent_method、$source、$consent_form_id、$consent_form_version
当 Klaviyo 中存在短信（SMS）同意许可时间戳时，短信（SMS）同意许可记录将添加到 Omnisend 的联系人资料中。
细分受众群
细分受众群在 Omnisend 支持其条件时同步：
细分（Segment）名称 – 在 Omnisend 中以 [OS] 为前缀。
筛选器和条件 - 当兼容时Omnisend 的细分（Segment）筛选器
联系人数量 - 在 Omnisend 中根据已同步的联系人重新计算。
使用 Klaviyo 特定功能（例如，predictive analytics）以及其他无法在 Omnisend 中重新创建的细分受众群将以 Failed 状态显示在“细分受众群迁移”表中。
重新启动手动同步
Klaviyo Data Import Tool 不会实时同步联系人或细分受众群。如果您在过渡到 Omnisend 期间仍在使用 Klaviyo，您需要手动重新同步以更新联系人信息并捕获新细分。
要重新同步：
第 1 步。在 Omnisend 中，前往Apps →Connected Apps（或点击此处）。然后，找到Klaviyo Data Import Tool 并点击编辑
步骤 2. 点击同步联系人与细分受众群
同步将再次运行，导入：
自上次同步以来添加到 Klaviyo 的新联系人。
已更新的联系人属性（例如，姓名更改、新的自定义字段）。
新建或修改的细分受众群。
"💡 提示：如果您同时运行这两个平台，请每天重新同步，以确保您的 Omnisend 受众保持最新。"
常见问题
为什么您的某些细分受众群未能迁移？
细分受众群在以下情况下会失败：使用高级的 AND/OR 组合与不支持的字段，或者使用 Klaviyo 特有的功能（例如 predictive analytics）。您可以在 Omnisend 中手动重新创建这些细分，使用受众 →Segments → 创建细分（Segment）。
我可以在 Omnisend 中编辑已迁移的细分受众群吗？
是。点击细分（Segment）迁移表中的细分（Segment）名称，以在受众 →细分受众，您可以在此处查看联系人、调整条件或重命名。
我如何知道哪些联系人来自 Klaviyo？
通过此工具导入的所有联系人将自动标记为klaviyo_import_app。您可以根据此标签在受众 → Contacts中进行筛选。
细分会实时同步吗？
否类似于联系人，细分受众群仅在您手动点击时同步同步联系人与细分受众群。如果您仍在Klaviyo上，请定期重新同步以获取新的细分受众群。
有问题？在应用内给我们留言或发送电子邮件至[email protected]。Omnisend 全天候为您服务。