Promocodes

So funktioniert's

Promocodes sind ein Marketinginstrument und dienen dazu, neuer Nutzer zu gewinnen und den Umsatz anzukurbeln. Nach der Aktivierung eines Promocodes erhält der Benutzer eine der folgenden Belohnungen:

  • Rabatt auf die Warenkorbsumme oder auf einen bestimmten Artikel
  • einen der folgenden Bonusartikel:
    • Spielschlüssel
    • virtuelles Währungspaket
    • virtueller Gegenstand, z. B. ein Bundle oder zeitlich begrenzte Artikel

Hauptmerkmale:

  • Wahl zwischen nur einem Rabatt, nur einem Bonusartikel und beidem (Rabatt und Artikel) als Belohnung
  • Festlegen, wie oft der Promocode im Rahmen einer Kampagne eingelöst werden darf
  • Festlegen, wie oft ein Benutzer Promocodes im Rahmen einer Kampagne einlösen darf
  • Festlegen regionaler Verkaufsbeschränkungen
  • Mehrfaches Generieren von Promocodes
  • Hinzufügen eines Bonusartikels zum Warenkorb nach Eingabe des Promocodes
  • Anwenden des Rabatts auf die Artikel nach Eingabe eines Promocodes

Einschränkungen:

  • Pro Warenkorb kann nur ein Promocode eingelöst werden.
  • Um einen Rabatt oder einen Bonus zu erhalten, muss der Benutzer die Artikel im Warenkorb bezahlen.
  • Wenn einem Promocode ein Artikel mit regionalen Verkaufsbeschränkungen zugewiesen ist und der Benutzer in einer solchen Region lebt, kann er keine Artikel mit diesem Promocode erhalten.

Ablauf für den Benutzer:

  1. Der Benutzer gibt den Promocode in das entsprechende Feld auf der Benutzeroberfläche ein.
  2. Daraufhin werden die Artikelpreise neu berechnet bzw. Bonusartikel hinzugefügt.
  3. Der Benutzer bezahlt und löst damit den Promocode ein.
  4. Sofern dem Promocode Bonusartikel zugewiesen sind, werden diese 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)

Achtung

Sie können verschiedene Aktionsarten für ein Spiel oder eine Liste von Spielen einrichten: Rabatte, Gutscheine, Promocodes und Boni.

Wenn für ein Spiel oder eine Liste von Spielen zum Zeitpunkt des Kaufs mehrere Werbeaktionen aktiv geschaltet sind, werden die Rabatte nacheinander auf den Artikel angewendet. Die Reihenfolge spielt dabei keine Rolle.

Zum Beispiel:

Ein Spielschlüssel kostet 10 €. Im Kundenportal wurden für die Spielschlüssel folgende Werbeaktionen erstellt:

  • Black Friday: Rabattaktion mit einem Preisnachlass von 10 % vom 4. bis 30. November
  • Sale: Rabattaktion mit einem Preisnachlass von 20 % vom 20. November bis 15. Dezember
  • Promocode-Aktion mit einem Preisnachlass von 5 % vom 4. bis 30. November

Wird der Spielschlüssel am 20. November gekauft, sind sowohl die beiden Rabattaktionen als auch die Promocode-Aktion aktiv.

Der Endpreis des Schlüssels berechnet sich wie folgt: ((10 € - 10 %) - 20 %) - 5 % = 6,84 €.

Wie komme ich dazu

Voraussetzungen

  1. Erstellen Sie ein Konto im Xsolla-Kundenportal.
  2. Verknüpfen Sie das Spielschlüssel-Modul, und konfigurieren Sie es.

Integrationsablauf

Hinweis
Promocode-Aktionen sind nicht möglich, wenn Sie Schlüssel über einen Direktlink oder ein Widget verkaufen. Promocode-Aktionen für Spielschlüssel lassen sich wie folgt erstellen:
  1. mit der In-Game Store & Buy Button API. Verwenden Sie in diesem Fall die Methode Promocode einlösen, um den Promocode auf den Warenkorb anzuwenden.
  2. Über die mit dem Website-Baukasten erstellte Shop-Oberfläche.

