> 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öschung von Advocate-Teilnehmern erklärt
{% hint style="danger" %}
**Warnung**: Löschungen sind dauerhaft, und Ihre Share-Links, Empfehlungen und Analysen können betroffen sein.
{% endhint %}
Unsere Löschfunktionalität entspricht vollständig den Anforderungen an das Löschen von Nutzern 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 PII abrufen mit der [Benutzer-PII nachschlagen](https://integrations.impact.com/brand-api-reference/advocate-api-reference-v1/reference/user-overview/user) API-Methode. 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 das Löschen mit der *Nicht verfolgen* Option konfigurieren. Wenn diese Option 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 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 in 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 den **Löschen** Schaltfläche unter ihrem Namen.
5. Wählen Sie aus, ob Sie den Teilnehmer zur *Nicht verfolgen* Liste einreichen.
6. Wählen Sie die endgültige Löschschaltflä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 alle ausgewählten Teilnehmer und ihre Verlaufsdaten (z. B. Empfehlungen, Belohnungen und Ereignisse) dauerhaft. 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. 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 500.000 Einträge nicht überschreitet.
* Erforderliche Felder: `id` und `accountId`.
* Optionale Felder: Sie können andere optionale Felder hinzufügen, um das Löschen anzupassen.
Alle Felder sind groß-/kleinschreibungsempfindlich. Siehe die *Feldverweises* Tabelle unten für weitere Informationen.
**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 **Nutzer 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 überprü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, um zu verhindern, dass ein Konto gelöscht wird, wenn alle zugehörigen Benutzer gelöscht werden.
* **Verhindern, dass gelöschte Benutzer erneut erstellt werden:** Wählen Sie diese Option, um das *Nicht verfolgen* Flag 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 | Zeichenkette
Erforderlich
| Die eindeutige Kennung des Kontos, zu dem dieser Benutzer gehört. |
| id | Zeichenkette
Erforderlich
| Die für diesen Benutzer bereitgestellte eindeutige Kennung. |
| preserveEmptyAccount | boolesch | Wenn das Konto des Benutzers ohne Benutzer zurückbleibt, wird das Konto standardmäßig gelöscht. Wenn dieses Feld gesetzt ist, bleibt das leere Konto erhalten. Dadurch wird die globale `Leere Konten beibehalten` Einstellung für den Importauftrag für diese Zeile speziell überschrieben. |
| doNotTrack | boolesch | Geben Sie an `true` wenn Sie möchten, dass dieser Benutzer mit der `Nicht verfolgen` gesetzten Einstellung gelöscht wird. Dadurch wird die globale `Nicht verfolgen` 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 herunterladen 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 verfallen nach 30 Tagen.
{% 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, generiert 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, um Unterstützung zu erhalten.
{% endtab %}
{% endtabs %}
#### Systemauswirkungen
Mehrere Bereiche des Systems können durch das Löschen eines Teilnehmers betroffen sein.
{% tabs %}
{% tab title="Share-Links" %}
Wenn ein Teilnehmer gelöscht wird, werden auch alle seine personenbezogenen Daten (PII), einschließlich seines Empfehlungs-Codes, 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 neu geworbenen Teilnehmern aber weiterhin, die Landingpage Ihres Programms zu besuchen.
{% endtab %}
{% tab title="Empfehlungen" %}
Wenn gelöschte Teilnehmer Empfehlungen ausgesprochen haben oder selbst geworben wurden, ändert sich der in den Widgets oder Microsites anderer Teilnehmer angezeigte Empfehlungsverlauf. 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 Aussprechen von Empfehlungen durchführen. Wenn Teilnehmer gelöscht werden, werden alle ihnen zugeordneten Analysen entfernt, was sich auf die Statistiken in der Reporting-Sektion Ihres Advocate-Programms in impact.com auswirkt.
{% 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 Empfehlungs-Tabelle im Profil des anderen Teilnehmers an, dass eine Empfehlung vorhanden ist, diese jedoch von einem gelöschten Teilnehmer stammte. Wenn im Rahmen der Empfehlung eine Belohnung vergeben wurde, weist die Belohnungs-Tabelle entsprechend 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.