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

La nostra funzionalità di eliminazione è pienamente conforme ai requisiti per l'eliminazione degli utenti come indicato dal GDPR. Quando elimini i partecipanti, il nostro sistema eliminerà entro 30 giorni tutti i dati personali identificabili (PII) archiviati per quei partecipanti nel nostro sistema e nei suoi subprocessori. Puoi recuperare un elenco completo delle PII archiviate per un partecipante specifico usando il [Ricerca delle 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 selezionato, il partecipante eliminato non potrà essere registrato di nuovo nel sistema e qualsiasi tentativo di ricreare il partecipante fallirà.
{% endtab %}

{% tab title="Mantieni gli account vuoti" %}
Mantenere gli account vuoti è un'opzione di configurazione che puoi usare quando elimini i partecipanti in blocco, tramite REST API o tramite GraphQL. Per mantenere 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 l'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 loro nome per aprire il loro profilo partecipante.
4. Seleziona il **Elimina** pulsante sotto il loro nome.
5. Scegli se aggiungere il partecipante alla *Non tracciare* lista.
6. Se sei sicuro di voler eliminare il partecipante, seleziona il pulsante finale Elimina.
   {% endtab %}

{% tab title="In blocco" %}
{% hint style="warning" %}
**Avviso**: Questo processo elimina definitivamente tutti i partecipanti selezionati e i loro dati storici (ad es. segnalazioni, premi ed eventi). Non è possibile recuperare questi dati. Prima di procedere, devi confermare che i partecipanti nel tuo file debbano essere eliminati.
{% endhint %}

**Prepara il tuo file**

Advocate accetta importazioni inviate in `.csv` o `.jsonl` formati di file. Fai riferimento al [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 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 il *riferimento dei campi* tabella seguente per maggiori 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 ![](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. 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 test e convalidare il tuo file.

L'anteprima controlla il tuo file alla ricerca di errori. Il sistema salterà eventuali righe con errori durante l'importazione finale.

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

* **Mantieni 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 ricreati:** Seleziona questa opzione per applicare il *Non tracciare* flag agli utenti eliminati.

7. Dopo che l'anteprima ha avuto successo, seleziona **Eliminazione in blocco**.

Quando il processo di eliminazione è completato, 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>Riferimento dei campi</summary>

| Campo                | Tipo                                                                  | Descrizione                                                                                                                                                                                                                                                                                                        |
| -------------------- | --------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| accountId            | <p>Stringa</p><p><mark style="color:$danger;">Obbligatorio</mark></p> | L'identificativo 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 mantenuto. Questo sovrascriverà il `Mantieni gli account vuoti` impostazione globale per il job di importazione specificamente per questa riga. |
| doNotTrack           | booleano                                                              | Specifica `true` se desideri che questo utente venga eliminato con l' `Non tracciare` impostazione attivata. Questo sovrascriverà il `Non tracciare` impostazione globale per il job di importazione specificamente per questa riga.                                                                               |

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

**Risultati**

Ti avvisiamo via email 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] → 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 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 degli utenti dei partecipanti eliminati e ti verrà inviato via email.
{% 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 del file originale e un messaggio di errore dettagliato.

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

#### Effetti sul sistema

Diversi ambiti del sistema possono essere influenzati dall'eliminazione di un partecipante.

{% tabs %}
{% tab title="Link di condivisione" %}
Quando un partecipante viene eliminato, anche tutte le sue PII (incluso il suo codice di referral) vengono eliminate. I link di condivisione funzionano diversamente — il link di condivisione in sé non viene eliminato, ma viene rimossa la sua associazione con un partecipante specifico. I link di condivisione del partecipante eliminato non attribuiranno più una segnalazione, ma consentiranno comunque ai partecipanti appena segnalati di visitare la landing page del tuo programma.
{% endtab %}

{% tab title="Segnalazioni" %}
Se i partecipanti eliminati hanno effettuato segnalazioni o sono stati a loro volta segnalati, la cronologia delle segnalazioni visualizzata nei widget o nei micrositi degli altri partecipanti cambierà. In questi casi, la segnalazione conta ancora ai fini dei premi, ma visivamente verrà mostrata come proveniente da un partecipante anonimo.
{% endtab %}

{% tab title="Analitiche" %}
Le analitiche vengono raccolte quando i partecipanti eseguono azioni come caricare widget, condividere link o fare segnalazioni. Quando i partecipanti vengono eliminati, tutte le analitiche a loro attribuite vengono rimosse, il che influenzerà le statistiche visualizzate nella sezione Reporting 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 una segnalazione, la tabella delle segnalazioni nel profilo dell'altro partecipante mostrerà che esiste una segnalazione, ma che proveniva da un partecipante eliminato. Se era stato assegnato un premio come parte della segnalazione, anche la tabella dei premi indicherà che la segnalazione è collegata 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.
