In-App-Artikel erkennen und ausliefern

In diesem Artikel wird beschrieben, wie du In-App-Produkte in deinem Spiel erkennen und bereitstellen kannst, nachdem Spieler sie mit Play Points in der Google Play App gekauft haben.

Sobald Nutzer ihre Play Points für ein In-App-Produkt in der Google Play App eingelöst haben, sollten die Artikel sofort in deinem Spiel geliefert werden. Im Folgenden wird gezeigt, wie ein Nutzer Artikel mit Play Points kauft.

1. Klicken Sie auf Play Points. 1. Klicken Sie auf den Tab Verwenden, um die Elemente anzusehen. 2. Wähle einen Artikel aus und klicke auf Punkte verwenden, um den Kauf abzuschließen. 3. Sie erhalten den Artikel.
Screenshot von TBD Screenshot von TBD Screenshot von TBD Screenshot von TBD

In diesem Beispiel läuft das Spiel nicht, während das Produkt gekauft wird. Nutzer können Play-Punkte auch gegen Produkte eintauschen, wenn das Spiel nicht auf ihrem Gerät installiert ist. Aus diesem Grund müssen Sie Ihr Spiel so gestalten, dass es die Lieferung von In-App-Artikeln von außerhalb des In-Game-Stores ermöglicht.

Vorbereitung

Bevor du ein In-App-Produkt erkennen und anbieten kannst, musst du das Produkt und Play Points-Promotions erstellen.

Anforderungen an die Übermittlung

Wenn du In-App-Produkte in deinem Spiel über eine Play Points-Promotion anbietest, musst du die Anforderungen in diesem Abschnitt beachten.

Lieferdauer

Wenn ein Spieler Play Points gegen ein In-App-Produkt eintauscht, müssen Sie den Artikel sofort liefern, ohne dass der Spieler das Spiel neu starten muss. In Fällen, in denen der Spielinhalt zuvor abgeschlossen werden muss, z. B. ein Tutorial, sollte der Artikel sofort danach bereitgestellt werden.

Zustellungsnachricht

Wenn ein Nutzer zu deinem Spiel zurückkehrt, nachdem er ein In-App-Produkt außerhalb des Spiels gekauft hat, musst du eine Bestätigung anzeigen, dass das Produkt innerhalb des Spiels erfolgreich gewährt wurde. Die Nachricht sollte in Form eines Pop-up-Dialogfelds oder einer Nachricht im Spiel vorliegen. Nutzer sollten keine zusätzlichen Schritte unternehmen müssen, um den Artikel zu erhalten.

Hier ist das erforderliche Nachrichtenformat:

  • Eine deutliche Nachricht, dass der Artikel angekommen ist.

  • Verweise auf den Artikelnamen und auf „Play-Punkte“, damit Nutzer ihn von anderen Inhalten unterscheiden können, die sie erhalten.

  • Falls es ähnliche Artikel mit unterschiedlichen Stückelungen gibt, muss der Name des Artikels auch die richtige Stückelung enthalten.

  • Der Pop-up-Dialog, die Pop-up-Meldung oder die In-Game-Benachrichtigung sollte für den Nutzer sichtbar sein, bis er auf eine Bestätigung wie Weiter oder OK klickt. Es sollte keine Schaltfläche zum Abbrechen vorhanden sein, da diese Nachricht Nutzer nur über den Artikel informiert, den sie im Spiel erhalten haben. Wenn keine Bestätigungsschaltfläche angezeigt wird, sollte die Nachricht mindestens 3 Sekunden lang sichtbar sein, bevor sie ausgeblendet wird, damit Nutzer wissen, dass sie den Artikel erhalten haben.

Hier eine Beispielnachricht:

„Artikel erhalten! Du hast gerade 100 Edelsteine bei Play Points erhalten. Weiter.“

Nutzer sollten eine Animation oder eine visuelle Bestätigung für die höhere In-Game-Währung sehen. Wenn es sich um einen langlebigen oder verbrauchbaren In-App-Artikel handelt, sollten Nutzer zu der Stelle weitergeleitet werden, an der der Artikel entsperrt wurde oder im Spiel verfügbar ist.

Außerhalb des Spiels erhaltene Gegenstände erkennen

Wenn dein Spiel die Google Play Billing Library verwendet, nimm die folgenden Änderungen vor, um In-App-Produkte zu erkennen, die außerhalb des Spiels empfangen werden.

  1. Rufe im onResume()-Callback deines Spiels die Methode queryPurchases() auf, um eine Liste von Elementen abzurufen. So kannst du feststellen, welche nicht bestätigt werden.

  2. Wenn dein Spiel einen Server hat, empfehlen wir dringend, den Kauf auf deinem Server zu prüfen. Verwende dazu die Subscriptions and In-App Purchases API.

  3. Wenn es eigene, aber nicht bestätigte Artikel gibt, bestätige den Kauf entweder mit consumeAsync() für Verbrauchsartikel oder mit acknowledgePurchase() für nicht konsumierbare Artikel.

  4. Erteile die Berechtigung für den gekauften Artikel im Spiel.

Elemente erkennen, die im geteilten Bildschirmmodus empfangen wurden

Wenn dein Spiel den Mehrfenstermodus unterstützt, können Nutzer Play-Punkte einlösen und den Artikel erhalten, während sie die Play Store App und dein Spiel gleichzeitig ausführen. In diesem Screenshot sehen Sie ein Beispiel:

