English (US)
Mit nur einer CSV-Datei können Sie eine Gutscheinliste für Ihre Apps und mobile Website erstellen und importieren.
Um in Ihrem Shopgate-Adminbereich manuell einen mobilen Gutschein zu erstellen, lesen Sie den Support-Artikel "Gutscheine einrichten".
Eine CSV-Datei für Gutscheine erstellen
Bei der Erstellung einer ".csv"-Datei für Ihre Gutscheine müssen Sie stets die Dateistruktur im Auge behalten. Hierfür haben Sie zwei Möglichkeiten:
|
1. Gutscheine als CSV-Datei exportieren |
Viele Shopsysteme stellen diese Option zur Verfügung. Prüfen Sie die Datei und ändern Sie diese gegebenenfalls so ab, dass sie den nachfolgenden Regeln und Strukturen entspricht. |
|
2. Eine CSV-Datei manuell erstellen |
Nutzen Sie ein Tabellenprogramm wie LibreOffice. Hier ist eine Beispieldatei zur Orientierung. Beachten Sie, dass Sie die Spalten nur mit Semikolons (;) trennen können. |
Generelle Regeln
Bitte beachten Sie die folgenden Regeln zur Erstellung einer CSV-Datei:
- Die Datei muss in UTF-8 kodiert sein.
- Jede Reihe enthält nur die Daten eines Gutscheins.
- Reihen müssen durch einen Zeilenumbruch (\n) (UNIX-Textformat) getrennt werden.
- Nutzen Sie Anführungszeichen ("), um Spaltengrenzen anzuzeigen (Texttrennzeichen).
- Alle Gutscheincodes müssen einmalig sein.
- Speichern Sie Ihre Datei im ".csv"-Format.
- Exportieren Sie Ihre Textdatei und achten Sie darauf, das korrekte Trennzeichen zu verwenden (Kommata, Doppelpunkte, Semikolons, Leerzeichen oder Tabe)
Die CSV-Struktur
Um sicherzustellen, dass das Datenbankprogramm von Shopgate Ihre Gutscheine korrekt importiert, folgen Sie der Dateistruktur in der Tabelle:
| Spaltenname | Beschreibung | Beispiel | |
| 1 | code | Jeder Gutschein muss einen einmaligen Code haben. Interpunktion und Symbole sind nicht erlaubt. Einzige Ausnahme: Bindestriche (-). | ABC123 |
| 2 | item_number | Eine Artikelnummer ist für jeden Gutschein notwendig. Sie können den Standardwert "COUPON" verwenden. | COUPON |
| 3 | public_name | Dies ist der Name des Gutscheins, der im Warenkorb und auf der Rechnung angezeigt wird. | Coupon x |
| 4 | description | Interne Beschreibung oder Kommentare zu dem Gutschein. | Comment |
| 5 | amount | Der Wert des Gutscheins. | 50,00 |
| 6 | currency | Der Währungscode des Gutscheins. | USD, EUR, GBP, CHF |
| 7 | discount_percent | Der Prozentsatz des Rabattwerts (nicht auf die Versandkosten anwendbar), keine Dezimalstellen. | 10 |
| 8 | is_free_shipping | Geben Sie "1" ein, um den kostenlosen Versand für diesen Gutschein zu aktivieren. | 1 or 0 |
| 9 | minimum_order_amount | Mindestbestellwert, um diesen Gutschein zu verwenden.
WICHTIG: Der Wert muss "0" bzw. höher als der Wert des Gutscheins sein.
|
50,00 |
| 10 | valid_from | Der Gutschein ist ab diesem Datum gültig. Verwenden Sie das Format JJJJ-MM-TT. | JJJJ-MM-TT, z. B. 2012-01-24 |
| 11 | valid_to | Der Gutschein ist bis zu diesem Datum gültig. Verwenden Sie das Format JJJJ-MM-TT. | JJJJ-MM-TT, z. B. 2012-06-24 |
| 12 | is_valid_iphone_app | Geben Sie "1" ein, um den Gutschein für die iPhone-App zuzulassen. | 1 oder 0 |
| 13 | is_valid_ipad_app | Geben Sie "1" ein, um den Gutschein für die iPad-App zuzulassen. | 1 oder 0 |
| 14 | is_valid_android_app | Geben Sie "1" ein, um den Gutschein für die Android-App zuzulassen. | 1 oder 0 |
| 15 | is_valid_wp_app | Geben Sie "1" ein, um den Gutschein für die Windows-App zu erlauben.
Nicht mehr aktiv – geben Sie entweder "1" oder "0" ein.
|
1 oder 0 |
| 16 | is_valid_webapp | Gültig für die mobile Website. | 1 oder 0 |
| 17 | is_valid_marketplace | Gültig für den Shopgate-Marktplatz.
Nicht mehr aktiv – geben Sie entweder "1" oder "0" ein.
|
1 oder 0 |
| 18 | is_valid_standalone | Gültig für Ihre iOS- oder Android-App. | 1 oder 0 |
| 19 | restricted_item_numbers | Beschränken Sie Ihren Gutschein auf die hier gelistete(n) Artikelnummer(n). Trennen Sie jede Artikelnummer mit einem "||". Lassen Sie das Feld frei, wenn Sie den Gutschein für alle Produkte erlauben möchten. | 987654||123456 oder leer |
| 20 | excluded_item_numbers | Schließen Sie die hier aufgelistete(n) Artikelnummer(n) von Ihrem Gutschein aus. Trennen Sie jede Artikelnummer mit einem "||". Lassen Sie das Feld frei, wenn Sie den Gutschein für alle Produkte erlauben möchten. | 123456red||123456blue oder leer |
| 21 | restricted_category_numbers | Beschränken Sie Ihren Gutschein auf die hier gelistete(n) Kategorienummer(n). Trennen Sie jede Kategorie mit einem "||". Lassen Sie das Feld frei, wenn Sie den Gutschein für alle Kategorien erlauben möchten. | 159||753 oder leer |
| 22 | excluded_category_numbers | Schließen die hier aufgelistete(n) Kategorienummer(n) von Ihrem Gutschein aus. Trennen Sie jede Kategorie mit einem "||". Lassen Sie das Feld frei, wenn Sie den Gutschein für alle Kategorien erlauben möchten. | 159men||753men oder leer |
| 23 | restricted_country_ids | Beschränken Sie Ihren Gutschein auf hier gelistete(n) Ländercode(s). Trennen Sie jedes Land mit einem "||". Lassen Sie das Feld frei, um den Gutschein in allen Ländern anzuwenden. | us||de||fr oder leer |
| 24 | redeem_limit | Legen Sie fest, wie Ihre Kunden den Gutschein einlösen können: Der Gutschein kann nur einmal, einmal pro Kunde oder unbegrenzt pro Kunde eingelöst werden. | 'unlimited', 'once_per_user', 'once' |
| 25 | is_promote | Stellen Sie ein, ob der Gutschein in einer öffentlichen Liste angezeigt werden soll.
Nicht mehr aktiv, geben Sie entweder "0" oder "1" ein.
|
1 oder 0 |
| 26 | is_active | Geben Sie "1" ein, um den Gutschein zu aktivieren. | 1 oder 0 |
Im Anhang des Artikels (ganz unten) finden Sie eine Muster-CSV-Datei.
Die CSV-Datei hochladen
Um die erstellte CSV-Datei hochzuladen, loggen Sie sich in Ihren Shopgate-Adminbereich ein.
- Navigieren Sie zu Marketing → Gutscheine.
- Klicken Sie dort auf Gutscheine importieren, um auf die Seite für den Import zu gelangen.
- Gehen Sie zu Datei auswählen, um die CSV-Datei hochzuladen. Anschließend klicken Sie auf Speichern.
- Die Gutscheine sollten jetzt in der Gutscheinliste erscheinen. Prüfen Sie, ob die Details korrekt sind. Möchten Sie Änderungen vornehmen, aktualisieren Sie die CSV-Datei und laden Sie diese erneut hoch.