Kostenlose Artikel
Kostenlose Artikel sind ein Artikeltyp, den Benutzer erhalten können, ohne virtuelle oder echte Währung ausgeben zu müssen. Zu solchen Artikeln zählen:
- virtuelle Gegenstände
- Bundles
- virtuelle Währungspakete
Nur autorisierte Benutzer können kostenlose Artikel erhalten. Nicht autorisierte Benutzer können nur den Katalog der kostenlosen Artikel einsehen.
Nutzungsbeispiel:
- An wichtigen Tagen können Sie kostenlose Artikel verschenken (z. B. am Gründungstag des Projekts), um treue Spieler zu belohnen.
- Sie können im Ingame-Shop kostenlose Starterpakete für das Spiel verschenken, um neue Nutzer für das Spiel zu gewinnen.
Sie können das kostenlose Verschenken von einzigartigen Artikeln einschränken, falls der Nutzer diese bereits besitzt.
So richten Sie kostenlose Artikel ein:
- Fügen Sie dem Katalog kostenlose Artikel hinzu.
- Implementieren Sie eine Logik für die Bestellung kostenloser Artikel durch die Benutzer.
- Implementieren Sie die Logik für die Gewährung kostenloser Artikel an den Benutzer.
Dem Katalog kostenlose Artikel hinzufügen
Detaillierte Anweisung zum Erstellen von Artikeln finden Sie in den folgenden Dokumentationsabschnitten:
Wenn Sie einen kostenlosen Artikel erstellen oder bearbeiten möchten, müssen Sie unter Kostenpflichtig oder kostenlos die Option Kostenloser Artikel, Kostenloses Paket oder Kostenloses Bundle auswählen.
Bestellung von kostenlosen Artikels durch den Benutzer
Ein Benutzer kann einen kostenlosen Artikel auf zwei Wege bestellen:
- per One-Click-Bestellung (ohne Nutzung des Warenkorbs) – eine SKU in beliebiger Menge, z. B.: 100 identische Tränke.
- über den Warenkorb – beliebige Artikeltypen in beliebiger Menge.
One-Click-Bestellung eines kostenlosen Artikels
Implementieren Sie dazu die SDK-Methode PurchaseFreeItem
, sodass der Benutzer beim Klick auf die entsprechende Schaltfläche im Katalog den kostenlosen Artikel bestellen kann.
Die Lieferung von Artikeln an das Benutzerinventar aufseiten von Xsolla erfolgt sofort nach einer erfolgreichen Anfrage an diese Methode (ohne die Pay Station öffnen zu müssen).
Bestellung von kostenlosen Artikeln über den Warenkorb
Bei Nutzung des Warenkorbs:
- Wenn der Warenkorb sowohl kostenpflichtige als auch kostenlose Artikel enthält, rufen Sie die SDK-Methode
Purchase
der KlasseCart
auf. Diese Methode kapselt Methoden zum Anlegen einer Bestellung, zum Öffnen eines Zahlungsportals und zum Tracken des Bestellstatus.
- Enthält der Warenkorb nur kostenlose Artikel, rufen Sie die SDK-Methode
PurchaseFreeCart
der KlasseCart
auf. Die Lieferung der Artikel an das Benutzerinventar aufseiten Xsollas erfolgt sofort nach der erfolgreichen Anfrage an diese Methode (ohne die Bezahlmaske der Pay Station öffnen zu müssen).
Benutzern kostenlose Artikel gewähren
Die Methoden Purchase
, PurchaseFreeItem
und PurchaseFreeCart
enthalten die Logik für das Tracken des Bestellstatus. Wenn Sie diese Methoden aufrufen, müssen Sie im Parameter onSuccess
eine Funktion übermitteln, die aufgerufen wird, wenn sich der Status der Bestellung in done
ändert. Aktualisieren Sie das Inventar aufseiten des Anwendungs-Clients auf einen der folgenden Wege:
- mit den SDK-Methoden für die Benutzerinventaranzeige
- mit den an die
onSuccess
-Rückruffunktion der Kaufmethoden übermittelten Bestelldaten
Nützliche Links
Haben Sie einen Tippfehler oder einen anderen Textfehler gefunden? Wählen Sie den Text aus und drücken Sie Strg+Eingabe.