> ## 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 Google Sheets

> Saiba como conectar o Google Sheets às suas landing pages no LanderLab para que cada lead seja adicionado automaticamente como uma nova linha na sua planilha.

<Frame>
  <img src="https://mintcdn.com/landerlab-babdc23f/b7I27OCOp06ppZUT/images/LL-Sheet.png?fit=max&auto=format&n=b7I27OCOp06ppZUT&q=85&s=a7cedd30c4728d03ffdc63d3d76f3fff" alt="Os logotipos do LanderLab e do Google Sheets lado a lado, representando a integração com o Google Sheets" width="1200" height="600" data-path="images/LL-Sheet.png" />
</Frame>

<Note>
  Conecte o Google Sheets às suas landing pages no LanderLab para enviar automaticamente cada lead para uma planilha. Cada envio de formulário adiciona uma nova linha com os campos que você escolher, para que os dados dos seus leads estejam sempre atualizados e prontos para uso.
</Note>

## O que é a integração com o Google Sheets?

A integração com o Google Sheets permite enviar os dados de leads das suas landing pages diretamente para uma planilha do Google Sheets. Toda vez que um visitante envia um formulário na sua página, o LanderLab acrescenta uma nova linha à planilha que você selecionou. Você pode mapear cada campo do formulário para uma coluna específica, para que os dados fiquem exatamente onde você precisa.

Isso é útil quando você quer um lugar simples e fácil de compartilhar para coletar e revisar leads, sem configurar um CRM nem criar um endpoint de API personalizado. A sua equipe pode acessar a planilha em tempo real, aplicar filtros, criar gráficos ou exportar os dados para usar em outras ferramentas.

Depois que você conecta uma conta do Google, ela fica salva **globalmente** na sua conta do LanderLab. Você pode reutilizar a mesma conta em várias landing pages sem precisar se autenticar novamente.

## Como adicionar o Google Sheets

A configuração guia você pela autenticação, pela seleção da planilha e pelo mapeamento de campos em um único fluxo.

