> 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 endgültig, und Ihre Freigabelinks, Empfehlungen und Analysen können beeinträchtigt werden.
{% endhint %}
Unsere Löschfunktionalität entspricht vollständig den Anforderungen für die Benutzelöschung gemäß der 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 seinen Unterauftragsverarbeitern gespeichert wurden. Sie können eine vollständige Liste der für einen bestimmten Teilnehmer gespeicherten personenbezogenen Daten über die [Nach PII eines Benutzers suchen](https://integrations.impact.com/brand-api-reference/advocate-api-reference-v1/reference/user-overview/user) API-Methode abrufen. Teilnehmer können entweder einzeln oder in großen Mengen aus Ihrem Programm gelöscht werden.
#### Löschoptionen
{% tabs %}
{% tab title="Nicht nachverfolgen" %}
Sie können die Löschung mit der *Nicht nachverfolgen* Option konfigurieren. Wenn diese ausgewählt ist, kann der gelöschte Teilnehmer im System nicht erneut 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 in Ihre Löschdatei oder Ihren Aufruf ein.
{% 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/brand-api-reference/advocate-api-reference-v1/reference/account-overview/account)**:** Verwenden Sie diese Methode, um ein Konto und alle darauf befindlichen Teilnehmer zu löschen.
* [**Einen 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 aus einem Konto 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 das **Löschen** Schaltfläche unter seinem Namen.
5. Wählen Sie aus, ob Sie den Teilnehmer zur *Nicht nachverfolgen* Liste hinzufügen möchten.
6. Wählen Sie die endgültige Schaltfläche zum Löschen aus, 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 alle ausgewählten Teilnehmer und ihre historischen Daten (z. B. Empfehlungen, Belohnungen und Ereignisse) endgültig. Sie können diese Daten nicht wiederherstellen. 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. 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) an, um die erforderliche Dateistruktur anzuzeigen. Für optimale Ergebnisse stellen Sie sicher, dass jede Datei 500.000 Einträge nicht überschreitet.
* Erforderliche Felder: `id` und `accountId`.
* Optionale Felder: Sie können weitere optionale Felder einfügen, um die Löschung anzupassen.
Alle Felder sind groß- und kleinschreibungsempfindlich. 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 *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 zur 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 das *Nicht nachverfolgen* 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. 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, zu dem dieser Benutzer gehört. |
| id | Zeichenkette
Erforderlich
| Die eindeutige Kennung, die für diesen Benutzer angegeben wurde. |
| preserveEmptyAccount | boolean | Wenn dem Konto des Benutzers keine Benutzer mehr verbleiben, wird das Konto standardmäßig gelöscht. Wenn dieses Feld gesetzt ist, wird das leere Konto beibehalten. Dadurch wird die globale `Leere Konten beibehalten` Einstellung für den Importauftrag für diese Zeile speziell überschrieben. |
| doNotTrack | boolean | Geben Sie `wahr` wenn dieser Benutzer mit der `Nicht nachverfolgen` gesetzten Einstellung gelöscht werden soll. Dadurch wird die globale `Nicht nachverfolgen` Einstellung für den Importauftrag für diese Zeile speziell überschrieben. |
{% endtab %}
{% endtabs %}
**Ergebnisse**
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" %}
**Hinweis**: 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 erstellt und Ihnen per E-Mail zugesandt.
{% endtab %}
{% tab title="Fehler" %}
**Importfehler:** Wenn Ihre Importdatei Fehler enthält, erstellt das System eine separate Fehlerdatei. Diese Datei listet jeden Fehler mit der entsprechenden Zeilennummer aus Ihrer ursprünglichen Datei 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 infolge der Löschung eines Teilnehmers beeinträchtigt werden.
{% tabs %}
{% tab title="Freigabelinks" %}
Wenn ein Teilnehmer gelöscht wird, werden auch alle seine personenbezogenen Daten (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, ermöglichen es neu geworbenen Teilnehmern aber weiterhin, die Landingpage Ihres Programms aufzurufen.
{% endtab %}
{% tab title="Empfehlungen" %}
Wenn gelöschte Teilnehmer Empfehlungen ausgesprochen haben oder selbst geworben wurden, ändert sich die in den Widgets oder Microsites anderer Teilnehmer angezeigte Empfehlungs-Historie. In diesen Fällen zählt die Empfehlung weiterhin für Belohnungszwecke, wird aber visuell als von einem anonymen Teilnehmer stammend angezeigt.
{% endtab %}
{% tab title="Analysen" %}
Analysen werden erfasst, wenn Teilnehmer Aktionen wie das Laden von Widgets, das Teilen von Links oder das Erstellen von Empfehlungen durchführen. Wenn Teilnehmer gelöscht werden, werden alle ihnen zugeordneten Analysen entfernt, was die im Bereich „Berichte“ Ihres Advocate-Programms in impact.com angezeigten Statistiken beeinflusst.
{% endtab %}
{% tab title="Plattform" %}
Gelöschte Teilnehmer erscheinen nicht mehr auf der **Teilnehmer** 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
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/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 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.