Virtuelle Gegenstände

So funktioniert's

Bei virtuellen Gegenständen handelt es sich um Ingame-Inhalte, die Sie gegen echte oder virtuelle Währung verkaufen können.

Hauptmerkmale:

• Festlegen von Preisen in echter und virtueller Währung.
• Konfigurieren eines hierarchisch strukturierten Katalogs.
• Automatische Erkennung des Landes des Benutzers und der entsprechenden Landeswährung.
• Beschränkung der Anzahl der käuflich erhältlichen Artikel.
• Kostenlose Artikel.

Merkmale der Preiskonfiguration:

• Ein Artikel kann sowohl in echter als auch in virtueller Währung bepreist werden.
• Sie können Preise in mehreren echten oder virtuellen Währungen festlegen. In diesem Falle müssen Sie eine Standardwährung festlegen.
• Sie können einen Artikel erstellen, ohne seinen Preis in echter oder virtueller Währung anzugeben. Wird ein solcher Artikel im Shop angezeigt, ist er für die Benutzer kostenlos erhältlich.

Einschränkungen bei der Preiskonfiguration:

• Sie können keinen Artikel mit einem Preiswert von Null erstellen.

Es gibt drei Typen von virtuellen Gegenständen:

• aufbrauchbar
• nicht aufbrauchbar
• zeitlich begrenzte Artikel

Virtuelle aufbrauchbare Gegenstände

Ein aufbrauchbar Gegenstand ist ein Gegenstand im Inventar. Er lässt sich in großer Stückzahl und mehrmals kaufen. Die Menge nimmt mit jedem Einsatz durch den Benutzer ab.

Hauptmerkmale:

• Auffüllen des Bestands an Gegenständen im Inventar.
• Hinterlegen zahlreicher Instanzen desselben Gegenstands im Benutzerinventar.
• Nutzung/Verbrauch kann aufseiten des Clients erfolgen.

Beispiel: Granaten, Kugeln usw.

Nicht aufbrauchbare virtuelle Gegenstände

Ein nicht aufbrauchbar virtueller Gegenstand ist ein Gegenstand im Inventar. Er kann nur einmal gesammelt bzw. gekauft werden.

Hauptmerkmale:

• Benutzer können nur ein Stück dieses Gegenstands im Inventar halten.
• Verschwindet durch den Einsatz aufseiten des Clients nicht aus dem Inventar. Lässt sich nur durch eine Servermethode aus dem Inventar entfernen.

Beispiel: Status, Skins, vorinstallierte DLC, Zugang zu einem Ort, Werbefreiheit in Handyspielen usw.

Zeitlich begrenzte Artikel

Bei einem zeitlich begrenzten Artikel handelt es sich um einen Einmalkauf. Der Benutzer muss ihn also nach Ablauf erneut erwerben.

Hauptmerkmale:

• Wird nach dem Ablauf inaktiv.
• Benutzer muss das Abonnement erneut erwerben, damit es aktiviert wird.

Beispiel: Battle Pass, Season Pass, temporärer Zugriff auf Ingame-Items, Skins oder sonstige Inhalte.

Weitere Informationen finden Sie in der Anleitung für zeitlich begrenzte Artikel.

Anzahl der käuflich erhältlichen Artikel beschränken

Der Artikelkauf lässt sich beschränken. Sie können beispielsweise:

• festlegen, wie viele Artikel ein Benutzer kaufen darf;
• Willkommensartikel erstellen, die nur einmal gekauft werden können.

Erreicht der Benutzer das festgelegte Limit, wird ihm der Artikel nicht mehr im Katalog angezeigt.

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

Um beim Erstellen eines Artikels im Kundenportal ein Kauflimit festzulegen, müssen Sie den Schalter Anzahl der Käufe dieses Artikels pro Benutzer beschränken auf EIN stellen, und festlegen, wie oft der Artikel gekauft werden darf.

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

In der Antwort sind neben den Informationen über den virtuellen Gegenstand die folgenden Daten enthalten:

• wie viele Artikel ein Benutzer maximal kaufen kann
• die verbleibende Anzahl der Artikel, die ein Benutzer kaufen kann

Antwortbeispiel:

