> 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/it/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participants/delete-participants-from-your-advocate-program.md).

# Spiegazione dell'eliminazione dei partecipanti Advocate

{% hint style="danger" %}
**Attenzione**: le eliminazioni sono permanenti e potrebbero influire sui link di condivisione, sui referral e sulle analisi.
{% endhint %}

La nostra funzionalità di eliminazione è pienamente conforme ai requisiti del GDPR in materia di cancellazione degli utenti. Quando elimini dei partecipanti, il nostro sistema cancella entro 30 giorni tutti i dati personali identificabili (PII) memorizzati per quei partecipanti nei nostri sistemi e presso i nostri sub-responsabili. Puoi recuperare un elenco completo dei PII memorizzati per un partecipante specifico usando il metodo API [Cercare i PII di un utente](https://integrations.impact.com/brand-api-reference/advocate-api-reference-v1/reference/user-overview/user) . Puoi eliminare i partecipanti dal tuo programma singolarmente o in blocco.

#### Opzioni di eliminazione

{% tabs %}
{% tab title="Non tracciare" %}
Puoi configurare l'eliminazione con l'opzione *Non tracciare* . Se selezionata, il partecipante eliminato non potrà essere registrato di nuovo nel sistema e qualsiasi tentativo di ricrearlo non andrà a buon fine.
{% endtab %}

{% tab title="Mantieni gli account vuoti" %}
La conservazione degli account vuoti è un'opzione di configurazione utilizzabile quando elimini partecipanti in blocco tramite REST API o GraphQL. Per mantenere gli account vuoti, includi il campo `preserveEmptyAccount` nel file di eliminazione oppure nella chiamata.
{% endtab %}
{% endtabs %}

#### Metodi di eliminazione

{% tabs %}
{% tab title="Tramite API" %}
L'API REST di Advocate offre due metodi per eliminare i partecipanti:

* [**Eliminare un account**](https://integrations.impact.com/brand-api-reference/advocate-api-reference-v1/reference/account-overview/account)**:** Usa questo metodo per eliminare un account e tutti i partecipanti associati.
* [**Eliminare un partecipante**](https://integrations.impact.com/brand-api-reference/advocate-api-reference-v1/reference/user-overview/user)**:** Usa questo metodo per eliminare un partecipante da un account senza eliminare l'account stesso.
  {% endtab %}

{% tab title="Singolarmente" %}

1. Dal menu di navigazione a sinistra, seleziona ![](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] → Partecipanti**.
2. Cerca il partecipante che vuoi eliminare.
3. Seleziona il suo nome per aprire il profilo del partecipante.
4. Seleziona il pulsante **Elimina** sotto il suo nome.
5. Scegli se aggiungere il partecipante all'elenco *Non tracciare* .
6. Se sei sicuro di voler eliminare il partecipante, seleziona il pulsante di eliminazione finale.
   {% endtab %}

{% tab title="In blocco" %}
{% hint style="warning" %}
**Attenzione**: questa procedura elimina definitivamente tutti i partecipanti selezionati e i relativi dati storici (ad esempio, referral, premi ed eventi). Non potrai recuperare questi dati. Prima di procedere, devi confermare che i partecipanti presenti nel file debbano essere eliminati.
{% endhint %}

**Prepara il file**

Advocate accetta importazioni nei formati `.csv` o `.jsonl` . Consulta il [file CSV di esempio per l'importazione](https://assets.ctfassets.net/s68ib1kj8k5n/4IWYz9jkNTP4gQiKU5HSnO/09794e8768e3732f6d06ea29a058d388/sample-user-delete.csv) e il [file JSONL di esempio per l'importazione](https://assets.ctfassets.net/s68ib1kj8k5n/1GMnqK0sMJ9LXXaKyjXOVD/ec39618863613f483703cd6f754b6017/userDeleteImportSample.zip) per vedere la struttura richiesta. Per ottenere risultati ottimali, assicurati che ogni file non superi le 500.000 voci.

* Campi obbligatori: `id` e `accountId`.
* Campi facoltativi: puoi includere altri campi facoltativi per personalizzare l'eliminazione.

Tutti i campi distinguono tra maiuscole e minuscole. Consulta la *riferimento dei campi* tabella seguente per ulteriori informazioni.

**Elimina partecipanti**

1. Nel menu di navigazione a sinistra, seleziona ![](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**.
2. Seleziona ![](https://1043985218-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-1c990ed7d1179d6bc54ec8a2f98688d63ffdf977%2F1ca7fd10d94ed494c076e86be8f0d3f371693b11c47f1b26ec0435a27e0e48c5.svg?alt=media) **Importa**.
3. In *Scegli un tipo di importazione*, seleziona **Elimina utenti**.
4. Per caricare il file, seleziona **Scegli file**.
5. Seleziona **Esegui anteprima** per eseguire un'importazione di prova e convalidare il file.

L'anteprima verifica la presenza di errori nel file. Durante l'importazione finale, il sistema ignorerà le righe che contengono errori.

6. (Facoltativo) Configura le opzioni di gestione dell'eliminazione:

* **Mantieni gli account vuoti:** Seleziona questa opzione per impedire l'eliminazione di un account quando vengono eliminati tutti gli utenti associati.
* **Impedisci che gli utenti eliminati vengano ricreati:** Seleziona questa opzione per applicare il *Do Not Track* agli utenti eliminati.

7. Dopo aver verificato che l'anteprima non presenti errori, seleziona **Eliminazione in blocco**.

Al termine del processo di eliminazione, il sistema invia un'email di conferma. Il processo può richiedere fino a 30 minuti, a seconda della coda e delle dimensioni del file.

<details>

<summary>Descrizione dei campi</summary>

| Campo                | Tipo                                                                  | Descrizione                                                                                                                                                                                                                                                                                                                   |
| -------------------- | --------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| accountId            | <p>Stringa</p><p><mark style="color:$danger;">Obbligatorio</mark></p> | L'identificatore univoco dell'account a cui appartiene questo utente.                                                                                                                                                                                                                                                         |
| id                   | <p>Stringa</p><p><mark style="color:$danger;">Obbligatorio</mark></p> | L'identificatore univoco assegnato a questo utente.                                                                                                                                                                                                                                                                           |
| preserveEmptyAccount | booleano                                                              | Se l'account dell'utente rimane senza utenti, per impostazione predefinita l'account viene eliminato. Se specificato, questo campo farà sì che l'account vuoto venga mantenuto. Questa impostazione sostituirà l'impostazione globale `Preserve Empty Accounts` per il processo di importazione, limitatamente a questa riga. |
| doNotTrack           | booleano                                                              | Specifica `true` se vuoi che questo utente venga eliminato con l'impostazione `Do Not Track` attivata. Questa impostazione sostituirà quella globale `Do Not Track` per il processo di importazione, limitatamente a questa riga.                                                                                             |

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

**Risultati**

Ti invieremo un'email al termine dell'importazione. Puoi scaricare i risultati da ![](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 →** [**Importazioni ed esportazioni**](https://app.impact.com/secure/advertiser/engage/advocate/p/6846ce09cf529b17c4549c95/t/live/jobs).

{% hint style="success" icon="memo" %}
**Nota**: i link per il download scadono dopo 30 giorni.
{% endhint %}

{% tabs %}
{% tab title="Caricamento completato" %}
Se l'importazione viene completata correttamente, verrà generato e inviato via email un file con gli ID degli account e degli utenti dei partecipanti eliminati.
{% endtab %}

{% tab title="Errori" %}
**Errori di importazione:** Se il file di importazione contiene errori, il sistema genera un file separato con gli errori. Il file elenca ciascun errore con il numero della riga corrispondente nel file originale e un messaggio di errore dettagliato.

**Errori di sistema:** Se un errore di sistema interrompe l'importazione, il suo stato diventerà *interrotto*. Questa procedura non può essere ripristinata. In questo caso, [contatta l'assistenza](https://app.impact.com/secure/advertiser/support/customer-support-portal-flow.ihtml) per ricevere aiuto.
{% endtab %}
{% endtabs %}

#### Effetti sul sistema

L'eliminazione di un partecipante può influire su diverse aree del sistema.

{% tabs %}
{% tab title="Link di condivisione" %}
Quando un partecipante viene eliminato, vengono eliminati anche tutti i suoi dati personali (PII), compreso il codice di referral. I link di condivisione funzionano diversamente: il link in sé non viene eliminato, ma viene rimossa l'associazione con il partecipante specifico. I link di condivisione del partecipante eliminato non attribuiranno più referral, ma consentiranno comunque ai nuovi partecipanti invitati di visitare la pagina di destinazione del tuo programma.
{% endtab %}

{% tab title="Referral" %}
Se i partecipanti eliminati hanno effettuato referral o sono stati invitati a loro volta, la cronologia dei referral mostrata nei widget o nei micrositi degli altri partecipanti cambierà. In questi casi, il referral continua a essere conteggiato ai fini dei premi, ma verrà mostrato come proveniente da un partecipante anonimo.
{% endtab %}

{% tab title="Analisi" %}
I dati analitici vengono raccolti quando i partecipanti eseguono azioni come caricare widget, condividere link o effettuare referral. Quando i partecipanti vengono eliminati, tutti i dati analitici a loro attribuiti vengono rimossi. Ciò influirà sulle statistiche mostrate nella sezione Reporting del tuo programma Advocate su impact.com.
{% endtab %}

{% tab title="Piattaforma" %}
I partecipanti eliminati non compaiono più nella pagina **Partecipanti** . Se il partecipante eliminato faceva parte di un referral, la tabella dei referral nel profilo dell'altro partecipante indicherà che esiste un referral, ma che proviene da un partecipante eliminato. Se per il referral era stato assegnato un premio, anche la tabella dei premi indicherà che il referral è collegato a un partecipante eliminato.
{% 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/it/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.
