---
title: "连接 Apsis One"
description: "在 Apsis One 中创建 API 密钥并完成连接，将新注册用户连同其属性和订阅发送到某个分区，分步说明。"
url: https://scratcher.io/zh/help/integrations/apsis-one
language: zh-Hans
---

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

# 连接 Apsis One

在 Apsis One 中创建 API 密钥并完成连接，将新注册用户连同其属性和订阅发送到某个分区，分步说明。

通过 Apsis One 集成，每位注册用户都会在你选择的分区中被创建或更新为 Apsis One 资料，并可以选择加入你的某个 Apsis One 订阅。

## 准备工作

- 一个 Apsis One 账户，以及一位可以管理 API 密钥的用户（通常是管理员）。
- 了解你的 Apsis One 账户位于**欧洲**还是**亚洲**区域。大多数账户位于欧洲。

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

1. 在 Apsis One 中打开 **Account settings**，前往 **API keys**（位于集成下）。
2. 点击创建新的 API 密钥。为其起一个易于识别的名称，例如“Scratcher”。
3. 授予该密钥访问你希望 Scratcher 发送资料的一个或多个分区的权限，并设置下列权限。
4. 保存，然后复制 **Client ID** 和 **Client secret**。Secret 只会显示一次。

Apsis 为此提供了自己的分步指南。在 Scratcher 的安装对话框中，可以通过**设置指南**找到它（“要安装此集成，请按照此处的指南操作”）。

## 密钥所需的权限

Scratcher 使用该密钥来：

- 读取你的分区及其中的属性、订阅（同意主题）和事件，以便你在活动中进行选择；
- 创建资料并更新其属性；
- 为资料添加同意（选择加入）；
- 为资料添加事件。

因此，该密钥需要分区的读取权限，以及你所用分区中资料、同意和事件的写入权限。如果没有写入权限，发送会失败，并显示 Apsis One 自身的错误信息。

## 第 2 步：将 Apsis One 连接到 Scratcher

1. 在 Scratcher 中，前往**设置** > **集成**，然后点击 **Apsis One**。
2. 选择 **API 区域**：**欧洲**或**亚洲**。
3. 粘贴 **Client ID** 和 **Client secret**。
4. 点击**安装集成**。Scratcher 会登录 Apsis One 以验证信息。

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

1. 在编辑器中，前往**连接** > **集成** > **Apsis One**，然后点击**激活**。
2. 如果你连接了多个 Apsis One 账户，请在**选择账户**下选择要使用的账户。
3. 在 **Apsis 分区**下选择分区（**选择分区**）。
4. 在**字段映射**下，为每个字段点击**添加字段映射**，并将 **Scratcher 字段**与**目标字段**中的 Apsis One 属性对应起来。列表会显示所选分区的属性，包括你自己创建的属性。
5. 在**订阅（同意）**下，选择用户应加入的订阅，或选择**无**。“选择参与者应选择加入的订阅。”
6. 在\*\*按许可筛选（可选）\*\*下，选择你的营销同意复选框，这样只会发送勾选了该复选框的用户。
7. 点击**保存**，然后点击**测试**发送一份测试资料。

## 字段映射

- 电子邮件地址始终会被发送，并用于识别资料。你无需映射它。
- 对于电话号码，请使用**格式**设置，按照属性要求的格式发送号码。
- 是/否属性接收 true 或 false，因此请将同意的**已接受**字段映射到是/否属性。

## 同意

如果你选择了订阅，每个人都会以“Subscribed via”加活动名称作为原因、以“Scratcher”作为来源加入该订阅。如果该用户已经加入，则不会有任何变化。使用**按许可筛选**，确保只有勾选了营销复选框的用户才会加入。

如果你的分区包含 Apsis One 的同意表单事件，Scratcher 还会将这次注册作为事件记录到资料中，并附上活动地址。

## 发送内容和时间

新注册用户会在一两分钟内发送。激活集成时，活动的现有潜在客户也会被发送。当有人再次参与时，其资料会被更新。在**设置** > **集成** > **发送状态**下查看每次发送；其中还会显示该资料是新建的还是已存在的。请参阅[查看发送状态并重新发送潜在客户](https://scratcher.io/zh/help/integrations/delivery-status)。

## 故障排除

- 安装时出现“All or some of the fields are invalid...”：请检查区域，并重新复制 Client ID 和 Secret。
- 发送失败并显示 Apsis One 的访问错误：该密钥无权访问该分区，或缺少写入权限。请在 Apsis One 中编辑该密钥。
- \*\*订阅（同意）\*\*为空：该分区尚无订阅。请在 Apsis One 中创建一个订阅，然后重新打开集成。

集成

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