{
  "items": [
    {
      "sku": "big_rocket",
      "name": "Big Rocket",
      "groups": [
        {
          "external_id": "accessory",
          "name": "Accessory"
        }
      ],
      "attributes": [
        {
          "external_id": "stack_size",
          "name": "Stack size",
          "values": [
            {
              "external_id": "size_e3364991f92e751689a68b96598a5a5a84010b85",
              "value": "5"
            }
          ]
        }
      ],
      "type": "virtual_good",
      "description": "Big Rocket - description",
      "image_url": "https://popmedia.blob.core.windows.net/popyourself/male/outfit/male_armor_white_a-01.png",
      "is_free": false,
      "price": {
        "amount": "100.99",
        "amount_without_discount": "100.99",
        "currency": "USD"
      },
      "virtual_prices": [
        {
          "amount": 100,
          "sku": "vc_test",
          "is_default": true,
          "amount_without_discount": 100,
          "image_url": "http://image.png",
          "name": "SHOTGUN FOR TRUE RAIDERS",
          "type": "virtual_currency",
          "description": "description"
        }
      ],
      "can_be_bought": true,
      "inventory_options": {
        "consumable": {
          "usages_count": 1
        },
        "expiration_period": {
          "type": "day",
          "value": 1
        }
      },
      "virtual_item_type": "non_renewing_subscription",
      "limits": {
        "per_user": {
            "total": 5,
            "available": 5
        },
        "per_item": null
      },
}

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, mit der sich virtuelle Gegenstände kaufen lassen.
• Partner, die den Ingame-Online-Shop integriert haben und einen neuen Produkttyp (virtuelle Gegenstände) einrichten möchten.

Wie komme ich dazu

Integrationsablauf

1. Konfigurieren Sie virtuelle Gegenstände und Gruppen virtueller Gegenstände.
2. Konfigurieren Sie regionale Beschränkungen und regionale Preise.

Virtuelle Gegenstände und Gruppen virtueller Gegenstände konfigurieren

Um virtuelle Gegenstände einrichten zu können, müssen Sie Gruppen von virtuellen Gegenständen konfigurieren. Mit Gruppen können Sie einen hierarchisch strukturierten Katalog erstellen. Gegenstände, denen keine bestimmte Gruppe zugewiesen ist, werden der Gruppe Ungrouped hinzugefügt.

Sie können virtuelle Gegenstände und Gruppen virtueller Gegenstände wie folgt einrichten:

• über das Kundenportal
• über API-Aufrufe

Konfiguration über das Kundenportal

• Gruppen von virtuellen Gegenständen
• Virtuelle Gegenstände

So richten Sie Gruppen virtueller Gegenstände ein:

1. Verknüpfen Sie das Modul Virtuelle Gegenstände im Kundenportal.

2. Navigieren Sie zu Online-Shop > Virtuelle Gegenstände, und klicken Sie auf Gruppe erstellen.

3. Legen Sie die folgenden Parameter fest:
   1. Gruppencode.
   2. Gruppenname.

4. Stellen Sie den Umschalter Gruppe im Online-Shop anzeigen auf EIN.
5. Klicken Sie auf Gruppe erstellen.

So richten Sie einen virtuellen Gegenstand ein:

1. Verknüpfen Sie das Modul Virtuelle Gegenstände im Kundenportal.

2. Gegenstand anlegen.

3. Legen Sie für jeden Gegenstand Folgendes fest:
   1. Bild.
   2. SKU.
   3. Eine oder mehrere Gruppen, zu denen der Gegenstand gehören soll.
   4. Name.
   5. Beschreibung.
   6. Gegenstandseigenschaften: aufbrauchbar, nicht aufbrauchbar oder zeitlich begrenzte Artikel.
   7. Preise in echter oder virtueller Währung.

4. Stellen Sie die Option Gegenstand im Store aktivieren auf EIN.
5. Klicken Sie auf Gegenstand anlegen.

Konfiguration über API-Aufrufe

Nutzen Sie die API-Aufrufe aus der Untergruppe Admin der Gruppe Virtual Items & Currency, um virtuelle Gegenstände einzurichten.

Die Basisauthentifizierung wird für API-Aufrufe genutzt. Übermitteln Sie Authorization:Basic <your_authorization_basic_key>, wobei <your_authorization_basic_key> das gemäß dem Base64-Standard kodierte Paar Händler-ID:API-Schlüssel ist. Die Parameter finden Sie im Kundenportal:

• Die Händler-ID finden Sie:
  • unter Projekteinstellungen > Webhooks.
  • unter Firmeneinstellungen > Firma.
  • in der URL in der Adresszeile des Browsers auf einer beliebigen Seite im Kundenportal. Die URL weist das folgende Format auf: https://publisher.xsolla.com/​Händler-ID/Kundeportalabschnitt.

• Der API-Schlüssel wird im Kundenportal nur einmal angezeigt, nämlich dann, wenn er erstellt wird. Sie sind selbst dafür verantwortlich, den Schlüssel zu speichern. Einen neuen Schlüssel können Sie in den folgenden Abschnitten erstellen:
  • Firmeneinstellungen > API-Schlüssel
  • Projekteinstellungen > API-Schlüssel

Nutzen Sie die API-Aufrufe aus der Untergruppe Catalog der Gruppe Virtual Items & Currency, um den Katalog mit virtuellen Gegenständen aufseiten des Clients abzurufen. Diese Aufrufe erfordern keine Basisautorisierung.

Nutzen Sie den API-Aufruf Get virtual items list, um die komplette, nicht in Gruppen unterteilte Liste der Gegenstände abzurufen. Um eine Liste der in einer bestimmten Gruppe enthaltenen Gegenstände abzurufen, übermitteln Sie den Parameter external_id an den Aufruf Get items list by specified group.

Regionale Beschränkungen und regionale Preise festlegen

Um regionale Beschränkungen für virtuelle Gegenstände einzurichten, übermitteln Sie ein Array von Objekten mit den Kennungen der Regionen, in denen der Gegenstand erhältlich sein soll, an den Aufruf Create item oder Update item.

"regions": [{
     “id”: “123”
  }, {
     “id”: “456”
  }
]

Um regionale Preise für virtuelle Gegenstände einzurichten, übermitteln Sie ein Array von Objekten mit regionalen Preiseinstellungen an den Aufruf Create item oder Update item.

"regional_prices": [{
     “region_id”: “123”,
     “country_iso”: “CHN”,
     “amount”: 40,
     “currency_iso”: “CNY”,
     “is_default”: true,
     “is_enabled”: true
  }
]

Diese Seite bewerten

Gibt es etwas, das wir verbessern können? Senden

Jetzt nicht

Vielen Dank für Ihr Feedback!