Gutscheine

So funktioniert's

Im Rahmen von Gutscheinkampagnen können Nutzer – ohne etwas zu kaufen – Bonusartikel erhalten, die zuvor in der Kampagne eingerichtet wurden. Das Feld für die Gutscheineingabe wird im Katalog angezeigt.

Nach dem Einlösen eines Gutscheincodes, kann der Benutzer einen der folgenden Bonusartikel erhalten:

• Spielschlüssel
• virtuelles Währungspaket
• virtueller Gegenstand, einschließlich eines Bundles oder zeitlich begrenzte Artikel

Hauptmerkmale:

• Gesamtzahl der Gutscheineinlösungen im Rahmen der Kampagne begrenzen
• Anzahl der Gutscheineinlösungen pro Benutzer im Rahmen der Kampagne begrenzen
• mehrere Gutscheincodes generieren
• regionale Verkaufsbeschränkungen für mit dem Gutschein verknüpfte Werbeaktionen und Artikel festlegen

Einschränkungen:

• Wenn dem Gutschein Spielschlüssel als Bonusartikel beigefügt sind, wird der Schlüssel nach dem Einlösen des Gutscheins an die E-Mail-Adresse des Benutzers gesendet. Sollten der Kampagne die Schlüssel ausgehen, kann der Benutzer den Gutschein nicht mehr einlösen.
• Wenn eine Gutscheinaktion regionalen Beschränkungen unterliegt, können Benutzer aus dieser Region den Gutschein nicht einlösen.
• Wenn der Gutschein einen Artikel mit regionalen Verkaufsbeschränkungen enthält, kann ein Benutzer aus einer Region, in der diese Artikel nicht erhältlich sind, diese Artikel nicht erhalten.
  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 Benutzer außerhalb der USA den Gutscheincode eingibt, antwortet die Methode Aktionscode verifizieren oder Gutscheincode einlösen mit einer Fehlermeldung. Der Benutzer kann in diesem Fall keinen der Artikel aus dem Gutschein erhalten.

Integrationsablauf

1. Ergänzen Sie Ihren Online-Shop um ein Feld, in das der Benutzer den Gutscheincode eingeben kann.
2. Nutzen Sie die Methode Aktionscode verifizieren, um den eingegebenen Code zu prüfen.
3. Nutzen Sie die Methode Gutscheincode einlösen, um den Gutschein einzulösen. Wird ein Spielschlüssel als Bonus vergeben, so wird dieser an die E-Mail-Adresse des Benutzers gesendet.

Wie komme ich dazu

Voraussetzungen

1. Erstellen Sie ein Konto im Kundenportal.
2. Verknüpfen Sie den Online-Shop, und richten Sie die Module Virtuelle Gegenstände und Virtuelle Währung ein.

Gutscheinaktion einrichten

Sie können Gutscheinaktionen auf eine der folgenden Arten einrichten:

• über das Kundenportal
• über API-Methoden

Bei jeder Einrichtung einer Werbeaktion ist es erforderlich, Aufrufe von API-Methoden zu implementieren, um die Gültigkeit des Gutscheincodes zu überprüfen und den Gutschein einzulösen.

Über Kundenportal einrichten

Wenn Sie Gutscheinaktionen über das Kundenportal einrichten, können Sie:

• den Gültigkeitszeitraum der Aktion festlegen
• begrenzen, wie oft die Werbeaktion pro Benutzer in Anspruch genommen werden darf
• Werbeaktionen für beliebige Artikeltypen einrichten:
  • virtuelle Währungspakete
  • virtuelle Gegenstände (einschließlich zeitlich begrenzte Artikel)
  • Spielschlüssel
  • Bundles

Gutscheinaktionen mit dem Status Aktiv lassen sich derzeit im Kundenportal nicht bearbeiten.

Die API-Methoden bieten erweiterte Konfigurationsmöglichkeiten für Gutscheinaktionen.

So richten Sie eine Werbeaktion über das Kundenportal ein:

1. Öffnen Sie Ihr Projekt im Kundenportal.
2. Klicken Sie in der Seitenleiste auf Store.
3. Klicken Sie bei Werbeaktionen und Belohungen auf:
   • Verknüpfen, sofern Sie noch keine Werbeaktionen eingerichtet haben;
   • Konfigurieren, sofern Sie das Modul zuvor bereits verknüpft haben.

