Virtuelle Währung

So funktioniert's

Virtuelle Währung ist virtuelles Geld, mit dem virtueller Güter ge- und verkauft werden. Je nach Einsatzbereich beeinflusst virtuelle Währung die Spielökonomie oder die Monetarisierung der gesamten Anwendung.

Hauptmerkmale:

• Virtuelle Währungen und virtuelle Währungspakete lassen sich in beliebiger Menge zu einem festen Preis verkaufen.
• Virtuelle Währungen und virtuelle Währungspakete lassen sich gegen echte oder virtuelle Währungen verkaufen.
• Wie oft ein virtuelles Währungspaket gekauft werden darf, lässt sich begrenzen.
• Wie lange virtuelle Währungen und virtuelle Währungspakete im Shop angezeigt werden, lässt sich begrenzen.
• Es lassen sich kostenlose virtuelle Währungspakete erstellen.

Für den Verkauf virtueller Währungen gibt es die folgenden Optionen:

• Beliebige Menge – ermöglicht den Verkauf von virtueller Währung in einer vom Nutzer gewählten Menge. Bei dieser Option müssen Sie aufseiten des Clients ein Eingabefeld implementieren, in das der Nutzer beim Kauf die gewünschte Menge eingeben kann.
• Pakete – ermöglicht Ihnen den Verkauf virtueller Währung in vordefinierten Mengen. Der Preis eines Währungspakets wird separat festgelegt und kann vom Standardpreis, der für dieselbe Menge dieser Währung gilt, abweichen.

1. Beispiel: Ein Paket enthält 100 Goldmünzen und kostet 90 $, während der Preis für eine Goldmünze 1 $ beträgt.

Einschränkungen:

• Sie können einem Paket nur eine Art von virtueller Währung hinzufügen.
• Preise in einer anderen virtuellen Währung können nur über API-Aufrufe festgelegt werden.
• Ein virtuelles Währungspaket kann kostenlos angeboten werden – also ohne einen Preis in echter oder virtueller Währung anzugeben. Dies kann im Kundenportal oder über API-Aufrufe konfiguriert werden. Kostenlose virtuelle Währung, die nicht Teil eines Pakets ist, kann nur über API-Aufrufe erstellt werden.
• Die Menge der virtuellen Währung in einem Paket kann nur als Ganzzahl angegeben werden.

Einrichtung

Im Kundenportal einrichten

• Virtuelle Währung
• Virtuelle Währungspakete

So richten Sie eine virtuelle Währung im Kundenportal ein:

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 Währung aus.

3. Legen Sie die folgenden Parameter fest:
   1. Bild (optional)
   2. SKU
   3. Name der virtuellen Währung
4. Indem Sie den entsprechenden Status auswählen, lässt sich steuern, wie virtuelle Währungen im Shop angezeigt werden.

5. Klicken Sie auf Preise festlegen, und geben Sie den Preis in echter Währung an. Bei Bedarf können Sie regionale Preise festlegen.
6. 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

7. Überprüfen Sie die Einstellungen, und klicken Sie auf Währung erstellen.

Hinweis

Bevor Sie ein virtuelles Währungspaket einrichten, müssen Sie eine virtuelle Währung erstellen.

So richten Sie ein virtuelles Währungspaket im Kundenportal ein:

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 Währungspakete aus.

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

5. Geben Sie an, welche virtuelle Währung und wie viel davon im Paket enthalten sein soll.
6. Legen Sie Preise fest oder erstellen Sie einen kostenlosen Artikel im Feld Kostenlos oder kostenpflichtig:

1. • Wählen Sie Kostenloses Paket, um eine kostenloses Paket zu erstellen.

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

7. Wenn Sie begrenzen möchten, wie oft ein Nutzer das Paket kaufen darf, müssen Sie den Schalter Anzahl der Paketkäufe pro Benutzer beschränken aktivieren und die gewünschte Höchstmenge festlegen.
8. 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 Pakets berechnet.
      • Nicht regelmäßig aktualisieren.

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

9. Legen Sie ein Zeitlimit für die Anzeige des Pakets 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 Artikel kein Anzeigezeitraumende angeben möchten, aktivieren Sie das Kontrollkästchen Kein Enddatum.

10. 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

11. Überprüfen Sie die Einstellungen, und klicken Sie auf Paket erstellen.

Über die API einrichten

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

Virtuelle Währungen im Shop anzeigen

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

Anzeige über Site Builder

1. Erstellen Sie ein virtuelles Währungspaket.
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 das virtuelle Währungspaket aus, das 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, werden die virtuellen Währungspakete in einem gesonderten Bereich angezeigt. Wenn keine virtuellen Währungspakete angezeigt werden, sollten Sie überprüfen, ob der Status des virtuellen Währungspakets auf “Verfügbar” gesetzt ist und keine zeitliche Anzeigebeschränkung aktiv ist.

Informationen zu virtuellen Währungen über die API abrufen

Verwenden Sie die Aufrufe aus dem Unterabschnitt Katalog der Gruppe Virtuelle Gegenstände und Währungen, um den Katalog der virtuellen Währungen und virtuellen Währungspakete clientseitig abzurufen.

Nutzern virtuelle Währung gewähren

Je nach Artikelart und den Integrationseinstellungen wird die virtuelle Währung 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.