> ## 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: Direct Post и Ping-Post

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

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

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

LeadsPedia — платформа для дистрибуции лидов и управления ими. Её используют компании в сфере лидогенерации, рекламодатели и партнёрские сети, чтобы собирать, валидировать, маршрутизировать и продавать лиды в реальном времени. Платформа поддерживает direct post и ping-post, поэтому её часто выбирают performance-маркетологи, работающие сразу в нескольких вертикалях.

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

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

***

## Direct Post и Ping-Post

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

**Direct Post** отправляет в LeadsPedia все данные лида одним запросом. Это самый простой способ — он подходит, когда лиды идут напрямую в конкретную кампанию без этапа торгов.

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

***

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

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

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

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

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

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

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

    **Если выбран Direct Post:**

    | Поле | Описание |
    | :- | :- |
    | **Post URL** | URL эндпоинта post в LeadsPedia (например, `https://api.leadspedia.com/.../post`). |
    | **LP Campaign ID** | Числовой Campaign ID вашей кампании в LeadsPedia (например, `12345`). |
    | **LP Campaign Key** | Campaign Key, связанный с вашей кампанией в LeadsPedia. Он генерируется внутри LeadsPedia. |

    **Если выбран Ping-Post:**

    | Поле | Описание |
    | :- | :- |
    | **Ping URL** | URL эндпоинта ping в LeadsPedia (например, `https://api.leadspedia.com/.../ping`). |
    | **Post URL** | URL эндпоинта post в LeadsPedia (например, `https://api.leadspedia.com/.../post`). |
    | **LP Campaign ID** | Числовой Campaign ID вашей кампании в LeadsPedia (например, `12345`). |
    | **LP Campaign Key** | Campaign Key, связанный с вашей кампанией в LeadsPedia. Он генерируется внутри 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` | ID варианта A/B-теста, который увидел посетитель. |

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

    <Tip>
      Если на лендинге есть **квиз-воронка** или **форма**, все добавленные вами поля формы (имя, email, телефон, адрес и любые пользовательские поля) автоматически появятся в этом списке рядом со стандартными полями 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 URL при Ping-Post)
    * раздел **сопоставления полей** со списком всех полей и соответствующих им переменных шаблона (например, `{{LL Lander URL}}`, `{{LL Visitor IP}}`)

    Внимательно проверьте всё, чтобы конфигурация и названия полей совпадали с ожиданиями вашей кампании в LeadsPedia.
  </Step>

  <Step title="Нажмите Connect LeadsPedia">
    Если всё выглядит верно, нажмите **Connect LeadsPedia**, чтобы сохранить и активировать интеграцию. Если нужно что-то изменить, нажмите **Back** и вернитесь к предыдущим шагам.
  </Step>
</Steps>

***

## Где найти Campaign ID и Campaign Key в LeadsPedia

Если вы не уверены, где найти Campaign ID и Campaign Key, выполните следующие шаги:

1. Войдите в свой аккаунт LeadsPedia.
2. Откройте кампанию, которую хотите подключить.
3. Нажмите кнопку **Post Keys** в верхнем меню окна кампании.
4. Отобразятся ваши **Campaign ID** и **Campaign Key**.

Эти значения также можно найти в разделе **Generate Posting Instructions** в левой боковой панели: выберите вертикаль, оффер и кампанию, а в качестве типа укажите «Server Post with Campaign ID and Campaign Key».

<Warning>
  Если вы перегенерируете Campaign Key в LeadsPedia, прежний ключ перестанет работать. Не забудьте обновить ключ в LanderLab.
</Warning>

***

## Типичные сценарии использования

* **Прямая доставка лидов** — используйте Direct Post, чтобы отправлять лиды напрямую конкретному покупателю или во внутреннюю кампанию без этапа торгов.
* **Дистрибуция через маркетплейс лидов** — используйте Ping-Post, чтобы несколько покупателей делали ставки на ваши лиды в реальном времени, а вы продавали лид тому, кто предложит больше.
* **Кампании в нескольких вертикалях** — настройте разные интеграции LeadsPedia на разных лендингах, чтобы направлять лиды в нужную вертикаль и кампанию.
* **Партнёрская отправка лидов** — если вы вебмастер-партнёр, используйте Campaign ID и Campaign Key, полученные от покупателя лидов, чтобы отправлять лиды прямо в его аккаунт LeadsPedia.


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