---
title: "连接 Klaviyo"
description: "在 Klaviyo 中创建具有正确权限范围的私有 API 密钥并完成连接，即可让新注册用户订阅 Klaviyo 列表。"
url: https://scratcher.io/zh/help/integrations/klaviyo
language: zh-Hans
---

1. [帮助中心](https://scratcher.io/zh/help)
2. [集成](https://scratcher.io/zh/help/integrations)
3. 连接 Klaviyo

# 连接 Klaviyo

在 Klaviyo 中创建具有正确权限范围的私有 API 密钥并完成连接，即可让新注册用户订阅 Klaviyo 列表。

借助 Klaviyo 集成，每位注册用户都会在 Klaviyo 中被创建或更新为档案，添加到您选择的列表中，并订阅电子邮件营销。

## 准备工作

- 一个 Klaviyo 账户。免费套餐即可。
- 一位可以创建私有 API 密钥的 Klaviyo 用户（在 Klaviyo 中通常是 **Owner**、**Admin** 或 **Manager**）。

## 第 1 步：在 Klaviyo 中创建私有 API 密钥

1. 在 Scratcher 中，前往 **设置** > **集成**，点击 **Klaviyo**，查看 **设置指南**：“创建私有 API 密钥。正确的权限已预先选好。”
2. 点击 **创建私有 API 密钥** 链接。Klaviyo 会打开，并已选好正确的权限范围。如果 Klaviyo 要求登录，请登录。
3. 为密钥起一个您能认出的名称，例如“Scratcher”。
4. 检查权限范围（见下方列表），然后点击创建密钥。
5. 复制密钥。它以“pk\_”开头。Klaviyo 只会完整显示一次密钥，因此在粘贴之前请保持该标签页打开。

如果您更愿意自己创建密钥：在 Klaviyo 中，打开您账户名称下的菜单，前往 **Settings** > **API keys**，然后点击 **Create Private API Key**。选择 **Custom Key** 并设置以下权限范围。

## 密钥所需的权限范围

密钥需要且仅需要以下权限范围（Scratcher 的帮助文本：“API 密钥需要对“Lists”和“Profiles”的读写权限，以及对“Subscriptions”的写入权限”）。

- **Lists**：读取和写入。用于显示您的列表并将用户添加到列表中。
- **Profiles**：读取和写入。用于创建和更新档案。
- **Subscriptions**：写入。用于让用户订阅电子邮件营销。

其他所有权限范围都可以保持为 **No Access**。

## 第 2 步：将 Klaviyo 连接到 Scratcher

1. 在 Scratcher 的 Klaviyo 对话框中，将密钥粘贴到 **私有 API 密钥**。**访问权限** 框中列出了 Scratcher 可以执行的操作：“对联系人和列表的读写权限”和“自动在后台同步活动参与者”。
2. 点击 **安装集成**。Scratcher 会检查该密钥能否读取您的列表。

## 第 3 步：在活动中启用

1. 在编辑器中，前往 **连接** > **集成** > **Klaviyo**，然后点击 **激活**。
2. 如果您连接了多个 Klaviyo 账户，请在 **选择账户** 下选择所需账户。
3. 在 **外部列表** 下，选择 Klaviyo 列表。
4. 在 **字段映射** 下，添加您希望出现在档案上的额外数据。在这里，您需要自己输入 Klaviyo 中的属性名称（**外部字段名称**），例如“favourite\_product”或“Campaign”。
5. 在 **按授权筛选（可选）** 下，选择您的营销同意复选框。
6. 点击 **保存**，然后点击 **测试**。

## 字段映射

- 电子邮件、电话号码、名字和姓氏会自动发送到 Klaviyo 自身的档案字段。您无需映射它们。
- 您映射的所有内容都会以您输入的名称保存为档案上的自定义属性。如果该属性尚不存在，Klaviyo 会自动创建。
- Klaviyo 只接受带 + 号和国家代码的电话号码。请确保表单中的电话字段带有国家代码。

## 同意

Scratcher 会让发送过去的每个人在 Klaviyo 中订阅电子邮件营销，来源标记为“Scratcher”。因此同意筛选非常重要：如果您表单上的营销复选框是可选的，请在 **按授权筛选（可选）** 下选择它。

如果您的 Klaviyo 列表使用双重选择加入，Klaviyo 会发送自己的确认邮件，用户确认后才会被订阅。之后，您可以在用户被添加到列表时于 Klaviyo 中启动欢迎流程。

## 发送内容和时间

新注册用户会在一两分钟内发送。激活集成时，活动中已有的潜在客户也会被发送。当有人再次参与时，其档案会被更新。

## 故障排除

发送失败的记录会显示在 **设置** > **集成** > **发送状态** 下。

- “The API key used does not have the correct API Scopes.”：密钥缺少上述某个权限范围。请在 Klaviyo 中编辑该密钥，或通过设置链接创建一个新密钥，并使用 **添加新账户** 进行连接。
- “Conflict: Duplicate profile detected.”：Klaviyo 找到了两个匹配的档案，例如一个使用该电子邮件，另一个使用相同的电话号码。请在 Klaviyo 中合并或修正这些档案，然后重新发送。
- 电话号码被拒绝：号码中没有国家代码。请在表单的电话字段中添加国家选择器。
- 安装后没有收到任何数据：请检查是否已在活动的 **外部列表** 下选择了列表，以及是否点击了 **保存**。

集成

- [集成的工作原理](https://scratcher.io/zh/help/integrations/how-integrations-work)
- [所有集成](https://scratcher.io/zh/help/integrations/other-integrations)
- [查看发送状态并重新发送潜在客户](https://scratcher.io/zh/help/integrations/delivery-status)
- [连接 HubSpot](https://scratcher.io/zh/help/integrations/hubspot)
- [连接 Salesforce Marketing Cloud](https://scratcher.io/zh/help/integrations/salesforce-marketing-cloud)
- [通过 Zapier 连接 Microsoft Dynamics 365](https://scratcher.io/zh/help/integrations/microsoft-dynamics-365)
- [连接 Emarsys](https://scratcher.io/zh/help/integrations/emarsys)
- [连接 Klaviyo](https://scratcher.io/zh/help/integrations/klaviyo)
- [连接 Mailchimp](https://scratcher.io/zh/help/integrations/mailchimp)
- [连接 ActiveCampaign](https://scratcher.io/zh/help/integrations/activecampaign)
- [连接 Apsis One](https://scratcher.io/zh/help/integrations/apsis-one)
- [连接 Drip](https://scratcher.io/zh/help/integrations/drip)
- [连接 HeyLoyalty](https://scratcher.io/zh/help/integrations/heyloyalty)
- [连接 Peytz](https://scratcher.io/zh/help/integrations/peytz)
- [连接 Marketingplatform](https://scratcher.io/zh/help/integrations/marketingplatform)
- [通过 Zapier 连接 Campaign Monitor](https://scratcher.io/zh/help/integrations/campaign-monitor)
- [通过 Zapier 连接 ActiveTrail](https://scratcher.io/zh/help/integrations/activetrail)
- [连接 Bloomreach](https://scratcher.io/zh/help/integrations/bloomreach)
- [连接 Iterable](https://scratcher.io/zh/help/integrations/iterable)
- [连接 Mapp](https://scratcher.io/zh/help/integrations/mapp)
- [连接 Agillic](https://scratcher.io/zh/help/integrations/agillic)
- [连接 Ortto](https://scratcher.io/zh/help/integrations/ortto)
- [连接 Emarketeer](https://scratcher.io/zh/help/integrations/emarketeer)
- [连接 Shopify](https://scratcher.io/zh/help/integrations/shopify)
- [连接 Hello Retail](https://scratcher.io/zh/help/integrations/hello-retail)
- [通过 Zapier 连接 8,000 多款应用](https://scratcher.io/zh/help/integrations/zapier)
- [通过 Zapier 连接 monday.com](https://scratcher.io/zh/help/integrations/monday-com)
- [通过 Zapier 连接 Asana](https://scratcher.io/zh/help/integrations/asana)
- [通过 Zapier 连接 Podio](https://scratcher.io/zh/help/integrations/podio)
- [通过 Zapier 连接 Intercom](https://scratcher.io/zh/help/integrations/intercom)

继续学习

## 相关文章

- [集成的工作原理](https://scratcher.io/zh/help/integrations/how-integrations-work): 只需连接一次你的邮件工具或 CRM，在每个活动中启用，选择列表，映射字段，并只发送已给予同意的用户。
- [查看发送状态并重新发送潜在客户](https://scratcher.io/zh/help/integrations/delivery-status): 查看哪些潜在客户已发送到你的工具，理解错误信息，解决问题并重新发送。
- [征求同意并添加条款和条件](https://scratcher.io/zh/help/forms/consent-and-permissions): 为新闻通讯添加同意复选框，链接您的条款，选择哪个复选框用于订阅，并只把表示同意的用户发送到您的邮件工具。

需要帮助？

## 仍需要帮助？

真人团队随时为您提供帮助。如果您已在使用 Scratcher，最快的方式是使用平台内的聊天功能。

- **[与我们聊天](https://platform.scratcher.io/zh-Hans/login)**

    登录后点击右下角的聊天按钮。Rex 会立即回复，我们的团队也只需一键即可联系。
- **[预约会议](https://scratcher.io/zh/book-a-meeting)**

    与我们的团队进行免费 30 分钟视频通话：产品演示、活动创意或设置协助。
- **[给我们发邮件](mailto:contact@scratcher.io)**

    发送邮件至 contact@scratcher.io，我们会尽快回复您。
