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

# 设置 LeadsPedia 集成

> 了解如何将 LeadsPedia 连接到 LanderLab，使用 Direct Post 或 Ping-Post 将线索实时直接发送到你的 LeadsPedia 活动。

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

## 什么是 LeadsPedia？

LeadsPedia 是一个线索分发与管理平台，线索生成公司、广告主和联盟网络使用它来实时收集、校验、路由和出售线索。它同时支持直接推送（Direct Post）和 Ping-Post 工作流，是跨多个垂直行业开展业务的效果营销人员的热门选择。

当你在 LanderLab 中将 LeadsPedia 连接到落地页后，页面上收集的每条线索都会按照你选择的推送方式自动发送到你的 LeadsPedia 活动。LanderLab 会替你处理 API 连接，因此你无需编写任何自定义代码或构建服务器端集成。

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

## Direct Post 与 Ping-Post 对比

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

**Direct Post** 会在一次请求中将完整的线索数据发送到 LeadsPedia。这是最简单的方式，适用于线索直接进入特定活动、不经过竞价步骤的情况。

**Ping-Post** 是一个两步流程。首先，发送一个包含部分线索数据的 “ping”，让 LeadsPedia 检查是否有买家想要该线索并返回出价。如果出价被接受，则发送第二个包含完整线索信息的 “post”。这种方式用于多个买家竞争每条线索的线索分发场景。

## 如何添加 LeadsPedia

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

### 步骤 1：配置连接

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

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

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

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

    **如果你选择 Direct Post：**

    | 字段 | 说明 |
    | :- | :- |
    | **Post URL** | LeadsPedia 的 post endpoint URL（例如 `https://api.leadspedia.com/.../post`）。 |
    | **LP Campaign ID** | 你的 LeadsPedia 活动的数字 Campaign ID（例如 `12345`）。 |
    | **LP Campaign Key** | 与你的 LeadsPedia 活动关联的 Campaign Key，在 LeadsPedia 内生成。 |

    **如果你选择 Ping-Post：**

    | 字段 | 说明 |
    | :- | :- |
    | **Ping URL** | LeadsPedia 的 ping endpoint URL（例如 `https://api.leadspedia.com/.../ping`）。 |
    | **Post URL** | LeadsPedia 的 post endpoint URL（例如 `https://api.leadspedia.com/.../post`）。 |
    | **LP Campaign ID** | 你的 LeadsPedia 活动的数字 Campaign ID（例如 `12345`）。 |
    | **LP Campaign Key** | 与你的 LeadsPedia 活动关联的 Campaign Key，在 LeadsPedia 内生成。 |

    <Tip>
      要查找你的 **LP Campaign ID** 和 **LP Campaign Key**，请登录 LeadsPedia，打开你的活动，然后点击顶部菜单中的 **Post Keys** 按钮。这两个值都会显示在那里。你也可以在左侧边栏的 **Generate Posting Instructions** 下找到它们。
    </Tip>
  </Step>

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

### 步骤 2：映射字段

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

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

    默认的 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** 的值，使其与你的 LeadsPedia 活动期望的字段名一致。

    <Tip>
      如果你的落地页包含**测验漏斗**或**表单**，你添加的所有表单字段（例如姓名、邮箱、电话、地址以及任何自定义输入项）都会自动出现在该字段列表中，与默认 LanderLab 字段并列。你可以像对待默认字段一样启用、禁用或重命名它们。
    </Tip>
  </Step>

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

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

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

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

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

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

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

## 在哪里找到你的 LeadsPedia Campaign ID 和 Campaign Key

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

1. 登录你的 LeadsPedia 账户。
2. 打开你要连接的活动。
3. 点击活动窗口顶部菜单栏中的 **Post Keys** 按钮。
4. 你的 **Campaign ID** 和 **Campaign Key** 就会显示出来。

你也可以进入左侧边栏的 **Generate Posting Instructions**，选择你的垂直行业、Offer 和活动，并将类型选为 “Server Post with Campaign ID and Campaign Key”，来找到这些值。

<Warning>
  如果你在 LeadsPedia 中重新生成 Campaign Key，之前的密钥将失效。重新生成后，请务必在 LanderLab 中更新该密钥。
</Warning>

## 常见使用场景

* **直接交付线索** - 使用 Direct Post 将线索直接发送给特定买家或内部活动，无需竞价步骤。
* **线索市场分发** - 使用 Ping-Post 让多个买家实时竞价你的线索，并卖给出价最高者。
* **多垂直行业活动** - 在不同的落地页上设置不同的 LeadsPedia 集成，将线索路由到正确的垂直行业和活动。
* **联盟线索推送** - 如果你是联盟客（affiliate），可以使用线索买家提供的 Campaign ID 和 Campaign Key，将线索直接推送到他们的 LeadsPedia 账户中。


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