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

> Saiba como conectar o LeadsPedia ao LanderLab para enviar leads diretamente para suas campanhas do LeadsPedia em tempo real usando Direct Post ou Ping-Post.

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

## O que é o LeadsPedia?

O LeadsPedia é uma plataforma de distribuição e gestão de leads usada por empresas de geração de leads, anunciantes e redes de afiliados para coletar, validar, rotear e vender leads em tempo real. Ele oferece suporte tanto ao envio direto (direct post) quanto a workflows de ping-post, o que o torna uma escolha popular entre profissionais de marketing de performance que atuam em várias verticais.

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

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

***

## Direct Post vs. Ping-Post

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

O **Direct Post** envia todos os dados do lead para o LeadsPedia em uma única requisição. Esse é o método mais simples e é usado quando os leads vão diretamente para uma campanha específica, sem uma etapa de lances.

O **Ping-Post** é um processo em duas etapas. Primeiro, um "ping" é enviado com dados parciais do lead para que o LeadsPedia verifique se algum comprador quer o lead e retorne um lance. Se um lance for aceito, um segundo envio, o "post", é feito com todos os detalhes do lead. Esse método é usado em configurações de distribuição de leads em que vários compradores disputam cada lead.

***

## Como adicionar o LeadsPedia

A configuração do LeadsPedia 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 LeadsPedia.
  </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 LeadsPedia">
    Na lista de integrações disponíveis, encontre **LeadsPedia integration** (com a descrição "Send leads to LeadsPedia 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.: "LeadsPedia - Financiamento de veículos"). Depois, selecione o **Type** (tipo) de acordo com a configuração da sua campanha no LeadsPedia:

    **Se você selecionar Direct Post:**

    | Campo               | Descrição                                                                                 |
    | :------------------ | :---------------------------------------------------------------------------------------- |
    | **Post URL**        | A URL do endpoint de post do LeadsPedia (ex.: `https://api.leadspedia.com/.../post`).     |
    | **LP Campaign ID**  | O Campaign ID numérico da sua campanha no LeadsPedia (ex.: `12345`).                      |
    | **LP Campaign Key** | A Campaign Key associada à sua campanha no LeadsPedia. Ela é gerada dentro do LeadsPedia. |

    **Se você selecionar Ping-Post:**

    | Campo               | Descrição                                                                                 |
    | :------------------ | :---------------------------------------------------------------------------------------- |
    | **Ping URL**        | A URL do endpoint de ping do LeadsPedia (ex.: `https://api.leadspedia.com/.../ping`).     |
    | **Post URL**        | A URL do endpoint de post do LeadsPedia (ex.: `https://api.leadspedia.com/.../post`).     |
    | **LP Campaign ID**  | O Campaign ID numérico da sua campanha no LeadsPedia (ex.: `12345`).                      |
    | **LP Campaign Key** | A Campaign Key associada à sua campanha no LeadsPedia. Ela é gerada dentro do LeadsPedia. |

    <Tip>
      Para encontrar o seu **LP Campaign ID** e a sua **LP Campaign Key**, faça login no LeadsPedia, abra a sua campanha e clique no botão **Post Keys** no menu superior. Os dois valores serão exibidos ali. Você também pode encontrá-los em **Generate Posting Instructions**, na barra lateral esquerda.
    </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 LeadsPedia.

<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 LeadsPedia 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 LeadsPedia 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.
    </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 um sub ID, uma tag de origem do lead ou qualquer parâmetro personalizado que a sua campanha do LeadsPedia 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 LeadsPedia">
    O último passo mostra um resumo completo do que será enviado ao LeadsPedia 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, a Campaign Key e a Post URL (e a Ping URL, se estiver usando Ping-Post)
    * 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 LeadsPedia espera.
  </Step>

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

***

## Onde encontrar o Campaign ID e a Campaign Key do LeadsPedia

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

1. Faça login na sua conta do LeadsPedia.
2. Abra a campanha que você quer conectar.
3. Clique no botão **Post Keys** na barra de menu superior da janela da campanha.
4. O seu **Campaign ID** e a sua **Campaign Key** serão exibidos.

Você também pode encontrar esses valores acessando **Generate Posting Instructions** na barra lateral esquerda, selecionando a sua vertical, a oferta e a campanha e escolhendo "Server Post with Campaign ID and Campaign Key" como tipo.

<Warning>
  Se você gerar novamente a Campaign Key dentro do LeadsPedia, a chave anterior deixará de funcionar. Não se esqueça de atualizar a chave no LanderLab se você gerar uma nova.
</Warning>

***

## Casos de uso comuns

* **Entrega direta de leads** - Use o Direct Post para enviar leads diretamente para um comprador específico ou para uma campanha interna, sem etapa de lances.
* **Distribuição em marketplaces de leads** - Use o Ping-Post para permitir que vários compradores deem lances nos seus leads em tempo real e vender para quem oferecer mais.
* **Campanhas em várias verticais** - Configure integrações diferentes com o LeadsPedia em landing pages diferentes para direcionar os leads para a vertical e a campanha corretas.
* **Envio de leads por afiliados** - Se você é afiliado, use o Campaign ID e a Campaign Key fornecidos pelo seu comprador de leads para enviar leads diretamente para a conta do LeadsPedia dele.