> ## Documentation Index
> Fetch the complete documentation index at: https://docs.landerlab.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 设置 ActiveCampaign 集成

> 了解如何将 ActiveCampaign 连接到你的 LanderLab 落地页，将线索实时同步到你的 ActiveCampaign 列表和自动化流程。

<Frame>
  <img src="https://mintcdn.com/landerlab-babdc23f/z2Nyn8JYMMirC6py/images/LL-AC.png?fit=max&auto=format&n=z2Nyn8JYMMirC6py&q=85&s=87379a281f9fc86b6232eeb0939dd282" alt="LanderLab 与 ActiveCampaign 的 logo 并排展示，代表 ActiveCampaign 集成" width="1200" height="600" data-path="images/LL-AC.png" />
</Frame>

## 什么是 ActiveCampaign？为什么要使用这个集成？

ActiveCampaign 是一个邮件营销和 CRM 平台，用于管理联系人列表、运行自动化流程和发送定向邮件活动。当你将 ActiveCampaign 连接到 LanderLab 落地页后，每一个提交表单的线索都会立即被添加为你所选 ActiveCampaign 列表中的联系人，同时应用标签，并将表单字段映射到正确的联系人属性。

ActiveCampaign 的连接分为两个阶段。首先，使用你的 Account URL 和 API 密钥将 ActiveCampaign 账户添加到 LanderLab。然后，将该账户连接到你的落地页，并配置列表、标签和字段映射。

<Note>
  ActiveCampaign 集成**不会**全局保存。每个集成都是按落地页单独配置的，因此你需要为每个需要同步线索的落地页单独设置一个新的 ActiveCampaign 连接。
</Note>

## 开始之前

开始之前，你需要从 ActiveCampaign 账户中获取两项信息：

* **Account URL** - 你唯一的 ActiveCampaign 账户 URL（例如 `https://your-account.api-us1.com`）
* **API Key** - 你的 ActiveCampaign API 密钥

要找到这两项信息，请登录 ActiveCampaign，在左侧边栏中进入 **Settings**，然后点击 **Developer**。你的 Account URL 和 API 密钥会显示在该页面上。

## 如何添加 ActiveCampaign

### 第 1 阶段：添加你的 ActiveCampaign 账户

<Steps>
  <Step title="进入你的落地页">
    前往 **Landing Pages**，点击你想添加 ActiveCampaign 的**落地页名称**。
  </Step>

  <Step title="打开集成标签页">
    点击 **Add Integration** 打开集成面板。
  </Step>

  <Step title="选择 ActiveCampaign">
    在可用集成列表中找到 **ActiveCampaign**（标注为“Sync leads with ActiveCampaign as they come in”）并点击。
  </Step>

  <Step title="填写账户凭据">
    输入以下信息：

    | 字段 | 说明 |
    | :- | :- |
    | **Name** | 用于识别该账户连接的标签（例如“ActiveCampaign Main Account”）。 |
    | **Account URL** | 你的 ActiveCampaign 账户 URL（例如 `https://your-account.api-us1.com`）。 |
    | **API Key** | 你在 Developer 设置页面中获取的 ActiveCampaign API 密钥。 |
  </Step>

  <Step title="点击 Add ActiveCampaign">
    点击 **Add ActiveCampaign** 完成身份验证并保存你的账户。LanderLab 会验证凭据并连接到你的 ActiveCampaign 账户。
  </Step>
</Steps>

### 第 2 阶段：配置列表、标签和字段映射

添加账户后，向导会进入集成配置环节。你可以在这里选择要将线索添加到哪些列表，以及表单字段如何映射到 ActiveCampaign 联系人属性。

#### 第 1 步：配置列表和标签

<Steps>
  <Step title="为该集成设置名称">
    为该集成设置一个容易识别的标签（例如“ActiveCampaign - Solar Leads”），方便你在落地页的集成列表中辨认。
  </Step>

  <Step title="选择你的列表">
    点击 **Lists** 下拉菜单，选择一个或多个 ActiveCampaign 列表。通过该落地页提交的每一条线索都会被添加为你在此处所选列表中的联系人。此字段为必填。

    <Note>
      列表必须已存在于你的 ActiveCampaign 账户中。你无法在这一步创建新列表。
    </Note>
  </Step>

  <Step title="添加标签（可选）">
    在 **Tags** 字段中，从现有标签中选择，或输入以创建新标签。标签会应用到通过该落地页添加的每一位联系人，可用于按活动、优惠或流量来源对线索进行细分。
  </Step>

  <Step title="点击 Continue">
    点击 **Continue** 进入字段映射步骤。
  </Step>
</Steps>

#### 第 2 步：映射你的字段

<Steps>
  <Step title="将表单字段映射到 ActiveCampaign 联系人属性">
    左侧会列出落地页表单中的所有字段，右侧有一个下拉菜单，用于选择对应的 ActiveCampaign 联系人属性。

    将每个表单字段映射到对应的 ActiveCampaign 属性。至少要映射 **Email**，因为创建联系人必须提供邮箱。

    | 表单字段 | ActiveCampaign 属性 |
    | :- | :- |
    | Full Name | Full Name |
    | Email | Email\* |
    | Phone Number | Phone |
    | （其他表单字段） | Select field |

    未映射的字段不会被发送到 ActiveCampaign。使用左侧的复选框来包含或排除单个字段。

    <Tip>
      LanderLab 还提供系统字段，例如 **LL Lander URL**、**LL Visitor IP**、**LL Visitor User Agent**、**LL Submission Time UTC** 和 **LL Variant ID**。如果你想将跟踪数据与联系人记录一起保存，可以将它们映射到 ActiveCampaign 中的自定义字段。
    </Tip>
  </Step>

  <Step title="点击 Continue">
    点击 **Continue** 进入审核步骤。
  </Step>
</Steps>

#### 第 3 步：审核并连接

<Steps>
  <Step title="审核你的集成">
    最后一步会显示 ActiveCampaign 集成的完整摘要，包括集成名称、所选列表、应用的标签以及所有已映射字段。启用前请仔细检查所有内容。

    如果有任何问题，点击 **Back** 返回前面的步骤进行修改。
  </Step>

  <Step title="点击 Connect ActiveCampaign">
    点击 **Connect ActiveCampaign** 保存并启用集成。从此以后，在该落地页上提交的每一条线索都会实时同步到 ActiveCampaign。
  </Step>
</Steps>

## ActiveCampaign 集成使用技巧

* **Email 为必填** - ActiveCampaign 使用邮箱作为联系人的唯一标识。请务必映射邮箱字段，并确保你的表单包含邮箱输入框。
* **现有联系人会被更新** - 如果线索提交的邮箱在 ActiveCampaign 中已存在，LanderLab 会更新现有联系人记录，而不是创建重复联系人。
* **使用标签触发自动化** - 如果你在 ActiveCampaign 中设置了在应用某个标签时触发的自动化流程，在此处添加对应标签就会自动将新线索加入这些自动化流程。
* **使用列表按活动细分** - 将不同的落地页分配到不同的列表，按优惠、产品或流量来源整理你的联系人。
* **用真实提交进行测试** - 连接完成后，在你的落地页上提交一条测试线索，并确认该联系人在几秒钟内出现在你的 ActiveCampaign 账户中。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.