Promocodes

So funktioniert's

Allgemeine Informationen

Promocode-Aktionen sind ein Marketinginstrument, das darauf abzielt, die Konversionsraten zu steigern und die durchschnittlichen Nutzerausgaben zu erhöhen. Wird ein Promocode auf eine Bestellung angewendet, kann der Nutzer Folgendes erhalten:

  • einen Rabatt, der auf den gesamten Einkauf oder auf bestimmte Artikel angewendet wird
  • Bonusartikel, z. B.:
    • virtuelle Währungspakete
    • Spielschlüssel
    • virtuelle Gegenstände
    • Bundles

Hauptmerkmale:

  • Flexible Bonuskonfiguration. Sie können einen einzelnen Bonustyp (Bonusartikel, Rabatt auf den Kauf, Rabatt auf ausgewählte Artikel) oder eine beliebige Kombination davon festlegen.
  • Wie oft der Promocode im Rahmen der Kampagne insgesamt eingelöst werden darf, ist festlegbar.
  • Wie oft ein Nutzer den Promocode im Rahmen der Kampagne einlösen darf, ist festlegbar.
  • Es lassen sich mehrere Promocodes generieren.
  • Kampagnen und Artikel, die mit einem Promocode verknüpft sind, lassen sich regional beschränken.
Hinweis
Wenn Sie eine Kampagne regional beschränken möchten, senden Sie uns eine E-Mail an igs@xsolla.com.

Einschränkungen:

  • Es kann nur ein Promocode auf den Kauf angewendet werden.
  • Um einen Rabatt oder einen Bonusartikel zu erhalten, muss der Nutzer den Kauf bezahlen.
  • Rabatte gelten nicht für Preise, die in virtueller Währung angegeben sind. Bei Artikeln, die sowohl in echter als auch in virtueller Währung angeboten werden, gelten Rabatte nur für den Preis in Echtwährung.
  • Wenn Spielschlüssel als Bonusartikel festgelegt sind, wird der Schlüssel nach dem Einlösen per E-Mail an den Nutzer oder an das Berechtigungssystem gesendet. Sollten die Schlüssel für die Kampagne bereits aufgebraucht sein, kann der Nutzer den Promocode nicht einlösen.
  • Wenn für eine Promocode-Kampagne regionale Beschränkungen festgelegt sind, können Nutzer aus den entsprechenden Regionen den Promocode nicht einlösen.
  • Enthält ein Promocode mindestens einen Bonusartikel mit einer regionalen Beschränkung, kann ein Nutzer aus dieser Region den Promocode nicht einlösen.
Beispiel: Löst man den Promocode ein, erhält man einen Schild und ein Schwert als Bonus. Der Schild unterliegt einer regionalen Verkaufsbeschränkung und kann nur in den USA erworben werden. Wenn ein Nutzer außerhalb der USA den Promocode eingibt, antwortet der Aufruf Aktionscode überprüfen oder Promocode einlösen mit einer Fehlermeldung. Der Nutzer erhält in diesem Fall keinen der Artikel aus dem Promocode.
Hinweis

Sie können auch Gutscheinaktionen für Ihr Shop einrichten.

Wesentliche Unterschiede:

  • Mit einem Gutschein kann ein Nutzer ausschließlich Bonusartikel erhalten. Ein Promocode hingegen kann Bonusartikel, einen Rabatt auf einen bestimmten Artikel oder einen Rabatt auf den gesamten Warenkorb gewähren.
  • Promocodes werden während des Bezahlvorgangs (an der Kasse) eingelöst, während Gutscheine erst eingelöst werden, nachdem der Nutzer den Code eingegeben und angewendet hat.

Ablauf für den Nutzer

Hinweis
Der Nutzer kann den angewendeten Promocode vor Abschluss der Zahlung stornieren.

Rabattregeln

Wenn für einen Artikel zum Zeitpunkt des Kaufs mehrere Werbeaktionen aktiv geschaltet sind, werden die Rabatte nacheinander auf den Artikel angewendet. Die Reihenfolge spielt dabei keine Rolle.

Beispiel:

