# Massen-Cash-Belohnungen mit Advocate erstellen

Während viele Prämien 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 **Massenprämien** Das Importtool ermöglicht es Ihnen, mehreren Advocates gleichzeitig Bargeld, Punkte oder Geschenkkarten zuzuweisen, indem Sie eine CSV-Datei hochladen. Diese Funktion umfasst einen Sicherheitsmechanismus für einen Probelauf, 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 einreichen.
{% 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 der Datei Prämiendetails (z. B. Betrag, Einheit, Typ) hinzufügen. Alternativ empfehlen wir, diese als *globale Standardwerte* während des Importvorgangs in der Plattform festzulegen, um Ihre Datei zu vereinfachen.

#### Spaltenreferenz der Datei

<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 Prämie (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 Prämie, 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>Die Prämie bis zu diesem Datum zurückstellen.</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 sein wird.</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ü ![](/files/8189ccdb3d6833e64eac05afbd5a6e7ceadce224) **\[Engage] → Berichterstattung → Importe & Exporte**.
2. Wähle oben rechts **Importieren**.
3. Unter *Importtyp*wählen Sie **Prämien**.

<div data-with-frame="true"><figure><img src="/files/2ce9cb66fc4f892b4e6b00be56ca2db602b6b661" 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 Prämie oder geben Sie eine manuelle Einheit an (z. B. „Cash/USD“).
* **Programm**: Ordnen Sie diese Prämien für Berichterstattungszwecke einem bestimmten Programm zu.
* **Dauer der ausstehenden Prämie**: ![](/files/f424427acccf2928175d7fd5013ee577927e3a4c) **\[Einschalten]** um einen Sicherheitspuffer hinzuzufügen (z. B. 30 Tage), bevor die Prämie für den Benutzer verfügbar ist. Dies gibt bei Bedarf Zeit für Rücknahmen.

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

{% step %}

#### Hochladen und Probelauf

Da Bargeldprämien endgültig sind und nicht rückgängig gemacht werden können, erfordert das System einen Probelauf (Testimport), damit Sie die Details vor der Verarbeitung der Prämien sicher überprüfen können.

1. Unter dem *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 wird die Datei verarbeiten **ohne** und Prämien erstellen.

<div data-with-frame="true"><figure><img src="/files/d3c16be2b8058f914c2f52911bb6bb4f97a15760" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}

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

Sobald der Testlauf abgeschlossen ist, sehen Sie einen Statuseintrag in der Liste „Imports & Exports“. Im Rahmen des Prüfprozesses können E-Mails versendet werden (Geschenkkarten, Auszahlungs-Konfiguration usw.).

1. **Überprüfen**: Wenn Fehler vorliegen (gekennzeichnet mit ![](/files/a36bf859af8aa6c0d2d02494f75b96bfc18cd295) **\[Ausrufezeichen]**), wählen Sie **Fehlerbericht herunterladen** um Ihre Datei zu korrigieren und es erneut zu versuchen. Wählen Sie außerdem **Bericht herunterladen** um eine Aufzeichnung aller Prämien zu erhalten, die erstellt werden. Unabhängig davon, ob ein Fehler vorliegt oder nicht, wird dies zur Prüfung empfohlen.
2. **Bestätigen**: Wenn der Test erfolgreich ist (gekennzeichnet mit einem ![](/files/0f3d3ed9ca37a8a081866fd08e0b5d9c54d7aef0) **\[Häkchen]**), wählen Sie **Import ausführen**.
3. Es erscheint ein Bestätigungsdialog mit einer Zusammenfassung der gesamten Auswirkung (z. B. „Durch die 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 nicht fortfahren möchten, 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="/files/e5c0cb1105e72cbd8411ee1f665def7184b01284" alt=""><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}


---

# Agent Instructions: 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:

```
GET https://help.impact.com/brand/de/woruber-mochten-sie-mehr-erfahren/advocate-program/advocate-rewards/massen-bargeldbelohnungen-mit-advocate-erstellen.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.