Coupons und Aktionen (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 !

Coupons sind Zeichenfolgentoken, die Sie für Ihre Kunden generieren können, um Inventarelemente in ihrem Spiel einzulösen. In Kombination mit Bundles oder CloudScript können diese Coupons verwendet werden, um fast jede Funktionalität in Ihrem Spiel auszulösen.

Voraussetzungen

• Vertrautheit mit Katalogen, Bündeln und Containern.
• Vertrautheit mit Game Manager.
• Vertrautheit mit Player Inventory.

Anweisungen zum Generieren und Einlösen von Gutschein

Alle folgenden Beispiele teilen den ersten grundlegenden Schritt zum Generieren eines Gutschein. Dies erfolgt im Game Manager.

Über Game Manager:

• Navigieren Sie zu Ihrem Titel.
• Wählen Sie im Menü auf der linken Seite Die Option Wirtschaft aus.
• Wechseln Sie zur Registerkarte Kataloge .

In einem der drei Registerkartenabschnitte: Elemente, Pakete und Container gibt es einen Link Coupons .

Über den Link wird ein Fenster geöffnet, in dem Sie Coupons für alle Elemente im Abschnitt generieren können. Wenn Sie Coupons für einen bestimmten Artikel erstellen möchten:

• Wählen Sie auf der Registerkarte Elementedie Option Coupons aus.
• Bündeln Sie Coupons unter Bundles und Container Coupons unter Container.

Das Popupfenster ähnelt dem, das wir unten angegeben haben. (Ihre Liste der Elemente sollte mit Ihrem Titel übereinstimmen. Die angezeigten Elemente werden in unserem Tutorial zum Löschen von Tabellen beschrieben.

So schließen Sie die Gutschein Generierung ab:

• Wählen Sie eine Menge von Coupons aus, die generiert werden sollen.

• Wählen Sie dann den Artikel aus, den die Coupons generieren sollen.

• Die CSV-Textdatei mit einer Liste von Coupons kann dann heruntergeladen werden

Wenn Sie einen der Links im Beispiel auswählen, werden die folgenden zehn durch Trennzeichen getrennten Coupons generiert.

65g-d4q5-zph,ahs-aofk-5ip,rqp-pk6c-yuu,58d-64h9-a6q,zxk-jtmi-5a1,oeu-6e4z-365,mfy-euhb-qj3,ru9-r1ux-wzy,shj-54cm-5oh,719-7hxc-pzz

Schließlich kann der Kunde eine Gutschein einlösen, wenn Sie eine GUI bereitstellen, über die er den Code eingeben kann, der dann RedeemCoupon aufruft.

// Unity/C#
void UseCoupon(string couponCode)
{
    var primaryCatalogName = "TestCatalog-001"; // In your game, this should just be a constant matching your primary catalog
    var request = new RedeemCouponRequest
    {
        CatalogVersion = primaryCatalogName,
        CouponCode = couponCode // This comes from player input, in this case, one of the coupon codes generated above
    };
    PlayFabClientAPI.RedeemCoupon(request, LogSuccess, LogFailure);
}

Beispielfall: Bestandselement Gutschein

Die einfachste Möglichkeit, Coupons zu verwenden, ist das Verschenschen eines Bestandsartikels. Nachdem Sie Ihren Katalog erstellt haben, können Sie Coupons für reguläre Artikel generieren, indem Sie die vorherigen Anweisungen befolgen, die wir bereits erläutert haben. Es gibt keine weiteren speziellen Schritte für diesen Fall.

Beispielfall: virtuelle Währung Gutschein oder mehrere Elemente Gutschein

Coupons können virtuelle Währungen nicht direkt gewähren, und sie können nur einen einzelnen Artikel gewähren.

Pakete können jedoch verwendet werden, um Inventarelemente nahtlos in Gruppen von Elementen oder virtuelle Währungen umzuwandeln. Im Vc-Beispiel sollten Sie ein neues Bündelelement mit VC-Inhalten erstellen.

Legen Sie fest, dass das Bündel in 15 Sekunden abläuft. Auf diese Weise wird der Spieler sofort den Vc sehen, sobald er das Bündel öffnet, und er wird das Zwischenelement nicht sehen.

Mehrere Elemente funktionieren auf die gleiche Weise:

• Erstellen Sie ein Bündel mit mehreren Elementen , oder löschen Sie sogar Tabellen.
• Legen Sie fest, dass sie in 15 Sekunden abläuft.
• Der Gutschein kann das Bündel generieren.
• Das Bündel wird dann in mehrere Elemente konvertiert.
• Das Zwischenpaketelement verschwindet.

Verwendungsszenarien

• Physische Belohnungen bei Konventionen:
  • Sie können Ihre Liste der Gutschein Codes drucken und nach Konventionen als Swag verteilen.
• Out-of-Game-Kommunikation wie Foren, Pushbenachrichtigungen und E-Mail.
  • Senden Sie Ihren Spielern Gutschein Codes direkt im Rahmen von Re-Akquise-Kampagnen oder anderen Community-Kontakten.
• Turniere:
  • Senden Sie Coupons an die spieler mit der höchsten Rangfolge, wenn Sie resettable Leaderboards verwenden.

Notiz

In diesem Fall können Sie Auch Inventarelemente direkt ausgeben. Wählen Sie also aus, was für Ihr Spiel relevanter ist.

Bewährte Methoden

Wenn Sie den PlayFab-Bestand verwenden, sollten Sie die Bestandsgrößen relativ klein halten – weniger als 100 Elemente pro Spieler insgesamt. Ein Paket, das zu viele Elemente gewährt, kann gedrosselt oder ratenbeschränkt sein.