> 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/advocate-rewards/create-bulk-cash-rewards-with-advocate.md).

# Belohnungen in Bargeld in großen Mengen mit Advocate erstellen

Während viele Belohnungen automatisch durch Programmregeln ausgelöst werden (z. B. eine Empfehlungsumwandlung), müssen Sie Teilnehmer manchmal für manuelle oder Offline-Aktionen belohnen – etwa für das Ausfüllen einer Umfrage oder das Gewinnen eines Wettbewerbs.

Die **Massenbelohnungen** Das Import-Tool ermöglicht es Ihnen, mehreren Fürsprechern gleichzeitig Bargeld, Punkte oder Geschenkkarten auszugeben, indem Sie eine CSV-Datei hochladen. Diese Funktion umfasst einen Testlauf als Sicherheitsmechanismus, um sicherzustellen, dass Ihre Daten korrekt sind, bevor Gelder ausgezahlt werden.

### Bereiten Sie Ihre Importdatei vor

{% hint style="success" %}
**Hinweis**: Wenn Sie die globalen Importeinstellungen verwenden, müssen Sie nur eine `userId` Liste
{% endhint %}

Zunächst benötigen Sie eine CSV- oder JSONL-Datei mit der Liste der Benutzer, die Sie belohnen möchten.

* **Erforderliche Spalten**: Ihre Datei muss mindestens `userId` enthalten, um den Benutzer zu identifizieren.
* **Optionale Spalten**: Sie können Belohnungsdetails (z. B. Betrag, Einheit, Typ) in die Datei aufnehmen. Alternativ empfehlen wir, diese während des Importvorgangs als *globale Standardwerte* in der Plattform festzulegen, um Ihre Datei zu vereinfachen.

#### Referenz für Dateispalten

<table data-header-hidden><thead><tr><th width="297.484375">Spalte</th><th>Beschreibung</th><th>Anforderung</th></tr></thead><tbody><tr><td><code>userId</code></td><td>Die eindeutige ID des Benutzers.</td><td><mark style="color:$danger;">Erforderlich</mark></td></tr><tr><td><code>assignedCreditInCurrencyBaseUnit</code></td><td>Der zu belohnende Betrag (z. B. 50).</td><td>Bedingt<br>(Nicht erforderlich, wenn ein globaler Standardwert festgelegt ist)</td></tr><tr><td><code>rewardUnit</code></td><td>Die Einheit der Belohnung (z. B. USD, POINTS).</td><td>Bedingt<br>(Nicht erforderlich, wenn ein globaler Standardwert festgelegt ist)</td></tr><tr><td><code>globalRewardKey</code></td><td>Der Schlüssel einer vorkonfigurierten Belohnung, die vergeben werden soll.</td><td><p>Bedingt<br>(Nicht erforderlich, wenn ein globaler Standardwert festgelegt ist)</p><p><br></p></td></tr><tr><td><code>discountPercent</code></td><td>Der als Rabatt zu belohnende Betrag</td><td>Bedingt<br>(Nicht erforderlich, wenn ein globaler Standardwert festgelegt ist)</td></tr><tr><td><code>dateScheduledFor</code></td><td>Stellen Sie die Belohnung bis zu diesem Datum zurück.</td><td>Optional</td></tr><tr><td><code>uniqueId</code></td><td>Eine eindeutige Kennung für die Transaktion.</td><td><mark style="color:$success;">Empfohlen</mark><br>Wird als Sicherheitsschlüssel verwendet, um doppelte Belohnungen zu verhindern, falls die Datei erneut ausgeführt wird.</td></tr><tr><td><code>customerNote</code></td><td>Fügen Sie eine Notiz hinzu, die für den Kunden sichtbar ist.</td><td>Optional</td></tr><tr><td><code>internalNote</code></td><td>Fügen Sie eine Notiz für den internen Gebrauch hinzu, die der Kunde nicht sehen kann.</td><td>Optional</td></tr></tbody></table>

{% stepper %}
{% step %}

#### Importeinstellungen konfigurieren

