# Spiegazione dell'eliminazione dei partecipanti Advocate

{% hint style="danger" %}
**Avviso**: Le eliminazioni sono permanenti e i tuoi link di condivisione, referral e analytics potrebbero essere interessati.
{% endhint %}

La nostra funzionalità di eliminazione è pienamente conforme ai requisiti per la cancellazione dell’utente previsti 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 subresponsabili del trattamento. Puoi recuperare un elenco completo delle PII archiviate per uno specifico partecipante utilizzando il [Cerca la PII di un utente](https://integrations.impact.com/impact-brand/reference/getuserpii) metodo API. I partecipanti possono essere eliminati dal tuo programma singolarmente oppure 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 i partecipanti in blocco, tramite API REST o GraphQL. Per conservare gli account vuoti, includi il `preserveEmptyAccount` campo nel tuo file o nella tua chiamata di eliminazione.
{% endtab %}
{% endtabs %}

#### Metodi di eliminazione

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

* [**Elimina un account**](https://integrations.impact.com/impact-brand/reference/opendeleteaccount)**:**  Usa questo metodo per eliminare un account e tutti i partecipanti associati.
* [**Elimina un partecipante**](https://integrations.impact.com/impact-brand/reference/opendeleteuser)**:**  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 desideri eliminare.
3. Seleziona il suo nome per aprire il profilo del partecipante.
4. Seleziona il **Elimina** pulsante sotto il suo nome.
5. Scegli se aggiungere il partecipante alla *Non tracciare* lista.
6. Seleziona il pulsante finale di eliminazione se sei sicuro di voler eliminare il partecipante.
   {% endtab %}

{% tab title="In blocco" %}
{% hint style="warning" %}
**Avviso**: Questo processo elimina in modo permanente tutti i partecipanti selezionati e i loro dati storici (ad esempio, referral, 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 CSV di importazione di esempio](https://assets.ctfassets.net/s68ib1kj8k5n/4IWYz9jkNTP4gQiKU5HSnO/09794e8768e3732f6d06ea29a058d388/sample-user-delete.csv) e al [file JSONL di importazione di esempio](https://assets.ctfassets.net/s68ib1kj8k5n/1GMnqK0sMJ9LXXaKyjXOVD/ec39618863613f483703cd6f754b6017/userDeleteImportSample.zip) per visualizzare la struttura richiesta del file. Per ottenere i migliori risultati, assicurati che ciascun file non superi 500.000 voci.

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

Tutti i campi fanno distinzione tra maiuscole e minuscole. Consulta la tabella di *riferimento dei campi* qui sotto 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 prova e convalidare il tuo file.

L’anteprima controlla il tuo file per individuare eventuali 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 in blocco**.

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>Riferimento 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 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à l’impostazione globale `Conserva gli account vuoti` per il job di importazione per questa riga nello specifico. |
| doNotTrack           | booleano                                                              | Specifica `true` se desideri che questo utente venga eliminato con l’ `Non tracciare` impostazione attivata. Questo sovrascriverà l’impostazione globale `Non tracciare` per il job di importazione per questa riga nello specifico.                                                                                |

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

**Risultati**

Ti notifichiamo 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] → 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 di 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 account e utente dei partecipanti eliminati e ti verrà 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 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 il supporto](https://app.impact.com/secure/advertiser/support/customer-support-portal-flow.ihtml) per assistenza.
{% endtab %}
{% endtabs %}

#### Effetti sul sistema

A seguito dell’eliminazione di un partecipante, diverse aree del sistema potrebbero essere interessate.

{% tabs %}
{% tab title="Link di condivisione" %}
Quando un partecipante viene eliminato, anche tutte le sue PII (incluso il suo codice referral) vengono eliminate. I link di condivisione funzionano in modo diverso: 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ù un referral, ma consentiranno comunque ai nuovi partecipanti referenziati di visitare la pagina di destinazione 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 continuerà a essere valido ai fini dei premi, ma visivamente sarà mostrato come proveniente da un partecipante anonimo.
{% endtab %}

{% tab title="Analytics" %}
Le analytics vengono raccolte quando i partecipanti eseguono azioni come caricare widget, condividere link o effettuare referral. Quando i partecipanti vengono eliminati, tutte le analytics a loro attribuite vengono rimosse, il che influirà sulle statistiche mostrate 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 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, la tabella dei premi indicherà analogamente che il referral è collegato a un partecipante eliminato.
{% endtab %}
{% endtabs %}