> 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/de/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participants/delete-participants-from-your-advocate-program.md).
# Löschen von Advocate-Teilnehmern erklärt
{% hint style="danger" %}
**Warnung**: Löschungen sind dauerhaft und Ihre Freigabelinks, Empfehlungen und Analysen können beeinträchtigt werden.
{% endhint %}
Unsere Löschfunktion entspricht vollständig den Anforderungen an die Benutzerlöschung gemäß DSGVO. 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 unseren Unterauftragsverarbeitern gespeichert wurden. Sie können eine vollständige Liste der für einen bestimmten Teilnehmer gespeicherten PII mit der [PII eines Nutzers nachschlagen](https://integrations.impact.com/brand-api-reference/advocate-api-reference-v1/reference/user-overview/user) API-Methode. Teilnehmer können aus Ihrem Programm einzeln oder gesammelt 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 neu anzulegen, schlägt fehl.
{% endtab %}
{% tab title="Leere Konten beibehalten" %}
Das Beibehalten leerer Konten ist eine Konfigurationsoption, die Sie beim Löschen von Teilnehmern gesammelt, über die REST-API oder über GraphQL verwenden können. Um leere Konten beizubehalten, fügen Sie das `preserveEmptyAccount` Feld Ihrer Löschdatei oder Ihres Aufrufs hinzu.
{% endtab %}
{% endtabs %}
#### Löschmethoden
{% tabs %}
{% tab title="Über die API" %}
Die Advocate REST-API bietet zwei Methoden zum Löschen von Teilnehmern:
* [**Konto löschen**](https://integrations.impact.com/brand-api-reference/advocate-api-reference-v1/reference/account-overview/account)**:** Verwenden Sie diese Methode, um ein Konto und alle darin befindlichen Teilnehmer zu löschen.
* [**Teilnehmer löschen**](https://integrations.impact.com/brand-api-reference/advocate-api-reference-v1/reference/user-overview/user)**:** 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 seinen Namen aus, um sein Teilnehmerprofil 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öschschaltfläche aus, wenn Sie sicher sind, dass Sie den Teilnehmer löschen möchten.
{% endtab %}
{% tab title="Gesammelt" %}
{% hint style="warning" %}
**Warnung**: Dieser Prozess löscht unwiderruflich alle ausgewählten Teilnehmer und ihre historischen Daten (z. B. Empfehlungen, Prämien 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 %}
**Datei vorbereiten**
Advocate akzeptiert Importe, die in `.csv` oder `.jsonl` Dateiformate. Siehe 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 500.000 Einträge nicht überschreitet.
* Erforderliche Felder: `id` und `accountId`.
* Optionale Felder: Sie können andere optionale Felder einfügen, um die Löschung anzupassen.
Alle Felder unterscheiden zwischen Groß- und Kleinschreibung. Siehe die *Feldreferenz* in der Tabelle unten für weitere Informationen.
**Teilnehmer löschen**
1. Wählen Sie im linken Navigationsmenü  **\[Engage] → Berichterstellung → Importe & Exporte**.
2. Wählen Sie  **Importieren**.
3. Unter *Wählen Sie einen Importtyp*, 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 Optionen für die Löschverarbeitung:
* **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 die *Nicht verfolgen* Kennzeichnung 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. Je nach Warteschlange und Dateigröße kann der Vorgang bis zu 30 Minuten dauern.
Feldreferenz
| Feld | Typ | Beschreibung |
| -------------------- | -------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| accountId | Zeichenkette
Erforderlich
| Die eindeutige Kennung des Kontos, dem dieser Benutzer angehört. |
| id | Zeichenkette
Erforderlich
| Die eindeutige Kennung, die für diesen Benutzer bereitgestellt wurde. |
| preserveEmptyAccount | boolesch | Wenn im Konto des Benutzers keine Benutzer mehr verbleiben, wird das Konto standardmäßig gelöscht. Wenn festgelegt, führt dieses Feld dazu, dass das leere Konto beibehalten wird. Dies überschreibt die globale `Leere Konten beibehalten` Einstellung für den Importauftrag für diese Zeile speziell. |
| doNotTrack | boolesch | Geben Sie `true` wenn dieser Benutzer mit der `Nicht verfolgen` Einstellung gelöscht werden soll. Dies überschreibt die globale `Nicht verfolgen` Einstellung für den Importauftrag für diese Zeile speziell. |
{% endtab %}
{% endtabs %}
**Ergebnis**
Wir benachrichtigen Sie per E-Mail, wenn Ihr Import abgeschlossen ist. Sie können die Ergebnisse von  **\[Engage] → Berichterstattung →** [**Importe & Exporte**](https://app.impact.com/secure/advertiser/engage/advocate/p/6846ce09cf529b17c4549c95/t/live/jobs).
{% hint style="success" icon="memo" %}
**Notiz**: Download-Links laufen nach 30 Tagen ab.
{% endhint %}
{% tabs %}
{% tab title="Erfolgreicher Upload" %}
Wenn der Import erfolgreich abgeschlossen wird, wird eine Datei mit den Konto- und Benutzer-IDs der gelöschten Teilnehmer generiert und Ihnen per E-Mail zugesendet.
{% endtab %}
{% tab title="Fehler" %}
**Importfehler:** Wenn Ihre Importdatei Fehler enthält, erzeugt das System eine separate Fehlerdatei. Diese Datei listet jeden Fehler 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 Sie sich an den Support, 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. Freigabelinks funktionieren anders — der Freigabelink selbst wird nicht gelöscht, aber seine Zuordnung zu einem bestimmten Teilnehmer wird entfernt. Die Freigabelinks des gelöschten Teilnehmers werden keine Empfehlung mehr zuordnen, erlauben jedoch weiterhin neu geworbenen Teilnehmern, die Landingpage Ihres Programms zu besuchen.
{% endtab %}
{% tab title="Empfehlungen" %}
Wenn gelöschte Teilnehmer Empfehlungen ausgesprochen haben oder selbst geworben wurden, ändert sich die angezeigte Empfehlungshistorie in den Widgets oder Microsites anderer Teilnehmer. In diesen Fällen zählt die Empfehlung weiterhin für Prämienzwecke, wird aber optisch so angezeigt, als ob sie von einem anonymen Teilnehmer stammte.
{% endtab %}
{% tab title="Analysen" %}
Analysen werden erfasst, wenn Teilnehmer Aktionen wie das Laden von Widgets, das Teilen von Links oder das Aussprechen von Empfehlungen ausführen. Wenn Teilnehmer gelöscht werden, werden alle ihnen zugeordneten Analysen entfernt, was die in der Berichtssektion Ihres Advocate-Programms in impact.com angezeigten Statistiken beeinflusst.
{% endtab %}
{% tab title="Plattform" %}
Gelöschte Teilnehmer werden nicht mehr auf der **Teilnehmer** Seite angezeigt. Wenn der gelöschte Teilnehmer Teil einer Empfehlung war, zeigt die Empfehlungstabelle im Profil des anderen Teilnehmers an, dass eine Empfehlung vorhanden ist, diese aber von einem gelöschten Teilnehmer stammt. Wenn im Rahmen der Empfehlung eine Prämie vergeben wurde, weist die Prämientabelle ebenfalls darauf hin, dass die Empfehlung mit einem gelöschten Teilnehmer verknüpft ist.
{% 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/de/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participants/delete-participants-from-your-advocate-program.md?ask=&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.