Erfolgt der Schnellkauf eines Schlüssels mit der Methode Bestellung mit angegebenem Artikel anlegen, wird der Benutzer ohne Umwege über den Warenkorb zur Kasse weitergeleitet.

Gleichzeitig wird aufseiten von Xsolla ein Warenkorb angelegt, der dem Benutzer jedoch nicht angezeigt wird. Das ist notwendig, um alle vorhandenen Rabatte korrekt anzuwenden und den Betrag einschließlich aller Rabatte in der Zahlungsmaske anzuzeigen.

Kampagne mit Promocodes einrichten

  1. Navigieren Sie im Kundenportal zu Online-Shop > Werbeaktionen, und erstellen Sie eine Werbeaktion.
  2. Legen Sie die folgenden Parameter fest:
    1. Benennen Sie die Werbeaktion.
    2. Wählen Sie als Werbeaktionstyp die Option Promocodes aus.
  3. Vergeben Sie eine External ID – eine eindeutige Werbeaktionskennung, mit der Sie die Werbeaktion über die Methoden Belohnungen abrufen und Promocode einlösen steuern können.
  4. Legen Sie den prozentualen Rabatt für den Promocode fest. Der Rabatt kann auf den gesamten Warenkorb oder auf bestimmte Artikel angewendet werden.
  5. Wählen Sie die Bonusartikel, die der Benutzer beim Einlösen eines Promocodes erhält:
  6. Legen Sie fest, wie oft der Promocode insgesamt und wie oft der Promocode pro Benutzer eingelöst werden darf.
  7. Spezifizieren Sie die Dauer der Werbekampagne.
  8. Überprüfen Sie die Einstellungen, und speichern Sie die Werbeaktion.
  9. Wechseln Sie in das Bearbeitungsmenü.
  10. Legen Sie auf der Registerkarte Codes fest, wie die Promocodes generiert werden sollen.
  11. Generieren Sie den Promocode oder geben Sie ihn manuell ein.
  12. Speichern Sie die Änderungen.
  13. Aktivieren Sie die Werbeaktion.

Promocode mit einem virtuellen Währungspaket

So erstellen Sie einen Promocode für ein virtuelles Währungspaket:

  1. Erstellen Sie ein virtuelles Währungspaket.
  2. Geben Sie als Bonusartikel das virtuelle Währungspaket an.

So erstellen Sie ein virtuelles Währungspaket:

  1. Navigieren Sie zu Online-Shop > Virtuelle Währung, und erstellen Sie eine virtuelle Währung. Klicken Sie dazu auf Neue virtuelle Währung, und geben Sie Folgendes an:
    • Bild der virtuellen Währung (optional)
    • SKU der virtuellen Währung
    • Name der virtuellen Währung
    • Preis für eine Einheit der virtuellen Währung
    • Standardwährung
    • Attribut (optional)
  2. Erstellen Sie die virtuellen Währungspakete. Klicken Sie dazu auf Neues Paket, und geben Sie Folgendes an:
    • Paketbild (optional)
    • SKU des Pakets
    • Name des Pakets
    • kurze Beschreibung des Pakets
    • virtuelle Währung für das Paket
    • Menge der virtuellen Währung im Paket
    • Preise in echter und/oder virtueller Währung
    • Standardwährung
    • Attribut (optional)
  3. Aktivieren Sie die Anzeige des Pakets im Online-Shop. Stellen Sie dazu den Schalter Im Online-Shop anzeigen auf EIN.
  4. Klicken Sie auf Paket erstellen.

Promocode mit einem virtuellen Gegenstand

So erstellen Sie einen Promocode für einen virtuellen Gegenstand:

  1. Erstellen Sie einen virtuellen Gegenstand.
  2. Geben Sie als Bonusartikel den virtuellen Gegenstand an.

