Promocodes und Gutscheine

Promocodes

Promocode- und Gutscheinaktionen sind Marketinginstrumente, bei denen Nutzer Codes einlösen und im Gegenzug Bonusartikel erhalten. Nutzer können den Promocode in ein spezielles Feld im Katalog eingeben und einlösen.

Promocodes, die zum Zeitpunkt des Kaufs eingelöst werden können, und Gutscheine – nachdem der Nutzer einen Code eingegeben hat.

Bei jeder Authentifizierungsart (Benutzer-ID oder Xsolla Login) lässt sich eine Personalisierung einrichten.

Ablauf für den Nutzer

  1. Der Nutzer gelangt zur Landingpage, auf der sich der Promocodes-Block befindet.

  1. Der Nutzer klickt auf Anmelden, und autorisiert sich per Benutzer-ID oder Xsolla Login.
  2. Der Nutzer gibt den Code in das entsprechende Feld auf der Benutzeroberfläche ein und klickt auf die Schaltfläche rechts neben dem Feld.

  1. Es öffnet sich ein Modalfenster:
    • mit Informationen über Rabatte und Boni, wenn ein Promocode aktiviert wird;
    • mit Informationen über Rabatte und Boni, die der Benutzer bereits erhalten hat, wenn ein Gutschein eingelöst wird.
Hinweis
Wurde ein falscher Code eingegeben, erscheint unter dem Feld eine Fehlermeldung.
Beispiel: Der Code wurde zu oft eingelöst.

  1. Bei Promocode-Aktionen:
    1. Es wird ein aktualisierter Katalog mit dem Promocode zugeordneten Rabatten und Bonusartikeln angezeigt.

Löscht der Nutzer den Aktionscode vor dem Kauf, wird der Katalog aktualisiert und ohne Rabatte und mit dem Promocode verknüpfte Boni angezeigt. In diesem Fall wird der Promocode als nicht eingelöst betrachtet.

    1. Der Nutzer kauft etwas, danach wird der Promocode als eingelöst betrachtet.

Wenn dem Promocode Bonusartikel beigefügt sind, werden diese dem Nutzer gutgeschrieben.

Wie komme ich dazu

So fügen Sie Ihrer Website einen Block zum Einlösen eines Codes hinzu:

Ausführliche Informationen zum Einrichten von Gutscheinen und Promocodes finden Sie auf der entsprechenden Registerkarte im Abschnitt So funktioniert’s.

Promocode-Werbeaktionen ermöglichen es Nutzern, Artikel mit einem Rabatt zu kaufen und Bonusartikel zu erhalten, die in der Werbeaktion konfiguriert sind. Das Feld zur Eingabe eines Promocodes kann im Katalog oder im Warenkorb angezeigt werden. Pro Kauf kann nur ein Promocode angewendet werden.

Achtung

Sie können verschiedene Arten von Werbeaktionen für einen Artikel einrichten: Rabatte, Promocodes und Boni.

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:

Der Preis eines virtuellen Gegenstands beträgt 10 $. Im Kundenportal wurden folgende Werbeaktionen für die virtuellen Gegenstände erstellt:

  • Black Friday Rabattaktion mit einem Rabatt von 10 % vom 4. bis 30. November
  • Sale Rabattaktion mit einem Rabatt von 20 % vom 15. November bis 15. Dezember
  • Werbeaktion mit einem Promocode für einen Rabatt 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 % und beträgt 6,84 $.

Neue Promocode-Werbeaktion erstellen

