Promocodes
So funktioniert's
Promocode-Aktionen rmöglichen es Nutzern, Artikel zu ermäßigten Preisen zu kaufen und Bonusartikel entsprechend den Kampagneneinstellungen zu erhalten. Das Promocode-Eingabefeld kann im Katalog oder im Warenkorbbereich angezeigt werden.
Der Hauptunterschied besteht darin, dass Promocodes während eines Kaufs eingelöst werden, während Gutscheine ohne etwas kaufen zu müssen eingelöst werden können.
- 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
Die folgende Szenarien beziehen sich auf einen autorisierten Benutzer.
Nicht autorisierten Benutzern wird stets angezeigt, wie oft sie eine Werbeaktion in Anspruch nehmen können. Um dem Benutzer (vorbehaltlich des aktuellen Limits) anzuzeigen, wie oft er eine Werbeaktion noch in Anspruch nehmen darf, müssen Sie den Artikelkatalog mithilfe der Methoden des Unterabschnitts Katalog aus der Methodengruppe Virtuelle Gegenstände und Währung anfordern und dabei die Benutzerautorisierungsdaten übermitteln.
Sie können verschiedene Aktionsarten für einen Artikel einrichten: Rabatte, Gutscheine, Promocodes und Boni.
Wenn für einen Artikel 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 virtueller Gegenstand kostet 10 €. Im Kundenportal wurden für den virtuellen Gegenstand 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 Artikel am 20. November gekauft, sind sowohl die beiden Rabattaktionen als auch die Promocode-Aktion aktiv.
Der Endpreis des virtuellen Gegenstands berechnet sich wie folgt: ((10 € - 10 %) - 20 %) - 5 % = 6,84 €.
Wie komme ich dazu
Voraussetzungen
- Erstellen Sie ein Konto im Kundenportal.
- 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.
- Öffnen Sie Ihr Projekt im Kundenportal.
- Klicken Sie in der Seitenleiste auf Store, und öffnen Sie den Abschnitt Werbeaktionen und Belohungen.
- Klicken Sie auf Werbeaktion anlegen.
- Geben Sie die folgenden Parameter an:
- Vergeben Sie einen Werbeaktionsnamen.
- Wählen Sie Promocode als Werbeaktionsart aus.
- Vergeben Sie eine Externe ID – eine einzigartige Werbeaktionskennung, mit der sich Werbeaktionen über API-Methoden verwalten lassen.
- Legen Sie den Rabattprozentsatz für den Promocode fest. Der Rabatt kann auf den gesamten Kauf oder nur auf bestimmte Artikel angewendet werden.
- 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
- Legen Sie fest, wie oft der Promocode insgesamt und pro Benutzer eingelöst werden kann.
- Legen Sie den Zeitraum der Kampagne fest.
- Überprüfen Sie die Einstellungen, und speichern Sie die Werbeaktion.
- Wechseln Sie zum Bearbeiten-Modus.
- Wechseln Sie zur Registerkarte Codes, wählen Sie dort aus, wie die Promocodes generiert werden sollen.
- Generieren Sie den Promocode oder geben Sie ihn manuell ein.
- Speichern Sie die Änderungen.
- Aktivieren Sie die Werbeaktion.
Promocode mit einem virtuellen Währungspaket
So erstellen Sie einen Promocode für ein virtuelles Währungspaket:- Erstellen Sie ein virtuelles Währungspaket.
- Geben Sie als Bonusartikel das virtuelle Währungspaket an.
Promocode mit einem virtuellen Gegenstand
So erstellen Sie einen Promocode für einen virtuellen Gegenstand:
- Erstellen Sie einen virtuellen Gegenstand.
- 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:- Erstellen Sie ein Spielschlüsselpaket.
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.
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.
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.Ü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:
| Funktion | API-Methoden |
|---|---|
| Promocode-Aktion erstellen | Promocode-Aktion erstellen |
| Promocode-Aktion aktivieren | Promocode-Aktion aktivieren |
| Werbeaktion bearbeiten | Promocode-Aktion aktualisieren, und zwar mit neuen Werbeaktionsoptionen. Auch Werbeaktionen mit dem Status Aktiv lassen sich bearbeiten. |
| Werbeaktion deaktivieren | Promocode-Aktion deaktivieren |
| Unbefristete Werbeaktion einrichten | Promocode-Aktion erstellen oder Promocode-Aktion aktualisieren. Übermitteln Sie den Parameter “date_end”:null an die angegebene Methode. |
| Funktion | API-Methoden |
|---|---|
| Den Promocode auf Gültigkeit prüfen | Aktionscode verifizieren |
| Promocode einlösen | Promocode einlösen |
| Liste der Spieledistributionsplattformern abrufen, die dem Benutzer angezeigt werden soll, wenn ein Spielschlüssel als Bonus für das Einlösen des Promocodes vergeben wird. | Promocodebelohnungen abrufen |
| Funktion | API-Methoden |
|---|---|
| Anzahl der verbleibenden Einlösungen eines Promocodes für einen bestimmten Benutzer abrufen | Promocode-Limit für den angegebenen Benutzer abrufen |
| Anzahl der verbleibenden Einlösungen des Promocodes für einen bestimmten Benutzer erhöhen | Promocode-Limit für den angegebenen Benutzer erhöhen |
| Neues Limit für die Anzahl der Einlösungen eines Promocodes für einen bestimmten Benutzer festlegen | Promocode-Limit für den angegebenen Benutzer festlegen |
| Anzahl der verbleibenden Einlösungen des Promocodes für einen bestimmten Benutzer verringern | Promocode-Limit für den angegebenen Benutzer verringern |
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.
Haben Sie einen Tippfehler oder einen anderen Textfehler gefunden? Wählen Sie den Text aus und drücken Sie Strg+Eingabe.
