Testprämien

Play Billing Lab ist eine Companion-App, mit der du Integrationen in das Abrechnungssystem von Google Play testen kannst. Mit der Vorabversion von Out-of-App-Käufen (OOAP) in Play Billing Lab kannst du prüfen, ob dein Backend richtig konfiguriert ist, um Artikel zu verarbeiten, die außerhalb deiner App erworben wurden, einschließlich Play Games-Prämien.

Mit der OOAP-Funktion in der Vorabversion können Sie ein bestimmtes Produkt oder Angebot auswählen, das auf Oberflächen außerhalb der App angezeigt werden soll, z. B. auf der App-Detailseite bei Google Play. Außerdem können Sie den gesamten Ablauf für den Erwerb und die Erfüllung von Berechtigungen prüfen.

Vorbereitung

Bevor Sie das Play Billing Lab verwenden, um Out-of-App-Kaufvorgänge (OOAP) zu testen und Ihre Einrichtung für Play Games-Prämien zu prüfen, müssen die folgenden Voraussetzungen erfüllt sein:

1. Registrieren Sie sich für das Early-Access-Programm für Play Games-Prämien.

2. Status als lizenzierter Tester: Ihr Testkonto muss als lizenzierter Tester für das Spiel registriert sein. Weitere Informationen finden Sie in der Dokumentation zu lizenzierten Testern bei Google Play.

   Hinweis: Die Play Billing Lab App kann von allen Nutzern aufgerufen werden. OOAP-Überschreibungen können jedoch nur von lizenzierten Testern von EAP-Entwicklern auf der Zulassungsliste konfiguriert und ausgelöst werden.

3. Konsistente Konten auf allen Oberflächen: Sie müssen sich im Play Billing Lab und im Google Play Store mit demselben Konto für lizenzierte Tester anmelden. Wenn die Konten nicht übereinstimmen, wird das überschriebene Testprodukt oder ‑angebot im Google Play Store möglicherweise nicht angezeigt oder der Testkauf kann nicht abgeschlossen werden.

Herunterladen und installieren

Sie können Play Billing Lab bei Google Play herunterladen und installieren:

• Google Play Store (Android): Play Billing Lab App
• Webtest-Track: Play Billing Lab-Web-Opt-in

Schritt-für-Schritt-Anleitung für die Integration und das Testen des EAP

In den folgenden Schritten wird beschrieben, wie Sie Play Games-Prämien mit Play Billing Lab einbinden und testen.

Schritt 1: Play Billing Lab starten und anmelden

Wenn Sie Play Billing Lab nach der Installation zum ersten Mal öffnen:

• Tippen Sie auf Über Google anmelden.
• Wählen Sie das Google-Konto aus, das als lizenzierter Tester für Ihre App registriert ist.
• Nach der Anmeldung wird das Haupt-Dashboard angezeigt.

Play Billing Lab-Dashboard

Schritt 2: Zum Testen von Out-of-App-Käufen (OOAP) wechseln

• Suchen Sie im Dashboard nach der Karte Out-of-App-Käufe.
• Tippen Sie auf Test, um den Bildschirm für die OOAP-Konfiguration zu öffnen.

Hinweis: Wenn Ihre App nicht auf der Zulassungsliste für dieses EAP steht oder Ihr Konto kein lizenzierter Tester für eine App auf der Zulassungsliste ist, wird diese Karte nicht angezeigt und Sie können keine OOAP-Vorschau starten.

Schritt 3: App-Paketnamen und Produkt-ID angeben

Geben Sie auf dem OOAP-Einrichtungsbildschirm die erforderlichen App-IDs ein:

1. Paketname: Der genaue Android-Paketname Ihrer App (z. B. com.example.app).
2. Produkttyp: Wählen Sie im Drop-down-Menü entweder Einmalkaufprodukt (In-App-Artikel) oder Abo aus.
3. Produkt-ID (SKU): Die Produkt-ID des In-App-Produkts oder Abos, das du testen möchtest.

Geben Sie den App-Paketnamen und die Produkt-ID an.

Schritt 4: Angebot auswählen, das die Voraussetzungen erfüllt

Nachdem du den Paketnamen, die Produkt-ID und den Produkttyp eingegeben hast, fragt Play Billing Lab das Backend ab und zeigt eine Liste der verfügbaren Angebote für dieses Produkt an.

Achtung: Es werden nur Angebote angezeigt und können ausgewählt werden, die derzeit für Ihr spezifisches Testerkonto infrage kommen. Wenn Ihr Konto bereits eine nicht genutzte Berechtigung für ein bestimmtes Produkt hat, wird es nicht angezeigt.