Ein virtueller Gegenstand kostet 10 €. Im Kundenportal wurden für den virtuellen Gegenstand folgende Werbeaktionen erstellt:

  • Rabattaktion namens Black Friday mit einem Preisnachlass von 10 % vom 4. bis 30. November
  • Rabattaktion namens Sale mit einem Preisnachlass von 20 % vom 15. November bis 15. Dezember
  • Promocode-Aktion mit einem Preisnachlass von 5 % vom 4. bis 30. November

Wird der Artikel am 20. November gekauft, sind sowohl die beiden Rabattaktionen als auch die Promocode-Aktion aktiv.

Der Endpreis des virtuellen Gegenstands berechnet sich wie folgt: ((10 € - 10 %) - 20 %) - 5 % = 10 € × (100 % - 10 %) × (100 % - 20 %) × (100 % - 5 %) = 10 € × 0,9 × 0,8 × 0,95 = 6,84 €.

Kampagne mit Promocodes einrichten

Hinweis

Wenn Sie eine Werbeaktion mit Bonusartikeln erstellen möchten, müssen Sie zunächst diese Artikel konfigurieren und anschließend Werbeaktion einrichten.

Navigieren Sie in Ihrem Kundenportal-Projekt zum Menüpunkt Artikelkatalog > Alle Artikel, um Artikel manuell zu erstellen. Ausführliche Informationen zu dieser und anderen Methoden zum Erstellen von Artikeln finden Sie im Abschnitt Artikelkatalog der Dokumentation.

Im Kundenportal einrichten

So erstellen Sie eine neue Promocode-Kampagne:

  1. Navigieren Sie im Kundenportal zu LiveOps > Werbeaktionen.
  2. Klicken Sie auf der Registerkarte Werbeaktionen auf Werbeaktion anlegen.
  1. Vergeben Sie einen Werbeaktionsnamen.
  2. Wählen Sie in der Drop-down-Liste Werbeaktionsart die Option Promocode aus.
  3. Geben Sie im Feld Externe ID eine Werbeaktion-ID an, mit der Werbeaktionen über API-Aufrufe verwaltet werden kann.
  4. So legen Sie einen Rabatt für einen Artikel oder den gesamten Warenkorb fest:

    1. Stellen Sie den Schalter Rabatt beim Kauf auf Ein.
    1. Geben Sie im Feld Rabattbetrag einen prozentualen Rabattwert an.

  1. So legen Sie einen Rabatt für einen bestimmten Artikel fest:

    1. Stellen Sie den Schalter Rabatt auf ausgewählte Artikel auf Ein.
    1. Geben Sie im Feld Rabattbetrag einen prozentualen Rabattwert an.
    1. Wählen Sie in der Drop-down-Liste Artikeltyp den Artikeltyp aus, für den beim Einlösen des Promocodes ein Rabatt gewährt werden soll.
    1. Wählen Sie die Artikel aus.

  1. So legen Sie Bonusartikel fest:

    1. Stellen Sie den Schalter Bonusartikel auf Ein.
    1. Wählen Sie in der Drop-down-Liste Bonusartikel auswählen den Artikeltyp aus, der einem Nutzer beim Einlösen des Promocodes gewährt werden soll.
    1. Wählen Sie die Artikel aus, die beim Einlösen des Promocodes gewährt werden sollen.
    1. Bei virtuellen Gegenständen müssen Sie die Menge für jeden Gegenstand angeben.
    1. Bei Spielschlüsseln müssen Sie angeben, wann die zugehörige Plattform festgelegt wird:
      • Um eine bestimmte Plattform (z. B. Steam) vorab zuzuweisen, wählen Sie aus der Drop-down-Liste Auswahl des DRM-Typs die Option DRM bei der Code-Generierung auswählen aus. Anschließend müssen Sie die Plattform aus der Drop-down-Liste DRM auswählen.
      • Um dem Nutzer die Auswahl zu überlassen, wählen Sie aus der Drop-down-Liste Auswahl des DRM-Typs die Option Spieler wählt DRM bei der Einlösung aus aus.
    1. Klicken Sie auf Weiter.

Hinweis

