> 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 podem afetar seus links de compartilhamento, indicações e análises.
{% endhint %}

Nossa funcionalidade de exclusão está totalmente em conformidade com os requisitos para exclusão de usuários definidos pelo GDPR. Quando você exclui participantes, nosso sistema excluirá, em até 30 dias, todos os dados pessoais identificáveis (PII) armazenados para esses participantes em nosso sistema e nos subprocessadores. Você pode obter uma lista completa dos dados pessoais identificáveis (PII) armazenados para um participante específico usando o [Consultar os dados pessoais identificáveis 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 opção *Não rastrear* . Se selecionada, não será possível registrar novamente o participante excluído no sistema, e qualquer tentativa de recriá-lo 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 por meio da API REST ou do GraphQL. Para preservar contas vazias, inclua o campo `preserveEmptyAccount` no arquivo de exclusão ou na chamada.
{% 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 associados a ela.
* [**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 ![](https://impact-1.gitbook.io/docs/emvxfLrwrlacc4y3y02Y/~gitbook/image?url=https%3A%2F%2F4048883401-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FwMLlMoFBtKJa8ptd3zaw%252Fuploads%252Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%252Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg%3Falt%3Dmedia\&width=300\&dpr=3\&quality=100\&sign=71dd50ef\&sv=2) **\[Engage] → Participantes**.
2. Pesquise o participante que você deseja excluir.
3. Selecione o nome dele para abrir o perfil do participante.
4. Selecione o botão **Excluir** abaixo do nome dele.
5. Escolha se deseja adicionar o participante à lista *Não rastrear* .
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). Não é possível recuperar esses dados. Antes de continuar, você precisa confirmar que os participantes do seu arquivo devem ser excluídos.
{% endhint %}

**Prepare seu arquivo**

O Advocate aceita importações nos formatos `.csv` ou `.jsonl` . Consulte o [arquivo de importação CSV de exemplo](https://assets.ctfassets.net/s68ib1kj8k5n/4IWYz9jkNTP4gQiKU5HSnO/09794e8768e3732f6d06ea29a058d388/sample-user-delete.csv) e o [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 obter melhores resultados, verifique se cada arquivo tem no máximo 500.000 registros.

* 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 campo* na tabela abaixo para mais informações.

**Excluir participantes**

1. No menu de navegação à esquerda, selecione ![](https://impact-1.gitbook.io/docs/emvxfLrwrlacc4y3y02Y/~gitbook/image?url=https%3A%2F%2F4048883401-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FwMLlMoFBtKJa8ptd3zaw%252Fuploads%252Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%252Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg%3Falt%3Dmedia\&width=300\&dpr=3\&quality=100\&sign=71dd50ef\&sv=2) **\[Engage] → Relatórios → Importações e exportações**.
2. Selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-1c990ed7d1179d6bc54ec8a2f98688d63ffdf977%2F1ca7fd10d94ed494c076e86be8f0d3f371693b11c47f1b26ec0435a27e0e48c5.svg?alt=media) **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évia** para fazer uma importação de teste e validar seu arquivo.

A prévia verifica se há erros no arquivo. O sistema ignorará todas as 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 flag *Do Not Track* aos usuários excluídos.

7. Depois que a prévia for concluída com sucesso, selecione **Excluir 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.

<details>

<summary>Referência dos campos</summary>

| Campo                | Tipo                                                                | Descrição                                                                                                                                                                                                                                                              |
| -------------------- | ------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| accountId            | <p>String</p><p><mark style="color:$danger;">Obrigatório</mark></p> | O identificador exclusivo da conta à qual este usuário pertence.                                                                                                                                                                                                       |
| id                   | <p>String</p><p><mark style="color:$danger;">Obrigatório</mark></p> | O identificador exclusivo fornecido para este usuário.                                                                                                                                                                                                                 |
| preserveEmptyAccount | boolean                                                             | Se a conta do usuário ficar sem usuários, por padrão ela será excluída. Se definido, este campo fará com que a conta vazia seja preservada. Isso substituirá a configuração global `Preserve Empty Accounts` da tarefa de importação, especificamente para esta linha. |
| doNotTrack           | boolean                                                             | Especifique `true` se quiser que este usuário seja excluído com a configuração `Do Not Track` definida. Isso substituirá a configuração global `Do Not Track` da tarefa de importação, especificamente para esta linha.                                                |

</details>
{% endtab %}
{% endtabs %}

**Resultados**

Enviaremos uma notificação por e-mail quando a importação for concluída. Você pode baixar os resultados em ![](https://impact-1.gitbook.io/docs/emvxfLrwrlacc4y3y02Y/~gitbook/image?url=https%3A%2F%2F4048883401-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FwMLlMoFBtKJa8ptd3zaw%252Fuploads%252Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%252Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg%3Falt%3Dmedia\&width=300\&dpr=3\&quality=100\&sign=71dd50ef\&sv=2) **\[Engage] → Reporting →** [**Imports & Exports**](https://app.impact.com/secure/advertiser/engage/advocate/p/6846ce09cf529b17c4549c95/t/live/jobs).

{% hint style="success" icon="memo" %}
**Observação**: os links para download expirarão após 30 dias.
{% endhint %}

{% tabs %}
{% tab title="Carregamento bem-sucedido" %}
Se a importação for concluída com sucesso, um arquivo com os IDs das contas e dos usuários dos participantes excluídos será gerado e enviado por e-mail para você.
{% endtab %}

{% tab title="Erros" %}
**Erros de importação:** Se o arquivo de importação contiver erros, o sistema gerará um arquivo de erros separado. Esse arquivo lista cada erro com o número da linha correspondente no arquivo original e uma mensagem detalhada sobre o erro.

**Erros do sistema:** Se um erro do sistema interromper a importação, o status mudará para *cancelada*. Não é possível recuperar esse processo. Nesse caso, [entre em contato com o suporte](https://app.impact.com/secure/advertiser/support/customer-support-portal-flow.ihtml) para receber ajuda.
{% endtab %}
{% endtabs %}

#### Efeitos no sistema

A exclusão de um participante pode afetar várias áreas do sistema.

{% tabs %}
{% tab title="Links de compartilhamento" %}
Quando um participante é excluído, todos os seus dados pessoais identificáveis (incluindo o código de indicação) também são excluídos. Os links de compartilhamento funcionam de outra forma: o link em si não é excluído, mas sua associação a um participante específico é removida. Os links de compartilhamento do participante excluído não atribuirão mais indicações, mas ainda permitirão que novos participantes indicados acessem a página de destino do seu programa.
{% endtab %}

{% tab title="Indicações" %}
Se os 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 contará para fins de recompensa, mas será exibida como tendo sido feita por um participante anônimo.
{% endtab %}

{% tab title="Análises" %}
As análises são coletadas à medida que os participantes realizam ações como carregar widgets, compartilhar links ou fazer indicações. Quando os participantes são excluídos, todos os dados analíticos atribuídos a eles são removidos, o que afeta 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 página **Participantes** . 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 ela 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=<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.
