> 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" %}
**Avvertenza**: Le eliminazioni sono permanenti e i tuoi link di condivisione, i referral e le analisi potrebbero risentirne.
{% endhint %}

La nostra funzionalità di eliminazione è pienamente conforme ai requisiti per l'eliminazione degli utenti come delineato dal GDPR. Quando elimini i partecipanti, il nostro sistema eliminerà entro 30 giorni tutti i PII memorizzati per tali partecipanti nel nostro sistema e nei suoi subprocessori. Puoi recuperare un elenco completo dei PII archiviati per un partecipante specifico utilizzando la [Ricerca dei PII di un utente](https://integrations.impact.com/brand-api-reference/advocate-api-reference-v1/reference/user-overview/user) metodo API. I partecipanti possono essere eliminati dal tuo programma singolarmente o in blocco.

#### Opzioni di eliminazione

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

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

#### Metodi di eliminazione

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

* [**Elimina 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.
* [**Elimina 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 suo profilo partecipante.
4. Seleziona il filtro **Eliminare** pulsante sotto il suo nome.
5. Scegli se aggiungere il partecipante al *Non tracciare* elenco.
6. Seleziona il pulsante finale di eliminazione se sei sicuro di voler eliminare il partecipante.
   {% endtab %}

{% tab title="In blocco" %}
{% hint style="warning" %}
**Avvertenza**: Questo processo elimina in modo permanente tutti i partecipanti selezionati e i loro dati storici (ad es. referral, premi ed eventi). Non puoi recuperare questi dati. Prima di procedere, devi confermare che i partecipanti nel tuo file devono essere eliminati.
{% endhint %}

**Prepara il tuo file**

Advocate accetta importazioni inviate in `.csv` oppure `.jsonl` formati di file. Fai riferimento a [file di importazione CSV di esempio](https://assets.ctfassets.net/s68ib1kj8k5n/4IWYz9jkNTP4gQiKU5HSnO/09794e8768e3732f6d06ea29a058d388/sample-user-delete.csv) e [file di importazione JSONL di esempio](https://assets.ctfassets.net/s68ib1kj8k5n/1GMnqK0sMJ9LXXaKyjXOVD/ec39618863613f483703cd6f754b6017/userDeleteImportSample.zip) per visualizzare la struttura del file richiesta. Per 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 fanno distinzione tra maiuscole e minuscole. Vedi il *riferimento dei campi* tabella sottostante per ulteriori informazioni.

**Elimina partecipanti**

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] → Reporting → Importazioni ed esportazioni**.
2. Seleziona ![](/files/468bf1148bc28c3984bbc2af1aac6965ef2c32c4) **Importa**.
3. Sotto *Scegli un tipo di importazione*, seleziona **Elimina utenti**.
4. Per caricare il tuo file, seleziona **Scegli file**.
5. Seleziona **Esegui anteprima** per eseguire un'importazione di prova e convalidare il tuo file.

L'anteprima controlla il tuo file per rilevare errori. Il sistema salterà tutte le righe con errori durante l'importazione finale.

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

* **Conserva gli account vuoti:** Seleziona questa opzione per impedire che un account venga eliminato quando tutti i suoi utenti associati vengono eliminati.
* **Impedisci che gli utenti eliminati vengano creati di nuovo:** Seleziona questa opzione per applicare il *Non tracciare* flag agli utenti eliminati.

7. Dopo che l'anteprima è andata a buon fine, seleziona **Eliminazione massiva**.

Quando il processo di eliminazione è completato, il sistema invia un'e-mail di conferma. Il processo può richiedere fino a 30 minuti, a seconda della coda e delle dimensioni del file.

<details>

<summary>Guida ai 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'identificativo univoco fornito per questo utente.                                                                                                                                                                                                                                                              |
| preserveEmptyAccount | booleano                                                              | Se l'account dell'utente rimane senza utenti, per impostazione predefinita l'account verrà eliminato. Se impostato, questo campo farà sì che l'account vuoto venga conservato. Questo sovrascriverà il `Conserva gli account vuoti` impostazione globale del processo di importazione per questa riga specifica. |
| doNotTrack           | booleano                                                              | Specifica `true` se desideri che questo utente venga eliminato con il `Non tracciare` flag impostato. Questo sovrascriverà il `Non tracciare` impostazione globale del processo di importazione per questa riga specifica.                                                                                       |

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

**Risultati**

Ti avvisiamo via e-mail quando l'importazione è completata. 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] → Reportistica →** [**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 scadranno dopo 30 giorni.
{% endhint %}

{% tabs %}
{% tab title="Caricamento riuscito" %}
Se l'importazione viene completata con successo, verrà generato un file con gli ID dell'account e dell'utente dei partecipanti eliminati e ti sarà inviato via e-mail.
{% endtab %}

{% tab title="Errori" %}
**Errori di importazione:** Se il tuo file di importazione contiene errori, il sistema genera un file di errore separato. Questo file elenca ogni errore con il relativo numero di riga dal file originale e un messaggio di errore dettagliato.

**Errori di sistema:** Se un errore di sistema interrompe l'importazione, il suo stato cambierà in *interrotta*. Questo processo non può essere ripristinato. In questo caso, [contattare l’assistenza](https://app.impact.com/secure/advertiser/support/customer-support-portal-flow.ihtml) per assistenza.
{% endtab %}
{% endtabs %}

#### Effetti sul sistema

Diverse aree del sistema potrebbero essere interessate a seguito dell'eliminazione di un partecipante.

{% tabs %}
{% tab title="Link di condivisione" %}
Quando un partecipante viene eliminato, tutti i suoi PII (incluso il suo codice referral) vengono eliminati anch'essi. I link di condivisione funzionano in modo diverso: il link di condivisione stesso non viene eliminato, ma viene rimossa la sua associazione con un partecipante specifico. I link di condivisione del partecipante eliminato non attribuiranno più un referral, ma consentiranno comunque ai partecipanti appena referenziati di visitare la landing page del tuo programma.
{% endtab %}

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

{% tab title="Analisi" %}
Le analisi vengono raccolte mentre i partecipanti eseguono azioni come caricare widget, condividere link o effettuare referral. Quando i partecipanti vengono eliminati, tutte le analisi attribuite a loro vengono rimosse, il che influirà sulle statistiche visualizzate nella sezione Reportistica del tuo programma Advocate in impact.com.
{% endtab %}

{% tab title="Piattaforma" %}
I partecipanti eliminati non compaiono più nella **Partecipanti** pagina. Se il partecipante eliminato faceva parte di un referral, la tabella dei referral nel profilo dell'altro partecipante mostrerà che esiste un referral, ma che proveniva da un partecipante eliminato. Se nell'ambito del referral era stato assegnato un premio, anche la tabella dei premi indicherà in modo analogo 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 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/it/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participants/delete-participants-from-your-advocate-program.md?ask=<question>&goal=<endgoal>
```

`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.
