Virtuelle Gegenstände

Funktionsweise

Virtuelle Gegenstände sind Ingame-Items, die Nutzer gegen echte oder virtuelle Währung kaufen oder als Bonus erhalten können. Diese Gegenstände sind nicht physisch und können ausschließlich im Spiel verwendet werden. Beispiele für virtuelle Gegenstände sind: Skins, Tränke, Waffen und andere Artikel, die das Gameplay oder das Aussehen eines Spielecharakters beeinflussen.

Hauptmerkmale:

• Flexible Preiskonfiguration:
  • Festlegen eines Preises für einen einzelnen Artikel in realer und/oder virtueller Währung.
  • Erstellen kostenloser Artikel.
• Automatische Erkennung von Land und Währung des Nutzers.
• Konfiguration der Verfügbarkeit:
  • Einschränkung des Artikelverkaufs in bestimmten Regionen.
  • Begrenzen der Anzahl der zum Kauf verfügbaren Artikel.
  • Begrenzen der Anzeigedauer von Artikeln im Shop.
  • Konfigurieren von Artikeln, die nicht zum Kauf verfügbar sind. Ein Artikel kann im Katalog ausgeblendet sein, aber weiterhin als Teil eines Bundles oder als Bonus für einen anderen Artikel verfügbar sein.

Einrichtung

2. Wählen Sie erst Manuell erstellen aus und danach in der Drop-down-Liste die Option Virtuelle Gegenstände.

3. Geben Sie im Abschnitt Allgemeine Einstellungen Folgendes an:
   • SKU
   • Eine oder mehrere Gruppen, zu denen der Artikel gehören soll (optional)
   • Name
   • kurze Beschreibung
   • erweiterte Beschreibung – aktivieren Sie hierzu den entsprechenden Schalter (optional)

4. Im Abschnitt Medien können Sie optional ein oder mehrere Bilder oder Videos von Ihrem Gerät oder über einen Link hochladen. In dem mit dem Xsolla-Website-Editor erstellten Shop wird auf allen Artikelkarten die als Main gekennzeichnete Datei angezeigt, während die übrigen Dateien nur auf Artikelkarten mit einer Mediengalerie sichtbar sind. Die als Main gekennzeichnete Datei wird außerdem in den Antworten der API-Aufrufe zur Katalogabfrage zurückgegeben.

5. Legen Sie im Abschnitt Preiseinstellungen Preise fest oder erstellen Sie einen kostenlosen Gegenstand:
   • Wenn Sie einen Preis festlegen möchten, müssen Sie Kostenpflichtiger Gegestand auswählen, die Schalter Preise in echter Währung und/oder Preise in virtuelle Währung aktivieren und danach die gewünschten Preis angeben. Bei Bedarf können Sie regionale Preise konfigurieren.
   • Wenn Sie stattdessen keinen Preis festlegen möchten, wählen Sie Kostenloser Gegenstand aus.

6. So begrenzen Sie, wie viele Artikel ein Nutzer erhalten kann:
   1. Aktivieren Sie den Schalter im Abschnitt Limits, und legen Sie die gewünschte Höchstmenge fest.
   2. Konfigurieren Sie, wie häufig das Limit zurückgesetzt werden soll. Wählen Sie dazu einen Zeitraum aus der Drop-down-Liste aus:
      1. Täglich.
      2. Wöchentlich.
      3. Monatlich.
      4. Benutzerdefiniertes Intervall. Das Intervall läuft ab dem Datum los, an dem der Artikel im Shop erstmals angezeigt wird.
      5. Nicht regelmäßig zurücksetzen.
   3. Legen Sie anhand der Parameter für den ausgewählten Zeitraum fest, wann das Limit zurückgesetzt wird.

7. So richten Sie eine zeitliche Anzeigebegrenzung für den Artikel ein (optional):

   1. Aktivieren Sie den Schalter im Abschnitt Bestimmten Anzeigezeitraum hinzufügen.
   2. Legen Sie die Zeitzone sowie den Beginn und das Ende des Zeitraums fest.

   Aktivieren Sie bei Bedarf den Schalter Kein Enddatum, um das Ende des Anzeigezeitraums offen zu lassen.

