> 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-participants/delete-participants-from-your-advocate-program.md).
# Explicação sobre a exclusão de participantes do Advocate
{% hint style="danger" %}
**Aviso**: As exclusões são permanentes e seus links de compartilhamento, indicações e análises podem ser impactados.
{% endhint %}
Nossa funcionalidade de exclusão está totalmente em conformidade com os requisitos de exclusão de usuários, conforme descrito pelo GDPR. Quando você exclui participantes, nosso sistema excluirá, em até 30 dias, todas as PII armazenadas para esses participantes em nosso sistema e em seus subprocessadores. Você pode recuperar uma lista completa das PII armazenadas para um participante específico usando o [Consultar a PII de um usuário](https://integrations.impact.com/brand-api-reference/advocate-api-reference-v1/reference/user-overview/user) método da API. Os participantes podem ser excluídos do seu programa individualmente ou em massa.
#### Opções de exclusão
{% tabs %}
{% tab title="Não rastrear" %}
Você pode configurar a exclusão com a *Não rastrear* opção. Se selecionado, o participante excluído não poderá ser registrado novamente no sistema e qualquer tentativa de recriar o participante falhará.
{% endtab %}
{% tab title="Preservar contas vazias" %}
Preservar contas vazias é uma opção de configuração que você pode usar ao excluir participantes em massa, via API REST ou via GraphQL. Para preservar contas vazias, inclua o `preserveEmptyAccount` campo em seu arquivo ou chamada de exclusão.
{% endtab %}
{% endtabs %}
#### Métodos de exclusão
{% tabs %}
{% tab title="Pela API" %}
A API REST da Advocate oferece dois métodos para excluir participantes:
* [**Excluir uma conta**](https://integrations.impact.com/brand-api-reference/advocate-api-reference-v1/reference/account-overview/account)**:** Use este método para excluir uma conta e todos os participantes nela.
* [**Excluir um participante**](https://integrations.impact.com/brand-api-reference/advocate-api-reference-v1/reference/user-overview/user)**:** Use este método para excluir um participante de uma conta sem excluir a própria conta.
{% endtab %}
{% tab title="Individualmente" %}
1. No menu de navegação à esquerda, selecione  **\[Engage] → Participantes**.
2. Procure o participante que você deseja excluir.
3. Selecione o nome dele para abrir o perfil do participante.
4. Selecione o **Excluir** botão abaixo do nome dele.
5. Escolha se deseja adicionar o participante à *Não rastrear* lista.
6. Selecione o botão final de exclusão se tiver certeza de que deseja excluir o participante.
{% endtab %}
{% tab title="Em massa" %}
{% hint style="warning" %}
**Aviso**: Este processo exclui permanentemente todos os participantes selecionados e seus dados históricos (por exemplo, indicações, recompensas e eventos). Você não pode recuperar esses dados. Antes de prosseguir, você deve confirmar que os participantes no seu arquivo devem ser excluídos.
{% endhint %}
**Prepare seu arquivo**
O Advocate aceita importações enviadas em `.csv` ou `.jsonl` formatos de arquivo. Consulte o [arquivo de importação CSV de exemplo](https://assets.ctfassets.net/s68ib1kj8k5n/4IWYz9jkNTP4gQiKU5HSnO/09794e8768e3732f6d06ea29a058d388/sample-user-delete.csv) e [arquivo de importação JSONL de exemplo](https://assets.ctfassets.net/s68ib1kj8k5n/1GMnqK0sMJ9LXXaKyjXOVD/ec39618863613f483703cd6f754b6017/userDeleteImportSample.zip) para ver a estrutura de arquivo necessária. Para melhores resultados, certifique-se de que cada arquivo não exceda 500.000 entradas.
* Campos obrigatórios: `id` e `accountId`.
* Campos opcionais: Você pode incluir outros campos opcionais para personalizar a exclusão.
Todos os campos diferenciam maiúsculas de minúsculas. Consulte a *referência de campos* tabela abaixo para mais informações.
**Excluir participantes**
1. No menu de navegação à esquerda, selecione  **\[Engage] → Relatórios → Importações e exportações**.
2. Selecione  **Importar**.
3. Em *Escolha um tipo de importação*, selecione **Excluir usuários**.
4. Para enviar seu arquivo, selecione **Escolher arquivo**.
5. Selecione **Executar prévia** para realizar uma importação de teste e validar seu arquivo.
A prévia verifica se há erros no seu arquivo. O sistema ignorará quaisquer linhas com erros durante a importação final.
6. (Opcional) Configure as opções de tratamento da exclusão:
* **Preservar contas vazias:** Selecione esta opção para impedir que uma conta seja excluída quando todos os usuários associados a ela forem excluídos.
* **Impedir que usuários excluídos sejam criados novamente:** Selecione esta opção para aplicar o *Não rastrear* marcador aos usuários excluídos.
7. Depois que a prévia for bem-sucedida, selecione **Exclusão em massa**.
Quando o processo de exclusão for concluído, o sistema enviará um e-mail de confirmação. O processo pode levar até 30 minutos, dependendo da fila e do tamanho do arquivo.
Referência de campos
| Campo | Tipo | Descrição |
| -------------------- | ------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| accountId | Texto
Obrigatório
| O identificador exclusivo da Conta à qual este usuário pertence. |
| id | Texto
Obrigatório
| O identificador exclusivo fornecido para este usuário. |
| preserveEmptyAccount | boolean | Se a conta do usuário ficar sem usuários, por padrão a conta será excluída. Se definido, este campo fará com que a conta vazia seja preservada. Isso substituirá a `Preservar contas vazias` configuração global do trabalho de importação para esta linha especificamente. |
| doNotTrack | boolean | Especifique `verdadeiro` se você deseja que este usuário seja excluído com a `Não rastrear` configuração definida. Isso substituirá a `Não rastrear` configuração global do trabalho de importação para esta linha especificamente. |
{% endtab %}
{% endtabs %}
**Resultados**
Nós o notificamos por e-mail quando sua importação for concluída. Você pode baixar os resultados em  **\[Engage] → Relatórios →** [**Importações e Exportações**](https://app.impact.com/secure/advertiser/engage/advocate/p/6846ce09cf529b17c4549c95/t/live/jobs).
{% hint style="success" icon="memo" %}
**Observação**: Os links de download expirarão após 30 dias.
{% endhint %}
{% tabs %}
{% tab title="Envio bem-sucedido" %}
Se a importação for concluída com sucesso, será gerado e enviado por e-mail um arquivo com os IDs de conta e de usuário dos participantes excluídos.
{% endtab %}
{% tab title="Erros" %}
**Erros de importação:** Se o arquivo de importação contiver erros, o sistema gerará um arquivo de erro separado. Esse arquivo lista cada erro com seu respectivo número de linha do arquivo original e uma mensagem de erro detalhada.
**Erros do sistema:** Se um erro do sistema interromper a importação, o status será alterado para *cancelada*. Esse processo não pode ser recuperado. Nesse caso, [entre em contato com o suporte](https://app.impact.com/secure/advertiser/support/customer-support-portal-flow.ihtml) para obter ajuda.
{% endtab %}
{% endtabs %}
#### Efeitos no sistema
Várias áreas do sistema podem ser impactadas como resultado da exclusão de um participante.
{% tabs %}
{% tab title="Links de compartilhamento" %}
Quando um participante é excluído, todas as suas PII (incluindo seu código de indicação) também são excluídas. Os links de compartilhamento funcionam de maneira diferente — o próprio link de compartilhamento não é excluído, mas sua associação com um participante específico é removida. Os links de compartilhamento do participante excluído não atribuirão mais uma indicação, mas ainda permitirão que participantes recém-indicados acessem a página inicial do seu programa.
{% endtab %}
{% tab title="Indicações" %}
Se participantes excluídos tiverem feito indicações ou tiverem sido indicados, o histórico de indicações exibido nos widgets ou microsites de outros participantes será alterado. Nesses casos, a indicação ainda conta para fins de recompensa, mas visualmente será mostrada como tendo vindo de um participante anônimo.
{% endtab %}
{% tab title="Análises" %}
As análises são coletadas à medida que os participantes executam ações como carregar widgets, compartilhar links ou fazer indicações. Quando os participantes são excluídos, todas as análises atribuídas a eles são removidas, o que afetará as estatísticas exibidas na seção de Relatórios do seu programa Advocate na impact.com.
{% endtab %}
{% tab title="Plataforma" %}
Os participantes excluídos não aparecem mais na **Participantes** página. Se o participante excluído fazia parte de uma indicação, a tabela de indicações no perfil do outro participante mostrará que existe uma indicação, mas que ela veio de um participante excluído. Se uma recompensa tiver sido concedida como parte da indicação, a tabela de recompensas indicará de forma semelhante que a indicação está vinculada a um participante excluído.
{% endtab %}
{% endtabs %}
---
# 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-participants/delete-participants-from-your-advocate-program.md?ask=&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.