# Erklärung der Löschung von Advocate-Teilnehmern
{% hint style="danger" %}
**Warnung**: Löschungen sind dauerhaft, und Ihre Share-Links, Empfehlungen und Analysen können beeinträchtigt sein.
{% endhint %}
Unsere Löschfunktion entspricht vollständig den in der DSGVO festgelegten Anforderungen an die Benutzerlöschung. Wenn Sie Teilnehmer löschen, löscht unser System innerhalb von 30 Tagen alle personenbezogenen Daten (PII), die für diese Teilnehmer in unserem System und bei dessen Unterauftragsverarbeitern gespeichert wurden. Eine vollständige Liste der für einen bestimmten Teilnehmer gespeicherten PII können Sie über die [Benutzer-PII nachschlagen](https://integrations.impact.com/impact-brand/reference/getuserpii) API-Methode abrufen. Teilnehmer können aus Ihrem Programm entweder einzeln oder in großen Mengen gelöscht werden.
#### Löschoptionen
{% tabs %}
{% tab title="Nicht verfolgen" %}
Sie können die Löschung mit der *Nicht verfolgen* Option konfigurieren. Wenn sie ausgewählt ist, kann der gelöschte Teilnehmer nicht erneut im System registriert werden, und jeder Versuch, den Teilnehmer erneut anzulegen, schlägt fehl.
{% endtab %}
{% tab title="Leere Konten beibehalten" %}
Das Beibehalten leerer Konten ist eine Konfigurationsoption, die Sie beim Löschen von Teilnehmern in großen Mengen, über die REST API oder über GraphQL verwenden können. Um leere Konten beizubehalten, fügen Sie das `preserveEmptyAccount` Feld Ihrer Löschdatei oder Ihrem Aufruf hinzu.
{% endtab %}
{% endtabs %}
#### Löschmethoden
{% tabs %}
{% tab title="Über die API" %}
Die Advocate REST API bietet zwei Methoden zum Löschen von Teilnehmern:
* [**Ein Konto löschen**](https://integrations.impact.com/impact-brand/reference/opendeleteaccount)**:** Verwenden Sie diese Methode, um ein Konto und alle darin enthaltenen Teilnehmer zu löschen.
* [**Einen Teilnehmer löschen**](https://integrations.impact.com/impact-brand/reference/opendeleteuser)**:** Verwenden Sie diese Methode, um einen Teilnehmer eines Kontos zu löschen, ohne das Konto selbst zu löschen.
{% endtab %}
{% tab title="Einzeln" %}
1. Wählen Sie im linken Navigationsmenü  **\[Engage] → Teilnehmer**.
2. Suchen Sie nach dem Teilnehmer, den Sie löschen möchten.
3. Wählen Sie den Namen aus, um das Profil des Teilnehmers zu öffnen.
4. Wählen Sie die **Löschen** Schaltfläche unter seinem Namen.
5. Wählen Sie aus, ob Sie den Teilnehmer zur *Nicht verfolgen* Liste hinzufügen möchten.
6. Wählen Sie die endgültige Löschen-Schaltfläche, wenn Sie sicher sind, dass Sie den Teilnehmer löschen möchten.
{% endtab %}
{% tab title="In großen Mengen" %}
{% hint style="warning" %}
**Warnung**: Dieser Vorgang löscht dauerhaft alle ausgewählten Teilnehmer und deren historische Daten (z. B. Empfehlungen, Belohnungen und Ereignisse). Diese Daten können nicht wiederhergestellt werden. Bevor Sie fortfahren, müssen Sie bestätigen, dass die Teilnehmer in Ihrer Datei gelöscht werden sollen.
{% endhint %}
**Bereiten Sie Ihre Datei vor**
Advocate akzeptiert Importe, die in `.csv` oder `.jsonl` Dateiformate. Beachten Sie die [Beispiel-CSV-Importdatei](https://assets.ctfassets.net/s68ib1kj8k5n/4IWYz9jkNTP4gQiKU5HSnO/09794e8768e3732f6d06ea29a058d388/sample-user-delete.csv) und [Beispiel-JSONL-Importdatei](https://assets.ctfassets.net/s68ib1kj8k5n/1GMnqK0sMJ9LXXaKyjXOVD/ec39618863613f483703cd6f754b6017/userDeleteImportSample.zip) um die erforderliche Dateistruktur anzuzeigen. Für beste Ergebnisse stellen Sie sicher, dass jede Datei nicht mehr als 500.000 Einträge enthält.
* Erforderliche Felder: `id` und `accountId`.
* Optionale Felder: Sie können weitere optionale Felder einfügen, um die Löschung anzupassen.
Alle Felder sind groß-/kleinschreibungssensitiv. Siehe die *Feldreferenz* Tabelle unten für weitere Informationen an.
**Teilnehmer löschen**
1. Wählen Sie im linken Navigationsmenü  **\[Engage] → Berichte → Importe & Exporte**.
2. Wählen Sie  **Import**.
3. Unter *Importtyp auswählen*wählen Sie **Benutzer löschen**.
4. Um Ihre Datei hochzuladen, wählen Sie **Datei auswählen**.
5. Wählen Sie **Vorschau ausführen** um einen Testimport durchzuführen und Ihre Datei zu validieren.
Die Vorschau prüft Ihre Datei auf Fehler. Das System überspringt beim endgültigen Import alle Zeilen mit Fehlern.
6. (Optional) Konfigurieren Sie die Löschbehandlungsoptionen:
* **Leere Konten beibehalten:** Wählen Sie diese Option aus, um zu verhindern, dass ein Konto gelöscht wird, wenn alle zugehörigen Benutzer gelöscht wurden.
* **Verhindern, dass gelöschte Benutzer erneut erstellt werden:** Wählen Sie diese Option aus, um das *Nicht verfolgen* Kennzeichen auf die gelöschten Benutzer anzuwenden.
7. Nachdem die Vorschau erfolgreich war, wählen Sie **Massenlöschung**.
Wenn der Löschvorgang abgeschlossen ist, sendet das System eine Bestätigungs-E-Mail. Der Vorgang kann je nach Warteschlange und Dateigröße bis zu 30 Minuten dauern.
Feldreferenz
| Feld | Typ | Beschreibung |
| -------------------- | -------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| accountId | Zeichenfolge
Erforderlich
| Die eindeutige Kennung des Kontos, zu dem dieser Benutzer gehört. |
| id | Zeichenfolge
Erforderlich
| Die eindeutige Kennung, die für diesen Benutzer bereitgestellt wurde. |
| preserveEmptyAccount | boolean | Wenn das Konto des Benutzers ohne Benutzer bleibt, wird das Konto standardmäßig gelöscht. Falls festgelegt, führt dieses Feld dazu, dass das leere Konto beibehalten wird. Dies überschreibt die globale `Leere Konten beibehalten` Einstellung für den Importauftrag speziell für diese Zeile. |
| doNotTrack | boolean | Geben Sie `true` wenn dieser Benutzer mit der `Nicht verfolgen` Einstellung gesetzt gelöscht werden soll. Dies überschreibt die globale `Nicht verfolgen` Einstellung für den Importauftrag speziell für diese Zeile. |
{% endtab %}
{% endtabs %}
**Ergebnisse**
Wir benachrichtigen Sie per E-Mail, wenn Ihr Import abgeschlossen ist. Sie können die Ergebnisse von  **\[Engage] → Berichte →** [**Importe & Exporte**](https://app.impact.com/secure/advertiser/engage/advocate/p/6846ce09cf529b17c4549c95/t/live/jobs).
{% hint style="success" icon="memo" %}
**Hinweis**herunterladen: Download-Links laufen nach 30 Tagen ab.
{% endhint %}
{% tabs %}
{% tab title="Erfolgreicher Upload" %}
Wenn der Import erfolgreich abgeschlossen wurde, wird eine Datei mit den Konto- und Benutzer-IDs der gelöschten Teilnehmer erstellt und Ihnen per E-Mail zugesendet.
{% endtab %}
{% tab title="Fehler" %}
**Importfehler:** Wenn Ihre Importdatei Fehler enthält, generiert das System eine separate Fehlerdatei. Diese Datei listet jeden Fehler zusammen mit der entsprechenden Zeilennummer aus Ihrer Originaldatei und einer detaillierten Fehlermeldung auf.
**Systemfehler:** Wenn ein Systemfehler den Import unterbricht, ändert sich sein Status zu *abgebrochen*. Dieser Vorgang kann nicht wiederhergestellt werden. In diesem Fall, [den Support kontaktieren](https://app.impact.com/secure/advertiser/support/customer-support-portal-flow.ihtml) wenden, um Hilfe zu erhalten.
{% endtab %}
{% endtabs %}
#### Systemauswirkungen
Mehrere Bereiche des Systems können durch das Löschen eines Teilnehmers beeinträchtigt werden.
{% tabs %}
{% tab title="Freigabelinks" %}
Wenn ein Teilnehmer gelöscht wird, werden auch alle seine PII (einschließlich seines Empfehlungscodes) gelöscht. Share-Links funktionieren anders — der Share-Link selbst wird nicht gelöscht, aber seine Zuordnung zu einem bestimmten Teilnehmer wird entfernt. Die Share-Links des gelöschten Teilnehmers werden keine Empfehlung mehr zuordnen, ermöglichen jedoch weiterhin neu geworbenen Teilnehmern, die Landingpage Ihres Programms zu besuchen.
{% endtab %}
{% tab title="Empfehlungen" %}
Wenn gelöschte Teilnehmer Empfehlungen abgegeben haben oder selbst geworben wurden, ändert sich die in den Widgets oder Microsites anderer Teilnehmer angezeigte Empfehlungshistorie. In diesen Fällen zählt die Empfehlung weiterhin für Belohnungszwecke, wird visuell jedoch als von einem anonymen Teilnehmer stammend angezeigt.
{% endtab %}
{% tab title="Analysen" %}
Analysen werden erfasst, wenn Teilnehmer Aktionen ausführen, wie Widgets laden, Links teilen oder Empfehlungen aussprechen. Wenn Teilnehmer gelöscht werden, werden alle ihnen zugeordneten Analysen entfernt, was sich auf die Statistiken auswirkt, die im Bereich Berichte Ihres Advocate-Programms in impact.com angezeigt werden.
{% endtab %}
{% tab title="Plattform" %}
Gelöschte Teilnehmer erscheinen nicht mehr auf der **Teilnehmenden** Seite. Wenn der gelöschte Teilnehmer Teil einer Empfehlung war, zeigt die Empfehlungstabelle im Profil des anderen Teilnehmers an, dass eine Empfehlung vorhanden ist, diese jedoch von einem gelöschten Teilnehmer stammt. Wenn im Rahmen der Empfehlung eine Belohnung vergeben wurde, weist die Belohnungstabelle ebenfalls darauf hin, dass die Empfehlung mit einem gelöschten Teilnehmer verknüpft ist.
{% endtab %}
{% endtabs %}
---
# Agent Instructions: 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:
```
GET https://help.impact.com/brand/de/woruber-mochten-sie-mehr-erfahren/advocate-program/manage-advocate-participants/delete-participants-from-your-advocate-program.md?ask=
```
The question should be specific, self-contained, and written in natural language.
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.