Um eine Promocode-Werbeaktion zu erstellen:

  1. Gehen Sie in Ihrem Projekt im Kundenportal zum Abschnitt LiveOps > Canvas.
  1. Öffnen Sie das Projekt in Ihrem Konto für Handyspiele und gehen Sie zum Abschnitt Operation > LiveOps.
  1. Beginnen Sie mit der Erstellung einer Aktion auf eine der folgenden Arten:
    • Option 1:
      1. Klicken Sie in der Symbolleiste auf das  Symbol.
      2. Klicken Sie im Bereich der Aktionsliste auf das +-Symbol.
      1. Wählen Sie Promocodes und klicken Sie auf Erstellen.
    • Option 2: Klicken Sie in der Symbolleiste auf das +-Symbol und wählen Sie Promocodes.
    • Option 3: Öffnen Sie das Kontextmenü irgendwo auf der Leinwand und wählen Sie Promocodes.
  1. Geben Sie die Grundeinstellungen an:
    • Name der Werbeaktion.
    • Externe ID — eine eindeutige Werbeaktions-ID, die zur Verwaltung von Werbeaktionen über API-Aufrufe verwendet wird.
  2. Definieren Sie, wann der Nutzer einen Promocode einlösen kann, indem Sie eine der Optionen im Einlösungszeitraum-Feld auswählen:
    • Vor dem Kauf — der Promocode kann ohne Kauf eingelöst werden. In diesem Fall kann der Nutzer nur Bonusartikel erhalten. Rabatteinstellungen sind für diese Option nicht verfügbar.
    • Jederzeit — der Promocode kann nur während eines Kaufs eingelöst werden. In diesem Fall kann der Nutzer Bonusartikel, Rabatte auf bestimmte Artikel und/oder einen Rabatt auf den gesamten Warenkorb erhalten.
  3. Bonusartikel hinzufügen:
    1. Setzen Sie den Bonusartikel-Schalter auf aktiv.
    2. Klicken Sie auf Artikel auswählen.
    3. Markieren Sie im sich öffnenden Fenster die Kästchen neben den gewünschten Artikeln und geben Sie deren Menge an.
    4. Klicken Sie auf Artikel hinzufügen.
  1. Um einen Rabatt auf den gesamten Kauf hinzuzufügen (optional, nicht verfügbar für den Einlösungstyp Vor dem Kauf):
    1. Setzen Sie den Rabatt auf gesamten Kauf anwenden-Schalter auf aktiv.
    2. Geben Sie den Rabattprozentsatz an.
  2. Um einen Rabatt auf bestimmte Artikel hinzuzufügen (optional, nicht verfügbar für den Einlösungstyp Vor dem Kauf):
    1. Setzen Sie den Rabatt nur auf ausgewählte Artikel anwenden-Schalter auf aktiv.
    2. Geben Sie den Rabattprozentsatz an.
    3. Klicken Sie auf Artikel auswählen.
    4. Markieren Sie im sich öffnenden Fenster die Kästchen neben den gewünschten Artikeln.
    5. Klicken Sie auf Artikel hinzufügen.
  1. Klicken Sie auf Weiter.
  2. Fügen Sie Bedingungen und Einschränkungen hinzu (optional):
    1. Um die Gesamtanzahl der Promocode-Einlösungen zu begrenzen, setzen Sie den Promocode-Einlösungsgrenze-Schalter auf aktiv und geben Sie die erforderliche Anzahl ein.
    2. Um die Anzahl der Einlösungen pro Nutzer zu begrenzen, setzen Sie den Promocode-Einlösungsgrenze pro Nutzer-Schalter auf aktiv und geben Sie die erforderliche Anzahl ein.
    3. Um die Anzahl der Einlösungen pro einzigartigem Promocode zu begrenzen, setzen Sie den Einzigartige Promocode-Einlösungen-Schalter auf aktiv und geben Sie die erforderliche Anzahl ein.
  3. Klicken Sie auf Weiter.
  4. Geben Sie den Zeitraum der Werbeaktion an.
  5. Klicken Sie auf Weiter.
  6. Überprüfen Sie die Einstellungen der Werbeaktion.
  7. Um die Werbeaktion sofort zu aktivieren (optional), setzen Sie den Im aktiven Status erstellen-Schalter auf aktiv.
  8. Klicken Sie auf Erstellen.
  1. Um die erstellte Promocode-Werbeaktion zur Website hinzuzufügen (optional):
    1. Öffnen Sie die Website im Builder, indem Sie auf Öffnen oder Im Site Builder öffnen im Banner im Bearbeitungsformular klicken.
    2. Befolgen Sie die Anweisungen im Abschnitt Promocode-Nutzung in Ihrer Anwendung oder Website einrichten.

