Promocodes

So funktioniert's

Promocodes sind ein Marketinginstrument, bei dem Benutzer Codes einlösen und im Gegenzug zusätzliche Vorteile erhalten. Benutzer können den Promocode in ein spezielles Feld im Katalog oder im Warenkorb eingeben und aktivieren.

Nach dem Aktivieren eines Promocodes kann der Benutzer Folgendes erhalten:

• einen Rabatt, der auf den gesamten Einkauf oder auf bestimmte Artikel angewendet wird

• einen Bonusartikel:

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

Hauptmerkmale:

• als Belohnung für das Einlösen eines Promocodes entweder einen Rabatt, einen Bonusartikel oder beides anbieten
• Gesamtzahl der Einlösungen des Promocodes im Rahmen der Kampagne begrenzen
• Anzahl der Einlösungen von Promocodes pro Benutzer im Rahmen der Kampagne begrenzen
• mehrere Promocodes generieren
• regionale Beschränkungen auf Anfrage festlegen
• nach Anwendung eines Promocodes Bonusartikels in den Warenkorb legen
• nach Anwendung eines Promocodes Artikel rabattieren

Beschränkungen:

• Es kann nur ein Promocode pro Warenkorb angewendet werden.
• Um einen Rabatt oder Bonus zu erhalten, muss der Benutzer die Artikel im Warenkorb bezahlen.
• Wenn ein Promocode 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 Promocode 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 Promocode eingibt, antwortet die Methode Aktionscode verifizieren oder Promocode einlösen mit einer Fehlermeldung. Der Benutzer kann in diesem Fall keinen der Artikel aus dem Promocode erhalten.

Integrationsablauf

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.

Promocode-Aktion einrichten

Sie können Promocode-Aktionen 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 Promocodes zu überprüfen und den Promocode einzulösen.

Über Kundenportal einrichten

Wenn Sie Promocode-Aktionen ü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

Promocode-Aktionen mit dem Status Aktiv lassen sich derzeit im Kundenportal nicht bearbeiten.

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

So richten Sie eine Werbeaktion über das Kundenportal ein:

1. Öffnen Sie Ihr Projekt im Kundenportal.
2. Klicken Sie in der Seitenleiste auf Online-Shop, und öffnen Sie den Abschnitt Werbeaktionen.

3. Klicken Sie auf Werbeaktion anlegen.

4. Geben Sie die folgenden Parameter an:
   • Vergeben Sie einen Werbeaktionsnamen.
   • Wählen Sie Promocode als Werbeaktionsart aus.
5. Vergeben Sie eine Externe ID – eine einzigartige Werbeaktionskennung, mit der sich Werbeaktionen über API-Methoden verwalten lassen.
6. Legen Sie den Rabattprozentsatz für den Promocode fest. Der Rabatt kann auf den gesamten Kauf oder nur auf bestimmte Artikel angewendet werden.
7. Wählen Sie die Bonusartikel, die der Benutzer erhält, wenn er einen Promocode einlöst:
• keine Belohnung
• virtuelles Währungspaket
• virtueller Gegenstand (einer oder mehrere, einschließlich Bundles und zeitlich begrenzte Artikel)
• Spielschlüssel

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

9. Legen Sie den Zeitraum der Kampagne fest.

10. Überprüfen Sie die Einstellungen, und speichern Sie die Werbeaktion.
11. Wechseln Sie zum Bearbeiten-Modus.
12. Wechseln Sie zur Registerkarte Codes, wählen Sie dort aus, wie die Promocodes generiert werden sollen.
13. Generieren Sie den Promocode oder geben Sie ihn manuell ein.
14. Speichern Sie die Änderungen.
15. 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.

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.

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.

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 Promocodes der Methodengruppe Werbeaktionen nutzen, um mit Promocode-Aktionen zu arbeiten.

Werbeaktion einrichten:

Promocode überprüfen und anwenden:Limits verwalten:

Wenn das Eingabefeld für den Promocode im Katalog platziert ist, müssen Sie nach der Eingabe des Promocodes den Artikelkatalog für den Benutzer erneut anfordern, indem Sie den Parameter promo_code in den Methoden für die Katalogerstellung aus der Untergruppe Katalog übermitteln.

Wenn Sie den Schnellkauf eines Artikels mit der Methode Bestellung mit angegebenem Artikel anlegen implementieren, übermitteln Sie Informationen über den Promocode im Parameter promo_code. Auf diese Weise kann der Kauf unter Anwendung des Promocodes getätigt werden.

Letztmalig aktualisiert: 22. Januar 2024