> 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

Viele Prämien werden zwar automatisch durch Programmregeln ausgelöst (z. B. wenn eine Empfehlung zu einer Conversion führt), manchmal müssen Sie Teilnehmende jedoch für manuelle oder Offline-Aktionen belohnen – etwa für das Ausfüllen einer Umfrage oder den Gewinn eines Wettbewerbs.

Mit dem **Tool zum Importieren von Sammelprämien** können Sie mehreren Fürsprecher:innen gleichzeitig Bargeld, Punkte oder Geschenkkarten zukommen lassen, indem Sie eine CSV-Datei hochladen. Diese Funktion bietet einen Sicherheitsmechanismus für einen Testlauf, damit Sie Ihre Daten überprüfen können, bevor Gelder ausgezahlt werden.

### Importdatei vorbereiten

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

Zu Beginn benötigen Sie eine CSV- oder JSONL-Datei mit der Liste der Nutzer:innen, die Sie belohnen möchten.

* **Erforderliche Spalten**: Ihre Datei muss mindestens Folgendes enthalten: `userId` zur Identifizierung des Benutzers.
* **Optionale Spalten**: Sie können Belohnungsdetails (z. B. Betrag, Einheit, Typ) in die Datei aufnehmen. Alternativ empfehlen wir, diese beim Import als *globale Standardeinstellungen* auf der Plattform festzulegen, um Ihre Datei zu vereinfachen.

#### Referenz zu 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 vergebende Betrag (z. B. 50).</td><td>Bedingt<br>(Nicht erforderlich, wenn ein globaler Standard festgelegt ist)</td></tr><tr><td><code>rewardUnit</code></td><td>Die Einheit der Prämie (z. B. USD, POINTS).</td><td>Bedingt<br>(Nicht erforderlich, wenn ein globaler Standard festgelegt ist)</td></tr><tr><td><code>globalRewardKey</code></td><td>Der Schlüssel einer vorkonfigurierten Prämie, die vergeben werden soll.</td><td><p>Bedingt<br>(Nicht erforderlich, wenn ein globaler Standard festgelegt ist)</p><p><br></p></td></tr><tr><td><code>discountPercent</code></td><td>Der als Rabatt zu vergebende Betrag</td><td>Bedingt<br>(Nicht erforderlich, wenn ein globaler Standard festgelegt ist)</td></tr><tr><td><code>dateScheduledFor</code></td><td>Die Prämie bis zu diesem Datum zurückhalten.</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 Prämien zu verhindern, wenn 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 interne Notiz 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] → Berichte → Importe und Exporte**.
2. Wählen Sie oben rechts **Importieren**.
3. Wählen Sie unter *Importtyp*, **Prämien**.

<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 vermeiden, können Sie voreingestellte Werte definieren, die für jede Zeile Ihres Imports gelten.

* **Prämie**: Wählen Sie eine vorkonfigurierte Prämie aus oder geben Sie eine manuelle Einheit an (z. B. „Cash/USD“).
* **Programm**: Ordnen Sie diese Prämien zu Berichtszwecken einem bestimmten Programm zu.
* **Wartezeit für Prämien**: ![](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) **\[Toggle on]** , um eine Sicherheitsspanne (z. B. 30 Tage) hinzuzufügen, bevor die Prämie für den Nutzer verfügbar ist. So bleibt bei Bedarf Zeit für Rücknahmen.

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

{% step %}

#### Hochladen und Probelauf

Da Barauszahlungen endgültig sind und nicht rückgängig gemacht werden können, erfordert das System einen Probelauf (Testimport). So können Sie die Details in Ruhe prüfen, bevor die Prämien verarbeitet werden.

1. Wählen Sie unter *Upload your import users CSV or JSONL file* die Option **Datei auswählen**.
2. Auswählen **Testimport ausführen** , um den Test zu starten.
3. Das System verarbeitet die Datei **ohne** Prämien 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 %}

#### Prüfen und abschließen

Nach Abschluss des Probelaufs wird in der Liste „Importe und Exporte“ ein Statuseintrag angezeigt. Im Rahmen des Prüfprozesses werden möglicherweise E-Mails versendet (z. B. zu Geschenkkarten oder Auszahlungsinformationen).

1. **Prüfen**: Bei Fehlern (gekennzeichnet durch ![](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 eine Übersicht aller zu erstellenden Prämien zu erhalten. Unabhängig davon, ob Fehler vorliegen, wird eine Prüfung des Berichts empfohlen.
2. **Bestätigen**: Wenn der Test erfolgreich ist (gekennzeichnet durch ein ![](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) **\[Checkmark]**), wählen Sie **Import ausführen**.
3. Es wird ein Bestätigungsdialog angezeigt, der die Gesamtauswirkungen zusammenfasst (z. B. „Bei Ausführung dieses Imports werden 412 Prämien erstellt“). Wählen Sie **Import ausführen** , um die Prämien zu bestätigen und auszuzahlen.

Wenn Sie den Vorgang doch nicht ausführen möchten, können Sie den Lauf einfach abbrechen und anschließend „Verwerfen“ wä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.
