> 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/platform-features/promo-codes/bulk-upload-promo-codes.md).
# Promo-Codes per Massen-Upload hochladen
Sie können mehrere Tracking-Promo-Codes gleichzeitig aus einer CSV-, XLS- oder XLSX-Datei erstellen. Nachdem Sie Ihre Datei hochgeladen haben, validiert impact.com jede Zeile, damit Sie vor dem Erstellen der Promo-Codes alle Fehler überprüfen und beheben können.
Dateien dürfen bei CSV bis zu 5 MB und bei XLS und XLSX bis zu 1 MB groß sein. Die Validierung basiert nur auf der Dateigröße, daher gibt es keine Begrenzung für die Anzahl der Zeilen.
## Laden Sie Ihre Promo-Codes hoch
1. Wählen Sie im linken Navigationsmenü  **\[Engage]** → **Inhalt** → [**Promo-Codes**](https://app.impact.com/secure/advertiser/engage/ads/view-adv-promo-codes-flow.ihtml).
2. Auf dem *Promo-Codes* Bildschirm wählen Sie **Massenupload**.
3. Optional können Sie **Herunterladen** wählen, um eine Beispielvorlage zu erhalten, oder wählen Sie **Formatdetails anzeigen** um die erforderlichen Spalten anzuzeigen.
4. Wählen Sie **Datei auswählen**, suchen Sie dann Ihre Datei und wählen Sie sie aus. Sie können die Datei auch per Drag-and-drop auf die Seite ziehen.
5. Wählen Sie **Weiter**.
6. Überprüfen Sie die *Datenvorschau* Tabelle. Die *Validierung* Spalte zeigt *Genehmigt* für Zeilen an, die bereit sind, oder eine Fehlermeldung für Zeilen, die Änderungen benötigen.
* Optional können Sie die Zeilen sortieren, indem Sie eine Spaltenüberschrift auswählen oder **Sortierreihenfolge**.
* Um alle Fehler für eine Zeile anzuzeigen, wählen Sie  **\[Expand]** neben dem Promo-Code. Die *Fehler-Vorschau* listet jede Spalte, ihren Wert und das Problem auf.
* Um Fehler zu beheben, aktualisieren Sie Ihre Datei, wählen Sie **Abbrechen** neben dem Dateinamen und laden Sie dann die korrigierte Datei hoch.
7. Wählen Sie **Akzeptieren & Promo-Codes erstellen**. Die Meldung neben der Schaltfläche zeigt die Anzahl der genehmigten Promo-Codes an, die impact.com erstellt. Wenn keine Zeilen genehmigt sind, ist die Schaltfläche deaktiviert.
impact.com erstellt die genehmigten Promo-Codes und bringt Sie zurück zum *Promo-Codes* Bildschirm. Es werden nur genehmigte Zeilen erstellt. Tritt beim Erstellen Ihrer Promo-Codes durch impact.com ein Fehler auf, wird eine Fehlermeldung mit einem Fehlercode angezeigt. Wenden Sie sich an den Support und geben Sie diesen Code an.
Um einen Massenupload abzubrechen, wählen Sie  **\[Schließen]** in der oberen rechten Ecke des Bildschirms und wählen Sie dann **Bestätigen**.
{% hint style="success" %}
**Hinweis:** Promo-Codes mit einem zukünftigen Startdatum haben den Status *Ausstehend* Der *Promo-Codes* Bildschirm zeigt *Aktive Promo-Codes* standardmäßig an, ändern Sie daher den [*Code-Zeitplan* Filter](/brand/de/what-would-you-like-to-learn-about/platform-features/promo-codes/manage-your-promo-codes.md) um sie zu finden.
{% endhint %}
## Formatieren Sie Ihre Promo-Code-Datei
Ihre Datei muss die folgenden Spaltennamen exakt wie gezeigt verwenden, einschließlich Groß- und Kleinschreibung und Punkten, andernfalls wird der Upload abgelehnt.
| Spalte | Typ | Erforderlich | Beschreibung |
| ---------------------- | ---------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Operation` | Zeichenfolge | Ja | Die Massen-Upload-Operation. Zulässiger Wert: `CREATE`. |
| `media.id` | Ganzzahl | Ja | Die impact.com-Media-ID, der der Promo-Code zugewiesen wird. Dies kann eine Partnerkonto-ID oder eine Media-Source-ID sein.
Jeder Tracking-Promo-Code kann nur 1 Partner oder 1 Media-Source zugewiesen werden. Bewirbt ein anderer Partner diesen Code, markiert impact.com die daraus resultierende Conversion als ungültig und storniert sie.
|
| `code` | Zeichenfolge | Ja | Der eindeutige Promo-Code. Er darf keine Winkelklammern (`<`, `>`) oder doppelte Anführungszeichen enthalten. |
| `creditRule` | Zeichenfolge | Ja | Die Gutschriftenregel für den Promo-Code. Zulässige Werte:
ALWAYS (Immer Gutschrift)
INVOLVED (Gutschrift, wenn beteiligt)
WINNER (Gutschrift, wenn Gewinner)
|
| `matchMode` | Zeichenfolge | Ja | Der Übereinstimmungsmodus des Promo-Codes. Zulässige Werte:
LI (Exakt/Literal)
RE (Regex/Regulärer Ausdruck)
|
| `deal.id` | Ganzzahl | Nein | Die ID des [Deals](/brand/de/what-would-you-like-to-learn-about/platform-features/deals.md) zur Verknüpfung mit dem Promo-Code. Der Deal muss in Ihrem Programm bereits vorhanden sein. |
| `scheduling.startDate` | Datum | Ja | Wann der Promo-Code verfügbar wird. Geben Sie ein lokales Datum und eine lokale Uhrzeit ohne Zeitzonenoffset im Format ein `YYYY-MM-DDTHH:mm:ss` (zum Beispiel, `2026-10-01T00:00:00`). |
| `scheduling.endDate` | Datum | Ja | Wann der Promo-Code abläuft. Verwenden Sie dasselbe Format wie `scheduling.startDate` (zum Beispiel, `2026-12-31T23:59:59`). |
| `scheduling.timezone` | Zeichenfolge | Ja | Die IANA-Zeitzone (Internet Assigned Numbers Authority) für die geplanten Daten (zum Beispiel, `America/New_York`). |
| `emailAddresses` | CSV-Zeichenfolge | Nein | Eine durch Kommas getrennte Liste von E-Mail-Adressen, die über diesen Promo-Code benachrichtigt werden sollen. |
| `comments` | Zeichenfolge | Nein | Freitextkommentare für diese Zeile. |
Beispiel: Diese Zeile erstellt den Promo-Code `10PEROFF` für 1 Partner, verfügbar vom 1. Oktober bis 31. Dezember 2026, in New Yorker Zeit.
```csv
Operation,media.id,code,creditRule,matchMode,deal.id,scheduling.startDate,scheduling.endDate,scheduling.timezone,emailAddresses,comments
CREATE,1299679,10PEROFF,ALWAYS,LI,,2026-10-01T00:00:00,2026-12-31T23:59:59,America/New_York,carrie.oakey@acmecorporation.io,Feiertagsaktion
```
Referenz für Validierungsfehler
| Validierungsmeldung | So beheben Sie es |
| --------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| *Nicht erkannter Wert* | Der Wert gehört nicht zu den zulässigen Werten, oder ein Datum verwendet das falsche Format. Prüfen Sie die obige Tabelle. |
| *Der Wert darf keine Winkelklammern (<, >) oder doppelten Anführungszeichen enthalten.* | Entfernen Sie diese Zeichen aus dem Promo-Code. |
| *Der Promo-Code existiert für dieses Programm bereits.* | Verwenden Sie einen Promo-Code, der in Ihrem Programm noch nicht vorhanden ist. |
| *Media-Partner \[ID] ist nicht der Kampagne \[ID] beigetreten* | Verwenden Sie die Media-ID eines Partners oder einer Media-Quelle, die Ihrem Programm beigetreten ist. |
| *Deal nicht gefunden* | Verwenden Sie die ID eines vorhandenen Deals, oder lassen Sie `deal.id` leer. |
| *Für geplante Promo-Code-Prozeduren wird nur CREATE unterstützt.* | Setzen Sie `Operation` auf `CREATE`. |
---
# 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/platform-features/promo-codes/bulk-upload-promo-codes.md?ask=&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.