Virtuelle Währung

Inhaltsverzeichnis

So funktioniert's
Für wen ist es
Wie komme ich dazu

So funktioniert's

Virtuelle Währung ist virtuelles Geld, das zum Kauf und Verkauf virtueller Güter dient. Die virtuelle Währung beeinflusst die Spielökonomie bzw. hängt mit der Monetarisierung der Anwendung zusammen.

Hauptmerkmale:

Verkauf einer beliebigen Menge von virtueller Währung oder eines separaten Währungspakets mit einer fixen Menge.
Verkauf von Premiumwährung.
Verkauf von virtueller Währung und virtuellen Währungspaketen gegen echtes oder virtuelles Geld.
Bereitstellung der Währung in das Spielerinventar.
Beschränkung der Anzahl der käuflich erhältlichen virtuellen Währungspakete.
Begrenzung der Anzeigedauer von virtueller Währung und virtuellen Währungspaketen im Shop.
Kostenlose Artikel.

Wenden Sie sich an Ihren Customer Success Manager oder senden Sie eine E-Mail an csm@xsolla.com, wenn Sie virtuelle Währung und virtuelle Währungspakete erstellen und dabei als Preis einen Nullwert festlegen möchten.

Optionen für den Verkauf von Währungen

Es gibt folgende Optionen für den Verkauf von virtueller Währung:

Verkauf einer beliebigen Menge von virtueller Währung
Verkauf von virtuellen Währungspaketen

Verkauf einer beliebigen Menge von virtueller Währung

Verkaufen Sie virtuelle Währung in den von Benutzern gewünschten Mengen. Implementieren Sie die Möglichkeit der Eingabe der gewünschten Währungsmenge aufseiten der Client-Anwendung.

Verkauf von virtuellen Währungspaketen

Verkaufen Sie virtuelle Währung in vorab festgelegten Mengen. So können Sie Ingame-Währung in Form von Paketen verkaufen, die günstiger sind als der Kauf derselben Menge über die benutzerdefinierte Eingabe.

Beispiel: Sie können für jedes Paket einen Aktionspreis festlegen, der günstiger ist als die Menge der darin enthaltenen virtuellen Währung, z. B.: 1 Münze = 1 USD, 500 Münzen = 450 USD.

Einschränkungen:

Sie können einem Paket nur eine Art von virtueller Währung hinzufügen.
Sie können ein virtuelles Währungspaket erstellen, ohne seinen Preis in realer oder virtueller Währung anzugeben. Wird ein solcher Artikel im Shop angezeigt, ist er für die Benutzer kostenlos erhältlich.
Die Menge der virtuellen Währung darf nur als Ganzzahl angegeben werden.

Währungsbereitstellung

Verfügbare Bereitstellungsmethoden:

Direkt in das Xsolla-Inventar (Standardmethode). Vor der Bereitstellung wird das virtuelle Währungspaket entpackt und die darin enthalten Währung im Spielerinventar bereitgestellt.
Zu PlayFab, sofern es integriert ist.

Wenn die Logik des Ingame-Shops aufseiten Ihrer Server implementiert ist, können Sie die Kauf-Webhooks konfigurieren.

Premiumwährung

Premiumwährung ist an die Plattform, auf der der Kauf stattfindet, gebunden und kann nur gegen Echtgeld gekauft werden kann.

Beschränkungen:

Sie können einer Währung den Premium-Status nur bei der Ersteinrichtung vergeben.
Sie können virtuelle Währungspakete, die Premiumwährung enthalten, nur gegen Echtgeld verkaufen.

So speichern Sie Premiumwährung auf verschiedenen Plattformen getrennt voneinander:

Stellen Sie den Schalter Premiumwährung auf Ein.

Übermitteln Sie beim Aufruf der API-Endpunkte für die Inventarverwaltung den String mit der Plattform, auf der der Kauf stattfindet, im Feld platform.

BEISPIEL

Copy

Full screen

Small screen

"platform": “playstation_network”

Anzahl der käuflich erhältlichen virtuellen Währungspakete beschränken

Der Kauf virtueller Währungspakete lässt sich beschränken. Sie können beispielsweise:

festlegen, wie viele virtuelle Währungspakete ein Benutzer kaufen darf;
Willkommenspakete mit virtueller Währung erstellen, die nur einmal gekauft werden können.

Erreicht der Benutzer das festgelegte Limit, wird ihm das virtuelle Währungspaket nicht mehr im Katalog angezeigt.

Sie können die maximale und die verbleibende Anzahl von Paketen anzeigen, die der Benutzer kaufen kann.

Um beim Erstellen eines virtuellen Währungspakets im Kundenportal ein Kauflimit festzulegen, müssen Sie den Schalter Anzahl der Paketkäufe pro Benutzer beschränken auf Ein stellen, und festlegen, wie oft das Paket gekauft werden darf.

