> 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/account-administration/program-settings/exception-lists/create-and-manage-general-exception-lists.md).

# Criar e gerenciar listas gerais de exceções

As listas gerais permitem agrupar valores associados a um atributo[^1] para que você possa afetar os pagamentos de todos eles com a mesma taxa. Por exemplo, se quiser aumentar o pagamento em 10% para determinadas cidades de clientes, adicione essas cidades à mesma lista e, em seguida, faça referência à lista nas suas [regras de pagamento](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/platform-features/contracts-and-template-terms/template-terms/payout-adjustments.md) em vez de configurar uma regra separada para cada cidade.

```mermaid
flowchart LR
    subgraph Setup["Configuração (uma única vez)"]
        A["Criar lista: Cidades-alvo<br/>Tipo de evento: Venda online"] --> B["Adicionar valores: Chicago, Austin, Seattle"]
        B --> C["Mapear para regra de pagamento<br/>Cidade do cliente na lista Cidades-alvo"]
    end
    subgraph Payout["No momento do pagamento (por conversão)"]
        D["Conversão recebida<br/>Cidade do cliente = Austin"] --> E["Correspondência encontrada → taxa de 10% aplicada"]
    end
    C --> D

    style A fill:#EEEDFE,stroke:#534AB7,color:#26215C
    style B fill:#EEEDFE,stroke:#534AB7,color:#26215C
    style C fill:#EEEDFE,stroke:#534AB7,color:#26215C
    style D fill:#E1F5EE,stroke:#0F6E56,color:#04342C
    style E fill:#E1F5EE,stroke:#0F6E56,color:#04342C
```

## Criar e mapear uma lista geral de exceções

A criação de uma lista geral segue um fluxo de três etapas: primeiro, defina a lista, adicione os valores e, em seguida, faça referência à lista em uma regra de pagamento.

{% stepper %}
{% step %}

### Criar a lista

1. Na barra de navegação superior, selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2F210dEQa93qyQgoJDkieL%2FUser%20profile.svg?alt=media\&token=f84c5b17-fae4-4a30-990a-9de5e57a150b) **\[Perfil do usuário] → Configurações**.
2. À direita, em *Listas de exceções*, selecione [**Geral**](https://app.impact.com/secure/advertiser/campaign/itemlist/view-generalitemlist-flow.ihtml).
3. Insira um nome para a lista em **Nome da lista**.
4. Em **Associar tipo de evento**, selecione o tipo de evento a associar à lista de exceções.
5. Opcionalmente, selecione **Mostrar configurações avançadas** para definir uma expressão de correspondência. Insira uma expressão regular para corresponder a padrões específicos.
6. Selecione **Salvar e adicionar itens** para continuar e adicionar valores à lista, **Salvar** para salvar a lista sem adicionar itens ainda, ou **Cancelar** para descartar a lista.

<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%2F35MX3vz5VRRu9vCDkAvd%2FScreenshot%202026-07-20%20at%2013.28.34.png?alt=media&amp;token=a000a259-d8a3-4695-9a93-0276ca7e76c6" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

### Adicionar valores à lista

1. Depois de selecionar **Salvar e adicionar itens**, a tela *\[Nome da lista] : Adicionar valores gerais* é aberta. Em *Adicionar itens de valor*, adicione valores de uma destas duas maneiras:
   * **Insira os valores manualmente:** insira um *Valor* e, opcionalmente, um *Valor de exibição*, depois selecione **Adicionar item** para adicionar outra linha.
   * **Fazer upload de um arquivo:** em *Fazer upload de um arquivo CSV ou Excel*, selecione **Escolher arquivo** e selecione um arquivo `.csv` ou Excel. Selecione **Mostrar/ocultar detalhes do formato do arquivo** para conferir o formato de arquivo necessário.
2. Selecione **Salvar** para salvar os valores ou **Cancelar** para descartá-los.

<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%2Fo969v8Hspqv1nIlAS22A%2FScreenshot%202026-07-20%20at%2013.30.40.png?alt=media&amp;token=8787892d-5354-4ae9-8d39-14c700d22dc9" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

### Referenciar uma lista em uma regra de repasse

1. [Modifique](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/platform-features/contracts-and-template-terms/template-terms/modify-template-terms.md) ou [crie](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/platform-features/contracts-and-template-terms/template-terms/create-template-terms.md) o termo do modelo em que você quer usar a lista geral de exceções.
2. Ao lado da modificação do repasse, configure a regra de repasse adicionando o atributo associado à lista de exceções, por exemplo, `Customer City`.
3. No menu suspenso do operador da regra, selecione `in list`, `not in list`, ou `when present is not in list`, dependendo das conversões que você quer que a regra afete.
   * `in list`: a regra é aplicada quando o valor do atributo está na lista selecionada.
   * `not in list`: a regra é aplicada quando o valor do atributo não está na lista selecionada.
   * `when present is not in list`: a regra só é aplicada quando o atributo tem um valor e esse valor não está na lista selecionada. Use esta opção se quiser deixar as conversões inalteradas quando o atributo estiver totalmente ausente, em vez de tratar um valor ausente da mesma forma que um valor que não corresponde.

{% hint style="success" %}
**Observação:** Atributos de data, monetários e numéricos não são compatíveis com `in list`, `not in list`e `when present is not in list`.
{% endhint %}

4. Na caixa de texto, adicione a lista geral de exceções digitando o nome da lista.
5. Selecione **Adicionar**.

<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%2FMJbBWqRDrjRFUYuVy3nX%2FScreenshot%202026-07-20%20at%2012.28.55.png?alt=media&amp;token=082e754f-83c2-4abf-98c9-0ca34c9455ef" alt="" width="563"><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

## Atualizar, visualizar ou remover uma lista geral

{% hint style="success" %}
**Observação:** Quando você atualiza uma lista geral, a regra de repasse que referencia a lista passa a usar a versão atualizada.
{% endhint %}

1. Na página *Listas gerais de exceções* na tela, passe o cursor sobre a lista geral que deseja atualizar e selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FPORUgP0qyEEctyFkbw08%2Factions.svg?alt=media\&token=2d406300-0455-4291-8028-aed6300b6e3c) **\[Mais]**.
2. Escolha uma ação:
   * **Editar:** Atualize o nome da lista, o tipo de evento associado ou a expressão de correspondência.
   * **Adicionar valor:** Adicione mais valores à lista, manualmente ou enviando um arquivo.
   * **Ver valores:** Veja os valores atuais da lista sem baixá-la.
   * **Limpar valores:** Remova todos os valores que estão na lista.
   * **Desativar:** Impeça que a lista fique disponível para uso, sem excluí-la. Quando desativada, o *status* da lista será atualizado para `Deactivated`.
     * Você pode reativar ou excluir a lista desativada.
   * **Baixar CSV:** Exporte os valores atuais da lista como um arquivo `.csv` .

[^1]: A propriedade de uma conversão que uma regra avalia.


---

# 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/account-administration/program-settings/exception-lists/create-and-manage-general-exception-lists.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.
