> 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/import-advocate-participants-in-bulk.md).
# Advocate-Teilnehmer gesammelt importieren
Advocate akzeptiert Importe, die in `.csv` oder `.jsonl` Dateiformaten eingereicht werden. Bitte beachten Sie unser [Beispiel-CSV-Importdatei](https://assets.ctfassets.net/s68ib1kj8k5n/7LOYwhDlsI22uuaIMaWImE/71cefe860edc71c0968c8065e1d6e953/sample-user-upload.csv) und [Beispiel-JSONL-Importdatei](https://assets.ctfassets.net/s68ib1kj8k5n/5rD1ZiKEjqStp54qjDB90N/48918dfa8b53a935c7c83ea5fbf3af77/userImportSample.jsonl) um die erforderliche Dateistruktur für Ihren Import anzuzeigen.
{% hint style="info" %}
**Hinweis:** Wir empfehlen, dass jeder Import 500.000 Einträge nicht überschreitet.
{% endhint %}
#### Teilnehmer massenweise importieren
1. Wählen Sie im linken Navigationsmenü  **\[Engage] → Teilnehmer**.
2. Wählen Sie **Benutzer importieren**.
3. Unter *Importtyp*, wählen Sie **Nutzer**.
4. Fügen Sie Ihre Importdatei hinzu, indem Sie auswählen **Datei auswählen**.
5. **\[Optional]** Um die importierten Teilnehmer zu einem bestimmten Benutzersegment hinzuzufügen oder daraus zu entfernen, wählen Sie das Segment aus der Dropdown-Liste aus.
{% hint style="info" %}
**Hinweis:** Diese Auswahl gilt für *alle* in dieser Importdatei enthaltenen Teilnehmer.
{% endhint %}
6. Wählen Sie **Import starten**.
Wenn der Import abgeschlossen ist, wird eine Bestätigungs-E-Mail gesendet. Importe können je nach Warteschlange und Dateigröße bis zu 30 Minuten dauern.
#### Felder
Massenimporte von Benutzern unterstützen sowohl Standardfelder als auch benutzerdefinierte Felder in der Upload-Datei. **Felder unterscheiden zwischen Groß- und Kleinschreibung.**
{% tabs %}
{% tab title="Standardfelder" %}
Standardfelder werden mit derselben Validierung verarbeitet wie unser [Open-Endpoint-User-Upsert-API-Aufruf](https://integrations.impact.com/integration-guides/for-brands/advocate/advocate-api/api-open-endpoints):
| Feld | Typ | Beschreibung |
| -------------------------------------------- | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| accountId (Erforderlich) | Zeichenkette | Die eindeutige Kennung des Kontos, zu dem dieser Teilnehmer gehört. |
| id (Erforderlich) | Zeichenkette | Die für diesen Teilnehmer bereitgestellte eindeutige Kennung. |
| Vorname | Zeichenkette | Der Vorname des Teilnehmers. |
| Nachname | Zeichenkette | Der Nachname des Teilnehmers. |
| E-Mail | Zeichenkette | Die E-Mail-Adresse des Teilnehmers. |
| empfehlbar | boolesch | Von impact.com verwendetes Flag, um festzustellen, ob ein Teilnehmer weiterempfohlen werden kann.
Hinweis: Das Flag darf nur mit einem r geschrieben werden, damit der Status erfolgreich geändert werden kann.
|
| Gebietsschema | Zeichenkette | Das Gebietsschema des Teilnehmers, verwendet für [Internationalisierung](/brand/de/what-would-you-like-to-learn-about/advocate-program/advocate-program-settings/translate-and-localize-your-advocate-program.md). Das Gebietsschema muss das Format `Sprache_LAND` haben, wobei der Sprachcode kleingeschrieben und der Ländercode großgeschrieben sein muss. Das Trennzeichen muss ein Unterstrich sein. |
| countryCode | Zeichenkette | Das Gebietsschema des Teilnehmers, verwendet für [Internationalisierung](/brand/de/what-would-you-like-to-learn-about/advocate-program/advocate-program-settings/translate-and-localize-your-advocate-program.md). Der Ländercode des Benutzers (z. B. CA). |
| referredBy.code | Zeichenkette | Der Empfehlungscode des Kundenfürsprechers, der diesen Teilnehmer geworben hat. |
| referralCodes.{programId} | Zeichenkette | Der benutzerdefinierte Empfehlungscode für diesen Teilnehmer zum Teilen für das angegebene Programm (wird automatisch generiert, falls nicht enthalten). |
| sharelinks.{programId} | Zeichenkette | Der benutzerdefinierte Freigabelink für diesen Teilnehmer zum Teilen für das angegebene Programm (wird automatisch generiert, falls nicht enthalten). |
| Erstellungsdatum | Zeichenkette | Das Datum, an dem dieser Teilnehmer in Ihrem Advocate-Programm erstellt wurde. |
| Bild-URL | Zeichenkette | Optional in Widgets, E-Mails und Themes verwendet. Wenn Sie eine absolute Profilbild-URL angeben, beträgt die minimale Bildgröße 80 px x 80 px. |
| Datum der Einreichung des US-Steuerformulars | Ganzzahl | Das Datum, an dem das W-9-Steuerformular eines Teilnehmers als eingegangen markiert wurde. Wird für die W-9-Compliance in Ihrem Mandanten verwendet, sofern konfiguriert. |
| customFields.{fieldName} | Zeichenkette | Verwenden Sie diese Struktur, um ein benutzerdefiniertes Feld Ihrer Wahl einzuschließen. |
| {% endtab %} | | |
{% tab title="Benutzerdefinierte Felder" %}
[Benutzerdefinierte Benutzerfelder](/brand/de/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participants/custom-and-calculated-fields/custom-fields-for-advocate-explained.md) ermöglichen einzigartige Daten für Ihre Teilnehmer. Sie können Ihre Programmziele so festlegen, dass sie basierend auf den Informationen in einem benutzerdefinierten Benutzerfeld ausgelöst werden.
{% hint style="info" %}
**Beispiel**: Belohnen Sie Teilnehmer, wenn sie ihre Abonnementmitgliedschaft verlängern. Fügen Sie zunächst das benutzerdefinierte Feld `customFields.subscriptionPaid` mit dem Wert **ja**. Legen Sie dann das Ziel so fest, dass eine Conversion erfolgt, wenn `customFields.subscriptionPaid` gleich **ja**.
{% endhint %}
Fügen Sie benutzerdefinierte Felder in diesem Format zur Spaltenüberschrift hinzu: `customFields.yourCustomFieldName`.
{% hint style="info" %}
**Hinweis:** Benutzerdefinierte Felder können keine Array- oder Objektwerte akzeptieren.
{% endhint %}
{% endtab %}
{% endtabs %}
**Ergebnisse**
Wir benachrichtigen Sie per E-Mail, wenn Ihr Import abgeschlossen ist. Sie können die Importergebnisse von der  **\[Engage] → Berichte → Importe & Exporte** Seite in Ihrem Advocate-Programm herunterladen.
{% hint style="warning" %}
**Warnung:** Download-Links laufen nach 30 Tagen ab.
{% endhint %}
{% tabs %}
{% tab title="Erfolgreicher Upload" %}
Wenn der Import erfolgreich abgeschlossen wird, wird eine Datei mit den Teilnehmerinformationen generiert und Ihnen per E-Mail zugesendet. Die in diesen Ergebnissen enthaltenen Informationen entsprechen denen in unserem [Bericht mit Benutzerdetails](/brand/de/what-would-you-like-to-learn-about/advocate-program/advocate-reporting-and-analytics/advocate-program-reports-explained.md).
{% endtab %}
{% tab title="Fehler" %}
Wenn während des Imports Fehler auftreten, wird eine zusätzliche Datei generiert. Diese Fehlerdatei enthält Einträge für jeden aufgetretenen Fehler, einschließlich der Zeilennummer des Datensatzes (aus der ursprünglichen Importdatei), der fehlgeschlagen ist, sowie aller zugehörigen Fehlermeldungen.
| Datensatznummer | Nachricht | apiErrorCode | Statuscode |
| --------------- | ---------------------------------------------------- | ------------ | ---------- |
| 2 | Diese Anfrage erfordert eine gültige, nicht leere ID | BAD\_REQUEST | 400 |
Falls wider Erwarten ein Systemfehler auftritt und der Import unterbrochen wird, erscheint der Import als **abgebrochen** und kann nicht wiederhergestellt werden. Bitte wenden Sie sich an unser Support-Team, wenn Sie weitere Hilfe benötigen.
{% 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/import-advocate-participants-in-bulk.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.