# Explicação sobre 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 afetados.
{% 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ê excluir 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 *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 com seu arquivo ou chamada de exclusão.
{% endtab %}
{% endtabs %}

#### Métodos de exclusão

{% tabs %}
{% tab title="Via API" %}
A API REST do 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) **\[Engage] → Participantes**.
2. Pesquise 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 nos formatos de arquivo `.csv` ou `.jsonl` . Consulte o [arquivo de exemplo de importação CSV](https://assets.ctfassets.net/s68ib1kj8k5n/4IWYz9jkNTP4gQiKU5HSnO/09794e8768e3732f6d06ea29a058d388/sample-user-delete.csv) e o [arquivo de exemplo de importação JSONL](https://assets.ctfassets.net/s68ib1kj8k5n/1GMnqK0sMJ9LXXaKyjXOVD/ec39618863613f483703cd6f754b6017/userDeleteImportSample.zip) para ver a estrutura de arquivo exigida. Para obter os melhores resultados, certifique-se de que cada arquivo não exceda 500.000 entradas.

* Campos obrigatórios: `id` e o `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 tabela de *referência de campos* 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 enviar 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 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 evitar que uma conta seja excluída quando todos os usuários associados a ela forem excluídos.
* **Impedir que usuários excluídos sejam recriados:** Selecione esta opção para aplicar a *Não rastrear* flag aos usuários excluídos.

7. Depois que a pré-visualização for bem-sucedida, 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 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` da tarefa de importação para esta linha especificamente. |
| doNotTrack           | booleano                                                            | 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 para esta linha especificamente.                                               |

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

**Resultados**

Nós o notificamos por e-mail quando sua importação estiver concluída. Você pode baixar os resultados de ![](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 do usuário 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 respectivo número da linha do seu arquivo original e uma mensagem de erro detalhada.

**Erros do sistema:** Se um erro do sistema interromper a importação, o status dela 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 PII (incluindo seu código de indicação) também são excluídos. 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 de destino 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 contará 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 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 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 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 %}