> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/microsite-experiences/customize-and-map-your-microsite-registration-form.md).

# Personalizar e mapear seu formulário de inscrição do microsite

Quando os participantes se inscrevem no seu programa pelo microsite, coletamos e armazenamos os dados de inscrição por meio de formulários. Quando você [configura um microsite](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/microsite-experiences/set-up-a-microsite.md) usando a configuração automática, um formulário é criado automaticamente. Este artigo de ajuda explica como definir as regras de envio do formulário de inscrição e mapear campos adicionais do formulário.

#### Personalizar as regras de tratamento de envios do microsite

Você pode definir regras de tratamento de envios para o formulário para que alguém da sua equipe receba uma notificação sempre que houver uma nova tentativa de envio. Isso pode ser útil se você quiser acompanhar quando recebe novos participantes ou receber uma notificação quando alguém tentar se inscrever, mas o envio falhar. Você também pode adicionar ou remover automaticamente participantes recém-atualizados de um segmento de usuários específico.

1. No menu de navegação à esquerda, selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[Engage] → Fontes de dados** → **Formulários**.
2. Passe o cursor sobre o formulário de inscrição que você quer personalizar e selecione **Editar**.
3. Na página *Atualizar formulário de inscrição*, role a página até *Quando o formulário é enviado com sucesso*.
   * Escolha quem recebe um e-mail quando alguém se inscreve com sucesso.
   * Escolha o segmento de usuários (se houver) ao qual o participante deve ser adicionado após se inscrever com sucesso.
4. Na seção *Quando o formulário falha* , escolha quem recebe um e-mail quando uma tentativa de envio falha.
5. Selecione **Atualizar inscrição**.

#### Mapear campos do formulário de inscrição

Quando o formulário de inscrição do microsite é criado, você pode configurar os campos de participante do Advocate para receber valores do formulário ou dados estáticos durante a inscrição. Seu microsite vem com os seguintes campos padrão do formulário: *Nome*, *Sobrenome*, *E-mail*, e *Senha*. Você pode modificar o formulário de inscrição para coletar informações adicionais sobre os usuários do microsite, como *Número de telefo*ne, *País/localidade*, *Tipo de empresa*, etc. Você também pode adicionar uma caixa de seleção de termos e condições para solicitar que os usuários aceitem os termos.

**Adicionar campos ao formulário de inscrição**

1. No menu de navegação à esquerda, selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[Engage] → Conteúdo**.
2. No cartão *Microsite* , selecione **Editar conteúdo**.
   * Essa ação abre o editor do microsite e exibe o painel deslizante do microsite.
3. Na seção *Layout desconectado* , selecione **Inscrever-se**.
4. No menu *Componente* , selecione **Adicionar** → **Componentes do microsite**.
5. Selecione o componente adequado para coletar dados adicionais e, em seguida, selecione **Adicionar aos campos adicionais**.
6. Em *Componente* menu, certifique-se de ter selecionado o **Editar** guia e, em seguida, preencha as seguintes informações:
   * **Mensagem de erro de campo obrigatório:** A mensagem exibida quando falta informação em um campo obrigatório.
   * **Rótulo do campo:** O nome do campo adicional que será exibido no formulário de cadastro.
   * **Atributo de nome do campo:** A chave do campo adicional usada para mapeá-lo aos dados do usuário.
   * ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FiZjM1xY8o3v1iR3Zaysd%2FToggle.svg?alt=media\&token=b1550d48-bba9-4e81-8604-bc12370c5caa) **\[Ativar]** **Opcional** se não for um campo obrigatório.
   * No menu suspenso *Tipo de entrada* , selecione como o campo coleta informações.
7. Selecione **Salvar**.

**Mapear os campos adicionais**

1. No menu de navegação à esquerda, selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[Engage] → Fontes de dados** → **Formulários**.
2. Passe o cursor sobre o formulário de inscrição que você quer personalizar e selecione **Editar**.
3. Na página *Atualizar formulário de cadastro*, selecione **Configurações avançadas**.
4. Em *Campo de participante Advocate*, selecione **Adicionar mapeamento**.
5. Selecione um valor de Advocate na lista suspensa e insira um valor de mapeamento na caixa de texto *Expressão(ões) JSONata* para que seja avaliado no momento do cadastro.
   * **Adicionar a segmentos:** Configure regras específicas para adicionar participantes a segmentos após o cadastro.

     **Exemplo:** `($contains(email, “acme.com”) ? ($append(segments, “Existing”)))`
   * **Campo personalizado:** Mapeie um valor personalizado que você queira coletar no formulário de cadastro.

     **Exemplo:** Celular → `cellPhone`
   * **País:** Capture o código do país do usuário.

     **Exemplo:** País → `countryCode`
   * **Localidade:** O valor do campo de formulário de localidade, nomeado e mapeado para o campo de localidade do participante.

     **Exemplo:** Localidade → `locale`
   * **Códigos de indicação:** Capture o código exclusivo de indicação do indicador.

     **Exemplo:** `$exists(referredByCodes) AND referredByCodes != ""`
   * **Pode ser indicado:** Indica se um usuário pode ou não ser indicado.

     **Exemplo:** Pode ser indicado → `false`
6. Selecionar **Atualizar cadastro** quando terminar.

   * Para ver os envios do seu formulário de cadastro, consulte [Ver os envios do seu formulário de cadastro](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/microsite-experiences/view-your-microsite-registration-form-submissions.md).

   <div data-with-frame="true"><figure><img src="https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FSUEDTMBL8XWwd5SDsQrL%2FUntitled%20design%20(51).png?alt=media&amp;token=2c8b47f4-c2b7-4b6b-88be-bb96df00ec44" alt=""><figcaption></figcaption></figure></div>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/microsite-experiences/customize-and-map-your-microsite-registration-form.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