Promocode-Werbeaktionen werden standardmäßig im deaktivierten Zustand erstellt und enthalten keine Promocodes zur Einlösung.

Auf der Leinwand werden visuelle Links zwischen der Werbekarte und den Artikeln in der Werbeaktion angezeigt.

Um deren Anzeige zu verwalten, klicken Sie auf das - oder -Symbol rechts von der Artikelkarte, neben dem  Symbol. Wenn ein Artikel in mehreren Werbeaktionen enthalten ist, kann nur ein Link gleichzeitig angezeigt werden.

Hinweis

Beim Einrichten einer Aktion über die Leinwand sind die folgenden Optionen nicht verfügbar:

  • Einrichten einer Werbeaktion mit Spielschlüsseln.
  • Festlegen eines Rabatts mit Bruchteilen von Prozenten.
  • Einrichten einer Werbeaktion ohne Enddatum.

Erweiterte Optionen zur Konfiguration von Promocode-Werbeaktionen sind über das Kundenportal und API-Aufrufe verfügbar.

Promocodes hinzufügen

Um Promocodes zur Werbeaktion hinzuzufügen:

  1. Öffnen Sie die Werbeaktion zur Bearbeitung.
  1. Klicken Sie auf Promocodes hinzufügen.
  2. Fügen Sie die erforderliche Anzahl von Promocodes hinzu:
    • Um Promocodes automatisch zu generieren:
      1. Wählen Sie Automatisch generiert und geben Sie die Anzahl der Promocodes an.
      2. Klicken Sie auf Generieren.
    • Um einen Promocode manuell hinzuzufügen:
      1. Wählen Sie Manuell eingegeben.
      2. Klicken Sie auf Erstellen.
Hinweis
Bei Promocodes wird zwischen Groß- und Kleinschreibung unterschieden. Beispielsweise sind winter2021 und WINTER2021 unterschiedliche Promocodes.
  1. Um eine Datei mit der Promocode-Liste zu exportieren (optional), klicken Sie auf CSV herunterladen.

Werbeaktion aktivieren

Sie können die Werbeaktion auf folgende Weise aktivieren:

  • Von der Werbeaktionskarte aus:
  • Aus der Werbeaktionsliste:
  • Während der Bearbeitung der Werbeaktion:
Hinweis
Aktive Werbeaktionen können nicht bearbeitet werden. Um die Einstellungen einer Werbeaktion zu ändern, deaktivieren Sie sie zuerst.

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:
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.
  1. Öffnen Sie das Projekt in Ihrem Konto und gehen Sie zum Abschnitt Web Shop.
  2. Wählen Sie im Abschnitt Seiten die gewünschte Website aus, und klicken Sie auf Site Builder öffnen.
  1. Wenn Ihre Website mehrere Seiten umfasst, wählen Sie die gewünschte Seite aus:
    1. Klicken Sie oben im Editor auf den Titel der aktuellen Seite.
    2. Wählen Sie die gewünschte Seite aus der Drop-down-Liste aus.
  2. 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.
  3. Wählen Sie den Promocodes-Block aus.
  4. 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.
Hinweis
Die Schaltfläche, über die man Gutscheine einlöst oder Promocodes aktiviert, ist standardmäßig beschriftet mit: Einlösen. Wenn Sie diesen Text ändern möchten, doppelklicken Sie darauf und geben Sie den gewünschten Text ein.
  1. 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: 24. August 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 [email protected].