8. Konfigurieren Sie Attribute optional auf eine der folgenden Arten:
   1. Attribute und zugehörige Werte im JSON-Format hinzufügen
   2. Attribute und Werte manuell erstellen und diese einem bestimmten Artikel zuordnen

9. Falls der kostenpflichtige Gegenstand bei Zufallsmechaniken (z. B. Lootboxen oder Gacha) verwendet wird, müssen Sie den Schalter Als kostenpflichtige zufällige Belohnung kennzeichen aktivieren.

10. Klicken Sie auf Erstellen.

11. Wählen Sie im sich öffnenden Fenster den Artikelstatus aus, und klicken Sie auf Weiter.

Der erstellte Artikel wird im Abschnitt Alle Artikel angezeigt.

Über die API einrichten

Zur Einrichtung virtueller Gegenstände können Sie die Aufrufe aus dem Unterabschnitt Admin in der Gruppe Virtuelle Gegenstände und Währung verwenden.

Virtuelle Gegenstände im Shop anzeigen

Die Anzeige virtueller Gegenstände hängt davon ab, wie der Katalog implementiert ist – über den Site Builder oder per API.

Anzeige über den Site-Editor

So zeigen Sie virtuelle Gegenstände auf Ihrer Website an:

1. Virtuellen Gegenstand erstellen.

2. Wechseln Sie in Ihrem Projekt im Kundenportal zum Abschnitt Storefronts > Websites.

3. Klicken Sie im Bereich der gewünschten Website auf Open Site Builder.

2. Wechseln Sie in Ihrem Projekt im Konto für Handyspiele zum Abschnitt Web Shop.

3. Klicken Sie auf die gewünschte Website.

4. Wenn Ihre Website mehrere Seiten enthält, wählen Sie die benötigte aus:

   1. Klicken Sie oben im Editor auf den aktuellen Seitentitel.
   2. Wählen Sie die gewünschte Seite aus der Drop-down-Liste.

5. Wählen Sie im Block Store im Feld Item type die Option Virtual items aus und wählen Sie im Feld Item group die Artikelgruppe aus, die Sie auf der Website verkaufen möchten.

6. Ein Artikelkarten-Layout festlegen.

7. Nachdem Sie alle erforderlichen Änderungen vorgenommen und Ihre Website für den Start vorbereitet haben:

   1. Klicken Sie oben rechts im Site-Editor auf Publish.
   2. Aktivieren Sie die Kontrollkästchen neben den Seiten, die Sie veröffentlichen möchten.
   3. Klicken Sie auf Publish.

Sobald die Website veröffentlicht ist, steht ein Bereich mit einer Gruppe virtueller Gegenstände zur Verfügung. Wenn keine Gegenstände angezeigt werden, prüfen Sie, ob deren Status auf „Available“ gesetzt ist und keine zeitbasierte Anzeigebeschränkung aktiv ist.

Informationen zu virtuellen Gegenständen per API abrufen

Um den Katalog virtueller Gegenstände clientseitig abzurufen, verwenden Sie die Methoden aus dem Unterabschnitt Catalog der Methodengruppe Virtuelle Gegenstände und Währung. Für diese Methoden ist keine Autorisierung erforderlich.

Virtuelle Gegenstände an Nutzer gewähren

Je nach Artikelart und den Integrationseinstellungen wird der virtuelle Gegenstand dem Nutzer auf eine der folgenden Arten gewährt:

• Wenn Sie PlayFab integriert haben, werden Virtuelle Währung und Gegenstände automatisch dem PlayFab-Inventar des Nutzers gutgeschrieben.
• Wenn Sie ein benutzerdefiniertes Auslieferungssystem verwenden, vergeben Sie alle virtuellen Gegenstände und Währung auf Ihrer Seite. Wir empfehlen, einen Webhook-Handler einzurichten, um Bestelldaten in Ihrem Backend zu empfangen. Die erforderlichen Daten sind im Webhook Successful payment for order enthalten.

Weitere Informationen zu dieser und anderen Methoden zum Abruf von Kaufdaten finden Sie im Abschnitt Bestellstatus-Tracking einrichten.

Nützliche Links