Einrichten eines PlayFab-Bündels, das im Google Play Store erworben werden kann

In diesem Tutorial erfahren Sie, wie Sie erfolgreich ein PlayFab-Bündel 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.
   1. Stellen Sie sicher, dass für Ihre App die Google Play Android-Entwickler-API aktiviert ist.

Schritt 1: Erstellen eines Pakets

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

Erstellen eines Bundles mithilfe der Google Play-Konsole

1. Öffnen Sie die gewünschte App in der Google Play-Konsole.

2. Scrollen Sie in der linken Navigationsleiste nach unten zum Abschnitt Monetarisierung , und wählen Sie In-App-Produkte aus.

   

3. Wählen Sie oben rechts Produkt erstellen aus.

   

4. Geben Sie die gewünschte Produkt-ID und den Namen für das Paket ein. Verwenden Sie in diesem Tutorial warrior_bundle als Produkt-ID. Merken Sie sich die Produkt-ID , da sie zum Verknüpfen von Game Manager verwendet wird.

   

5. Scrollen Sie nach unten zum Abschnitt Preis , und wählen Sie Preis festlegen aus.

   

6. Fügen Sie den gewünschten Preis für Ihr Paket hinzu, z. B. 1,00 USD, und wählen Sie unten rechts Preise anwenden aus.

   

7. Wählen Sie Speichern aus, um alle Änderungen zu speichern, die Sie soeben am Bündel vorgenommen haben. Beachten Sie, dass das Speichern nicht als Produkt aktiviert wird. Nach dem Speichern wird die Aktivierungsoption angezeigt. Um das Bundle in Ihrer App in der Google Play Console zu aktivieren, wählen Sie unten rechts die Schaltfläche Aktivieren aus.

   

Erstellen eines Bundles mithilfe des Game Managers

Führen Sie die nächsten Schritte aus, um ein neues Bundle 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 Bundles aus .

   

4. Wählen Sie Neues Bündel aus.

   

5. Fügen Sie dem Bundle alle gewünschten Informationen hinzu, z. B. Elemente und Preise In diesem Tutorial verwenden Sie Warrior Bundle 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 Paket

Ein Bündel an sich gewährt keine Elemente an einen Spieler. Wir müssen zuerst Elemente mit ihm verknüpfen und sobald es eingelöst wurde, diese Elemente diesem bestimmten Spieler zuweisen.

Stellen Sie vor dem Hinzufügen von Elementen zu einem Bündel sicher, dass sie bereits in Ihrem Katalog erstellt und veröffentlicht wurden. Wir haben bereits ein Schwert namens Feuerschwert und einen Schild namens Eisschild. Wenn Sie nicht wissen, wie Sie ein Element erstellen, lesen Sie diesen Schritt.

Fügen Sie sie nun Ihrem Bundle hinzu! Dazu können Sie sie entweder beim ersten Erstellen Ihres Bündels hinzufügen, vorausgesetzt, dass die Elemente bereits erstellt wurden, oder Sie können sie später hinzufügen, indem Sie das Bündelelement bearbeiten.

Scrollen Sie im Bearbeitungsmodus nach unten zum Abschnitt Elemente Ihres Bündels, 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 (User Generated Content, UGC) filtern oder nach einem bestimmten Element suchen. Wir wählen die Schaltfläche Hinzufügen neben jedem der Elemente aus, die wir hinzufügen möchten, und schließlich die blaue Schaltfläche Hinzufügen am unteren Rand des Fensters.

Aktivieren der Marketplace-Zuordnung

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

1. Navigieren Sie im Bearbeitungsmodus zu Ihrem Bundle.
2. Scrollen Sie nach unten zum Abschnitt Marketplace-Zuordnung .
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-Konsole. In diesem Tutorial haben wir Warrior_bundle 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 (in diesem Fall ein Bündel) 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 Paket von Googles Ende kaufen, 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 Bündelelemente 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 Pakets

Nachdem Sie Ihr Bündel sowohl im Game Manager als auch in der Google Play Console erstellt haben, können Sie Ihr Bündel für einen Ihrer Spieler einlösen. In diesem Beispiel konzentrieren wir uns auf die Verwendung der PlayFab-API, insbesondere des RedeemGooglePlayInventoryItems-Aufrufs , der 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 Bundle in Game Manager. Die Marketplace-ID ist das, was wir AlternateId nennen. Im Grunde ist dies eine andere Möglichkeit, Ihr Bundle zu identifizieren.

Wechseln Sie in der Google Play-Konsole zum Bildschirm "In-App-Produkte " unter dem Abschnitt Monetarisierung . Von hier aus sehen Sie alle Ihre erstellten Produkte, einschließlich des Warrior Bundles. 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. Dies würde so aussehen, wenn Sie eine API-Plattform zum Testen verwenden.

Tätigen des Einlösungsaufrufs

Wenn Ihr Player authentifiziert ist, werden beide Bündelinstanzen 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": "warrior_bundle",
            "Token": "{Your Google Purchase Token}"
        }
    ]
}

Der Aufruf ist einfach, Sie verfügen über ein Purchases Array, das das Product ID -Element enthält (das mit dem in der Google Play-Konsole ü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 neben 200 status code Daten wie einem Zeitstempel und einer MarketplaceTransactionId.

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

Jede Einlösungsaktion löst auch ein entsprechendes Ereignisprotokoll im Transaktionsverlauf des Spielers aus, das von der Registerkarte Transaktionsverlauf (V2) auf der Übersichtsseite eines angegebenen Spielers abgerufen werden kann, und sieht in etwa wie folgt aus:

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, z. B.:

Sie stellen fest, dass zwei verschiedene items_redeemed PlayStream-Ereignisse protokolliert werden. Dies liegt daran, dass das Bundle zwei verschiedene Elemente enthielt, obwohl wir nur ein Bündel eingelöst haben.

Schritt 4: Verbrauch

Nachdem Sie Ihren Kauf erfolgreich eingelöst haben, sollten Sie sicherstellen, dass er im Marketplace ordnungsgemäß genutzt wird. Hierfür gibt es folgende Möglichkeiten:

• Verwenden der Methode "purchases.products.consume " der Google Play-Entwickler-API.
• Verwenden der BillingClient.consumeAsync-Methode , die Teil des Abrechnungsclients von Google ist.
• Oder indem Sie eines der integrierten Plug-Ins verwenden, z. B. die in Unity und Unreal verfügbaren.

Bevor Sie jedoch den Verbrauchsaufruf tätigen (oder in den Unity- oder Unreal-Plug-Ins, bevor der Client angibt, dass er die Verarbeitung des Kaufs abgeschlossen hat), müssen Sie nach dem Einlösungsprozess eine 200 Antwort mit 1 oder mehr Erfolgen und 0 Fehlern erhalten. Wenn Sie eine 202 Antwort oder einen Einlösungsfehler erhalten, werden Sie aufgefordert, den Verbrauchsaufruf nach einer Weile erneut zu versuchen.

Weitere Informationen

• Erste Schritte mit Economy v2, Unity und Android

• Schnellstart zur Betrugsprävention