Gutscheine

So funktioniert's

Gutscheinaktionen sind ein Marketingtool und dienen dazu, neue Nutzer zu gewinnen und den Umsatz anzukurbeln. Ein Spieler, der einen Gutschein einlöst, erhält eine mit dem Gutschein verknüpfte Belohnung. Dazu zählen:

  • virtuelles Währungspaket
  • Spielschlüssel
  • virtueller Gegenstand

Jeder Gutschein verfügt über einen Code. Zum Einlösen gibt der Benutzer den Code im Spiel, auf der Website oder in der mobilen Anwendung ein.

Hauptmerkmale:

  • Festlegen, wie oft ein Gutschein im Rahmen einer Kampagne eingelöst werden darf.
  • Festlegen, wie oft ein Benutzer den Gutschein im Rahmen einer Kampagne einlösen darf.
  • Mehrfaches Generieren von Gutscheinen.
  • Festlegen regionaler Verkaufsbeschränkungen für Werbeaktionen und Gegenstände, die mit einem Gutschein verknüpft sind.

Einschränkungen:

  • Wenn Sie Spielschlüssel mit einem Gutschein verknüpfen, wird einer davon per E-Mail an den Spieler versandt, der den Gutschein einlöst. Sind im Rahmen der Kampagne keine weiteren Spielschlüssel vorhanden, wird die Anfrage des Spielers, einen Gutschein einzulösen, abgelehnt.
  • Wenn die Gutscheinaktion regionalen Verkaufsbeschränkungen unterliegt, kann ein Benutzer aus einer betroffenen Region den Gutschein nicht einlösen.
  • Wenn der Gutschein einen Gegenstand mit regionalen Verkaufsbeschränkungen umfasst, wird einem Benutzer aus einer betroffenen Region der mit diesem Gutschein verknüpfte Gegenstand nicht gewährt.

Ablauf für den Benutzer:

  1. Der Benutzer löst einen Gutschein ein.
  2. Die mit dem Gutschein verknüpfte Belohnung wird dem Benutzer auf eine der folgenden Weisen bereitgestellt:
    • direkt in das Inventar (virtueller Gegenstand oder virtuelles Währungspaket)
    • per E-Mail (Spielschlüssel)
    • direkt in das Berechtigungssystem (Spielschlüssel)

Für wen ist es

  • Partner, die eines oder beide der folgenden Produkte integriert haben:
  • Partner, die ihren Umsatz mithilfe von Gutscheinaktionen steigern möchten.

Wie komme ich dazu

Voraussetzungen

  1. Erstellen Sie ein Konto im Xsolla-Kundenportal.
  2. Verknüpfen Sie den Online-Shop mit Ihrem Projekt.

Integrationsablauf

  1. Richten Sie eine Werbekampagne mit Gutscheinen ein.
  2. Nutzen Sie die Methoden für den Abruf einer Gutscheinbelohnung.
  3. Nutzen Sie die Methoden für die Gutscheineinlösung durch Codeeingabe.

Kampagne mit Gutscheinen einrichten

  1. Navigieren Sie im Kundenportal zu Online-Shop > Werbeaktionen, und erstellen Sie eine Werbeaktion.
  2. Legen Sie die nötigen Parameter fest:
    1. Geben Sie den Titel der Werbeaktion an.
    2. Wählen Sie als Werbeaktionstyp die Option Gutscheine aus.
  3. Wählen Sie die Prämien aus, welcher der Benutzer beim Einlösen des Gutscheins erhalten soll. Verfügbare Optionen:
    1. Virtuelles Währungspaket.
    2. Spielschlüssel.
    3. Virtueller Gegenstand (ein oder mehrere, einschließlich Bundles und automatisch endende Abos).
  4. Legen Sie fest, wie oft der Gutschein insgesamt und wie oft der Gutschein pro Benutzer eingelöst werden darf.
  5. Legen Sie das Start- und Enddatum der Kampagne fest.
  6. Überprüfen Sie die Einstellungen, und speichern Sie die Werbeaktion.
  7. Wechseln Sie ins Bearbeitungsmenü der Werbeaktion.
  8. Wählen Sie im Menü Codes die Methode der Gutscheingenerierung aus.
  9. Generieren Sie den Gutscheincode oder geben Sie ihn ein.
  10. Speichern Sie die Änderungen.
  11. 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 mit virtuellen Gegenständen 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 automatisch endende Abos.

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.

Note
Bei Gutscheincodes wird zwischen Groß- und Kleinschreibung unterschieden. So sind beispielsweise winter2021 und WINTER2021 zwei unterschiedliche Gutscheincodes.

Regionale Beschränkungen

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

Gutscheinbelohnung abrufen

