# 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 todos os dados pessoais identificáveis (PII) que tenham sido armazenados para esses participantes em nosso sistema e em seus subprocessadores. Você pode recuperar uma lista completa dos PII armazenados para um participante específico usando o [Consultar PII de um usuário](https://integrations.impact.com/impact-brand/reference/getuserpii) 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, o participante excluído não poderá ser registrado novamente 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, via API REST ou via GraphQL. Para preservar contas vazias, inclua o `preserveEmptyAccount` campo com seu arquivo ou chamada de exclusão.
{% endtab %}
{% endtabs %}

#### Métodos de exclusão

{% tabs %}
{% tab title="Via a API" %}
A API REST da Advocate oferece dois métodos para excluir participantes:

* [**Excluir uma conta**](https://integrations.impact.com/impact-brand/reference/opendeleteaccount)**:** Use este método para excluir uma conta e todos os participantes nela.
* [**Excluir um participante**](https://integrations.impact.com/impact-brand/reference/opendeleteuser)**:** 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) **\[Engajar] → 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 à *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 a [arquivo de exemplo de importação CSV](https://assets.ctfassets.net/s68ib1kj8k5n/4IWYz9jkNTP4gQiKU5HSnO/09794e8768e3732f6d06ea29a058d388/sample-user-delete.csv) e [arquivo de exemplo de importação JSONL](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. Veja a *referência de campos* 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 ![](/files/aba5f32934b31e047c124f21c4a6d5bd0ac5f37d) **Importar**.
3. Em *Escolha um tipo de importação*, selecione **Excluir usuários**.
4. Para enviar seu arquivo, selecione **Escolher arquivo**.
5. Selecione **Executar visualização** para realizar uma importação de teste e validar seu arquivo.

A visualização verifica se há erros no seu arquivo. O sistema ignorará qualquer linha 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 *Não rastrear* aos usuários excluídos.

7. Após a 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.

<details>

<summary>Referência de 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 | booleano                                                            | 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` para o trabalho de importação especificamente para esta linha. |
| doNotTrack           | booleano                                                            | Especifique `verdadeiro` se você quiser que este usuário seja excluído com a configuração `Não rastrear` definida. Isso substituirá a configuração global `Não rastrear` para o trabalho de importação especificamente para esta linha.                                         |

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

**Resultados**

Nós o notificamos por e-mail quando sua importação for concluída. Você pode baixar os परिणामados 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] → 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, um arquivo com os IDs da conta e dos usuários dos participantes excluídos será gerado e enviado a você por e-mail.
{% endtab %}

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

**Erros do sistema:** Se um erro do sistema interromper a importação, o status dele mudará para *abortada*. Este 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, todos os seus dados pessoais identificáveis (PII), incluindo seu código de indicação, também são excluídos. 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 visitem 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 mudará. Nesses casos, a indicação ainda conta para fins de recompensa, mas visualmente a indicação 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 realizam 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 no impact.com.
{% endtab %}

{% tab title="Plataforma" %}
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 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: 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:

```
GET https://help.impact.com/brand/pt-br/sobre-o-que-voce-gostaria-de-aprender/advocate-program/manage-advocate-participants/delete-participants-from-your-advocate-program.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