Ein Screenshot, auf dem die Schaltfläche „Punkte einlösen“ angezeigt wird, während ein Spiel läuft.

So kannst du dieses Szenario mit der Google Play Billing Library unterstützen:

  1. Google Play ruft die Methode onPurchasesUpdated() auf, um dein Spiel über einen neuen ausstehenden Artikel zu informieren.

  2. Wenn dein Spiel einen Server hat, empfehlen wir dringend, den Kauf auf deinem Server zu prüfen. Verwende dazu die Subscriptions and In-App Purchases API.

  3. Bestätige den Kauf entweder mit consumeAsync() für Verbrauchsgüter oder mit acknowledgePurchase() für nicht konsumierbare Artikel.

  4. Erteile die Berechtigung für den gekauften Artikel im Spiel.

Lieferbestätigung anzeigen

Wenn Nutzer Play Points einlösen und einen Tauschartikel erhalten, erwarten sie, dass im Spiel eine In-Game-Nachricht oder eine Benachrichtigung angezeigt wird, um sie darüber zu informieren, dass das Spiel den Artikel korrekt erhalten und verarbeitet hat. Hier sind einige Optionen zur Bestätigung der Lieferung:

  • In-Game-Pop-up anzeigen

  • Übermitteln Sie die Nachricht an ein Nachrichtenfeld im Spiel und geben Sie deutlich an, dass sich darin eine neue Nachricht befindet.

  • Verwenden Sie eine Betriebssystembenachrichtigung.

Es kann vorkommen, dass das Spiel bei Erhalt des Angebotsartikels einen beliebigen Status hat oder dass es nicht auf dem Gerät installiert ist. Werbeartikel müssen unabhängig davon erkannt werden, in welchem Zustand sich das Spiel befindet, wenn der Artikel geliefert wird. Es gibt jedoch einige Ausnahmen, bei denen es akzeptabel ist, den Nutzer nicht sofort über den Erhalt des Artikels zu informieren. Beispiele:

  • Während der Spielaktion, durch die eine Nachricht den Nutzer ablenken kann. In diesem Fall müssen Sie den Nutzer nach dem Ende der Aktion benachrichtigen.

  • Während Zwischensequenzen, wo eine Nachricht den Nutzer ablenken kann. In diesem Fall müssen Sie den Nutzer benachrichtigen, nachdem die Zwischensequenz abgeschlossen ist.

  • Während der ersten Anleitung und der ersten Einrichtung durch den Nutzer im Spiel Wir empfehlen Ihnen, neue Nutzer sofort nach dem Öffnen des Spiels oder während der Ersteinrichtung durch den Nutzer über die Prämie zu informieren. Sie können jedoch warten, bis die Hauptspielsequenz verfügbar ist, um den Nutzer zu benachrichtigen.

Wenn deine App mehrere Charaktere oder Konten hat, für die der Artikel verwendet werden kann, empfehlen wir dir, den Nutzer auszuwählen, welches Konto die Werbeartikel erhalten soll.

Berücksichtige die Nutzer bei der Entscheidung, wann und wie sie über Werbeaktionen informiert werden sollen. Wenn ein Nutzer nicht sofort eine Benachrichtigung erhält, kann er verwirrt sein, das Spiel nicht mehr spielen, den Nutzersupport kontaktieren oder sich in den sozialen Medien darüber beschweren.

Updates für bestimmte Spiel-Engines

Hier sind einige Überlegungen, die du bei bestimmten Spiel-Engines beachten solltest:

  • Wenn Ihr Spiel mit Unity erstellt wurde, sollten Sie prüfen, ob die von Ihnen verwendete IAP-Implementierung bereits Play Points-Promotions unterstützt.

  • Wenn Ihr Spiel mit Cocos2d-x oder Unreal Engine (C/C++) erstellt wurde, müssen Sie höchstwahrscheinlich den JNI-Code schreiben, mit dem Java APIs aus Ihrem C/C++-Code aufgerufen werden.

Best Practices für serverseitiges Tagging

Dieser Abschnitt enthält serverseitige Best Practices für Play Points-Promotions:

  • Wenn du Purchases.products: get auf deinem Server aufrufst, prüfe, ob du Play-Prämien-Umtauschartikel und andere In-App-Produkte basierend auf den productId-Werten separat verarbeiten musst.

  • Wenn du Inappproducts: list auf deinem Server verwendest, solltest du prüfen, ob du Play Rewards-Artikel vom Umtausch von anderen In-App-Produkten anhand von productId-Werten trennen musst.

  • Anhand der folgenden Best Practices können Sie überprüfen, ob Sie zusätzliche Änderungen vornehmen müssen:

Fehlerbehebung

Dieser Abschnitt enthält Empfehlungen für Szenarien, die zu Kundenanfragen führen können.

Mehrere Nutzerkonten

Wenn ein Nutzer mehrere Google-Konten auf seinem Gerät hat und Play Points über das falsche Konto einlöst, kann Google die Artikel nicht auf die anderen Konten übertragen. Ebenso kann die Anwendung das Element nicht durch Aufrufen der Methode getPurchases() übertragen. In diesem Szenario solltest du dem Nutzer die In-App-Artikel über deinen Kundensupport manuell zur Verfügung stellen.

Verspätete oder fehlende Artikel

Wenn Spieler verzögerte oder fehlende Prämien erhalten, lesen Sie die Anleitung zur Fehlerbehebung bei In-App-Käufen in der Google Play-Hilfedokumentation.