> 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 in großen Mengen importieren

Advocate akzeptiert Importe im Format `.csv` oder `.jsonl` Dateiformat. Bitte beachten Sie unsere [CSV-Beispieldatei für den Import](https://assets.ctfassets.net/s68ib1kj8k5n/7LOYwhDlsI22uuaIMaWImE/71cefe860edc71c0968c8065e1d6e953/sample-user-upload.csv) und [JSONL-Beispieldatei für den Import](https://assets.ctfassets.net/s68ib1kj8k5n/5rD1ZiKEjqStp54qjDB90N/48918dfa8b53a935c7c83ea5fbf3af77/userImportSample.jsonl) um die erforderliche Dateistruktur für Ihren Import einzusehen.

{% hint style="info" %}
**Hinweis:** Wir empfehlen, pro Import nicht mehr als 500.000 Einträge zu verwenden.
{% endhint %}

#### Teilnehmer in großen Mengen importieren

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. Wählen Sie **Benutzer importieren**.
3. Wählen Sie unter *Importtyp*, **Benutzer**.
4. Fügen Sie Ihre Importdatei hinzu, indem Sie **Datei auswählen**.
5. **\[Optional]** Wenn Sie die importierten Teilnehmer einem bestimmten Benutzersegment hinzufügen oder daraus entfernen möchten, wählen Sie das Segment aus der Dropdown-Liste aus.

{% hint style="info" %}
**Hinweis:** Diese Auswahl gilt für *alle* Teilnehmer in dieser Importdatei.
{% endhint %}

6. Wählen Sie **Import starten**.

Nach Abschluss des Imports wird eine Bestätigungs-E-Mail gesendet. Je nach Warteschlange und Dateigröße kann der Import bis zu 30 Minuten dauern.

#### Felder

Massenimporte von Benutzern unterstützen sowohl Standardfelder als auch benutzerdefinierte Felder in der Upload-Datei. **Bei Feldern wird zwischen Groß- und Kleinschreibung unterschieden.**

{% tabs %}
{% tab title="Standardfelder" %}
Standardfelder werden mit derselben Validierung verarbeitet wie bei unserem [Open-Endpoint-API-Aufruf zum Anlegen oder Aktualisieren von Benutzern](https://integrations.impact.com/integration-guides/for-brands/advocate/advocate-api/api-open-endpoints):

| Feld                      | Typ          | Beschreibung                                                                                                                                                                                                                                                                                                                                                                                                                                |
| ------------------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| accountId (erforderlich)  | Zeichenfolge | Die eindeutige Kennung des Kontos, zu dem dieser Teilnehmer gehört.                                                                                                                                                                                                                                                                                                                                                                         |
| id (erforderlich)         | Zeichenfolge | Die für diesen Teilnehmer angegebene eindeutige Kennung.                                                                                                                                                                                                                                                                                                                                                                                    |
| firstName                 | Zeichenfolge | Der Vorname des Teilnehmers.                                                                                                                                                                                                                                                                                                                                                                                                                |
| lastName                  | Zeichenfolge | Der Nachname des Teilnehmers.                                                                                                                                                                                                                                                                                                                                                                                                               |
| email                     | Zeichenfolge | Die E-Mail-Adresse des Teilnehmers.                                                                                                                                                                                                                                                                                                                                                                                                         |
| referable                 | boolesch     | <p>Flag, das impact.com verwendet, um festzustellen, ob ein Teilnehmer weiterempfohlen werden kann.</p><p><strong>Hinweis:</strong> Das Flag darf ausschließlich mit <em>eins</em> <code>r</code> damit der Status erfolgreich geändert werden kann.</p>                                                                                                                                                                                    |
| Gebietsschema             | Zeichenfolge | Das Gebietsschema des Teilnehmers, verwendet für [Internationalisierung](https://help.impact.com/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 `language_COUNTRY` haben. Der Sprachcode muss kleingeschrieben und der Ländercode großgeschrieben sein. Als Trennzeichen muss ein Unterstrich verwendet werden. |
| countryCode               | Zeichenfolge | Das Gebietsschema des Teilnehmers, verwendet für [Internationalisierung](https://help.impact.com/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 Nutzers (z. B. CA).                                                                                                                                                            |
| referredBy.code           | Zeichenfolge | Der Empfehlungscode des Kundenbotschafters, der diesen Teilnehmer geworben hat.                                                                                                                                                                                                                                                                                                                                                             |
| referralCodes.{programId} | Zeichenfolge | Der individuelle Empfehlungscode, den dieser Teilnehmer im angegebenen Programm teilen kann (wird automatisch generiert, wenn er nicht angegeben ist).                                                                                                                                                                                                                                                                                      |
| sharelinks.{programId}    | Zeichenfolge | Der individuelle Freigabelink, den dieser Teilnehmer im angegebenen Programm teilen kann (wird automatisch generiert, wenn er nicht angegeben ist).                                                                                                                                                                                                                                                                                         |
| dateCreated               | Zeichenfolge | Das Datum, an dem dieser Teilnehmer in Ihrem Advocate-Programm angelegt wurde.                                                                                                                                                                                                                                                                                                                                                              |
| imageUrl                  | Zeichenfolge | Optional zur Verwendung in Widgets, E-Mails und Designs. Wenn Sie eine absolute URL für das Profilbild angeben, muss das Bild mindestens 80 × 80 Pixel groß sein.                                                                                                                                                                                                                                                                           |
| 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 Mandanten verwendet, sofern konfiguriert.                                                                                                                                                                                                                                                                   |
| customFields.{fieldName}  | Zeichenfolge | Verwenden Sie diese Struktur, um ein benutzerdefiniertes Feld Ihrer Wahl einzubeziehen.                                                                                                                                                                                                                                                                                                                                                     |
| {% endtab %}              |              |                                                                                                                                                                                                                                                                                                                                                                                                                                             |

{% tab title="Benutzerdefinierte Felder" %}
[Benutzerdefinierte Nutzerfelder](https://help.impact.com/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 speziell für Ihre Teilnehmer gelten. Sie können Ihre Programmziele so festlegen, dass sie anhand der Informationen in einem benutzerdefinierten Nutzerfeld ausgelöst werden.

{% hint style="info" %}
**Beispiel**: Belohnen Sie Teilnehmer, wenn sie ihr Abonnement verlängern. Fügen Sie zunächst das benutzerdefinierte Feld `customFields.subscriptionPaid` mit dem Wert **yes**hinzu. Legen Sie anschließend fest, dass das Ziel erreicht wird, wenn `customFields.subscriptionPaid` gleich **yes**.
{% endhint %}

Fügen Sie benutzerdefinierte Felder im folgenden Format als Spaltenüberschrift hinzu: `customFields.yourCustomFieldName`.

{% hint style="info" %}
**Hinweis:** Benutzerdefinierte Felder können keine Array- oder Objektwerte enthalten.
{% endhint %}
{% endtab %}
{% endtabs %}

**Ergebnisse**

Wir benachrichtigen Sie per E-Mail, wenn Ihr Import abgeschlossen ist. Sie können die Importergebnisse 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] → Reporting → Imports & Exports** auf der Seite Ihres Advocate-Programms.

{% hint style="warning" %}
**Warnung:** Downloadlinks laufen nach 30 Tagen ab.
{% endhint %}

{% tabs %}
{% tab title="Upload erfolgreich" %}
Wenn der Import erfolgreich abgeschlossen wird, wird eine Datei mit den Teilnehmerinformationen erstellt und per E-Mail an Sie gesendet. Die in diesen Ergebnissen enthaltenen Informationen entsprechen denen in unserem [Bericht mit Nutzerdetails](https://help.impact.com/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 beim Import Fehler auftreten, wird eine zusätzliche Datei erstellt. Diese Fehlerdatei enthält für jeden aufgetretenen Fehler einen Eintrag, einschließlich der Zeilennummer des Datensatzes (aus der ursprünglichen Importdatei), bei dem der Fehler aufgetreten ist, sowie der zugehörigen Fehlermeldungen.

| recordNumber | message                                                         | apiErrorCode | statusCode |
| ------------ | --------------------------------------------------------------- | ------------ | ---------- |
| 2            | Für diese Anfrage ist eine gültige, nicht leere ID erforderlich | BAD\_REQUEST | 400        |

Falls wider Erwarten ein Systemfehler auftritt und der Import unterbrochen wird, wird der Import als **abgebrochen** angezeigt und nicht wieder aufgenommen. Bitte wenden Sie sich an unser Support-Team, wenn Sie weitere Unterstützung 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 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/import-advocate-participants-in-bulk.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.
