Schnellstart: Stores (Legacy Economy)

Wichtig

Economy v1-APIs befinden sich im Wartungsmodus und erhalten keine neuen Features, nur Fehlerbehebungen. Die v1-APIs werden auf absehbare Zeit beibehalten. Weitere Informationen zur nächsten Version von PlayFab Economy finden Sie in der Übersicht über Die Wirtschaft v2 !

Stores sind die beste Möglichkeit, Spielern den Kauf von Gegenständen in Ihrem Spiel zu ermöglichen.

Wie im Schnellstart Artikel gezeigt, unterstützt PlayFab den Kauf von Artikeln aus einem Katalog, aber so strukturieren die meisten Spiele ihre Käufe nicht. Egal, ob Sie einen Leerlaufklicker, ein RPG, einen FPS oder einen endlosen Runner erstellen, Wahrscheinlich haben Sie Anbieter in Ihrem Spiel. Places, wo Spieler Waffen, Rüstungen oder Laufschuhe kaufen können.

Unsere Lösung für In-Game-Anbieter und Shops ist Stores, eine Teilmenge Ihres Katalogs mit Preisen, die Sie außer Kraft setzen können.

In dieser Schnellstartanleitung für Stores gehen Sie folgendermaßen vor:

• Hinzufügen von Elementen zu einem Katalog mit regulären Preisen.
• Erstellen Sie einen Store, der die gleichen Artikel mit ermäßigten Preisen enthält.
• Verwenden Sie PlayFab-APIs, um einen Artikel im Store zu kaufen.
• Verwenden Sie die Informationen im Game Manager, um zu bestätigen, dass der Artikel zum ermäßigten Store-Preis erworben wurde.

Hinzufügen von Elementen zu einem Katalog

Fügen Sie zunächst einige Artikel zum Verkauf in Ihrem Katalog hinzu:

1. Öffnen Sie Game Manager , und wählen Sie auf der linken Seite die Option Wirtschaft aus.
2. Wählen Sie die Registerkarte Kataloge aus, und öffnen Sie Ihren Standard Katalog.
3. Wählen Sie mehrmals Neues Element aus, und erstellen Sie einige Elemente:
   • Aprikosen mit einem GD-Preis von 4.
   • Birne mit einem GD-Preis von 3.
   • Trauben ohne GD-Preis (wählen Sie keine Preise aus).

Tipp

Sie müssen den Artikeln in einem Katalog keinen Preis für virtuelle Währungen zuweisen, damit sie in einem Geschäft angezeigt werden.

Im folgenden Beispiel wird dem Standard Katalog ein Element namens Aprikosen mit einem GD-Preis von 4 hinzugefügt.

Erstellen eines Speichers

Sie sollten nun einige Artikel mit Preisen in Ihrem Katalog enthalten. Lassen Sie uns einen Store erstellen, um sie an einen Spieler zu verkaufen.

1. Öffnen Sie Ihren Standard Katalog, und wählen Sie Stores aus.
2. Wählen Sie Neuer Store aus.
3. Legen Sie die Store-ID und den Store-Namen auf Früchte fest (wie im folgenden Beispiel gezeigt).
4. Wählen Sie ZUM STORE HINZUFÜGEN aus.
   • Ein Popupbildschirm – wie der unten gezeigte – zeigt alle Elemente, Bündel und Container im aktuellen Katalog an.
5. Fügen Sie Ihrem Store einige Elemente hinzu, indem Sie neben dem Element auf die Schaltfläche Hinzufügen klicken.

Festlegen des Ladenpreises für einen Artikel

Ihre Artikel sollten nun im STORE CONTENTS aufgeführt werden, aber sie sind erst gültig, wenn sie mindestens einen Preis haben.

Die kleine statische Zahl (z. B < . 4) neben dem Textfeld preis ist der ursprüngliche Katalogpreis. Sie müssen nur einen Preis für ein Feld in jeder Zeile eingeben, aber Sie können beliebig viele Preise eingeben.