Sie können die Methoden der Untergruppe Katalog aus der Methodengruppe Virtuelle Gegenstände und Währung nutzen, um Informationen über virtuelle Währungspakete abzurufen.

In der Antwort sind neben den Informationen über das virtuelle Währungspaket die folgenden Daten enthalten:

wie viele virtuelle Währungspakete ein Benutzer maximal kaufen kann
die verbleibende Anzahl der virtuellen Währungspakete, die ein Benutzer kaufen kann

Wie Sie Beschränkungen einrichten oder aktualisieren, erfahren Sie in der Anleitung Limits pro Benutzer.

Nicht autorisierten Benutzern wird stets angezeigt, wie viele virtuelle Währungspakete sie maximal kaufen können. Um dem Benutzer die verbleibende Anzahl der virtuellen Währungspakete (vorbehaltlich des aktuellen Limits) anzuzeigen, müssen Sie den Währungspakete-Katalog mithilfe der Methoden des Unterabschnitts Katalog aus der Methodengruppe Virtuelle Gegenstände und Währung anfordern und dabei die Benutzerautorisierungsdaten übermitteln.

Um die Anzahl der für den Benutzer erhältlichen virtuellen Währungspakete korrekt anzuzeigen, müssen Sie die Authentifizierung konfigurieren.

Antwortbeispiel:

Copy

Full screen

Small screen

{
  "items": [
    {
      "sku": "vc_package_1",
      "name": "VC Name first package",
      "groups": [],
      "attributes": [],
      "type": "bundle",
      "description": "VC Short Package Description",
      "image_url": "http://vc_package_image.png",
      "is_free": false,
      "price": {
        "amount": "2.0000",
        "amount_without_discount": "2.0000",
        "currency": "USD"
      },
      "bundle_type": "virtual_currency_package",
      "content": [
        {
          "description": "Big Rocket - short description",
          "image_url": "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png",
          "sku": "big_rocket",
          "name": "Big Rocket",
          "type": "virtual_currency",
          "quantity": 100,
          "inventory_options": {
            "consumable": {
              "usages_count": 1
            },
            "expiration_period": null
          }
        }
      ],
      "virtual_prices": [],
      "limits": {
        "per_user": {
          "total": 5,
          "available": 5
          },
        "per_item": null
       },
      "can_be_bought": true
    },
    {
      "sku": "vc_package_3",
      "name": "VC Name third package",
      "groups": [],
      "attributes": [],
      "type": "bundle",
      "description": "VC Short Package Description",
      "image_url": "http://vc_package_image.png",
      "is_free": false,
      "price": {
        "amount": "4.0000",
        "amount_without_discount": "4.0000",
        "currency": "USD"
      },
      "bundle_type": "virtual_currency_package",
      "content": [
        {
          "description": "description",
          "image_url": "http://image.png",
          "sku": "shotgun_raider",
          "name": "SHOTGUN FOR TRUE RAIDERS",
          "type": "virtual_currency",
          "quantity": 200,
          "inventory_options": {
            "consumable": {
              "usages_count": 1
            },
            "expiration_period": null
          }
        }
      ],
      "virtual_prices": [],
      "limits": {
        "per_user": {
          "total": 5,
          "available": 5
          },
        "per_item": null
       },
      "can_be_bought": true
    }
  ]
}

Xsolla achtet darauf, dass die Limits nicht überschritten werden und verhindert, dass Benutzer mehr virtuelle Währungspakete als erlaubt kaufen.

Öffnet ein Benutzer das Zahlungsportal und bezahlt ein Paket, verfallen alle unbezahlten Bestellungen, die dieses Paket enthalten.

Beispiel: Der Benutzer öffnet Zahlungsmasken für ein Paket, das Kaufbeschränkungen unterliegt, in mehreren Browser-Tabs. Es werden also automatisch mehrere Bestellungen für dasselbe Paket angelegt. Nach dem Kauf des Pakets in einem der geöffneten Tabs storniert Xsolla alle unbezahlten Bestellungen, die dasselbe Paket enthalten.

Anzeigedauer für virtuelle Währung und virtuelle Währungspakete im Shop begrenzen

Sie können den Anzeigezeitraum für eine virtuelle Währung und ein virtuelles Währungspaket im Shop festlegen und dadurch:

den Katalog je nach Zeitraum relevanter gestalten, z. B. während der Weihnachtsfeiertage
eine virtuelle Währung und ein virtuelles Währungspaket im Voraus erstellen, ohne die Währung bzw. das Paket im Katalog anzuzeigen
Benutzer zum Kauf motivieren, indem man einen Timer neben der virtuellen Währung bzw. dem Paket einblendet

