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

# 设置 Leadprosper 集成

> 了解如何将 Leadprosper 连接到 LanderLab，从任意落地页或测验漏斗将线索实时直接发送到你的 Leadprosper 活动。

> 在 LanderLab 中将 LeadProsper 连接到你的落地页，将线索数据实时直接发送到你的 LeadProsper 活动。根据你的活动配置，在 Direct Post 和 Ping-Post 之间进行选择。

## 什么是 LeadProsper？

LeadProsper 是一个线索分发平台，线索生成商、联盟客和广告主使用它来实时接收、校验线索并将其路由给买家。它同时支持直接推送（将线索直接发送到活动）和 ping-post 工作流（先发送部分数据，让买家在收到完整线索前出价）。

当你在 LanderLab 中将 LeadProsper 连接到落地页后，页面上收集的每条线索都会自动推送到你的 LeadProsper 活动。LanderLab 会替你处理 API 连接，因此你无需编写自定义代码，也无需手动构建服务器端集成。

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

## Direct Post 与 Ping-Post 对比

LanderLab 为 LeadProsper 支持两种推送类型。你可以在设置过程中根据 LeadProsper 活动的配置方式选择类型。

**Direct Post** 会在一次请求中将完整的线索数据发送到 LeadProsper。随后，线索会被校验，并根据你的活动规则分发给买家。这是更简单的选项，适合线索交付流程较为直接的场景。

**Ping-Post** 是一个两步流程。首先，发送一个包含部分线索数据（例如邮政编码或州）的 “ping”，让买家决定是否想要该线索并出价。如果出价被接受，则发送第二个包含完整线索信息的 “post”。这种方式适用于多个买家实时竞争线索的场景。

## 如何添加 LeadProsper

LeadProsper 设置采用 3 步向导：配置连接、映射字段，并在连接前检查最终的 payload。

### 步骤 1：配置连接

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

  <Step title="打开集成选项卡">
    点击 **Add Integration**，打开集成面板。
  </Step>

  <Step title="选择 LeadProsper integration">
    在可用集成列表中找到 **LeadProsper integration**（标注为 “Send leads to LeadProsper in real time”）并点击。随后会打开配置向导。
  </Step>

  <Step title="填写连接详情">
    首先为此集成输入一个 **Name**（例如 “LeadProsper - Auto Loans”）。然后根据你的 LeadProsper 活动配置选择 **Type**：**Direct Post** 或 **Ping-Post**。

    两种类型都需要相同的三个字段：

    | 字段 | 说明 |
    | :- | :- |
    | **LP Campaign ID** | 你的 LeadProsper 活动的数字 Campaign ID（例如 `12345`）。 |
    | **LP Supplier ID** | LeadProsper 中分配给你供应商账户的数字 Supplier ID（例如 `6789`）。 |
    | **LP Key** | 与你的活动和供应商关联的唯一密钥，在 LeadProsper 内生成。 |

    这三个值对每个 LeadProsper 活动都是唯一的，Direct Post 和 Ping-Post 设置均需要它们。

    <Tip>
      要查找你的 **LP Campaign ID**、**LP Supplier ID** 和 **LP Key**，请打开你的 LeadProsper 活动，进入 **Supplier API Specs**（也称为 Posting Guide），然后查找 `lp_campaign_id`、`lp_supplier_id` 和 `lp_key` 的值。它们作为必填静态字段列在 API 文档顶部。
    </Tip>
  </Step>

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

### 步骤 2：映射字段

在这一步中，你可以选择请求中包含哪些数据字段，以及它们发送到 LeadProsper 时使用的名称。

