> 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 stapelweise importieren
Advocate akzeptiert Importe, die in `.csv` oder `.jsonl` Dateiformaten. Bitte verwenden 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 für Ihren Import erforderliche Dateistruktur anzuzeigen.
{% hint style="info" %}
**Hinweis:** Wir empfehlen, dass jeder Import 500.000 Einträge nicht überschreitet.
{% endhint %}
#### Teilnehmer 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 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* Teilnehmer, die in dieser Importdatei enthalten sind.
{% 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 Hochladedatei. **Bei Feldern wird zwischen Groß- und Kleinschreibung unterschieden.**
{% tabs %}
{% tab title="Standardfelder" %}
Standardfelder werden mit derselben Validierung verarbeitet wie unsere [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) | Zeichenfolge | Der eindeutige Bezeichner des Kontos, dem dieser Teilnehmer zugeordnet ist. |
| id (Erforderlich) | Zeichenfolge | Der eindeutige Bezeichner, der für diesen Teilnehmer angegeben wurde. |
| firstName | Zeichenfolge | Der Vorname des Teilnehmers. |
| lastName | Zeichenfolge | Der Nachname des Teilnehmers. |
| email | Zeichenfolge | Die E-Mail-Adresse des Teilnehmers. |
| referable | Boolesch | Von impact.com verwendetes Kennzeichen, um festzustellen, ob ein Teilnehmer empfohlen werden kann.
Hinweis: Das Kennzeichen muss mit nur einem r geschrieben sein, damit der Status erfolgreich geändert werden kann.
|
| locale | Zeichenfolge | Die Gebietsschemaeinstellung 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 im Format `language_COUNTRY` angegeben sein, wobei der Sprachcode kleingeschrieben und der Ländercode großgeschrieben sein muss. Als Trennzeichen muss ein Unterstrich verwendet werden. |
| countryCode | Zeichenfolge | Die Gebietsschemaeinstellung 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 | Zeichenfolge | Der Empfehlungscode des Kundenbotschafters, der diesen Teilnehmer geworben hat. |
| referralCodes.{programId} | Zeichenfolge | Der benutzerdefinierte Empfehlungscode, den dieser Teilnehmer für das angegebene Programm teilen kann (wird automatisch generiert, falls nicht enthalten). |
| sharelinks.{programId} | Zeichenfolge | Der benutzerdefinierte Freigabelink, den dieser Teilnehmer für das angegebene Programm teilen kann (wird automatisch generiert, falls nicht enthalten). |
| dateCreated | Zeichenfolge | Das Datum, an dem dieser Teilnehmer in Ihrem Advocate-Programm erstellt wurde. |
| imageUrl | Zeichenfolge | Wird optional in Widgets, E-Mails und Designs verwendet. Wenn Sie eine absolute URL für das Profilbild angeben, beträgt die minimale Bildgröße 80 px x 80 px. |
| dateUsTaxFormSubmitted | Ganzzahl | Das Datum, an dem das W-9-Steuerformular eines Teilnehmers als eingegangen markiert wurde. Wird für die W-9-Compliance in Ihrem Tenant verwendet, sofern konfiguriert. |
| customFields.{fieldName} | Zeichenfolge | Verwenden Sie diese Struktur, um ein benutzerdefiniertes Feld Ihrer Wahl einzubinden. |
| {% 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 Daten, die einzigartig für Ihre Teilnehmer sind. 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 ihr Abonnement verlängern. Fügen Sie zuerst das benutzerdefinierte Feld hinzu `customFields.subscriptionPaid` mit dem Wert **ja**. Legen Sie dann das Ziel so fest, dass es konvertiert wird, wenn `customFields.subscriptionPaid` gleich ist **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 annehmen.
{% 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 erstellt und Ihnen per E-Mail zugesendet. Die in diesen Ergebnissen enthaltenen Informationen sind dieselben wie in unserem [Benutzerdetailsbericht](/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 erstellt. 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 |
Für den unwahrscheinlichen Fall, dass ein Systemfehler auftritt und der Import unterbrochen wird, wird der Import als **abgebrochen** angezeigt und kann nicht fortgesetzt 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.