Virtuelle Gegenstände

So funktioniert's

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:

• Preise flexibel konfigurierbar:
  • Gegenstände lassen sich in echter und/oder virtueller Währung bepreisen.
  • Es lassen sich kostenlose Gegenstände erstellen.
• Das Land und die Währung des Nutzers werden automatisch erkannt.
• Verfügbarkeit konfigurierbar:
  • Der Verkauf von Gegenständen lässt sich auf bestimmte Regionen beschränken.
  • Wie oft ein Gegenstand gekauft werden kann, lässt sich begrenzen.
  • Wie lange der Gegenstand im Shop angezeigt wird, lässt sich begrenzen.
  • Es lassen sich Gegenstände konfigurieren, die nicht zum Kauf angeboten werden: Ein Gegenstand kann im Katalog ausgeblendet sein, aber trotzdem als Teil eines Bundles oder als Bonus für einen anderen Artikel erhältlich sein.

Einrichtung

Im Kundenportal einrichten

1. Navigieren Sie in Ihrem Kundenportal-Projekt zum Menüpunkt Artikelkatalog > Alle Artikel.
2. Klicken Sie auf Hinzufügen, und wählen Sie aus der Drop-down-Liste die Option Virtuelle Gegenstände aus.

3. Legen Sie die folgenden Parameter fest:
   • Bild (optional)
   • SKU
   • eine oder mehrere Gruppen, zu denen der Gegenstand gehören soll
   • Name
   • Beschreibung (optional)
4. Indem Sie den entsprechenden Status auswählen, lässt sich steuern, wie virtuelle Gegenstände im Shop angezeigt werden.

5. Legen Sie Preise fest oder erstellen Sie einen kostenlosen Gegenstand im Feld Kostenlos oder kostenpflichtig:

1. • Wählen Sie Kostenloser Gegenstand, um einen kostenlosen Gegenstand zu erstellen.

1. • Wenn Sie stattdessen einen Preis festlegen möchten, wählen Sie Kostenpflichtiger Gegenstand. Legen Sie dann den Preis in echter Währung fest. Bei Bedarf können Sie regionale Preise festlegen.

6. Wenn Sie begrenzen möchten, wie oft ein Nutzer den Gegenstand kaufen darf, müssen Sie den Schalter Anzahl der Käufe dieses Artikels pro Benutzer beschränken aktivieren und die gewünschte Höchstmenge festlegen.
7. So legen Sie fest, wie häufig das Limit zurückgesetzt wird:

1. 1. Wählen Sie aus der Drop-down-Liste einen Zeitraum aus:
      • Täglich.
      • Wöchentlich.
      • Monatlich.
      • Benutzerdefiniertes Intervall – wird anhand des Anzeigezeitraums des Gegenstands berechnet.
      • Nicht regelmäßig aktualisieren.

1. 2. Legen Sie entsprechend dem gewählten Zeitraum fest, wann das Limit zurückgesetzt werden soll.

8. Legen Sie ein Zeitlimit für die Anzeige des Gegenstands fest (optional):

1. 1. Wählen Sie unter Gegenstand im Store aktivieren die Option Begrenzte Zeit.

1. 2. Geben Sie die Zeitzone sowie den Beginn und das Ende des Zeitraums an.

1. 1. Wenn Sie für den Gegenstand kein Anzeigezeitraumende angeben möchten, aktivieren Sie das Kontrollkästchen Kein Enddatum.

9. Konfigurieren Sie Attribute mithilfe einer der folgenden Methoden (optional):

1. 1. Attribute und zugehörige Werte im JSON-Format hinzufügen

1. 2. Attribute und Werte manuell erstellen und diese einem bestimmten Artikel zuordnen

10. Überprüfen Sie die Einstellungen, und klicken Sie auf Artikel anlegen.

Über die API einrichten

Virtuelle Gegenstände können Sie mit den Aufrufen aus dem Unterabschnitt Verwaltung in der Gruppe Virtuelle Gegenstände und Währung einrichten.

Virtuelle Gegenstände im Shop anzeigen

Wie virtuelle Gegenstände angezeigt werden, hängt davon ab, wie der Katalog implementiert ist: über Site Builder oder über die API.

Anzeige über Site Builder

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

1. Erstellen Sie einen virtuellen Gegenstand.

2. Navigieren Sie im Kundenportal zum Menüpunkt Storefronts > Websites.
3. Klicken Sie bei der gewünschten Website auf Site Builder öffnen.

4. Wählen Sie im Online-Shop-Block im Feld Artikeltyp die Option Virtuelle Gegenstände aus. Anschließend wählen Sie im Feld Artikelgruppe die Gruppe aus, die Sie auf der Website verkaufen möchten.

5. Wählen Sie ein Artikelkarten-Layout aus.
6. Gehen Sie wie folgt vor, nachdem Sie alle erforderlichen Änderungen vorgenommen haben und Ihre Website für den Launch bereit ist:
   1. Klicken Sie oben rechts im Site Builders auf Veröffentlichen.
   2. Aktivieren Sie die Kontrollkästchen neben den Seiten, die Sie veröffentlichen wollen.
   3. Klicken Sie Veröffentlichen.

Sobald die Website veröffentlicht ist, wird ein Bereich mit einer Gruppe virtueller Gegenstände verfügbar. Wenn keine Gegenstände angezeigt werden, sollten Sie überprüfen, ob der Status der virtuellen Gegenstände auf “Verfügbar” gesetzt ist und keine zeitliche Anzeigebeschränkung aktiv ist.

Informationen zu virtuellen Gegenständen über die API abrufen

Mit den Methoden aus dem Unterabschnitt Katalog der Methengruppe Virtuelle Gegenstände und Währung können Sie den Katalog clientseitig abrufen. Für die Nutzung dieser Methoden ist keine Autorisierung erforderlich.

Nutzern virtuelle Gegenstände 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ährungen und Gegenstände automatisch dem PlayFab-Inventar des Nutzers hinzugefügt.
• Wenn Sie ein eigenes Bereitstellungssystem verwenden, werden alle virtuellen Gegenstände und Währungen von Ihrem System gewährt. Wir empfehlen, einen Webhook-Handler einzurichten, um Bestelldaten in Ihrem Backend zu empfangen. Die erforderlichen Daten sind im Webhook Erfolgreiche Bezahlung der Bestellung enthalten.

Nützliche Links