> 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
Listas gerais permitem agrupar valores associados a um atributo[^1] para que você possa afetar os pagamentos de todos eles pela mesma taxa. Por exemplo, se você quiser aumentar o pagamento em 10% para determinadas cidades de clientes, adicione essas cidades à mesma lista e, então, faça referência à lista em sua [pagamento](/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 vez)"]
A["Criar lista: Target Cities
Tipo de evento: Venda online"] --> B["Adicionar valores: Chicago, Austin, Seattle"]
B --> C["Mapear para regra de pagamento
Cidade do cliente na lista Target Cities"]
fim
subgraph Payout["No momento do pagamento (por conversão)"]
D["A conversão chega
Cidade do cliente = Austin"] --> E["Correspondência encontrada → taxa de 10% aplicada"]
fim
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
```
## Crie e mapeie uma lista geral de exceções
Criar uma lista geral é um fluxo de três etapas: primeiro, você define a lista, adiciona seus valores e, depois, faz referência à lista em uma regra de pagamento.
{% stepper %}
{% step %}
### Criar a lista
1. Na barra de navegação superior, selecione  **\[Perfil do usuário] → Configurações**.
2. À direita, em *Listas de exceção*, 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 para associar à lista de exceção.
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.
{% endstep %}
{% step %}
### Adicionar valores à lista
1. Depois que você selecionar **Salvar e adicionar itens**, o *\[List Name] : Adicionar valores gerais* a tela é aberta. Em *Adicionar itens de valor*, adicione valores de uma destas duas formas:
* **Insira valores manualmente:** insira um *Valor* e, opcionalmente, um *Valor de exibição*, então selecione **Adicionar item** para adicionar outra linha.
* **Fazer upload de um arquivo:** em *Fazer upload de arquivo CSV ou Excel*, selecione **Escolher arquivo** e selecione um `.csv` ou arquivo Excel. Selecione **Mostrar/ocultar detalhes do formato do arquivo** para revisar o formato de arquivo exigido.
2. Selecione **Salvar** para salvar os valores, ou **Cancelar** para descartá-los.
{% endstep %}
{% step %}
### Fazer referência a uma lista em uma regra de pagamento
1. [Modificar](/brand/pt-br/what-would-you-like-to-learn-about/platform-features/contracts-and-template-terms/template-terms/modify-template-terms.md) ou [crie](/brand/pt-br/what-would-you-like-to-learn-about/platform-features/contracts-and-template-terms/template-terms/create-template-terms.md) o termo de modelo em que você deseja usar a lista geral de exceções.
2. Ao lado da modificação de pagamento, configure a regra de pagamento adicionando o atributo associado à lista de exceção, por exemplo `Cidade do cliente`.
3. No menu suspenso de operador da regra, selecione `na lista`, `não na lista`, ou `quando presente não está na lista`, dependendo das conversões que você quer que a regra afete.
* `na lista`: A regra se aplica quando o valor do atributo é encontrado na lista que você selecionar.
* `não na lista`: A regra se aplica quando o valor do atributo não é encontrado na lista que você selecionar.
* `quando presente não está na lista`: A regra se aplica somente quando o atributo tem um valor, e esse valor não é encontrado na lista que você selecionar. Use isso 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 suportam `na lista`, `não na lista`, e `quando presente não está na lista`.
{% endhint %}
4. Na caixa de texto, adicione a lista geral de exceções digitando o nome da lista.
5. Selecione **Adicionar**.
{% endstep %}
{% endstepper %}
## Atualize, visualize ou remova uma lista geral
{% hint style="success" %}
**Observação:** Quando você atualiza uma lista geral, a regra de pagamento que faz referência à lista usará a versão atualizada.
{% endhint %}
1. Na *Listas gerais de exceções* tela, passe o mouse sobre a lista geral que você deseja atualizar e, em seguida, selecione  **\[Mais]**.
2. Escolha sua 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 por upload de arquivo.
* **Ver valores:** Veja os valores atuais da lista sem baixá-la.
* **Limpar valores:** Remova todos os valores que estão atualmente 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 `Desativado`.
* Você pode reativar ou excluir a lista desativada.
* **Baixar CSV:** Exporte os valores atuais da lista como um `.csv` arquivo.
[^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 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/account-administration/program-settings/exception-lists/create-and-manage-general-exception-lists.md?ask=&goal=
```
`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.
