# Advocate-Teilnehmer per Bulk-Import 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 einzusehen.
{% 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 Upload-Datei. **Felder sind Groß-/Kleinschreibungssensitiv.**
{% tabs %}
{% tab title="Standardfelder" %}
Standardfelder werden mit derselben Validierung wie unsere [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 dieser Teilnehmer gehört. |
| id (Erforderlich) | string | Die für diesen Teilnehmer angegebene eindeutige Kennung. |
| firstName | string | Der Vorname des Teilnehmers. |
| lastName | string | Der Nachname des Teilnehmers. |
| email | string | Die E-Mail-Adresse des Teilnehmers. |
| referable | boolean | Flag, das von impact.com verwendet wird, um zu bestimmen, ob ein Teilnehmer weiterempfohlen werden kann.
Hinweis: Das Flag muss ausschließlich mit einem r geschrieben werden, damit der Status erfolgreich geändert werden kann.
|
| locale | string | Die Locale des Teilnehmers, verwendet für [Internationalisierung](https://help.impact.com/brand/de/was-mochten-sie-lernen/advocate-program/advocate-program-settings/translate-and-localize-your-advocate-program). Die Locale muss im Format `language_COUNTRY` sein, wobei der Sprachcode kleingeschrieben und der Ländercode großgeschrieben sein muss. Der Trenner muss ein Unterstrich sein. |
| countryCode | string | Die Locale des Teilnehmers, verwendet für [Internationalisierung](https://help.impact.com/brand/de/was-mochten-sie-lernen/advocate-program/advocate-program-settings/translate-and-localize-your-advocate-program). Der Ländercode des Benutzers (z. B. CA). |
| referredBy.code | string | Der Referral-Code des Kundenadvokaten, der diesen Teilnehmer empfohlen hat. |
| referralCodes.{programId} | string | Der individuelle Referral-Code, den dieser Teilnehmer für das angegebene Programm teilen kann (wird automatisch generiert, wenn er nicht enthalten ist). |
| sharelinks.{programId} | string | Der individuelle Share-Link, den dieser Teilnehmer für das angegebene Programm teilen kann (wird automatisch generiert, wenn er nicht enthalten ist). |
| dateCreated | string | Das Datum, an dem dieser Teilnehmer in Ihrem Advocate-Programm erstellt wurde. |
| imageUrl | string | Optional in Widgets, E-Mails und Themes verwendet. Wenn Sie eine absolute Profilbild-URL angeben, beträgt die minimale Bildgröße 80px x 80px. |
| dateUsTaxFormSubmitted | integer | Das Datum, an dem das W-9-Steuerformular eines Teilnehmers als eingereicht markiert wurde. Wird für W-9-Compliance in Ihrem Mandanten verwendet, sofern konfiguriert. |
| customFields.{fieldName} | string | Verwenden Sie diese Struktur, um ein benutzerdefiniertes Feld nach Wahl einzuschließen. |
| {% endtab %} | | |
{% tab title="Benutzerdefinierte Felder" %}
[Benutzerdefinierte Benutzerfelder](https://help.impact.com/brand/de/was-mochten-sie-lernen/advocate-program/manage-advocate-participants/custom-and-calculated-fields/custom-fields-for-advocate-explained) ermöglichen Daten, die für Ihre Teilnehmer einzigartig sind. Sie können Ihre Programmziele so einstellen, dass sie basierend auf den Informationen in einem benutzerdefinierten Benutzerfeld ausgelöst werden.
{% hint style="info" %}
**Beispiel**: Belohnen Sie Teilnehmer, wenn sie ihre Abonnementmitgliedschaft erneuern. Fügen Sie zunächst das benutzerdefinierte Feld `customFields.subscriptionPaid` mit dem Wert **yes**hinzu. Legen Sie dann das Ziel so fest, dass es konvertiert, wenn `customFields.subscriptionPaid` gleich ist **yes**.
{% endhint %}
Fügen Sie benutzerdefinierte Felder zur Spaltenüberschrift in diesem Format 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 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 Teilnehmerinformationen generiert und Ihnen per E-Mail zugesandt. Die in diesen Ergebnissen enthaltenen Informationen sind dieselben wie in unserem [Benutzerdetailbericht](https://help.impact.com/brand/de/was-mochten-sie-lernen/advocate-program/advocate-reporting-and-analytics/advocate-program-reports-explained).
{% 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 fehlgeschlagenen Datensatzes (aus der ursprünglichen Importdatei) und etwaiger zugehöriger 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, erscheint der Import als **abgebrochen** und wird nicht wiederhergestellt. Bitte wenden Sie sich an unser Support-Team, wenn Sie weitere Unterstützung benötigen.
{% endtab %}
{% endtabs %}