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

# Configurar a integração com o Leadprosper

> Saiba como conectar o Leadprosper ao LanderLab para enviar leads diretamente para suas campanhas do Leadprosper em tempo real a partir de qualquer landing page ou funil de quiz.

> Conecte o LeadProsper às suas landing pages no LanderLab para enviar dados de leads diretamente para as suas campanhas do LeadProsper em tempo real. Escolha entre Direct Post e Ping-Post, de acordo com a configuração da sua campanha.

## O que é o LeadProsper?

O LeadProsper é uma plataforma de distribuição de leads usada por geradores de leads, afiliados e anunciantes para receber, validar e direcionar leads a compradores em tempo real. Ele oferece suporte tanto ao envio direto (direct post, que envia os leads diretamente para uma campanha) quanto a workflows de ping-post (que enviam primeiro dados parciais para que os compradores possam dar lances antes de receber o lead completo).

Quando você conecta o LeadProsper à sua landing page no LanderLab, cada lead coletado na página é enviado automaticamente para a sua campanha do LeadProsper. O LanderLab cuida da conexão com a API para você, então não é preciso escrever código personalizado nem criar integrações no servidor manualmente.

<Note>
  As integrações com o LeadProsper **não** são salvas globalmente. Cada integração é configurada por landing page, então você precisará configurar uma nova conexão com o LeadProsper para cada landing page da qual quiser enviar leads.
</Note>

***

## Direct Post vs. Ping-Post

O LanderLab oferece dois tipos de envio para o LeadProsper. Você escolhe o tipo durante a configuração, de acordo com a forma como a sua campanha do LeadProsper está configurada.

O **Direct Post** envia todos os dados do lead para o LeadProsper em uma única requisição. Em seguida, o lead é validado e distribuído aos compradores com base nas regras da sua campanha. Essa é a opção mais simples e funciona bem quando a sua configuração de entrega de leads é direta e sem complicações.

O **Ping-Post** é um processo em duas etapas. Primeiro, um "ping" é enviado com dados parciais do lead (como código postal ou estado) para que os compradores decidam se querem o lead e deem um lance. Se um lance for aceito, um segundo envio, o "post", é feito com as informações completas do lead. Esse método é usado quando vários compradores disputam leads em tempo real.

***

## Como adicionar o LeadProsper

A configuração do LeadProsper usa um assistente de 3 passos: configure a conexão, mapeie seus campos e revise o payload final antes de conectar.

### Passo 1: Configurar a conexão

<Steps>
  <Step title="Acesse sua landing page">
    Vá até **Landing Pages** e clique no **nome da landing page** à qual você quer adicionar a integração com o LeadProsper.
  </Step>

  <Step title="Abra a aba de integrações">
    Clique em **Add Integration** para abrir o painel de integrações.
  </Step>

  <Step title="Selecione a integração com o LeadProsper">
    Na lista de integrações disponíveis, encontre **LeadProsper integration** (com a descrição "Send leads to LeadProsper in real time") e clique nela. O assistente de configuração será aberto.
  </Step>

  <Step title="Preencha os dados da conexão">
    Comece informando um **Name** (nome) para esta integração (ex.: "LeadProsper - Financiamento de veículos"). Depois, selecione o **Type** (tipo) de acordo com a configuração da sua campanha no LeadProsper: **Direct Post** ou **Ping-Post**.

    Os dois tipos exigem os mesmos três campos:

    | Campo              | Descrição                                                                                           |
    | :----------------- | :-------------------------------------------------------------------------------------------------- |
    | **LP Campaign ID** | O Campaign ID numérico da sua campanha no LeadProsper (ex.: `12345`).                               |
    | **LP Supplier ID** | O Supplier ID numérico atribuído à sua conta de fornecedor (supplier) no LeadProsper (ex.: `6789`). |
    | **LP Key**         | A chave exclusiva associada à sua campanha e ao seu fornecedor. Ela é gerada dentro do LeadProsper. |

    Esses três valores são exclusivos de cada campanha do LeadProsper e são obrigatórios tanto na configuração de Direct Post quanto na de Ping-Post.

    <Tip>
      Para encontrar o seu **LP Campaign ID**, o **LP Supplier ID** e a **LP Key**, abra a sua campanha no LeadProsper, acesse as **Supplier API Specs** (também chamadas de Posting Guide) e procure os valores `lp_campaign_id`, `lp_supplier_id` e `lp_key`. Eles aparecem como campos estáticos obrigatórios no início da documentação da API.
    </Tip>
  </Step>

  <Step title="Clique em Continue">
    Clique em **Continue** para avançar para o passo de mapeamento de campos.
  </Step>
</Steps>

***

### Passo 2: Mapear seus campos

Neste passo, você escolhe quais campos de dados incluir na requisição e como eles devem ser nomeados ao serem enviados para o LeadProsper.