• Wenn Sie keinen Preis für einen Artikel eingeben, wird er aus dem Store entfernt.
• Wenn ein Ladenartikel keinen Preis in einer Währung hat, kann er nicht mit dieser Währung gekauft werden.
• Store-Preise können höher sein als Katalogpreise, und null ist ein gültiger Preis für einen Artikel.

Tipp

Sie können die Zeilen im Speicherinhalt ziehen und ablegen, um die Reihenfolge der Elemente neu anzuordnen.

1. Fügen Sie Einige GD-Preise zu Ihren Artikeln hinzu, aber machen Sie sie niedriger als die Katalogpreise:
   • Aprikose: 3.
   • Birne: 2.
   • Traube: 1.
2. Wählen Sie SPEICHER SPEICHERN aus, wenn Sie fertig sind.

Im folgenden Beispiel erhält ein Artikel namens Aprikosen mit einem Katalogpreis von 4 GD einen Ladenpreis von 3 GD.

Kauf eines Artikels aus dem Geschäft

Nachdem Sie nun über einen Store verfügen, können Sie die PlayFab-APIs verwenden, um einen Artikel aus dem Store in Ihrem Spiel zu kaufen.

1. Rufen Sie Ihren Store ab, indem Sie GetStoreItems mit den folgenden Parametern in der Anforderung aufrufen:
   • CatalogVersion = "main"
   • StoreId = "fruits"
2. Das Store Feld in GetStoreItemsResult sollte eine Liste Ihrer Store-Artikel und deren Preise enthalten.
3. Rufen Sie PurchaseItem mit Werten in der Anforderung auf, die die Währung und den Store-Preis des Artikels angeben, den Sie kaufen möchten.
   • CatalogVersion = "main"
   • StoreId = "fruits"
   • ItemId = "pear"
   • VirtualCurrency = "GD"
   • Price = 2

Tipp

Wenn Sie beim Aufrufen von StoreIdPurchaseItem nicht angeben, wird versucht, den Kauf gegen den Katalogpreis zu verwenden.

Bestätigen des Kaufpreises

Öffnen Sie Game Manager, und bestätigen Sie, dass der Kauf zum Store-Preis von zwei GD erfolgt ist.

1. Wählen Sie in der linken Seitenleiste Spieler aus, um die Registerkarte Spieler zu öffnen.
2. Wählen Sie die ID des Spielers aus, der den Artikel gekauft hat.
3. Überprüfen Sie die folgenden Informationen für den Spieler:
   • Öffnen Sie die Registerkarte Bestand . Das Inventar sollte nun eine Birne enthalten.
   • Öffnen Sie die Registerkarte Virtuelle Währung . Überprüfen Sie die virtuelle Währung Betrag , um zu überprüfen, ob der Spieler nur 2 GD ausgegeben hat.
   • Öffnen Sie die Registerkarte PlayStream . Es werden Ereignisse angezeigt, die den Einkaufsflow aus dem Store anzeigen. Zu den Ereignissen gehören ein Ereignis zum Kauf eines virtuellen Spielerwährungselements und ein Virtuelles Spielerwährungssaldo-Ereignis , das anzeigt, dass sich der Guthaben der virtuellen Währung um zwei GD geändert hat.

Tipp

Sie können den Game Manager verwenden, um die Reihenfolge der Artikel in Ihrem Store zu ändern und die Preise jederzeit anzupassen.

Nächste Schritte

Nachdem Sie nun gelernt haben, wie Sie Stores in Ihrem Spiel erstellen und nutzen, können Sie einige erweiterte Verwendungsmöglichkeiten von Stores erkunden.

Wenn Sie beispielsweise Segmente mit Stores verwenden, können Sie bestimmten Spielern Sonderpreise gewähren, ohne Ihren Spielcode zu berühren.

• Benutzerdefinierte Stores für Spielersegmente
• Bewährte Methoden für die Speichersegmentierung