> 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).
# Exclusão de participantes do Advocate explicada
{% hint style="danger" %}
**Aviso**: As exclusões são permanentes e seus links de compartilhamento, indicações e análises podem ser afetados.
{% endhint %}
Nossa funcionalidade de exclusão está totalmente em conformidade com os requisitos para exclusão de usuários, conforme descrito pelo GDPR. Quando você exclui participantes, nosso sistema excluirá, em até 30 dias, toda a PII armazenada para esses participantes em nosso sistema e em seus subprocessadores. Você pode recuperar uma lista completa da PII armazenada para um participante específico usando o [Localizar 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 no seu arquivo ou chamada de exclusão.
{% endtab %}
{% endtabs %}
#### Métodos de exclusão
{% tabs %}
{% tab title="Pela API" %}
A API REST do 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. Pesquise o participante que você deseja excluir.
3. Selecione o nome dele para abrir o perfil do participante.
4. Selecione a **Excluir** botão abaixo do nome dele.
5. Escolha se deseja adicionar o participante ao *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**
Advocate aceita importações enviadas em `.csv` ou `.jsonl` formatos de arquivo. Consulte o [arquivo CSV de importação de exemplo](https://assets.ctfassets.net/s68ib1kj8k5n/4IWYz9jkNTP4gQiKU5HSnO/09794e8768e3732f6d06ea29a058d388/sample-user-delete.csv) e [arquivo JSONL de importação 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 o *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 carregar seu arquivo, selecione **Escolher arquivo**.
5. Selecione **Executar pré-visualização** para realizar uma importação de teste e validar seu arquivo.
A pré-visualização verifica seu arquivo em busca de erros. 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 a *Não rastrear* sinalizador aos usuários excluídos.
7. Após a pré-visualização ser 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 | String
Obrigatório
| O identificador exclusivo da conta à qual este usuário pertence. |
| id | String
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 configuração global `Preservar contas vazias` da tarefa de importação especificamente para esta linha. |
| doNotTrack | boolean | Especifique `true` se você quiser que este usuário seja excluído com a `Não rastrear` configuração definida. Isso substituirá a configuração global `Não rastrear` da tarefa de importação especificamente para esta linha. |
{% endtab %}
{% endtabs %}
**Resultados**
Nós o notificamos por e-mail quando sua importação estiver 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 um arquivo com as IDs de conta e de usuário dos participantes excluídos, e ele será enviado a você por e-mail.
{% endtab %}
{% tab title="Erros" %}
**Erros de importação:** Se o arquivo de importação contiver erros, o sistema gera um arquivo de erro separado. Esse arquivo lista cada erro com o respectivo número da linha do arquivo original e uma mensagem de erro detalhada.
**Erros do sistema:** Se um erro do sistema interromper a importação, o status mudará para *abortado*. 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 afetadas como resultado da exclusão de um participante.
{% tabs %}
{% tab title="Links de compartilhamento" %}
Quando um participante é excluído, toda a sua PII (incluindo seu código de indicação) também é excluída. Os links de compartilhamento funcionam de forma 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 de destino do seu programa.
{% endtab %}
{% tab title="Indicações" %}
Se participantes excluídos tiverem feito indicações ou 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á exibida 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 Relatórios do seu programa Advocate no 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 foi feita por um participante excluído. Se uma recompensa tiver sido concedida como parte da indicação, a tabela de recompensas também indicará 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 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/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 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.