Der Rabatt auf eine Bestellung oder einen bestimmten Artikel muss als Ganzzahl angegeben werden und darf maximal 99 % betragen. Beachten Sie bei der Konfiguration von Rabatten auf bestimmte Artikel oder Bonusartikel Folgendes:

  • Sie können einen Artikeltyp nur auswählen, wenn Sie mindestens einen Artikel dieses Typs in Ihrem Projekt erstellt haben.
  • Sie können Artikel unterschiedlichen Typs konfigurieren. Verwenden Sie das Artikeltyp-Auswahlfeld, um zwischen den Artikeltypen zu wechseln.
  1. Konfiguration von Einlösungslimits für Promocodes:

    1. Wenn Sie begrenzen möchten, wie oft Promocode im Rahmen der Kampagne insgesamt eingelöst werden dürfen, stellen Sie den Schalter Gesamtanzahl der Eineinlösungen begrenzen auf Ein und legen Sie das Limit fest.
    1. Wenn Sie begrenzen möchten, wie oft ein bestimmter Nutzer Promocodes im Rahmen der Kampagne einlösen darf, stellen Sie den Schalter Gesamtanzahl der Einlösungen pro Benutzer begrenzen auf Ein und legen Sie das Limit fest.
    1. Wenn Sie begrenzen möchten, wie oft ein bestimmter Promocode im Rahmen der Kampagne insgesamt eingelöst werden darf, stellen Sie den Schalter Anzahl von Einlösungen pro Promocode beschränken auf Ein und legen Sie das Limit fest.
    1. Klicken Sie auf Weiter.

  1. Legen Sie den Gültigkeitszeitraum der Kampagne fest: Zeitzone, Start- und Enddatum. Um eine Kampagne ohne Enddatum zu erstellen, müssen Sie das Kontrollkästchen Kein Enddatum aktivieren.
  2. Klicken Sie auf Weiter.
  3. Überprüfen Sie die Kampagneneinstellungen.
  4. Klicken Sie auf Speichern und beenden.

So fügen Sie Promocodes einer Kampagne hinzu:

  1. Navigieren Sie im Kundenportal zu LiveOps > Werbeaktionen.
  2. Klicken Sie in der Zeile mit der gewünschten Promocode-Aktion auf •••, und wählen Sie in Drop-down-Liste die Option Werbeaktion bearbeiten.
  1. Wechseln Sie zur Registerkarte Codes.
  2. So generieren Sie Codes automatisch:
    1. Wählen Sie in der Drop-down-Liste Stringformat des Codes die Option Automatisch generiert aus.
    1. Legen Sie fest, wie viele Codes generiert werden sollen, und klicken Sie auf Generieren.
  1. So fügen Sie Codes manuell hinzu:
    1. Wählen Sie in der Drop-down-Liste Stringformat des Codes die Option Manuelle Eingabe aus.
    1. Geben Sie den Promocode ein, und klicken Sie auf Erstellen.
    1. Wiederholen Sie den vorherigen Schritt, bis die gewünschte Anzahl von Codes erreicht ist.
  1. Laden Sie die CSV-Datei mit den Codes herunter (optional).
Hinweis

Bei Promocodes wird zwischen Groß- und Kleinschreibung unterschieden. Beispielsweise werden winter123 und WINTER123 als unterschiedliche Promocodes behandelt.

Sie können einer Kampagne beliebig oft neue Codes hinzufügen. Die Gesamtzahl der auf einmal hinzugefügten Codes darf jedoch 50.000 nicht überschreiten.

Wenn Sie eine große Anzahl selbst generierter Codes hochladen müssen, senden Sie uns eine E-Mail an igs@xsolla.com.

Damit die Kampagne für die Nutzer verfügbar ist, müssen Sie sie aktivieren. Gehen Sie dazu wie folgt vor:

  1. Navigieren Sie im Kundenportal zu LiveOps > Werbeaktionen.
  2. Klicken Sie in der Zeile mit der gewünschten Promocode-Aktion auf •••, und wählen Sie in Drop-down-Liste die Option Werbeaktion bearbeiten.
  3. Wählen Sie oben rechts in der Drop-down-Liste die Option Werbeaktion aktivieren aus.