<Steps>
  <Step title="Abra o painel de integrações">
    Vá até **Landing Pages** e clique no **nome da landing page** à qual você quer adicionar a integração. Clique em **Add Integration** para abrir o painel de integrações.
  </Step>

  <Step title="Selecione o Google Sheets">
    Na lista de integrações, encontre **Google Sheets** e clique em **+ Add**.

    <Frame>
      <img src="https://mintcdn.com/landerlab-babdc23f/b7I27OCOp06ppZUT/images/add-google-sheet.png?fit=max&auto=format&n=b7I27OCOp06ppZUT&q=85&s=37cc568da3cf8191040196c0105b0515" alt="O Google Sheets na lista do painel de integrações do LanderLab, com o botão Add" width="1470" height="834" data-path="images/add-google-sheet.png" />
    </Frame>
  </Step>

  <Step title="Faça a autenticação com o Google">
    Uma janela de login do Google será aberta. Escolha a conta do Google que é proprietária da planilha que você quer usar (ou que tem acesso a ela). Se você estiver conectado a várias contas do Google, selecione a correta na lista.
  </Step>

  <Step title="Conceda as permissões">
    O Google pedirá que você confirme que o LanderLab pode acessar os seus arquivos do Google Drive. Essa permissão é limitada aos arquivos específicos que você usar com o aplicativo. Marque a caixa para permitir o acesso e clique em **Continue**.

    <Tip>
      O LanderLab só solicita acesso aos arquivos que você selecionar explicitamente. Ele não tem acesso a todo o seu Google Drive.
    </Tip>
  </Step>

  <Step title="Dê um nome à integração e selecione uma planilha">
    O assistente de integração abre no **Passo 1**, com dois campos:

    | Campo           | Descrição                                                                                                                                                                                                                                       |
    | --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
    | **Name**        | Um nome para identificar esta integração (preenchido automaticamente com o e-mail da sua conta do Google). Você pode alterá-lo para algo mais descritivo, como "Planilha de leads - Campanha A".                                                |
    | **Spreadsheet** | Clique em **Select Spreadsheet** para abrir o seletor de arquivos do Google Sheets. Navegue pelas suas pastas ou use a barra de pesquisa para encontrar a planilha desejada. Clique no arquivo para selecioná-lo e depois clique em **Select**. |

    Depois que a planilha for selecionada, será exibido um menu suspenso **Sheet**. Escolha a página (aba) específica da planilha em que os leads devem ser gravados.

    Clique em **Continue** para avançar para o mapeamento de campos.
  </Step>

  <Step title="Mapeie os campos do formulário para as colunas da planilha">
    Neste passo, você controla quais dados são gravados na sua planilha e onde eles ficam. O LanderLab exibe duas colunas lado a lado:

    | Coluna           | O que faz                                                                                                                                                                      |
    | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
    | **Form Field**   | Os dados capturados na sua landing page (campos do formulário e campos de sistema do LanderLab).                                                                               |
    | **Sheet Column** | A coluna da sua planilha em que os dados serão gravados. Selecione uma opção no menu suspenso ou escolha **Auto Generate** para que o LanderLab crie a coluna automaticamente. |

    Cada campo tem uma caixa de seleção à esquerda. Desmarque os campos que você não quer enviar para a planilha.

    Os campos do seu formulário (como nome, e-mail, telefone ou quaisquer campos personalizados) aparecem na parte superior. Abaixo deles, você verá os campos de sistema padrão do LanderLab:

    | Campo de sistema           | Descrição                                                 |
    | -------------------------- | --------------------------------------------------------- |
    | **LL Lander URL**          | A URL completa da landing page em que o visitante estava. |
    | **LL Visitor IP**          | O endereço IP do visitante.                               |
    | **LL Visitor User Agent**  | As informações de navegador e dispositivo do visitante.   |
    | **LL Submission Time UTC** | A data e a hora em que o lead foi enviado (em UTC).       |
    | **LL Variant ID**          | O ID da variante do teste A/B exibida ao visitante.       |

    Use o menu suspenso **Sheet Column** ao lado de cada campo para escolher o cabeçalho de coluna correspondente na sua planilha. Se você selecionar **Auto Generate**, o LanderLab criará uma nova coluna usando o nome do campo do formulário.

    <Tip>
      Se a sua planilha já tiver cabeçalhos de coluna configurados, associe cada campo do formulário à coluna correta. Isso mantém os seus dados organizados e evita colunas em branco ou com dados trocados.
    </Tip>

    Clique em **Continue** para concluir a configuração.
  </Step>
</Steps>

A sua integração com o Google Sheets agora está ativa. Toda vez que um visitante enviar um formulário nesta landing page, uma nova linha será adicionada à planilha selecionada com os valores dos campos mapeados.

## Usar a mesma conta em outras landing pages

Como a sua conta do Google fica salva globalmente, você não precisa se autenticar novamente ao adicionar o Google Sheets a outra landing page. Abra o painel de integrações em qualquer landing page, expanda **Google Sheets** e você verá a sua conta conectada na lista. Clique em **Connect to page** para iniciar a configuração da planilha e do mapeamento de campos usando essa mesma conta.

## Dicas para obter os melhores resultados

**Prepare a planilha antes.** Crie a planilha e adicione os cabeçalhos de coluna antes de configurar a integração. Isso deixa o passo de mapeamento de campos mais rápido e garante que os seus dados fiquem organizados desde o início.

**Use nomes de coluna descritivos.** Cabeçalhos como "Nome", "E-mail" e "Telefone" são mais fáceis de usar do que rótulos genéricos como "Coluna A" ou "Campo 1".

**Use uma página (aba) por landing page.** Se você tiver várias campanhas, use páginas ou planilhas separadas para evitar dados misturados e facilitar a filtragem.

**Confira o menu suspenso Sheet.** Se a sua planilha tiver várias abas, certifique-se de selecionar a correta. Os leads só serão gravados na página que você escolher durante a configuração.
