Gutscheine

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.