Über die API einrichten

Hinweis
Wenn Sie eine Werbeaktion über die API konfigurieren, können Sie den Rabattbetrag als Dezimalzahl angeben.
Achtung
Die Liste der Parameter, die bei der Verwendung der API-Aufrufe zum Aktualisieren von Werbeaktionen erforderlich sind, unterscheidet sich von der Liste der Parameter, die von den API-Aufrufen zum Abrufen von Werbeaktionen zurückgegeben werden. Beim Aufruf der API-Methoden zum Aktualisieren von Werbeaktionen müssen Sie Folgendes übermitteln:
  • die erforderlichen Parameter
  • die zu ändernden Parameter
  • alle sonstigen Parameter, die von der Werbeaktionen-abrufen-Aufruf zurückgegeben werden

Zur Einrichtung und Verwaltung von Promocode-Aktionen über die API verwenden Sie bitte die folgenden Aufrufe:

FunktionAPI-Aufruf
Promocode-Aktion erstellenPromocode-Aktion erstellen
Promocode-Aktion aktivierenPromocode-Aktion aktivieren
Werbeaktion bearbeitenPromocode-Aktion aktualisieren, und zwar mit neuen Werbeaktionsoptionen. Auch Werbeaktionen mit dem Status Aktiv lassen sich bearbeiten.
Werbeaktion deaktivierenPromocode-Aktion deaktivieren
Unbefristete Werbeaktion einrichtenPromocode-Aktion erstellen oder Promocode-Aktion aktualisieren. Übermitteln Sie den Parameter “date_end”: null an die jeweilige Methode.
Werbeaktion löschenPromocode-Aktion löschen
Hinweis
Wenn Sie eine aktive Werbeaktion deaktivieren oder löschen, können Nutzer diese nicht mehr in Anspruch nehmen.

Promocodes in Ihrer Anwendung oder auf Ihrer Website einlösen

Promocodes auf Ihrer Benutzeroberfläche einlösen

  1. Implementieren Sie auf Ihrer Anwendungsoberfläche (im Katalog oder Warenkorb) die folgenden Elemente:

    • ein Promocode-Eingabefeld
    • UI-Elemente für die Anzeige der durch Promocodes gewährten Belohnungen und Rabatte
    • eine Auswahlmaske für Promocode-Belohnungen (falls zutreffend)
    • eine Schaltfläche, über die man den Promocode anwendet
  2. Implementieren Sie eine Promocode-Logik mithilfe der folgenden clientseitigen API-Aufrufe:

Hinweis
Um die Xsolla-API aufzurufen, können Sie die vorgefertigten SDK-Methoden für Spiel-Engines und Plattformen verwenden:
FunktionAPI-Aufruf
Den Promocode auf Gültigkeit prüfenAktionscode verifizieren
Eine Liste der Spieledistributionsplattformen abrufen, die dem Nutzer angezeigt wird, wenn ein Spielschlüssel als Promocode-Bonus vergeben wird

Promocode-Belohnung abrufen

Wird in der Antwort is_selectable=true zurückgegeben, müssen Sie für jeden Artikel mit dem Parameter type=unit eine Auswahlmaske für die Elemente im Objekt unit_items anzeigen. In dieser Maske kann der Nutzer pro unit-Type nur ein Element auswählen.

Auch bei Spielschlüsseln wird der Parameter type=unit übermittelt. In diesem Fall muss der Nutzer eine Spieleplattform auswählen.

Aktualisierten Katalog anzeigen, in dem Rabatte und Bonusartikel aus einem Promocode berücksichtigt sindVerwenden Sie die Aufrufe aus dem Unterabschnitt Katalog. Sie müssen den Promocode im Anfrageparameter promo_code übermitteln.
Bestimmten Artikel direkt kaufen (ohne ihn in den Warenkorb zu legen) und Promocode einlösen

Bestellung mit angegebenem Artikel anlegen

Übermitteln Sie den Promocode im Anfrageparameter promo_code.

Promocode anwenden und den Warenkorbinhalt sowie die Gesamtkosten aktualisieren (Rabatte anwenden und Bonusartikel in den Warenkorb legen)

