# Advocate-Teilnehmer in großen Mengen importieren
Advocate akzeptiert Importe, die in `.csv` oder `.jsonl` Dateiformaten eingereicht werden. Bitte beachten Sie unsere [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 %}
#### Teilnehmende in großen Mengen importieren
1. Wählen Sie im linken Navigationsmenü  **\[Engage] → Teilnehmer**.
2. Wählen Sie **Benutzer importieren**.
3. Unter *Importtyp*wählen Sie **Benutzer**.
4. Fügen Sie Ihre Importdatei hinzu, indem Sie **Datei auswählen**.
5. **\[Optional]** Um die importierten Teilnehmenden 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 Teilnehmenden.
{% 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 sind groß-/kleinschreibungsempfindlich.**
{% tabs %}
{% tab title="Standardfelder" %}
Standardfelder werden mit derselben Validierung geparst wie unser [Open Endpoint User Upsert API-Aufruf](https://integrations.impact.com/impact-brand/docs/api-open-endpoints):
| Feld | Typ | Beschreibung |
| ------------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| accountId (erforderlich) | string | Die eindeutige Kennung des Kontos, zu dem diese teilnehmende Person gehört. |
| id (erforderlich) | string | Die eindeutige Kennung, die für diese teilnehmende Person angegeben wurde. |
| firstName | string | Der Vorname der teilnehmenden Person. |
| lastName | string | Der Nachname der teilnehmenden Person. |
| email | string | Die E-Mail-Adresse der teilnehmenden Person. |
| referable | boolean | Kennzeichen, das von impact.com verwendet wird, um festzustellen, ob eine teilnehmende Person weiterempfohlen werden kann.
Hinweis: Das Kennzeichen muss nur mit einem r geschrieben werden, damit der Status erfolgreich geändert werden kann.
|
| locale | string | Das Gebietsschema der teilnehmenden Person, verwendet für [Internationalisierung](/brand/de/woruber-mochten-sie-mehr-erfahren/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 | string | Das Gebietsschema der teilnehmenden Person, verwendet für [Internationalisierung](/brand/de/woruber-mochten-sie-mehr-erfahren/advocate-program/advocate-program-settings/translate-and-localize-your-advocate-program.md). Der Ländercode des Benutzers (z. B. CA). |
| referredBy.code | string | Der Empfehlungscode des Kunden-Befürworters, der diese teilnehmende Person empfohlen hat. |
| referralCodes.{programId} | string | Der Vanity-Empfehlungscode für diese teilnehmende Person, den sie für das angegebene Programm teilen kann (wird automatisch generiert, wenn er nicht enthalten ist). |
| sharelinks.{programId} | string | Der Vanity-Share-Link für diese teilnehmende Person, den sie für das angegebene Programm teilen kann (wird automatisch generiert, wenn er nicht enthalten ist). |
| dateCreated | string | Das Datum, an dem diese teilnehmende Person in Ihrem Advocate-Programm erstellt wurde. |
| imageUrl | string | Wird optional in Widgets, E-Mails und Themes verwendet. Wenn Sie eine absolute Profilbild-URL angeben, beträgt die Mindestbildgröße 80 px x 80 px. |
| dateUsTaxFormSubmitted | integer | Das Datum, an dem das W-9-Steuerformular einer teilnehmenden Person als eingereicht markiert wurde. Wird für die W-9-Konformität auf Ihrem Tenant verwendet, sofern konfiguriert. |
| customFields.{fieldName} | string | Verwenden Sie diese Struktur, um ein benutzerdefiniertes Feld Ihrer Wahl einzuschließen. |
| {% endtab %} | | |
{% tab title="Benutzerdefinierte Felder" %}
[Benutzerdefinierte Benutzerfelder](/brand/de/woruber-mochten-sie-mehr-erfahren/advocate-program/manage-advocate-participants/custom-and-calculated-fields/custom-fields-for-advocate-explained.md) ermöglichen Daten, die für Ihre Teilnehmenden einzigartig sind. Sie können Ihre Programmziele so festlegen, dass sie basierend auf Informationen in einem benutzerdefinierten Benutzerfeld ausgelöst werden.
{% hint style="info" %}
**Beispiel**: Belohnen Sie Teilnehmende, wenn sie ihr Abonnement verlängern. Fügen Sie zunächst das benutzerdefinierte Feld `customFields.subscriptionPaid` mit dem Wert **ja**hinzu. Legen Sie dann das Ziel so fest, dass es konvertiert wird, wenn `customFields.subscriptionPaid` gleich **ja**.
{% endhint %}
Fügen Sie benutzerdefinierte Felder in diesem Format zur Spaltenüberschrift hinzu: `customFields.IhrBenutzerdefinierterFeldname`.
{% 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 innerhalb Ihres Advocate-Programms herunterladen.
{% hint style="warning" %}
**Warnung:** Download-Links verfallen nach 30 Tagen.
{% endhint %}
{% tabs %}
{% tab title="Erfolgreicher Upload" %}
Wenn der Import erfolgreich abgeschlossen wird, wird eine Datei mit den Teilnehmendeninformationen generiert und Ihnen per E-Mail zugesendet. Die in diesen Ergebnissen enthaltenen Informationen sind dieselben wie in unserem [Bericht mit Benutzerdetails](/brand/de/woruber-mochten-sie-mehr-erfahren/advocate-program/advocate-reporting-and-analytics/advocate-program-reports-explained.md).
{% endtab %}
{% tab title="Fehler" %}
Wenn während des Imports Fehler auftreten, wird zusätzlich eine weitere 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.
| recordNumber | message | 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 Unterstützung benötigen.
{% endtab %}
{% endtabs %}
---
# Agent Instructions: 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:
```
GET https://help.impact.com/brand/de/woruber-mochten-sie-mehr-erfahren/advocate-program/manage-advocate-participants/import-advocate-participants-in-bulk.md?ask=
```
The question should be specific, self-contained, and written in natural language.
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.