4. Klicken Sie auf Werbeaktion anlegen.

5. Legen Sie die folgenden Parameter fest:
   1. Vergeben Sie einen Werbeaktionsnamen.
   2. Wählen Sie Gutschein als Werbeaktionsart aus.
   3. Vergeben Sie eine Externe ID – eine einzigartige Werbeaktionskennung, mit der sich Werbeaktionen über API-Methoden verwalten lassen.
   4. Wählen Sie den Bonusartikel, den der Benutzer erhält, wenn er einen Gutschein einlöst:
      • virtuelles Währungspaket
      • Spielschlüssel
      • virtueller Gegenstand (einer oder mehrere, einschließlich Bundles und zeitlich begrenzte Artikel)

6. Legen Sie fest, wie oft der Gutschein insgesamt und pro Benutzer eingelöst werden kann.

7. Legen Sie das Start- und Enddatum der Kampagne fest.

8. Überprüfen Sie die Einstellungen, und speichern Sie die Werbeaktion.

9. Wechseln Sie zum Bearbeiten-Modus.
10. Wechseln Sie zur Registerkarte Codes, wählen Sie dort aus, wie die Gutscheincodes generiert werden sollen.
11. Generieren Sie den Gutscheincode oder geben Sie ihn manuell ein.
12. Speichern Sie die Änderungen.
13. Aktivieren Sie die Werbeaktion.

Gutschein mit einem virtuellen Währungspaket

Für einen Gutschein mit einem virtuellen Währungspaket müssen sie das entsprechende Währungspaket angeben. So erstellen Sie ein virtuelles Währungspaket:

1. Wechseln Sie in die Einstellungen des Moduls Virtuelle Währung, und legen Sie folgende Parameter fest:
   • Bild
   • SKU
   • Name der Währung
   • Preis für eine Einheit der virtuellen Währung
   • Standard-Währung
2. Erstellen Sie eine erforderliche Anzahl von Währungspaketen, und legen Sie für jedes einzelne die folgenden Parameter fest:
   • Bild
   • SKU
   • Name
   • Beschreibung
   • Zu verwendende Währung
   • Betrag der Währung im Paket
   • Preis
   • Standard-Währung
3. Aktivieren Sie die Option “Im Online-Shop anzeigen”.

Gutschein mit einem Spielschlüssel

Für einen Spielschlüsselgutschein müssen Sie eine Spielschlüssel-SKU und DRM-Infos angeben. Es gibt 2 Optionen:

• Generieren Sie Gutscheine für bereits festgelegte DRM. Der Parameter wird beim Generieren der Gutscheine festgelegt.
• Auswahl eines DRM beim Einlösen des Gutscheins.

Gutschein mit virtuellen Gegenständen

Für einen Gutschein, der virtuelle Gegenstände gewährt, müssen Sie die SKU der virtuellen Gegenstände und deren Menge angeben. Sie können einen oder mehrere Gegenstände mit verschiedenen SKUs für einen Gutschein auswählen, darunter Bundles und zeitlich begrenzte Artikel.

Generieren von Gutscheinen

Eine Kampagne kann einen oder mehrere Gutscheine umfassen. Für das Gutscheinformat stehen 2 Optionen zur Verfügung:

1. Manuell eingegebener String – geeignet für Kampagnen mit einem einzelnen Gutschein, der viele Male eingelöst werden kann (maximale Zeichenlänge: 128).
2. Generierter String – Code bestehend aus Ziffern und lateinischen Buchstaben (10 Zeichen). Geeignet für Kampagnen mit vielen Gutscheinen.

Nachdem Sie eine Gutscheinaktion erstellt haben, lassen sich im Werbeaktionseditor Gutscheine generieren. Mehrfaches Generieren von Codes ist möglich. Das Hochladen der manuell eingegebenen Codes erfolgt auf Anfrage per E-Mail an Xsolla.

Regionale Beschränkungen

Regionale Beschränkungen gelten für die gesamte Werbekampagne und werden auf Anfrage per E-Mail an Xsolla in Kraft gesetzt.

Über API-Methoden einrichten

Sie können die Methoden aus der Untergruppe Gutscheine der Methodengruppe Werbeaktionen nutzen, um mit Gutscheinaktionen zu arbeiten.

Werbeaktion einrichten:

Aktionscode überprüfen und anwenden:Limits verwalten:Letztmalig aktualisiert: 3. Oktober 2024