<Steps>
  <Step title="选择并配置字段">
    LanderLab 会自动包含一组默认的 LanderLab 字段。每个字段都有一个复选框用于包含或排除该字段，还有一个 **Sent As** 列，你可以在其中重命名键，使其与 LeadProsper 期望的一致。

    默认的 LanderLab 字段如下：

    | 表单字段 | Sent As（默认键） | 说明 |
    | :- | :- | :- |
    | **LL Lander URL** | `ll_lander_url` | 访客所在落地页的完整 URL。 |
    | **LL Visitor IP** | `ll_visitor_ip` | 访客的 IP 地址。 |
    | **LL Visitor User Agent** | `ll_visitor_user_agent` | 访客的浏览器和设备信息。 |
    | **LL Submission Time UTC** | `ll_submission_time_utc` | 线索提交的日期和时间（UTC）。 |
    | **LL Variant ID** | `ll_variant_id` | 向访客展示的 A/B 测试变体 ID。 |

    使用复选框启用或禁用任意字段。你也可以编辑 **Sent As** 的值，使其与你的 LeadProsper 活动期望的字段名一致。

    <Tip>
      如果你的落地页包含**测验漏斗**或**表单**，你添加的所有表单字段（例如姓名、邮箱、电话、地址以及任何自定义输入项）都会自动出现在该字段列表中，与默认 LanderLab 字段并列。你可以像对待默认字段一样启用、禁用或重命名它们。请确保 **Sent As** 的值与你的 LeadProsper API 规范中的字段名完全一致，否则你的线索可能会被拒绝。
    </Tip>
  </Step>

  <Step title="添加自定义字段（可选）">
    在 **Additional fields** 部分下，点击 **+ Add field**，在请求中加入额外的键值对。这适用于发送静态值，例如 sub ID、线索来源标签，或你的 LeadProsper 活动要求的任何自定义参数。
  </Step>

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

### 步骤 3：检查并连接

<Steps>
  <Step title="检查你的 LeadProsper 集成">
    最后一步会完整汇总每条线索将发送到 LeadProsper 的内容。你会看到：

    * **推送类型**（Direct Post 或 Ping-Post）和集成名称
    * **配置**部分，显示你的 Campaign ID、Supplier ID 和 Key
    * **字段映射**部分，列出所有字段及其对应的模板变量（例如 `{{LL Lander URL}}`、`{{LL Visitor IP}}`）

    仔细检查所有内容，确保配置和字段名与你的 LeadProsper 活动期望的一致。
  </Step>

  <Step title="点击 Connect LeadProsper">
    如果一切无误，点击 **Connect LeadProsper** 按钮保存并启用该集成。如果需要修改任何内容，点击 **Back** 返回之前的步骤。
  </Step>
</Steps>

## 在哪里找到你的 LeadProsper 凭据

如果你不确定在哪里找到 Campaign ID、Supplier ID 和 Key，请按以下步骤操作：

1. 登录你的 [LeadProsper](https://app.leadprosper.io) 账户。
2. 打开你要连接的活动。
3. 进入 **Supplier API Specs**（也称为 Posting Guide）。你可以从活动的供应商部分访问它。
4. 在顶部找到三个必填静态字段：`lp_campaign_id`、`lp_supplier_id` 和 `lp_key`。
5. 复制这些值，并将它们粘贴到 LanderLab 中对应的字段。

<Note>
  你的 LeadProsper 活动必须至少配置一个**供应商（supplier）和一个买家（buyer）**，API 规范才会可用。如果你看不到 Posting Guide，请确认活动中已设置这两者。
</Note>

## LeadProsper 集成提示

* **字段名完全匹配** - LeadProsper 会根据活动的字段定义校验传入数据。如果 LanderLab 中的字段名与 LeadProsper API 规范中的字段名不一致，线索将被拒绝。请根据需要使用步骤 2 中的 **Sent As** 列重命名字段。
* **上线前先测试** - 设置 LeadProsper 活动时，请让你的供应商保持 **Test Mode**，直到确认线索被正确接受。测试线索不会分发给买家，也不会产生费用。
* **检查字段格式** - LeadProsper 内置了字段类型和格式校验（例如电话号码必须是 10 位数字，邮箱必须有效）。请确保你的表单字段按照 LeadProsper 活动期望的格式收集数据。


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