Wenn Sie eine Katalogoberfläche mit dem Website-Baukasten erstellen, wird der Timer automatisch eingeblendet. Wenn Sie einen Katalog ohne den Website-Baukasten erstellen, müssen Sie den Timer selbst implementieren.

Der Anzeigezeitraum der virtuellen Währung im Shop lässt sich nur mit API-Methoden einrichten.

Um die Anzeigedauer einer virtuellen Währung im Shop über die API zu begrenzen, übermitteln Sie die folgenden Parameter im API-Aufruf Create virtual currency oder Update virtual currency:

periods[0].date_from mitsamt dem Startdatum und der Startuhrzeit des Artikelanzeigezeitraums im Format YYYY-MM-DDThh:mm:ss±TMZ, wobei TMZ die Zeitzonenangabe im Format hh:mm ist.
periods[0].date_until mitsamt dem Enddatum und der Enduhrzeit des Artikelanzeigezeitraums im Format YYYY-MM-DDThh:mm:ss±TMZ, wobei TMZ die Zeitzonenangabe – bezogen auf GMT – im Format hh:mm ist. Wenn Sie keine Ende für den Anzeigezeitraum des Artikels festlegen möchten, übermitteln Sie null.

Sie können mehrere Zeiträume für die Anzeige einer virtuellen Währung im Shop festlegen. Übermitteln Sie dazu in der Methode Create virtual currency oder Update virtual currency ein Objekt-Array mit dem jeweiligen Start- und Enddatum der Zeiträume.

Beispiel:

Copy

Full screen

Small screen

"periods": [
      {
        "date_from": "2022-06-10T14:00:00+03:00",
        "date_until": "2022-06-30T14:00:00+03:00"
      },
       {
        "date_from": "2022-07-10T14:00:00+03:00",
        "date_until": "2022-07-30T14:00:00+03:00"
      },
       {
        "date_from": "2022-08-10T14:00:00+03:00",
        "date_until": "2022-08-30T14:00:00+03:00"
      }
]

So begrenzen Sie über das Kundenportal, wie lange ein virtuelles Währungspaket im Shop angezeigt wird:

Stellen Sie beim Erstellen eines virtuellen Währungspakets im Kundenportal den Schalter Im Online-Shop anzeigen auf Ein.
Wählen Sie Zeitraum, und legen Sie die Zeitzone sowie das Start- und Enddatum fest. Wenn Sie kein Enddatum für den Anzeigezeitraum des Pakets festlegen möchten, setzen Sie ein Häkchen bei Kein Enddatum.

Um die Anzeigedauer eines Pakets im Shop über die API zu begrenzen, übermitteln Sie die folgenden Parameter im API-Aufruf Create virtual currency package oder Update virtual currency package:

periods[0].date_from mitsamt dem Startdatum und der Startuhrzeit des Artikelanzeigezeitraums im Format YYYY-MM-DDThh:mm:ss±TMZ, wobei TMZ die Zeitzonenangabe im Format hh:mm ist.
periods[0].date_until mitsamt dem Enddatum und der Enduhrzeit des Artikelanzeigezeitraums im Format YYYY-MM-DDThh:mm:ss±TMZ, wobei TMZ die Zeitzonenangabe – bezogen auf GMT – im Format hh:mm ist. Wenn Sie keine Ende für den Anzeigezeitraum des Artikels festlegen möchten, übermitteln Sie null.

Sie können mehrere Zeiträume für die Anzeige eines Pakets im Shop festlegen. Übermitteln Sie dazu in der Methode Create virtual currency package oder Update virtual currency package ein Objekt-Array mit dem jeweiligen Start- und Enddatum der Zeiträume.

Beispiel:

Copy

Full screen

Small screen

"periods": [
      {
        "date_from": "2022-06-10T14:00:00+03:00",
        "date_until": "2022-06-30T14:00:00+03:00"
      },
       {
        "date_from": "2022-07-10T14:00:00+03:00",
        "date_until": "2022-07-30T14:00:00+03:00"
      },
       {
        "date_from": "2022-08-10T14:00:00+03:00",
        "date_until": "2022-08-30T14:00:00+03:00"
      }
]

Für wen ist es

Partner, die eine Spielökonomie aufbauen oder ihr Spiel monetarisieren möchten, indem sie es um virtuelle Währung ergänzen und virtuelle Gegenstände verkaufen.
Partner, die mindestens eines der folgenden Produkte integriert haben:
- Ingame-Online-Shop samt konfiguriertem Virtuelle-Gegenstände-Modul.
- Buy Button samt konfiguriertem Spielschlüssel-Modul.

Wie komme ich dazu

Voraussetzungen

Melden Sie sich beim Xsolla-Kundenportal an.
Öffnen Sie ein Projekt.

Konfigurieren Sie das Ingame-Online-Shop- oder das Buy Button-Modul.