---
title: "连接 Iterable"
description: "在 Iterable 中创建服务器端 API 密钥并完成连接，即可将新注册用户作为用户添加到 Iterable 列表中。"
url: https://scratcher.io/zh/help/integrations/iterable
language: zh-Hans
---

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

# 连接 Iterable

在 Iterable 中创建服务器端 API 密钥并完成连接，即可将新注册用户作为用户添加到 Iterable 列表中。

借助 Iterable 集成，每位注册用户都会在 Iterable 中以电子邮件地址为标识被创建或更新为用户，并订阅到您选择的 Iterable 列表。

## 准备工作

- 一个以电子邮件作为用户标识的 Iterable 项目，以及一位有权管理 API 密钥的用户（通常是组织管理员或项目管理员）。
- 了解您的 Iterable 项目位于美国还是欧盟数据中心。

## 第 1 步：在 Iterable 中创建 API 密钥

1. 在 Iterable 中，前往 **Integrations** > **API Keys**。
2. 点击 **New API Key**。
3. 为其命名，例如“Scratcher”，并选择 **Standard**（服务器端）类型。
4. 点击创建密钥并复制。Iterable 只会完整显示一次密钥。

## 密钥的用途

标准（服务器端）密钥可以完成 Scratcher 所需的操作：

- 读取您的列表和用户字段，以便您在活动中进行选择；
- 创建和更新用户；
- 将用户订阅到列表。

请勿使用 JavaScript、移动端或只读密钥：它们无法从服务器添加用户。

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

1. 在 Scratcher 中，前往 **设置** > **集成**，然后点击 **Iterable**。
2. 选择数据中心（美国或欧盟），并粘贴 API 密钥。
3. 点击 **安装集成**。Scratcher 会检查是否能读取您的列表。

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

1. 在编辑器中，前往 **连接** > **集成** > **Iterable**，然后点击 **激活**。
2. 如果您连接了多个项目，请在 **选择账户** 下选择所需项目。
3. 在 **外部列表** 下，选择 Iterable 列表。只能选择静态列表。
4. 在 **字段映射** 下，点击 **添加字段映射**，将每个 **Scratcher 字段** 与 Iterable 用户字段相对应，例如将“潜在客户 - 名字”对应到 **firstName**。
5. 在 **按授权筛选（可选）** 下，选择您的营销同意复选框。
6. 点击 **保存**，然后点击 **测试**。

## 字段映射

- 电子邮件地址始终会被发送，并用于识别用户。您无需映射它。
- **目标字段** 列表会显示您项目中的用户字段。如果某个字段尚不存在，请先在 Iterable 中创建，以确保其类型正确。
- 对于电话号码，请使用带 + 号和国家代码的 **格式**，这是 Iterable 发送短信所要求的格式。

## 同意

加入列表本身并不会让用户订阅您的消息类型：Iterable 对此使用其自身的订阅设置。请在 **按授权筛选（可选）** 下选择您的营销复选框，只发送表示同意的用户。您还可以将同意项的 **已接受** 和 **日期** 字段映射到用户字段，这样就能在 Iterable 中保留同意证明。

## 发送内容和时间

新注册用户会在一两分钟内发送，活动中已有的潜在客户会在您激活集成时发送。当有人再次参与时，该用户信息会被更新。您可以将该列表用作 Iterable 中某个旅程的起点，以发送欢迎消息。每次发送都会显示在 **设置** > **集成** > **发送状态** 下。

## 故障排除

- 安装时出现“All or some of the fields are invalid...”：密钥错误或不是标准密钥，或者您选错了数据中心。
- 某个字段被拒绝：该值与 Iterable 中用户字段的类型不符，例如在日期字段中填入了文本。请检查映射。
- 找不到列表：动态列表无法接收用户。请在 Iterable 中创建静态列表。

集成

- [集成的工作原理](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，我们会尽快回复您。
