> ## 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 через Direct Post или Ping-Post.

> Подключите LeadProsper к лендингам в LanderLab, чтобы в реальном времени отправлять данные лидов прямо в ваши кампании LeadProsper. Выберите Direct Post или Ping-Post в зависимости от настройки кампании.

## Что такое LeadProsper?

LeadProsper — платформа дистрибуции лидов, которой пользуются лидогенераторы, партнёры и рекламодатели, чтобы получать, валидировать и маршрутизировать лиды к покупателям в реальном времени. Она поддерживает и direct post (отправка лидов сразу в кампанию), и ping-post (сначала отправляются частичные данные, чтобы покупатели могли сделать ставку до получения полного лида).

Когда вы подключаете LeadProsper к лендингу в LanderLab, каждый собранный на странице лид автоматически отправляется в вашу кампанию LeadProsper. LanderLab берёт на себя API-подключение, поэтому писать собственный код или вручную строить серверные интеграции не нужно.

<Note>
  Интеграции LeadProsper **не** сохраняются глобально. Каждая интеграция настраивается отдельно для лендинга, поэтому для каждого лендинга, с которого нужно отправлять лиды, придётся создать новое подключение LeadProsper.
</Note>

***

## Direct Post и Ping-Post

LanderLab поддерживает два типа отправки в LeadProsper. Тип выбирается при настройке в зависимости от того, как настроена ваша кампания в LeadProsper.

**Direct Post** отправляет в LeadProsper все данные лида одним запросом. Затем лид валидируется и распределяется между покупателями по правилам вашей кампании. Это более простой вариант, он хорошо подходит для несложной схемы доставки лидов.

**Ping-Post** — двухэтапный процесс. Сначала отправляется «ping» с частичными данными лида (например, почтовым индексом или штатом), чтобы покупатели решили, нужен ли им лид, и сделали ставку. Если ставка принята, отправляется второй запрос — «post» — с полной информацией о лиде. Этот способ используется, когда несколько покупателей конкурируют за лиды в реальном времени.

***

## Как добавить LeadProsper

Настройка LeadProsper проходит в три шага: настройте подключение, сопоставьте поля и проверьте итоговый payload перед подключением.

### Шаг 1. Настройте подключение

<Steps>
  <Step title="Откройте свой лендинг">
    Перейдите в **Landing Pages** и нажмите на **название лендинга**, к которому хотите добавить интеграцию LeadProsper.
  </Step>

  <Step title="Откройте вкладку Integrations">
    Нажмите **Add Integration**, чтобы открыть панель интеграций.
  </Step>

  <Step title="Выберите интеграцию LeadProsper">
    В списке доступных интеграций найдите **LeadProsper integration** (с подписью «Send leads to LeadProsper in real time») и нажмите на неё. Откроется мастер настройки.
  </Step>

  <Step title="Заполните данные подключения">
    Сначала введите **Name** для этой интеграции (например, «LeadProsper - Auto Loans»). Затем выберите **Type** в зависимости от настройки кампании в LeadProsper: **Direct Post** или **Ping-Post**.

    Для обоих типов нужны одни и те же три поля:

    | Поле | Описание |
    | :- | :- |
    | **LP Campaign ID** | Числовой Campaign ID вашей кампании в LeadProsper (например, `12345`). |
    | **LP Supplier ID** | Числовой Supplier ID, присвоенный вашему аккаунту поставщика в LeadProsper (например, `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` | ID варианта A/B-теста, который увидел посетитель. |

    Включайте и отключайте любые поля флажками. Значение **Sent As** можно изменить, чтобы оно совпадало с названиями полей, которых ждёт ваша кампания в LeadProsper.

    <Tip>
      Если на лендинге есть **квиз-воронка** или **форма**, все добавленные вами поля формы (имя, email, телефон, адрес и любые пользовательские поля) автоматически появятся в этом списке рядом со стандартными полями LanderLab. Их можно включать, отключать и переименовывать так же, как стандартные. Убедитесь, что значения **Sent As** в точности совпадают с названиями полей в API-спецификации LeadProsper, иначе лиды могут быть отклонены.
    </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 должны быть настроены хотя бы один **поставщик** и один **покупатель**, иначе API-спецификация будет недоступна. Если вы не видите Posting Guide, убедитесь, что оба настроены в кампании.
</Note>

***

## Советы по интеграции с LeadProsper

* **Точно совпадайте по названиям полей** — LeadProsper проверяет входящие данные по описанию полей вашей кампании. Если названия полей в LanderLab не совпадают с названиями в API-спецификации LeadProsper, лид будет отклонён. При необходимости переименуйте поля в столбце **Sent As** на шаге 2.
* **Тестируйте перед запуском** — при настройке кампании в LeadProsper держите поставщика в **Test Mode**, пока не убедитесь, что лиды принимаются корректно. Тестовые лиды не передаются покупателям и не тарифицируются.
* **Проверьте форматы полей** — в LeadProsper есть встроенная проверка типов и форматов полей (например, телефон должен состоять из 10 цифр, email — быть корректным). Убедитесь, что поля вашей формы собирают данные в формате, которого ждёт кампания в LeadProsper.


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