Implementieren Sie den Aufruf der Methode Get coupon rewards, um die Liste der Gegenstände abrufen zu können, welche der Benutzer nach Einlösen eines Gutscheins erhält. Je nach Wert des Parameters is_selectable in der Antwort gibt es zwei mögliche Abläufe:

  1. Ist is_selectable=true festgelegt, sollte für jedes item mit dem Element type=unit das Formular für die Auswahl von Elementen aus dem Objekt unit_items angezeigt werden. Darin können Benutzer nur ein Element pro unit-Typ wählen.
Beispielhafte Antwort:

Copy
Full screen
Small screen
{
   "bonus": [{
       "item": {
           "sku": "xsollus_gold_edition",
           "name": "Xsollus: Gold Edition",
           "type": "unit",
           "description": null,
           "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/9541470622d96a821a9a11ea7763ea4c.png",
           "unit_items": [{
               "sku": "xsollus_gold_edition_steam",
               "name": "Xsollus: Gold Edition (steam)",
               "type": "game_key",
               "drm_name": "Steam",
               "drm_sku": "steam"
           }, {
               "sku": "xsollus_gold_edition_playstation",
               "name": "Xsollus: Gold Edition (playstation)",
               "type": "game_key",
               "drm_name": "Playstation",
               "drm_sku": "playstation"
           }, {
               "sku": "xsollus_gold_edition_xbox",
               "name": "Xsollus: Gold Edition (xbox)",
               "type": "game_key",
               "drm_name": "XBox",
               "drm_sku": "xbox"
           }, {
               "sku": "xsollus_gold_edition_rockstar",
               "name": "Xsollus: Gold Edition (rockstar)",
               "type": "game_key",
               "drm_name": "Rockstar Games Launcher",
               "drm_sku": "rockstar"
           }]
       },
       "quantity": 1
   }, {
       "item": {
           "sku": "xsollus_bonus_pack_edition",
           "name": "Xsollus: Bonus Pack",
           "type": "unit",
           "description": null,
           "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/aa2efd78dfd4e5dda5293f8c8e49af6d.png",
           "unit_items": [{
               "sku": "xsollus_bonus_pack_edition_steam",
               "name": "Xsollus: Bonus Pack (steam)",
               "type": "game_key",
               "drm_name": "Steam",
               "drm_sku": "steam"
           }, {
               "sku": "xsollus_bonus_pack_edition_playstation",
               "name": "Xsollus: Bonus Pack (playstation)",
               "type": "game_key",
               "drm_name": "Playstation",
               "drm_sku": "playstation"
           }, {
               "sku": "xsollus_bonus_pack_edition_xbox",
               "name": "Xsollus: Bonus Pack (xbox)",
               "type": "game_key",
               "drm_name": "XBox",
               "drm_sku": "xbox"

           }]
       },
       "quantity": 3
   }],
   "is_selectable": true

  1. Ist is_selectable=false festgelegt, sollte der zusätzliche Parameter in der Anfrage nicht übermittelt werden.

Gutschein mittels Codes einlösen

Implementieren Sie den Aufruf der Methode Redeem coupon code, damit ein Gutschein eingelöst werden kann. Je nach Wert des Parameters is_selectable in der Antwort der Methode Get coupon rewards gibt es zwei mögliche Abläufe:

  1. Istis_selectable=true festgelegt, sollte das Objekt selected_unit_items im folgenden Format beim Aufruf der Methode Redeem coupon code übermittelt werden:

Copy
Full screen
Small screen
selected_unit_items:{
      unit_1_sku: "selected_unit_item_sku",
      unit_2_sku: "selected_unit_item_sku"
}

Beispielhafte Antwort:

Copy
Full screen
Small screen
{
  {
    "items": [
    {
      "sku": "xsollus_gold_edition_steam",
      "name": "Xsollus: Gold Edition (steam)",
      "type": "game_key",
      "description": null,
      "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/9541470622d96a821a9a11ea7763ea4c.png",
      "attributes": [],
      "is_free": true,
      "groups": [],
      "price": null,
      "virtual_prices": [],
      "drm_name": "Steam",
      "drm_sku": "steam",
      "has_keys": false,
      "is_pre_order": true,
      "release_date": null,
      "quantity": 1
    },
    {
      "sku": "xsollus_bonus_pack_edition_origin",
      "name": "Xsollus: Bonus Pack (origin)",
      "type": "game_key",
      "description": null,
      "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/aa2efd78dfd4e5dda5293f8c8e49af6d.png",
      "attributes": [],
      "is_free": true,
      "groups": [],
      "price": null,
      "virtual_prices": [],
      "drm_name": "Origin",
      "drm_sku": "origin",
      "has_keys": false,
      "is_pre_order": true,
      "release_date": null,
      "quantity": 3
  }
  ]
}

  1. Ist is_selectable=false festgelegt, sollte der zusätzliche Parameter in der Anfrage nicht übermittelt werden.
    1. 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.
      Diese Seite bewerten
      Diese Seite bewerten
      Gibt es etwas, das wir verbessern können?

      Jetzt nicht

      Vielen Dank für Ihr Feedback!
      Letztmalig aktualisiert: 7. April 2021

      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!