So erstellen Sie virtuelle Gegenstände:

  1. Navigieren Sie zu Online-Shop > Virtuelle Gegenstände, und klicken Sie auf Artikel anlegen.
  2. Geben Sie für jeden Gegenstand Folgendes an:
    • Bild (optional)
    • SKU
    • eine oder mehrere Gruppen, denen der Gegenstand angehören soll (optional)
    • Gegenstandsname
    • Beschreibung des Gegenstands
    • Eigenschaft: aufbrauchbar, nicht aufbrauchbar oder zeitlich begrenzt
    • Preise in echter und/oder virtueller Währung
  3. Stellen Sie die Option Im Online-Shop anzeigen auf Ein.
  4. Klicken Sie auf Artikel anlegen.

Sie können einem Promocode einen oder mehrere Artikel mit verschiedenen SKUs (z. B. Bundles und zeitlich begrenzte Artikel) zuweisen.

Promocode mit einem Spielschlüssel

So erstellen Sie einen Promocode für einen Spielschlüssel:

  1. Erstellen Sie ein Spielschlüsselpaket.
  2. Geben Sie als Bonusartikel die SKU des erstellten Spielschlüsselpakets an und legen Sie fest, welche Methode zur Auswahl der Spielplattform zum Einsatz kommen soll:
    • Der Promocode wird für die bereits festgelegte spezifische Plattform generiert.
    • Der Benutzer wählt bei Eingabe des Promocodes eine Plattform aus.

Sie können einem Promocode mehrere Schlüssel mit verschiedenen SKUs zuweisen.

Generierung von Promocodes

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

  • Manuell eingegebener String – geeignet für Kampagnen mit einem einzelnen Promocode, der viele Male genutzt werden darf (maximale Zeichenlänge: 128).
  • Generierter String – Code bestehend aus Ziffern und lateinischen Buchstaben (10 Zeichen). Geeignet für Kampagnen mit vielen Promocodes.
Nachdem Sie Werbeaktion mit Promocodes erstellt haben, lassen sich im Werbeaktionseditor Promocodes generieren. Mehrfaches Generieren von Promocodes ist möglich. Das Hochladen der manuell eingegebenen Codes erfolgt auf Anfrage per E-Mail an Xsolla.

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

Promocodebelohnungen abrufen

Implementieren Sie den Aufruf der Methode Get promo code rewards, um die Liste der Gegenstände abrufen zu können, welche der Benutzer nach Einlösen eines Promocodes 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_nintendo_eshop",
               "name": "Xsollus: Gold Edition (nintendo_eshop)",
               "type": "game_key",
               "drm_name": "Nintendo Switch eShop",
               "drm_sku": "nintendo_eshop"
           }]
       },
       "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_origin",
               "name": "Xsollus: Bonus Pack (origin)",
               "type": "game_key",
               "drm_name": "Origin",
               "drm_sku": "origin"
           }, {
               "sku": "xsollus_bonus_pack_edition_drmfree",
               "name": "Xsollus: Bonus Pack (drmfree)",
               "type": "game_key",
               "drm_name": "DRM Free",
               "drm_sku": "drmfree"
           }, {
               "sku": "xsollus_bonus_pack_edition_gog",
               "name": "Xsollus: Bonus Pack (gog)",
               "type": "game_key",
               "drm_name": "GOG",
               "drm_sku": "gog"
           }, {
               "sku": "xsollus_bonus_pack_edition_rockstar",
               "name": "Xsollus: Bonus Pack (rockstar)",
               "type": "game_key",
               "drm_name": "Rockstar Games Launcher",
               "drm_sku": "rockstar"
           }]
       },
       "quantity": 3
   }],
   "discount": {
       "percent": null
   },
   "is_selectable": true

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

Promocode einlösen

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

  1. Ist is_selectable=true festgelegt, sollte das Objekt selected_unit_items im folgenden Format beim Aufruf der Methode Redeem promo 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.

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: 30. Dezember 2022

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!