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

# 设置 Phonexa 集成

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

> 在 LanderLab 中将 Phonexa 连接到你的落地页，将线索数据实时直接发送到你的 Phonexa 活动。你只需要 Phonexa 平台上的 Publisher API 凭据。

## 什么是 Phonexa？

Phonexa 是一个一体化的效果营销平台，线索生成商、发布商和广告主使用它来管理线索分发、电话跟踪、邮件营销等业务。其 LMS Sync 产品负责线索推送，允许发布商通过 HTTP POST 将线索实时发送到 Phonexa 活动。

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

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

## 如何添加 Phonexa

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

### 步骤 1：配置连接

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

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

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

  <Step title="填写连接详情">
    输入以下信息：

    | 字段 | 说明 |
    | :- | :- |
    | **Name** | 用于识别该集成的名称（例如 “Phonexa - Auto Loans”）。这有助于你在集成列表中快速识别。 |
    | **API URL** | 你的 Phonexa 产品的推送 endpoint URL（例如 `api.phonexa.com/...`），在你的 Phonexa Publisher API 规范中提供。 |
    | **API ID** | 你的数字 Publisher API ID（例如 `12345`），是 Phonexa 为你的发布商账户分配的唯一标识符。 |
    | **API Password** | 与你的 Publisher API ID 关联的 API 密码，在 Phonexa 内设置和管理。 |

    <Tip>
      要查找你的 **API URL**、**API ID** 和 **API Password**，请登录你的 Phonexa 账户，进入 **LMS Sync**，然后打开 **Publisher Products API**。选择你要推送线索的产品。推送 URL、API ID 和 API Password 都列在 API 文档的 Lead Specs 部分中。你也可以在发布商资料的 API Access 设置中找到它们。
    </Tip>
  </Step>

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

### 步骤 2：映射字段

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

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

    默认的 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** 的值，使其与你的 Phonexa API 规范中的字段名一致。

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

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

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

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

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

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

    仔细检查所有内容，确保配置和字段名与你的 Phonexa 活动期望的一致。如果有任何问题，点击 **Back** 返回之前的步骤。
  </Step>

  <Step title="点击 Connect Phonexa">
    如果一切无误，点击 **Connect Phonexa** 按钮保存并启用该集成。
  </Step>
</Steps>

## 在哪里找到你的 Phonexa API 凭据

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

1. 登录你的 [Phonexa](https://app.phonexa.com) 账户。
2. 进入左侧边栏中的 **LMS Sync**。
3. 点击 **Publisher Products API**。
4. 选择你要连接的产品。
5. 在 **Lead Specs** 部分，你会找到 **posting URL**（即你的 API URL）、**API ID** 和 **API Password**。

你也可以在发布商资料的 **API Access** 设置中找到你的 API ID 和 API Password。点击 API Password 字段旁边的 **Show** 按钮即可显示该值。

<Warning>
  如果你在 Phonexa 中更改或重置了 API Password，旧密码将失效。重置后，请务必在 LanderLab 中更新该密码。
</Warning>

## Phonexa 集成提示

* **字段名完全匹配** - Phonexa 会根据产品的 API 规范校验所有传入字段。使用步骤 2 中的 **Sent As** 列重命名字段，使其与你的 Phonexa 文档中的字段名完全一致。
* **检查必填字段** - 你的 Phonexa 产品的 API 规范会明确标注哪些字段是必填的。缺少必填字段或包含格式错误值的线索将被拒绝。
* **设置期间使用测试模式** - Phonexa 支持通过在 payload 中添加 `testMode=1` 启用测试模式。测试期间，你可以使用步骤 2 中的 **Additional fields** 部分将其作为静态键值对添加。上线前请将其删除。


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