• Bei Einmalkaufprodukten: Wählen Sie die entsprechende Kaufoption oder das entsprechende Angebot aus.

  

  Wählen Sie ein gültiges Angebot aus.

Schritt 5: OOAP-Test starten

Tippen Sie nach Auswahl des Angebots auf Test starten. Die Konfiguration wird gespeichert und mit den Google Play-Backend-Servern synchronisiert.

Nach der Aktivierung wird auf dem Dashboard auf der Karte Out-of-App-Käufe das Badge Aktiv angezeigt. Außerdem sind der konfigurierte Paketname, die Produkt-ID (SKU) und die verbleibende Dauer zu sehen.

• Testfenster: Aktive OOAP-Testkonfigurationen bleiben standardmäßig zwei Stunden lang aktiv, bevor sie automatisch ablaufen.

• Backend-Überschreibung: Solange die Konfiguration aktiv ist, wird sie auf den verschiedenen OOAP-Oberflächen (z. B. auf der Detailseite Ihrer App im Google Play Store) mit der höchsten Priorität angezeigt.

  

  OOAP-Test starten

Schritt 6: End-to-End-Akquisitionsvorgang für Angebote außerhalb der App testen

Öffne die Google Play Store App, während der OOAP-Test in Play Billing Lab aktiv ist, und melde dich mit demselben Konto für lizenzierte Tester an:

1. Google Play Store-Cache leeren:
   1. Öffne die App Einstellungen auf deinem Gerät.
   2. Tippen Sie auf Apps > Google Play Store.
   3. Tippen Sie auf Speicher und Cache und dann auf Cache leeren und Speicherinhalt löschen.
2. Öffnen Sie die Google Play Store App.
3. Rufen Sie die Detailseite Ihrer App auf.

4. Testkauf abschließen (Play Express-Overlay): Tippen Sie auf die Karte für den Artikel. Die native Google Play Express-Ansicht am unteren Rand wird im Play Store eingeblendet.

   • Prüfe den Preis, das Zahlungsmittel (Testzahlungsmittel für lizenzierte Tester) und die Angebotsdetails.
   • Tippe auf Mit einem Tipp kaufen, um die Zahlung abzuschließen.

   

   End-to-End-Akquisitionsablauf testen

5. Backend-Integration prüfen:

   • Prüfe nach einem erfolgreichen Kauf, ob Google Play eine Echtzeit-Entwicklerbenachrichtigung (Real-Time Developer Notification, RTDN) an deinen Backend-Server sendet.
     • Hinweis: Bei Prämien wird ebenfalls eine RTDN gesendet.
   • Prüfe, ob dein Server die Google Play Developer API aufruft, um den Kauf zu bestätigen und dem Nutzer die Berechtigung zu erteilen.
   • Prüfe die bisherigen Käufe des Nutzers in der Google Play Store App, um zu bestätigen, dass die Testbestellung aufgezeichnet wurde.

Hinweis: Mit diesem Schritt wird sichergestellt, dass dein Backend für die Verarbeitung von Prämien bereit ist. Play Games-Prämien senden eine ähnliche RTDN, erfordern dieselbe Google Play Developer API, um die Berechtigung zu bestätigen und zu gewähren, und zeichnen eine Transaktion im Wert von 0 $ im Kaufverlauf des Nutzers in der Play Store App auf.

Schritt 7: OOAP-Test beenden und löschen

Nach Abschluss des Tests:

1. Rufen Sie die Seite Out-of-App-Käufe auf.
2. Tippen Sie auf Test löschen, um den OOAP-Test zu beenden und die OOAP-Test-Einstellungen zu löschen.

OOAP-Test löschen.

Testkonfigurationen ändern

Während ein OOAP-Vorschautest aktiv ist, können Sie den Paketnamen, die Produkt-ID, die Angebotsauswahl oder die Überschreibung des Google Play Store-Landes nicht ändern.

Dazu muss der aktuelle OOAP-Test beendet und gelöscht werden.

Produkt oder Angebot bearbeiten

Wenn Sie derzeit einen OOAP-Test ausführen und ein anderes Produkt oder Angebot testen möchten:

