> 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 können sich auf Ihre Freigabelinks, Empfehlungen und Analysen auswirken.
{% endhint %}

Unsere Löschfunktion erfüllt vollständig die Anforderungen der DSGVO an die Löschung von Nutzerdaten. Wenn Sie Teilnehmer löschen, entfernt unser System innerhalb von 30 Tagen alle personenbezogenen Daten, die zu diesen Teilnehmern in unserem System und bei unseren Unterauftragsverarbeitern gespeichert sind. Eine vollständige Liste der personenbezogenen Daten, die zu einem bestimmten Teilnehmer gespeichert sind, können Sie mit der folgenden Methode abrufen: [Nutzerbezogene personenbezogene Daten abrufen](https://integrations.impact.com/brand-api-reference/advocate-api-reference-v1/reference/user-overview/user) API-Methode. Teilnehmer können einzeln oder gesammelt aus Ihrem Programm gelöscht werden.

#### Löschoptionen

{% tabs %}
{% tab title="Nicht nachverfolgen" %}
Sie können die Löschung mit der Option *Nicht nachverfolgen* konfigurieren. Wenn diese Option ausgewählt ist, kann der gelöschte Teilnehmer nicht erneut im System registriert werden. 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 gesammelten Löschen von Teilnehmern über die REST-API oder GraphQL verwenden können. Um leere Konten beizubehalten, fügen Sie Ihrer Löschdatei bzw. Ihrem Aufruf das Feld `preserveEmptyAccount` 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 enthaltenen 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 aus einem Konto zu löschen, ohne das Konto selbst zu löschen.
  {% endtab %}

{% tab title="Einzeln" %}

1. Wählen Sie im linken Navigationsmenü ![](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] → Participants**.
2. Suchen Sie nach dem Teilnehmer, den Sie löschen möchten.
3. Wählen Sie den Namen aus, um das Teilnehmerprofil zu öffnen.
4. Wählen Sie unter dem Namen die Schaltfläche **Löschen** aus.
5. Wählen Sie aus, ob der Teilnehmer zur Liste *Nicht nachverfolgen* hinzugefügt werden soll.
6. Wählen Sie die abschließende Schaltfläche zum Löschen aus, wenn Sie sicher sind, dass Sie den Teilnehmer löschen möchten.
   {% endtab %}

{% tab title="Gesammelt" %}
{% hint style="warning" %}
**Warnung**: Dieser Vorgang löscht alle ausgewählten Teilnehmer und ihre historischen Daten (z. B. Empfehlungen, Prämien und Ereignisse) endgültig. 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 im Dateiformat `.csv` oder `.jsonl` . Die erforderliche Dateistruktur finden Sie in der [Beispiel-CSV-Importdatei](https://assets.ctfassets.net/s68ib1kj8k5n/4IWYz9jkNTP4gQiKU5HSnO/09794e8768e3732f6d06ea29a058d388/sample-user-delete.csv) und der [Beispiel-JSONL-Importdatei](https://assets.ctfassets.net/s68ib1kj8k5n/1GMnqK0sMJ9LXXaKyjXOVD/ec39618863613f483703cd6f754b6017/userDeleteImportSample.zip) . Um optimale Ergebnisse zu erzielen, sollte jede Datei höchstens 500.000 Einträge enthalten.

* Erforderliche Felder: `id` und `accountId`.
* Optionale Felder: Sie können weitere optionale Felder hinzufügen, um die Löschung anzupassen.

Bei allen Feldern wird zwischen Groß- und Kleinschreibung unterschieden. Siehe *Feldreferenz* Weitere Informationen finden Sie in der Tabelle unten.

**Teilnehmende löschen**

1. Wählen Sie im linken Navigationsmenü ![](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 → Imports & Exports**.
2. Wählen Sie ![](https://1698965099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-1c990ed7d1179d6bc54ec8a2f98688d63ffdf977%2F1ca7fd10d94ed494c076e86be8f0d3f371693b11c47f1b26ec0435a27e0e48c5.svg?alt=media) **Importieren**.
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 überprüfen.

Bei der Vorschau wird Ihre Datei auf Fehler überprüft. Beim endgültigen Import überspringt das System alle Zeilen mit Fehlern.

6. (Optional) Konfigurieren Sie die Optionen für den Umgang mit Löschungen:

* **Leere Konten beibehalten:** Wählen Sie diese Option aus, damit ein Konto nicht gelöscht wird, wenn alle zugehörigen Benutzer gelöscht werden.
* **Verhindern, dass gelöschte Benutzer erneut erstellt werden:** Wählen Sie diese Option aus, um das Flag *Do Not Track* auf die gelöschten Benutzer anzuwenden.

7. Wenn die Vorschau erfolgreich war, wählen Sie **Massenlöschung**.

Nach Abschluss des Löschvorgangs sendet das System eine Bestätigungs-E-Mail. Je nach Warteschlange und Dateigröße kann der Vorgang bis zu 30 Minuten dauern.

<details>

<summary>Feldreferenz</summary>

| Feld                 | Typ                                                                        | Beschreibung                                                                                                                                                                                                                                                                           |
| -------------------- | -------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| accountId            | <p>Zeichenfolge</p><p><mark style="color:$danger;">Erforderlich</mark></p> | Der eindeutige Bezeichner des Kontos, zu dem dieser Benutzer gehört.                                                                                                                                                                                                                   |
| id                   | <p>Zeichenfolge</p><p><mark style="color:$danger;">Erforderlich</mark></p> | Der für diesen Benutzer angegebene eindeutige Bezeichner.                                                                                                                                                                                                                              |
| preserveEmptyAccount | boolesch                                                                   | Wenn im Konto des Benutzers keine Benutzer mehr vorhanden sind, wird das Konto standardmäßig gelöscht. Wenn dieses Feld gesetzt ist, bleibt das leere Konto erhalten. Dies setzt die globale Einstellung `Leere Konten beibehalten` für den Importauftrag für diese Zeile außer Kraft. |
| doNotTrack           | boolesch                                                                   | Geben Sie `true` an, wenn dieser Benutzer mit der Einstellung `Do Not Track` gelöscht werden soll. Dies setzt die globale Einstellung `Do Not Track` für den Importauftrag für diese Zeile außer Kraft.                                                                                |

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

**Ergebnisse**

Wir benachrichtigen Sie per E-Mail, sobald der Import abgeschlossen ist. Sie können die Ergebnisse hier herunterladen: ![](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] → Berichte →** [**Importe und Exporte**](https://app.impact.com/secure/advertiser/engage/advocate/p/6846ce09cf529b17c4549c95/t/live/jobs).

{% hint style="success" icon="memo" %}
**Hinweis**: Downloadlinks laufen nach 30 Tagen ab.
{% endhint %}

{% tabs %}
{% tab title="Upload erfolgreich" %}
Wenn der Import erfolgreich abgeschlossen wird, wird eine Datei mit den Konto- und Benutzer-IDs der gelöschten Teilnehmenden erstellt und Ihnen per E-Mail zugesendet.
{% endtab %}

{% tab title="Fehler" %}
**Importfehler:** Wenn Ihre Importdatei Fehler enthält, erstellt das System eine separate Fehlerdatei. Diese Datei führt 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. Wenden Sie sich in diesem Fall an den [Support](https://app.impact.com/secure/advertiser/support/customer-support-portal-flow.ihtml) , um Hilfe zu erhalten.
{% endtab %}
{% endtabs %}

#### Auswirkungen auf das System

Das Löschen eines Teilnehmers kann sich auf mehrere Bereiche des Systems auswirken.

{% tabs %}
{% tab title="Freigabelinks" %}
Wenn ein Teilnehmer gelöscht wird, werden auch alle seine personenbezogenen Daten (einschließlich seines Empfehlungscodes) gelöscht. Bei Freigabelinks verhält es sich anders: Der Freigabelink selbst wird nicht gelöscht, aber die Verknüpfung mit einem bestimmten Teilnehmer wird aufgehoben. Über die Freigabelinks des gelöschten Teilnehmers werden keine Empfehlungen mehr zugeordnet. Neu geworbene Teilnehmer können damit aber weiterhin die Landingpage Ihres Programms 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 Prämien, wird aber visuell so dargestellt, als stamme sie von einem anonymen Teilnehmer.
{% endtab %}

{% tab title="Analysen" %}
Analysedaten werden erfasst, wenn Teilnehmer Aktionen ausführen, etwa Widgets laden, Links teilen oder Empfehlungen aussprechen. Wenn Teilnehmer gelöscht werden, werden alle ihnen zugeordneten Analysedaten entfernt. Dies wirkt sich auf die Statistiken aus, die im Bereich „Berichte“ Ihres Advocate-Programms auf impact.com angezeigt werden.
{% endtab %}

{% tab title="Plattform" %}
Gelöschte Teilnehmer werden nicht mehr auf der Seite **Teilnehmer** angezeigt. War der gelöschte Teilnehmer an einer Empfehlung beteiligt, wird in der Empfehlungstabelle im Profil des anderen Teilnehmers angezeigt, dass eine Empfehlung vorliegt, diese aber von einem gelöschten Teilnehmer stammt. Wurde im Rahmen der Empfehlung eine Prämie vergeben, 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=<question>&goal=<user_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.
