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.

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

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.

3. Vergeben Sie einen Werbeaktionsnamen.
4. Wählen Sie in der Drop-down-Liste Werbeaktionsart die Option Promocode aus.
5. Geben Sie im Feld Externe ID eine Werbeaktion-ID an, mit der Werbeaktionen über API-Aufrufe verwaltet werden kann.
6. So legen Sie einen Rabatt für einen Artikel oder den gesamten Warenkorb fest:

1. 1. Stellen Sie den Schalter Rabatt beim Kauf auf Ein.

1. 2. Geben Sie im Feld Rabattbetrag einen prozentualen Rabattwert an.

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

1. 1. Stellen Sie den Schalter Rabatt auf ausgewählte Artikel auf Ein.

1. 2. Geben Sie im Feld Rabattbetrag einen prozentualen Rabattwert an.

1. 3. 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. 4. Wählen Sie die Artikel aus.

8. So legen Sie Bonusartikel fest:

1. 1. Stellen Sie den Schalter Bonusartikel auf Ein.

1. 2. 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. 3. Wählen Sie die Artikel aus, die beim Einlösen des Promocodes gewährt werden sollen.

1. 1. Bei virtuellen Gegenständen müssen Sie die Menge für jeden Gegenstand angeben.

1. 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. 4. Klicken Sie auf Weiter.

9. Konfiguration von Einlösungslimits für Promocodes:

1. 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. 2. 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. 3. 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. 4. Klicken Sie auf Weiter.

10. 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.
11. Klicken Sie auf Weiter.
12. Überprüfen Sie die Kampagneneinstellungen.
13. 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.

3. Wechseln Sie zur Registerkarte Codes.
4. So generieren Sie Codes automatisch:

1. 1. Wählen Sie in der Drop-down-Liste Stringformat des Codes die Option Automatisch generiert aus.

1. 2. Legen Sie fest, wie viele Codes generiert werden sollen, und klicken Sie auf Generieren.

5. So fügen Sie Codes manuell hinzu:

1. 1. Wählen Sie in der Drop-down-Liste Stringformat des Codes die Option Manuelle Eingabe aus.

1. 2. Geben Sie den Promocode ein, und klicken Sie auf Erstellen.

1. 3. Wiederholen Sie den vorherigen Schritt, bis die gewünschte Anzahl von Codes erreicht ist.

6. Laden Sie die CSV-Datei mit den Codes herunter (optional).

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

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

Promocodes in Ihrer Anwendung oder auf Ihrer Website einlösen

Promocodes auf Ihrer Benutzeroberfläche einlösen

3. 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.

Promocodes auf mithilfe von Xsolla erstellten Websites einlösen

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. 1. Klicken Sie oben rechts im Site Builder auf Veröffentlichen.

1. 2. Aktivieren Sie die Kontrollkästchen neben den Seiten, die Sie veröffentlichen möchten.

1. 3. Klicken Sie auf Weiter.

So funktioniert's

Gutscheinkampagnen sind ein Marketinginstrument, mit dem Sie potenzielle Nutzer für Ihr Produkt gewinnen und Ihren Umsatz steigern können. Löst ein Nutzer einen Gutschein ein, erhält er einen oder mehrere Bonusartikel. Als Boni können die folgenden Artikel verwendet werden:

• virtuelle Währungspakete
• Spielschlüssel
• virtuelle Gegenstände
• Bundles

Ein Gutschein enthält einen eindeutigen Code. Um einen Gutschein einzulösen, muss der Nutzer den Code im Spiel-Client oder im Shop des Spiels (z. B. im Web Shop) eingeben.

Hauptmerkmale:

• Wie oft der Gutschein im Rahmen der Kampagne insgesamt eingelöst werden darf, ist festlegbar.
• Wie oft ein Nutzer den Gutschein im Rahmen der Kampagne einlösen darf, ist festlegbar.
• Es lassen sich mehrere Gutscheincodes generieren.
• Kampagnen und Artikel, die mit einem Gutschein verknüpft sind, lassen sich regional beschränken.

Einschränkungen:

• 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 Gutschein nicht einlösen.
• Wenn für eine Gutscheinkampagne regionale Beschränkungen festgelegt sind, können Nutzer aus den entsprechenden Regionen den Gutschein nicht einlösen.
• Enthält ein Gutschein mindestens einen Bonusartikel mit einer regionalen Beschränkung, kann ein Nutzer aus dieser Region den Artikel nicht mit diesem Gutschein erhalten.

1. Beispiel: Löst man den Gutschein 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 Gutscheincode eingibt, antwortet der Aufruf Aktionscode überprüfen oder Gutscheincode einlösen mit einer Fehlermeldung. Der Nutzer erhält in diesem Fall keinen der Artikel aus dem Gutschein.

Ablauf für den Nutzer:

1. Ein autorisierter Nutzer ruft den Shop auf.
2. Der Nutzer gibt den Gutscheincode ein.
3. Xsolla gibt eine Liste der mit dem Gutschein verknüpften Bonusartikel zurück (optional).
4. Der Nutzer wählt die gewünschten Boni aus (optional).
5. Der Nutzer löst den Gutschein ein.
6. Die mit dem Gutschein verknüpften Artikel werden dem Nutzer auf die gleiche Weise wie bei einem regulären Kauf gewährt.

Gutscheinkampagne einrichten

Voraussetzungen

Bevor Sie eine Gutscheinkampagne einrichten, müssen Sie zunächst die Artikel konfigurieren, die als Bonus vergeben werden sollen.

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 Gutscheinkampagne:

1. Navigieren Sie im Kundenportal zu LiveOps > Werbeaktionen.
2. Klicken Sie auf der Registerkarte Werbeaktionen auf Werbeaktion anlegen.

3. Legen Sie die wichtigsten Parameter fest:

1. 1. Vergeben Sie einen Werbeaktionsnamen.

1. 2. Wählen Sie in der Drop-down-Liste Werbeaktionsart die Option Gutschein.

1. 3. Geben Sie im Feld Externe ID eine Werbeaktions-ID, mit der Werbeaktionen über API-Aufrufe verwaltet werden kann.

1. 4. Wählen Sie in der Drop-down-Liste Bonusartikel auswählen den Artikeltyp aus, der einem Nutzer beim Einlösen des Gutscheins gewährt werden soll.

1. 5. Wählen Sie die Artikel aus, die einem Nutzer beim Einlösen des Gutscheins gewährt werden sollen.

1. 1. Bei virtuellen Gegenständen müssen Sie die Menge für jeden Gegenstand angeben.

1. 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.

Hinweis

Sie können verschiedene Typen von Artikeln als Boni auswählen. Im Feld Bonusartikel auswählen können Sie zwischen den verschiedenen Artikeltypen wechseln. Informationen zu allen ausgewählten Artikeln werden im Bereich Liste von Bonusartikeln angezeigt.

1. 6. Klicken Sie auf Weiter.

4. Einschränkungen beim Einlösen von Gutscheinen festlegen:

1. 1. Wenn Sie begrenzen möchten, wie oft Gutscheine im Rahmen der Kampagne insgesamt eingelöst werden dürfen, stellen Sie den Schalter Gesamtanzahl der Gutscheineinlösungen begrenzen auf Ein und legen Sie das Limit fest.

1. 2. Wenn Sie begrenzen möchten, wie oft ein bestimmter Nutzer Gutscheine 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. 3. Wenn Sie begrenzen möchten, wie oft ein bestimmter Gutschein im Rahmen der Kampagne insgesamt eingelöst werden darf, stellen Sie den Schalter Anzahl von Einlösungen pro Gutschein beschränken auf Ein und legen Sie das Limit fest.

1. 4. Klicken Sie auf Weiter.

5. 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.
6. Klicken Sie auf Weiter.
7. Überprüfen Sie die Kampagneneinstellungen.
8. Klicken Sie auf Speichern und beenden.

So fügen Sie Gutscheincodes einer Kampagne hinzu:

1. Navigieren Sie im Kundenportal zu LiveOps > Werbeaktionen.
2. Klicken Sie in der Zeile mit der gewünschten Gutscheinaktion auf •••, und wählen Sie in Drop-down-Liste die Option Werbeaktion bearbeiten.

3. Wechseln Sie zur Registerkarte Codes.
4. So generieren Sie Codes automatisch:

1. 1. Wählen Sie in der Drop-down-Liste Stringformat des Codes die Option Automatisch generiert aus.

1. 2. Legen Sie fest, wie viele Codes generiert werden sollen, und klicken Sie auf Generieren.

5. So fügen Sie Codes manuell hinzu:

1. 1. Wählen Sie in der Drop-down-Liste Stringformat des Codes die Option Manuelle Eingabe aus.

1. 2. Geben Sie den Gutscheincode ein, und klicken Sie auf Erstellen.

1. 2. Wiederholen Sie den vorherigen Schritt, bis die gewünschte Anzahl von Codes erreicht ist.

6. Laden Sie die CSV-Datei mit den Codes herunter (optional).

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 Gutscheinaktion 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

Zur Einrichtung und Verwaltung von Gutscheinaktionen über die API verwenden Sie bitte die folgenden Aufrufe:

Gutscheine in Ihrer Anwendung oder auf Ihrer Website einlösen

Gutscheine auf Ihrer eigenen UI einlösen

So ermöglichen Sie es Nutzern, Gutscheine in Ihrer Anwendung oder auf Ihrer Website einzulösen:

3. Stellen Sie sicher, dass die Artikel dem Nutzer beim Einlösen des Gutscheins 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 Gutschein verknüpfte Artikel werden dem Nutzer auf die gleiche Weise wie bei einem Standardkauf gewährt.

Gutscheine auf einer mit Xsolla erstellten Website einlösen

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. 1. Klicken Sie oben rechts im Site Builder auf Veröffentlichen.

1. 2. Aktivieren Sie die Kontrollkästchen neben den Seiten, die Sie veröffentlichen möchten.

1. 3. Klicken Sie auf Weiter.