Freigeben über

Einrichten eines PlayFab-Abonnements, das im Google Play Store erworben werden kann

  • Artikel

Notiz

Die Einlösung von Google-Abonnements befindet sich derzeit in der privaten Vorschau. Senden Sie für den Zugriff auf dieses Feature eine E-Mail mit PFEconomyPreviews@microsoft.com dem Betreff PlayFab Mobile Subscriptions zusammen mit Ihrer PlayFab-Titel-ID. Wir aktivieren das Feature in Ihrer Umgebung.

In diesem Tutorial erfahren Sie, wie Sie erfolgreich ein PlayFab-Abonnement erstellen, es ihrem Spiel im Google Marketplace hinzufügen, damit Spieler es kaufen können, und wie Sie die darin enthaltenen Elemente einlösen.

Voraussetzungen

  1. Ein Titel im Game Manager von PlayFab.
  2. Eine vorhandene Integration zwischen dem ausgewählten Titel und Dem gewünschten Marketplace.
  3. Eine App, die bereits erstellt wurde und in Google Play verfügbar ist.

Schritt 1: Erstellen eines Abonnements

Bevor Sie mit der Einlösung eines Abonnements beginnen, müssen Sie es zuerst sowohl im Game Manager als auch in Ihrer App in der Google Play Console zur Verfügung haben.

In diesem Tutorial erstellen wir zunächst das Abonnement in der Google Play Console.

Google Play-Konsole

Um ein Abonnement mit der Google Play-Konsole zu erstellen, müssen Sie die nächsten Schritte ausführen:

  1. Öffnen Sie die gewünschte App in der Google Play-Konsole.
  2. Scrollen Sie im linken Navigationsmenü nach unten zum Abschnitt Monetarisierung , und wählen Sie Abonnements aus.
  3. Wählen Sie oben rechts Abonnement erstellen aus.
  4. Geben Sie die gewünschte Produkt-ID und den Namen für das Abonnement ein. Verwenden Sie in diesem Tutorial up_basic_sub als Produkt-ID. Merken Sie sich die Produkt-ID , da sie zum Verknüpfen von Game Manager verwendet wird.
  5. Scrollen Sie nach unten zu Basispläne und -angeboten , und wählen Sie Basisplan hinzufügen aus.
  6. Fügen Sie ihrem Basisplan die gewünschten Konfigurationen hinzu, und wählen Sie unten rechts Speichern aus.
  7. Wählen Sie Speichern aus, um alle Änderungen zu speichern, die Sie soeben am Abonnement vorgenommen haben. Beachten Sie, dass das Speichern nicht als Produkt aktiviert wird. Nach dem Speichern wird die Aktivierungsoption angezeigt. Um das Abonnement in Ihrer App in der Google Play-Konsole zu aktivieren, wählen Sie unten rechts die Schaltfläche Aktivieren aus.

Erstellen eines Abonnements mit Game Manager

Führen Sie die nächsten Schritte aus, um ein neues Abonnement in Game Manager zu erstellen:

  1. Wechseln Sie zum Game Manager , und navigieren Sie zu Titel.
  2. Wählen Sie im linken Navigationsmenü Engage>Wirtschaft aus.
  3. Wählen Sie die Registerkarte Abonnements aus.
  4. Wählen Sie Neues Abonnement aus.
  5. Fügen Sie Ihrem Abonnement alle gewünschten Informationen hinzu, z. B. Elemente und Preise In diesem Tutorial verwenden Sie Swords-Abonnement als Namen.
  6. Scrollen Sie nach unten bis zum Ende der Seite, und wählen Sie Speichern und veröffentlichen aus, wenn sie sofort veröffentlicht werden soll, oder Als Entwurf speichern , wenn sie gespeichert werden soll, aber noch nicht verfügbar sein soll.

Hinzufügen von Elementen zu Ihrem Abonnement

Ein Abonnement selbst gibt keine Elemente an einen Spieler weiter. Wir müssen zuerst Elemente mit ihm verknüpfen, und sobald es eingelöst wurde, gewährt es diese Elemente diesem bestimmten Spieler.

Stellen Sie vor dem Hinzufügen von Elementen zu einem Abonnement sicher, dass die Elemente bereits in Ihrem Katalog erstellt und veröffentlicht wurden. Wir haben bereits ein Schwert-Element namens Oath Keeper und ein weiteres namens Frostmourne. Wenn Sie nicht wissen, wie Sie ein Element erstellen, lesen Sie diesen Schritt.

