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.
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.
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
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
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:
- Navigieren Sie im Kundenportal zu LiveOps > Werbeaktionen.
- Klicken Sie auf der Registerkarte Werbeaktionen auf Werbeaktion anlegen.
- Vergeben Sie einen Werbeaktionsnamen.
- Wählen Sie in der Drop-down-Liste Werbeaktionsart die Option Promocode aus.
- Geben Sie im Feld Externe ID eine Werbeaktion-ID an, mit der Werbeaktionen über API-Aufrufe verwaltet werden kann.
- So legen Sie einen Rabatt für einen Artikel oder den gesamten Warenkorb fest:
- Stellen Sie den Schalter Rabatt beim Kauf auf Ein.
- Geben Sie im Feld Rabattbetrag einen prozentualen Rabattwert an.
- So legen Sie einen Rabatt für einen bestimmten Artikel fest:
- Stellen Sie den Schalter Rabatt auf ausgewählte Artikel auf Ein.
- Geben Sie im Feld Rabattbetrag einen prozentualen Rabattwert an.
- 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.
- Wählen Sie die Artikel aus.
- So legen Sie Bonusartikel fest:
- Stellen Sie den Schalter Bonusartikel auf Ein.
- 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.
- Wählen Sie die Artikel aus, die beim Einlösen des Promocodes gewährt werden sollen.
- Bei virtuellen Gegenständen müssen Sie die Menge für jeden Gegenstand angeben.
- 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.
- Bei Spielschlüsseln müssen Sie angeben, wann die zugehörige Plattform festgelegt wird:
- Klicken Sie auf Weiter.
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.
- Konfiguration von Einlösungslimits für Promocodes:
- 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.
- 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.
- 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.
- Klicken Sie auf Weiter.
- 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.
- Klicken Sie auf Weiter.
- Überprüfen Sie die Kampagneneinstellungen.
- Klicken Sie auf Speichern und beenden.
So fügen Sie Promocodes einer Kampagne hinzu:
- Navigieren Sie im Kundenportal zu LiveOps > Werbeaktionen.
- Klicken Sie in der Zeile mit der gewünschten Promocode-Aktion auf •••, und wählen Sie in Drop-down-Liste die Option Werbeaktion bearbeiten.
- Wechseln Sie zur Registerkarte Codes.
- So generieren Sie Codes automatisch:
- Wählen Sie in der Drop-down-Liste Stringformat des Codes die Option Automatisch generiert aus.
- Legen Sie fest, wie viele Codes generiert werden sollen, und klicken Sie auf Generieren.
- So fügen Sie Codes manuell hinzu:
- Wählen Sie in der Drop-down-Liste Stringformat des Codes die Option Manuelle Eingabe aus.
- Geben Sie den Promocode ein, und klicken Sie auf Erstellen.
- Wiederholen Sie den vorherigen Schritt, bis die gewünschte Anzahl von Codes erreicht ist.
- Laden Sie die CSV-Datei mit den Codes herunter (optional).
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:
- Navigieren Sie im Kundenportal zu LiveOps > Werbeaktionen.
- Klicken Sie in der Zeile mit der gewünschten Promocode-Aktion auf •••, und wählen Sie in Drop-down-Liste die Option Werbeaktion bearbeiten.
- Wählen Sie oben rechts in der Drop-down-Liste die Option Werbeaktion aktivieren aus.
Über die API einrichten
- 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:
| Funktion | API-Aufruf |
|---|---|
| Promocode-Aktion erstellen | Promocode-Aktion erstellen |
| Promocode-Aktion aktivieren | Promocode-Aktion aktivieren |
| Werbeaktion bearbeiten | Promocode-Aktion aktualisieren, und zwar mit neuen Werbeaktionsoptionen. Auch Werbeaktionen mit dem Status Aktiv lassen sich bearbeiten. |
| Werbeaktion deaktivieren | Promocode-Aktion deaktivieren |
| Unbefristete Werbeaktion einrichten | Promocode-Aktion erstellen oder Promocode-Aktion aktualisieren. Übermitteln Sie den Parameter “date_end”: null an die jeweilige Methode. |
| Werbeaktion löschen | Promocode-Aktion löschen |
Promocodes in Ihrer Anwendung oder auf Ihrer Website einlösen
Promocodes auf Ihrer Benutzeroberfläche einlösen
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
Implementieren Sie eine Promocode-Logik mithilfe der folgenden clientseitigen API-Aufrufe:
| Funktion | API-Aufruf |
|---|---|
| Den Promocode auf Gültigkeit prüfen | Aktionscode verifizieren |
| Eine Liste der Spieledistributionsplattformen abrufen, die dem Nutzer angezeigt wird, wenn ein Spielschlüssel als Promocode-Bonus vergeben wird | Wird in der Antwort Auch bei Spielschlüsseln wird der Parameter |
| Aktualisierten Katalog anzeigen, in dem Rabatte und Bonusartikel aus einem Promocode berücksichtigt sind | Verwenden 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 |
| Promocode anwenden und den Warenkorbinhalt sowie die Gesamtkosten aktualisieren (Rabatte anwenden und Bonusartikel in den Warenkorb legen) | Übermitteln Sie den Promocode im Anfrageparameter |
- Stellen Sie sicher, dass die Artikel dem Nutzer beim Einlösen des Promocodes ordnungsgemäß gewährt werden.
- 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.
Promocodes auf mithilfe von Xsolla erstellten Websites einlösen
So blenden Sie das Code-Eingabefeld auf Ihrer Website ein:
- Öffnen Sie Ihr Projekt im Kundenportal, und navigieren Sie zum Menüpunkt Storefronts > Websites.
- Wählen Sie im Abschnitt Seiten die gewünschte Website aus, und klicken Sie auf Site Builder öffnen.
- 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.
- Wählen Sie den Promocodes-Block aus.
- 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.
- Damit die Änderungen wirksam werden, müssen Sie die Website veröffentlichen:
- Klicken Sie oben rechts im Site Builder auf Veröffentlichen.
- Aktivieren Sie die Kontrollkästchen neben den Seiten, die Sie veröffentlichen möchten.
- Klicken Sie auf Weiter.
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.
Haben Sie einen Tippfehler oder einen anderen Textfehler gefunden? Wählen Sie den Text aus und drücken Sie Strg+Eingabe.