<Steps>
  <Step title="Selecione e configure os campos">
    O LanderLab inclui automaticamente um conjunto de campos padrão do LanderLab. Cada campo tem uma caixa de seleção para incluí-lo ou excluí-lo e uma coluna **Sent As**, na qual você pode renomear a chave para que ela corresponda ao que o LeadProsper espera.

    Os campos padrão do LanderLab são:

    | Campo do formulário        | Sent As (chave padrão)   | Descrição                                                 |
    | :------------------------- | :----------------------- | :-------------------------------------------------------- |
    | **LL Lander URL**          | `ll_lander_url`          | A URL completa da landing page em que o visitante estava. |
    | **LL Visitor IP**          | `ll_visitor_ip`          | O endereço IP do visitante.                               |
    | **LL Visitor User Agent**  | `ll_visitor_user_agent`  | As informações de navegador e dispositivo do visitante.   |
    | **LL Submission Time UTC** | `ll_submission_time_utc` | A data e a hora em que o lead foi enviado (em UTC).       |
    | **LL Variant ID**          | `ll_variant_id`          | O ID da variante do teste A/B exibida ao visitante.       |

    Use as caixas de seleção para ativar ou desativar qualquer campo. Você também pode editar o valor de **Sent As** para que ele corresponda aos nomes de campo que a sua campanha do LeadProsper espera.

    <Tip>
      Se a sua landing page tiver um **funil de quiz** ou um **formulário**, todos os campos de formulário que você adicionou (como nome, e-mail, telefone, endereço e quaisquer campos personalizados) aparecerão automaticamente nesta lista, junto com os campos padrão do LanderLab. Você pode ativá-los, desativá-los ou renomeá-los da mesma forma que os campos padrão. Certifique-se de que os valores de **Sent As** correspondam exatamente aos nomes de campo das API specs do LeadProsper; caso contrário, seus leads poderão ser rejeitados.
    </Tip>
  </Step>

  <Step title="Adicione campos personalizados (opcional)">
    Na seção **Additional fields**, clique em **+ Add field** para incluir pares de chave-valor extras na requisição. Isso é útil para enviar valores fixos, como sub IDs, tags de origem do lead ou qualquer parâmetro personalizado que a sua campanha do LeadProsper exija.
  </Step>

  <Step title="Clique em Continue">
    Clique em **Continue** para avançar para o passo de revisão.
  </Step>
</Steps>

***

### Passo 3: Revisar e conectar

<Steps>
  <Step title="Revise sua integração com o LeadProsper">
    O último passo mostra um resumo completo do que será enviado ao LeadProsper para cada lead. Você verá:

    * O **tipo de envio** (Direct Post ou Ping-Post) e o nome da integração
    * A seção de **configuração**, com o seu Campaign ID, o Supplier ID e a Key
    * A seção de **mapeamento de campos**, com todos os campos e as variáveis de modelo correspondentes (ex.: `{{LL Lander URL}}`, `{{LL Visitor IP}}`)

    Revise tudo com atenção para garantir que a configuração e os nomes dos campos correspondam ao que a sua campanha do LeadProsper espera.
  </Step>

  <Step title="Clique em Connect LeadProsper">
    Se estiver tudo certo, clique no botão **Connect LeadProsper** para salvar e ativar a integração. Se precisar alterar algo, clique em **Back** para voltar aos passos anteriores.
  </Step>
</Steps>

***

## Onde encontrar suas credenciais do LeadProsper

Se você não tiver certeza de onde encontrar o seu Campaign ID, o Supplier ID e a Key, siga estes passos:

1. Faça login na sua conta do [LeadProsper](https://app.leadprosper.io).
2. Abra a campanha que você quer conectar.
3. Acesse as **Supplier API Specs** (também chamadas de Posting Guide). Você pode acessá-las pela seção de fornecedores (suppliers) da campanha.
4. Procure os três campos estáticos obrigatórios no início: `lp_campaign_id`, `lp_supplier_id` e `lp_key`.
5. Copie esses valores e cole-os nos campos correspondentes no LanderLab.

<Note>
  A sua campanha do LeadProsper precisa ter pelo menos um **supplier** (fornecedor) e um **buyer** (comprador) configurados para que as API specs fiquem disponíveis. Se você não estiver vendo o Posting Guide, verifique se ambos estão configurados na sua campanha.
</Note>

***

## Dicas para a integração com o LeadProsper

* **Use exatamente os mesmos nomes de campo** - O LeadProsper valida os dados recebidos com base nas definições de campos da sua campanha. Se os nomes de campo no LanderLab não corresponderem aos nomes de campo das API specs do LeadProsper, o lead será rejeitado. Use a coluna **Sent As** no Passo 2 para renomear os campos conforme necessário.
* **Teste antes de colocar no ar** - Ao configurar a sua campanha no LeadProsper, mantenha o seu supplier em **Test Mode** até confirmar que os leads estão sendo aceitos corretamente. Os leads de teste não são distribuídos aos compradores e não geram cobranças.
* **Verifique os formatos dos campos** - O LeadProsper tem validação integrada para tipos e formatos de campo (ex.: números de telefone precisam ter 10 dígitos e e-mails precisam ser válidos). Certifique-se de que os campos do seu formulário coletem os dados no formato que a sua campanha do LeadProsper espera.