Promocode einlösen

Übermitteln Sie den Promocode im Anfrageparameter coupon_code.

Hinweis
Um darüber hinaus zu überprüfen, wie oft ein Nutzer im Rahmen der Kampagne einen Promocode noch einlösen kann, verwenden Sie den serverseitigen API-Aufruf Promocode-Limit für den angegebenen Benutzer abrufen.
  1. Stellen Sie sicher, dass die Artikel dem Nutzer beim Einlösen des Promocodes ordnungsgemäß gewährt werden.
  1. Wenn Sie bereits einen Ingame-Shop in Ihrer Anwendung oder auf Ihrer Website implementiert haben, ist keine zusätzliche Einrichtung erforderlich. Mit einem Promocode verknüpfte Artikel werden dem Nutzer auf die gleiche Weise wie bei einem Standardkauf gewährt.
Hinweis
Spielschlüssel werden dem Nutzer per E-Mail oder an das Berechtigungssystem gesendet.

Promocodes auf mithilfe von Xsolla erstellten Websites einlösen

Achtung
Die Funktion, Gutscheine und Promocodes einzulösen, kann nur Websites hinzugefügt werden, die mit der Web Shop-Vorlage erstellt wurden.

So blenden Sie das Code-Eingabefeld auf Ihrer Website ein:

  1. Öffnen Sie Ihr Projekt im Kundenportal, und navigieren Sie zum Menüpunkt Storefronts > Websites.
  2. Wählen Sie im Abschnitt Seiten die gewünschte Website aus, und klicken Sie auf Site Builder öffnen.
  3. Wählen Sie im Hauptfenster des Baukastens eine Stelle, an der Sie einen neuen Block hinzufügen möchten, und klicken Sie auf Block hinzufügen.
  4. Wählen Sie den Promocodes-Block aus.
  5. Passen Sie das Erscheinungsbild des Blocks an (optional):
    • Bearbeiten Sie die Überschrift und die Beschreibung.
    • Legen Sie einen eigenen Hintergrund für den Block fest.
    • Ändern Sie den Schaltflächenstil.
    • Bearbeiten Sie den Schaltflächentext.
  6. Damit die Änderungen wirksam werden, müssen Sie die Website veröffentlichen:

    1. Klicken Sie oben rechts im Site Builder auf Veröffentlichen.
    1. Aktivieren Sie die Kontrollkästchen neben den Seiten, die Sie veröffentlichen möchten.
    1. Klicken Sie auf Weiter.

Hinweis

Sollte eine Veröffentlichung der Website nicht möglich sein, stellen Sie bitte sicher, dass alle folgenden Bedingungen erfüllt sind:

  • Keine leeren Abschnitte im Baukasten vorhanden (gekennzeichnet durch einen roten Punkt).
  • Xsolla-Lizenzvereinbarung ist unterzeichnet.
  • Die Hauptseite muss bereits veröffentlicht oder zur Veröffentlichung ausgewählt sein. Es ist nicht möglich, Unterseiten vor der Hauptseite zu veröffentlichen.
War dieser Artikel hilfreich?
Vielen Dank!
Gibt es etwas, das wir verbessern können? Nachricht
Das tut uns leid
Bitte erläutern Sie, weshalb dieser Artikel nicht hilfreich ist. Nachricht
Vielen Dank für Ihr Feedback!
Wir werden Ihr Feedback aufgreifen und dazu nutzen, Ihr Erlebnis verbessern.
Letztmalig aktualisiert: 13. Februar 2026

Haben Sie einen Tippfehler oder einen anderen Textfehler gefunden? Wählen Sie den Text aus und drücken Sie Strg+Eingabe.

Problem melden
Wir überprüfen unsere Inhalte ständig. Ihr Feedback hilft uns, sie zu verbessern.
Geben Sie eine E-Mail-Adresse an, damit wir Sie erreichen können
Vielen Dank für Ihr Feedback!
Ihr Feedback konnte nicht gesendet werden
Versuchen Sie es später erneut oder kontaktieren Sie uns unter doc_feedback@xsolla.com.