> 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/platform-features/reach-out-to-partners/generate-leads/create-a-custom-widget.md).

# Criar um widget personalizado

Desenvolva ferramentas dinâmicas que capacitem parceiros a promover sua marca. Widgets personalizados permitem incorporar ferramentas ou páginas hospedadas externamente diretamente na interface do impact.com por meio de um iframe. Use este guia para criar e configurar um widget de conteúdo personalizado que forneça recursos personalizados e uma experiência de marca consistente para seus parceiros.

{% stepper %}
{% step %}

#### Acesse o criador de widget personalizado

1. No menu de navegação à esquerda, selecione ![](/files/160944180402269557074f48f2ece20bc35e8b4d) **\[Engage]** → **Conteúdo** → [**Widgets**](https://app.impact.com/secure/advertiser/engage/ads/list-widget-tool-flow.ihtml)**.**
2. No canto superior direito, selecione **Criar widget** → **Personalizado**.
   {% endstep %}

{% step %}

#### Insira os detalhes do widget

1. Insira um **Nome** do widget personalizado.
2. Opcionalmente, insira uma **Descrição** para o widget personalizado.
3. Opcionalmente, insira uma **Rótulo** para o widget personalizado.
4. Se necessário, ![](/files/56148a29d7f42673dde9884eb52356c45eca06c3) **\[Ative] Restringir acesso do parceiro** para especificar parceiros individuais e grupos que devem ter acesso ao widget.
   * **Parceiros:** Insira o nome dos parceiros que podem acessar o widget personalizado.
   * **Grupos:** Insira o nome dos grupos que podem acessar o widget personalizado.
     {% endstep %}

{% step %}

#### Configurar o widget

1. Selecione como o widget se comporta nas opções de exibição:
   * **Abrir em nova guia:** Abre a URL hospedada em uma guia separada.
   * **Incorporar no impact.com:** Exibe o widget diretamente na interface da plataforma.
2. Opcionalmente, em **Imagem de pré-visualização** seção, selecione **Escolher arquivo** para carregar uma miniatura. Certifique-se de que o arquivo seja GIF, JPG ou PNG e não exceda 512 KB.
3. No **URL do widget** campo, insira o endereço da web onde seu widget está hospedado.
4. Na ![](/files/fd163b7ecfbcabc8d4b0b2247a6ffecec5a92253)**\[Menu suspenso]**, selecione o protocolo (por exemplo, https\://) que corresponda à segurança do seu site.
5. Opcionalmente, selecione ![](/files/f04b408fd368673af7defa3c8a7a0cac711f0eb8) **\[Adicionar] Inserir campos dinâmicos** para expandir a lista de tokens.
6. Localize o token que você deseja usar e selecione **Inserir**. A plataforma anexará automaticamente o token (por exemplo, {irpid}) ao seu **URL do widget**. Consulte o [Tokens de campos dinâmicos](#dynamic-field-tokens) seção abaixo para uma descrição de cada token.
   {% endstep %}

{% step %}

#### Atualizar configurações avançadas

Na **Idioma** ![](/files/fd163b7ecfbcabc8d4b0b2247a6ffecec5a92253)**\[Menu suspenso]**, selecione o idioma no qual este widget será exibido.
{% endstep %}

{% step %}

#### Finalizar o widget personalizado

Selecione **Criar** para salvar seu widget. Os parceiros podem encontrar este widget em *Widgets de conteúdo*.
{% endstep %}
{% endstepper %}

<details>

<summary>Tokens de campos dinâmicos</summary>

| Token                          | Descrição                                                    |
| ------------------------------ | ------------------------------------------------------------ |
| `{click_url_encoded}`          | URL de clique codificada                                     |
| `{click_url}`                  | URL de clique não codificada                                 |
| `{irimpurl}`                   | Nossa URL de impressão                                       |
| `{irpid}`                      | ID do parceiro                                               |
| `{subid1}`                     | ID secundário do parceiro 1                                  |
| `{subid2}`                     | ID secundário do parceiro 2                                  |
| `{subid3}`                     | ID secundário do parceiro 3                                  |
| `{sharedId}`                   | ID compartilhado                                             |
| `{iradid}`                     | ID do anúncio                                                |
| `{ircid}`                      | ID do Programa                                               |
| `{click_url_encoded_deeplink}` | URL de clique codificada com parâmetro de deep link anexado. |

</details>


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/platform-features/reach-out-to-partners/generate-leads/create-a-custom-widget.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