1. Wählen Sie im linken Navigationsmenü ![](https://1698965099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[Engage] → Berichterstattung → Importe & Exporte**.
2. Wählen Sie in der oberen rechten Ecke **Import**.
3. Unter *Importtyp*, wählen Sie **Belohnungen**.

<div data-with-frame="true"><figure><img src="https://1698965099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FNCv4EHK61ypIahnjieFB%2FScreenshot%202026-05-19%20at%2010.12.35.png?alt=media&amp;token=1b2a3fe3-f3ba-4bff-9612-a47317c223f7" alt=""><figcaption></figcaption></figure></div>

**Voreingestellte Werte festlegen (globale Standardwerte)**

Um Zeit zu sparen und Fehler in Ihrer CSV-Datei zu reduzieren, können Sie voreingestellte Werte definieren, die für jede Zeile Ihres Imports gelten.

* **Belohnung**: Wählen Sie eine vorkonfigurierte Belohnung oder geben Sie eine manuelle Einheit an (z. B. „Bargeld/USD“).
* **Programm**: Ordnen Sie diese Belohnungen für Berichterstattungszwecke einem bestimmten Programm zu.
* **Dauer der ausstehenden Belohnung**: ![](https://1698965099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FiZjM1xY8o3v1iR3Zaysd%2FToggle.svg?alt=media\&token=b1550d48-bba9-4e81-8604-bc12370c5caa) **\[Aktivieren]** um einen Sicherheitspuffer hinzuzufügen (z. B. 30 Tage), bevor die Belohnung für den Benutzer verfügbar ist. So bleibt bei Bedarf Zeit für Rücknahmen.

{% hint style="success" %}
**Hinweis**: Wenn Sie hier einen Wert festlegen (z. B. Belohnungseinheit: USD), müssen Sie **nicht** diese Spalte in Ihre CSV-Datei aufnehmen.
{% endhint %}
{% endstep %}

{% step %}

#### Hochladen und Testlauf

Da Bargeldbelohnungen endgültig sind und nicht rückgängig gemacht werden können, verlangt das System einen Testlauf (Testimport), damit Sie die Details vor der Verarbeitung der Belohnungen sicher überprüfen können.

1. Unter *Laden Sie Ihre CSV- oder JSONL-Datei mit den zu importierenden Benutzern hoch* wählen Sie **Datei auswählen**.
2. Wählen Sie **Testimport ausführen** um den Teststatus zu starten.
3. Das System verarbeitet die Datei **ohne** Belohnungen zu erstellen.

<div data-with-frame="true"><figure><img src="https://1698965099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FXzOTAlFdV9PBePeTWjd2%2FScreenshot%202026-05-19%20at%2010.15.36.png?alt=media&amp;token=859ccc75-e655-4002-b915-b8225028ddff" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

#### Überprüfen und abschließen

Sobald der Testlauf abgeschlossen ist, sehen Sie einen Statuseintrag in der Liste „Importe & Exporte“. Im Rahmen des Prüfprozesses können E-Mails gesendet werden (Geschenkkarten, Auszahlungskonfiguration usw.).

1. **Prüfen**: Wenn es Fehler gibt (gekennzeichnet mit ![](https://1698965099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2F42gbg9NHA1obODpwpxh1%2Ficons8-high-importance-16.png?alt=media\&token=80a809ae-ca8e-43d4-af95-a416a44c8ec3) **\[Exclaimation]**), wählen Sie **Fehlerbericht herunterladen** um Ihre Datei zu korrigieren und es erneut zu versuchen. Wählen Sie außerdem **Bericht herunterladen** um einen Datensatz aller Belohnungen zu erhalten, die erstellt werden. Unabhängig davon, ob ein Fehler vorliegt oder nicht, wird dies zur Überprüfung empfohlen.
2. **Bestätigen**: Wenn der Test erfolgreich ist (gekennzeichnet mit einem ![](https://1698965099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FvdMZSNCvTeUSIm6qrJ5o%2Ficons8-check-16.png?alt=media\&token=998fe3ad-c8a2-4dbc-bdc0-8f79e246b314) **\[Häkchen]**), wählen Sie **Import ausführen**.
3. Es erscheint ein Bestätigungsdialog, der die Gesamtauswirkung zusammenfasst (z. B. „Wenn Sie diesen Import ausführen, werden 412 Belohnungen erstellt“). Wählen Sie **Import ausführen** um die Belohnungen zu bestätigen und auszuzahlen.

Wenn Sie sich dagegen entscheiden, können Sie den Lauf einfach abbrechen und dann „Verwerfen“ auswählen, um den Testlauf zu löschen.

<div data-with-frame="true"><figure><img src="https://1698965099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FNa7x8cn8GL73umRhPqxk%2Fimage3.jpg?alt=media&amp;token=232b052b-b167-4613-81d1-581178951f27" alt=""><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}


---

# 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/advocate-rewards/create-bulk-cash-rewards-with-advocate.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.