1. Öffne Play Billing Lab und tippe auf der aktiven Karte Out-of-App-Käufe auf Ansehen.
2. Tippen Sie auf Bearbeiten, um den Paketnamen, die Produkt-ID oder das Testangebot zu ändern.
3. Bestätigen Sie den Vorgang, wenn Sie dazu aufgefordert werden, indem Sie Test beenden auswählen. Der Test wird angehalten und alle relevanten Eingaben werden gelöscht.
4. Geben Sie das neue Produkt ein oder wählen Sie das neue Angebot aus und starten Sie den Test neu.

Produkt oder Angebot bearbeiten.

Lokalisierte Preise mit länderspezifischen Überschreibungen testen

Mit Play Billing Lab können Sie das Land Ihres Google Play Store überschreiben, um regionale Preise und Währungsformate zu testen. Länderänderungen müssen jedoch sauber mit OOAP-Tests synchronisiert werden:

1. Aktiven Out-of-App-Kauf-Test beenden: Wenn du versuchst, deine Länderüberschreibung zu bearbeiten, während ein Out-of-App-Kauf-Test aktiv ist, wird im Play Billing Lab eine Warnung angezeigt, in der du aufgefordert wirst, den Test zuerst zu beenden. Dies gilt sowohl für die Bearbeitung über das Dashboard als auch über die Seite „Out-of-App-Kauf“. Wenn Sie auf Test beenden tippen, wird der aktuelle OOAP-Test beendet und die Testeingaben werden gelöscht.

2. Länderspezifische Einstellung festlegen: Nachdem Sie den OOAP-Test beendet haben, können Sie die Ländereinstellung auf der Seite Konfigurationseinstellungen bearbeiten. Wählen Sie das Zielland aus (z. B. Japan, Vereinigtes Königreich) und tippen Sie auf Anwenden.

3. Out-of-App-Kauf-Test neu starten: Sobald die Länderüberschreibung aktiv ist, kehre zur Karte Out-of-App-Käufe zurück, wähle dein Produkt und Angebot aus und tippe auf Test starten.

   In Ihrem Dashboard werden jetzt sowohl eine aktive Länderüberschreibung als auch ein aktiver OOAP-Test angezeigt.

4. Lokalisierten Preis im Google Play Store prüfen: Öffne den Google Play Store und rufe die Detailseite deiner App auf. Auf der angezeigten UI-Karte und in der Ansicht am unteren Rand von Play Express wird der Produktpreis jetzt in der Landeswährung des überschriebenen Landes angezeigt.

Lokalisierte Preise mit länderspezifischen Überschreibungen testen

Fehlerbehebung und häufig gestellte Fragen

Warum wird mein konfiguriertes Testangebot nicht auf der App-Detailseite im Google Play Store angezeigt?

• Kontokonsistenz: Prüfe, ob das in der Google Play Store App angemeldete Konto genau dasselbe Konto ist, das auch in Play Billing Lab angemeldet ist.
• EAP-Zulassungsliste und Status als lizenzierter Tester: Prüfe, ob dein Entwicklerkonto auf der Zulassungsliste für das EAP für die Play Billing Lab-Vorschau für OOAP steht und ob dein Konto in der Play Console als aktiver lizenzierter Tester aufgeführt ist.
• Ablauf: Aktive OOAP-Tests laufen nach 2 Stunden ab. Öffnen Sie Play Billing Lab, um zu prüfen, ob sich Ihr Test-Tag in Abgelaufen geändert hat. Wenn ja, starten Sie einen neuen Test.

Warum kann ich beim Einrichten eines Produkts im Play Billing Lab keine Angebote auswählen oder sehen?

• Angebotsberechtigung: In Play Billing Lab werden nur Angebote angezeigt, die du mit deinem spezifischen Testkonto derzeit kaufen kannst.

Warum ist mein Testkauf im Play Express-Overlay fehlgeschlagen?

• Auf Ihrem Testgerät muss Android 12 (API-Level 31) oder höher und die aktuelle Version des Google Play Store installiert sein.
• Prüfen Sie den RTDN-Webhook und die API-Integration im Backend Ihrer App. Beim Testen über den Google Play Store erfolgen Käufe außerhalb der Standard-UI deiner App. Ihr Backend-Server muss RTDN-Nachrichten von Google Play zuverlässig empfangen und Käufe asynchron bestätigen.

Wie kann ich einen aktiven Test beenden oder löschen, bevor der 2-Stunden-Timer abläuft?

• Öffne Play Billing Lab, suche die aktive Karte (Out-of-App-Käufe oder Konfigurationseinstellungen) und tippe auf Beenden oder Löschen. Bestätige deine Auswahl, wenn du dazu aufgefordert wirst. Die Überschreibung wird sofort von den Google Play-Servern entfernt.