Fügen Sie sie nun Ihrem Abonnement hinzu! Dazu können Sie sie beim ersten Erstellen Ihres Abonnements hinzufügen, vorausgesetzt, dass die Elemente bereits erstellt wurden. Sie können sie auch später hinzufügen, indem Sie das Abonnementelement bearbeiten.

Scrollen Sie im Bearbeitungsmodus nach unten zum Abschnitt Elemente Ihres Abonnements, und wählen Sie die Schaltfläche Hinzufügen aus. Dadurch wird ein Fenster angezeigt, in dem alle in Ihrem Katalog verfügbaren Elemente angezeigt werden. Von hier aus können Sie entweder nach Typ (Elemente oder Elemente mit benutzergeneriertem Inhalt( UGC) filtern oder nach einem bestimmten Element suchen. In unserem Fall haben wir nur zwei Elemente veröffentlicht, daher wählen wir die Schaltfläche Hinzufügen neben jedem von ihnen und schließlich die blaue Schaltfläche Hinzufügen am unteren Rand des Fensters aus.

Aktivieren der Marketplace-Zuordnung

Um sicherzustellen, dass ein Spieler, der ein Abonnement von Ihrer App erwirbt, ordnungsgemäß erworben und in Game Manager zugewiesen wird, Sie Ihre Marketplace-Zuordnung konfigurieren müssen. Dies kann beim Erstellen Ihres Abonnements in Game Manager oder nach der Erstellung des Abonnements erfolgen, indem Sie zum Abonnement im Bearbeitungsmodus zurückkehren.

  1. Navigieren Sie im Bearbeitungsmodus zu Ihrem Abonnement.
  2. Scrollen Sie nach unten zum Abschnitt Markenplatzzuordnung .
  3. Wählen Sie in der Dropdownliste Marketplace den gewünschten Marketplace aus. (Für dieses Tutorial wird es GooglePlay sein.)
  4. Verwenden Sie für Ihre Marketplace-ID die gleiche wie Ihre Produkt-ID in der Google Play Console. In diesem Tutorial haben wir up_basic_sub verwendet.
  5. Um den Vorgang abzuschließen, wählen Sie rechts + in dieser Zeile aus.

Schritt 2: Generieren eines Kauftokens

Notiz

Stellen Sie sicher, dass Voraussetzung 3 erfüllt ist, bevor Sie fortfahren. Andernfalls gibt es keine praktische Möglichkeit zum Generieren eines Kauftokens.

Ein Kauftoken ist ein Token, das von den APIs von Google Play bei jedem Kauf generiert wird, ähnlich einer Beleg-ID. Laut Google-Dokumentation ist "ein Kauftoken eine Zeichenfolge, die den Anspruch eines Käufers auf ein Produkt auf Google Play darstellt. Es gibt an, dass ein Google-Benutzer für ein bestimmtes Produkt bezahlt hat."

In Ihrer Implementierung sollten Sie dieses Token speichern, da es an die API von PlayFab gesendet werden soll, um den Kauf mit dem Google Marketplace zu überprüfen. Es ermöglicht PlayFab, die gekauften Gegenstände des Spielers einzulösen und sie im Inventar des Spielers zu gewähren.

Um das Token zu generieren, müssen Sie bereits über eine App mit einer aktiven Integration in Google Play verfügen. Für Ihre App-Registrierung in Google Play müssen auch Artikel (oder in diesem Fall ein Abonnement) zum Kauf verfügbar sein. Ihre Codeimplementierung muss das Abrechnungssystem von Google Play verwenden, damit Sie nach dem Kauf ein Token zurückgeben können.

Zusammenfassend sollte das Abrechnungssystem beim Codieren Ihrer App verwendet werden. Über dieses Abrechnungssystem können Sie das Abonnement von Google erwerben, wodurch das Kauftoken zurückgegeben wird. Das Token sollte dann mit der Economy-API von PlayFab verwendet werden, um den Kauf einzulösen und die Abonnementelemente dem Inventar des Spielers hinzuzufügen.

Tipp

Beispiele für die Implementierung eines ähnlichen Projekts mit Google-Systemen finden Sie in diesem CodeLab.

Weitere Informationen zur Abrechnung finden Sie in der Dokumentation zum Abrechnungssystem von Google.

Schritt 3: Einlösen eines Abonnements

Nachdem Sie Ihr Abonnement sowohl im Game Manager als auch in der Google Play Console erstellt haben, können Sie Ihr Abonnement für einen Ihrer Spieler einlösen. In diesem Beispiel konzentrieren wir uns auf die Verwendung der PlayFab-API, insbesondere der RedeemGooglePlayInventoryItems-Methode , die Teil der Economy-API von PlayFab ist.

Überprüfen von AlternateIDs

Stellen Sie vor dem Einlösen sicher, dass Sie über die richtige AlternateId im Game Manager verfügen. Diese sollte mit der in der Google Play-Konsole identisch sein.

Der folgende Screenshot stammt aus Ihrem Abonnement in Game Manager. Die Marketplace-ID ist das, was wir AlternateId nennen. Im Grunde ist dies eine andere Möglichkeit, Ihr Abonnement zu identifizieren.

Wechseln Sie in der Google Play-Konsole zu Ihrem Abonnement in Ihrer App, und unter Abonnementdetails werden hier alle Ihre erstellten Produkte angezeigt, einschließlich Ihres Abonnements. Die Produkt-ID wird in der zweiten Spalte angezeigt. Sie sollten sicherstellen, dass sie mit Ihrer AlternateId in Game Manager identisch ist. Wenn dies nicht der Fall ist, aktualisieren Sie dann Game Manager.

Authentifizieren des Spielers

Um ein Element einzulösen, verwenden Sie RedeemGooglePlayInventoryItems. Vorher müssen wir jedoch sicherstellen, dass der Spieler, der die Elemente einlösen möchte, in Ihrer App ordnungsgemäß authentifiziert wird, wofür Sie wahrscheinlich LoginWithGoogleAccount verwenden werden.

Notiz

Ein ausführlichere Beispiel finden Sie unter Einrichten der PlayFab-Authentifizierung mithilfe der Google Play Games-Anmeldung in Unity.

Nach einem erfolgreichen LoginWithGoogleAccount-Aufruf gibt die PlayFab-API ein EntityToken zurück, das Sie als Teil Ihrer RedeemGooglePlayInventoryItems-Header mit einem X-EntityToken Schlüssel verwenden müssen.

Tätigen des Einlösungsaufrufs

Wenn Ihr Player authentifiziert ist, werden beide Abonnementinstanzen erstellt und ihre alternativen IDs aktiviert, und Ihr Kauftoken. Sie sind bereit, den Einlösungsaufruf zu tätigen. Hierfür verwenden wir den API-Aufruf RedeemGooglePlayInventoryItems .

{
    "Purchases": [
        {
            "ProductId": "up_basic_sub",
            "Token": "{Your purchase token}"
        }
    ]
}

Der Aufruf ist ganz einfach, Sie verfügen über ein Purchases Array, das die Product ID enthält (die mit dem in der Google Play Console übereinstimmen sollte) und ein Token Feld, das dem Kauftoken entspricht, das beim Aufrufen des Google Play-Abrechnungssystems zurückgegeben wird.

Eine erfolgreiche Antwort enthält 200 status code neben Daten wie einem Zeitstempel und einer MarketplaceTransactionId eine.

Wenn Sie nach einer erfolgreichen Einlösung in das Inventar Ihres Spielers einsteigen, sollten Sie nun das Abonnement und beide mit dem Abonnement verknüpften Elemente sehen können.

Jede Einlösungsaktion löst auch ein entsprechendes Protokoll im Transaktionsverlauf des Spielers aus, das auf der Registerkarte Transaktionsverlauf (V2) unter der Übersichtsseite eines angegebenen Spielers wiederholt werden kann.

Neben dem Datensatz im Transaktionsverlauf des Spielers wird auch ein PlayStream-Ereignis ausgelöst und protokolliert. Sie können auf diese Protokolle für Ihren Titel zugreifen, indem Sie in Game Manager im Abschnitt Analysieren auf der linken Navigationsleiste zur Seite Daten wechseln. Hier können Sie Abfragen bearbeiten, um nach bestimmten Datensätzen zu suchen, oder sie mit den Standardeinstellungen ausführen, um alles abzurufen. Unter dem Ereignisnamenvon items_redeemed sollte ein Datensatz vorhanden sein. Dort sollte ein neues Ereignis angezeigt werden, das für das Abonnement spezifisch ist, das gerade eingelöst wurde.

Weitere Informationen