> ## 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.

# 将 Klaviyo 连接到 LanderLab

> 将线索从你的 LanderLab 落地页实时直接发送到 Klaviyo 列表。几分钟即可完成集成设置，无需编写代码。

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

将 Klaviyo 连接到 LanderLab，即可在每位新线索提交表单的那一刻，自动将其发送到 Klaviyo 列表。无需手动导出，没有任何延迟。

## 前提条件

开始之前，请确保你已具备：

* 一个至少有一个已发布落地页的 LanderLab 账户
* 一个 Klaviyo 账户
* 一个 Klaviyo **Public API Key**（以 `pk_` 开头）

## 第 1 步：获取你的 Klaviyo API 密钥

1. 登录你的 [Klaviyo 账户](https://www.klaviyo.com)。
2. 点击左下角的账户名称，然后进入 **Settings**。
3. 打开 **API Keys** 标签页。
4. 复制你的 **Public API Key**，它以 `pk_` 开头。

<Note>
  请使用 Public API Key，而不是 Private API Key。LanderLab 中的字段要求 `pk_` 格式。
</Note>

## 第 2 步：将 Klaviyo 添加到 LanderLab

<Steps>
  <Step title="打开集成">
    在 LanderLab 中，从主导航进入 **Integrations**。
  </Step>

  <Step title="选择 Klaviyo">
    在集成列表中找到 Klaviyo，点击打开设置对话框。
  </Step>

  <Step title="输入你的凭据">
    填写以下字段：

    * **Name** - 该集成的标签（例如“Klaviyo”）。你可以将其重命名为任何便于日后辨认的名称。
    * **API Key** - 粘贴你的 Klaviyo Public API Key。

    点击 **Add Klaviyo** 保存并进入下一步。
  </Step>
</Steps>

## 第 3 步：配置集成

保存 API 密钥后，会打开第二个配置步骤。

<Steps>
  <Step title="选择 Klaviyo 列表">
    在 **List** 下，选择新线索应添加到的 Klaviyo 列表。下拉菜单会直接从 Klaviyo 拉取你的列表。
  </Step>
</Steps>

## 第 4 步：映射你的表单字段

字段映射步骤让你可以控制将 LanderLab 表单中的哪些数据发送到 Klaviyo，以及它们映射到哪个 Klaviyo 属性。

LanderLab 会在左侧显示所有可用字段。对于每个要发送的字段，使用右侧的下拉菜单选择对应的 Klaviyo 字段。

<Note>
  你必须至少映射一个字段才能继续。在至少设置一个字段映射之前，**Continue** 按钮将保持禁用状态。
</Note>

默认可用的字段包括：

* LL Lander URL
* LL Visitor IP
* LL Visitor User Agent
* LL Submission Time UTC
* LL Variant ID

你的落地页表单中的所有自定义字段也会出现在该列表中。

完成映射后点击 **Continue**。

## 第 5 步：审核并连接

最后一步会在任何内容上线之前显示你的集成配置摘要。

请检查以下内容：

* **List** - 线索将被添加到的 Klaviyo 列表
* **Field Mapping** - 要发送的字段及其对应的 Klaviyo 属性

如果一切无误，点击 **Connect Klaviyo**。使用 **Back** 进行修改。

连接完成后，你的落地页上采集到的每条新线索都会实时发送到 Klaviyo。

## 问题排查

<AccordionGroup>
  <Accordion title="我的 Klaviyo 列表无法加载">
    这通常意味着 API 密钥输入有误。请确认你使用的是 **Public API Key**（以 `pk_` 开头），而不是 Private API Key。返回集成设置，重新输入密钥后再试一次。
  </Accordion>

  <Accordion title="线索没有出现在 Klaviyo 中">
    请检查该集成是否已在你的落地页上启用，并且至少映射了一个字段。同时确认所选的 Klaviyo 列表正确，且该列表存在于你的 Klaviyo 账户中。
  </Accordion>

  <Accordion title="字段映射步骤中的 Continue 按钮被禁用">
    你需要至少映射一个字段才能继续。使用右侧的下拉菜单，为至少一个表单字段指定一个 Klaviyo 属性。
  </Accordion>
</AccordionGroup>


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