Einbindung der Google Play Billing Library testen

Du solltest deine Integration während der Entwicklung testen. Für Tests während der Entwicklungsphase empfehlen wir, Lizenztester und das Play Billing Lab zu nutzen, um die in diesem Abschnitt beschriebenen Szenarien durchzugehen.

Lizenztester

Informationen zum Konfigurieren von Lizenztestern finden Sie unter In-App-Abrechnung mit App-Lizenzierung testen.

Lizenztester bieten folgende Vorteile:

• Normalerweise wird die Google Play Billing Library für Apps blockiert, die nicht signiert und bei Google Play hochgeladen wurden. Lizenztester können diese Prüfung umgehen. Das bedeutet, dass du Apps zu Testzwecken per Sideload übertragen kannst, auch für Apps, die Debug-Builds mit Debug-Signaturen verwenden, ohne sie in die neue Version deiner App hochladen zu müssen. Beachte, dass der Paketname mit dem Namen der App übereinstimmen muss, die für Google Play konfiguriert ist. Das Google-Konto muss ein Lizenztester für das Google Play Console-Konto sein.
• Lizenztester haben Zugriff auf Testzahlungsmethoden, sodass den Testern für Käufe kein echtes Geld in Rechnung gestellt wird. Du kannst auch Testzahlungsmethoden verwenden, um bestimmte Situationen zu simulieren, z. B. wenn eine Zahlung abgelehnt wird. In Abbildung 1 siehst du diese Testformen, wie sie während des Kaufvorgangs angezeigt werden.
• Lizenztester können Abofunktionen schnell testen.

Weitere Informationen zum Testkaufprozess:

• Für Testkäufe gilt derselbe Ablauf wie bei den tatsächlichen Käufen.
• Für Testkäufe werden keine Steuern berechnet.
• In Google Play wird in der Mitte des Kaufdialogfelds ein Hinweis auf einen Testkauf angezeigt.

Du kannst das Konto, über das ein Kauf getätigt wird, bestätigen, indem du das Kaufdialogfeld maximierst. Beachten Sie Folgendes:

• Testkonten müssen sich auf dem Android-Gerät des Testers befinden.
• Wenn das Gerät mehr als ein Konto hat, wird der Kauf über das Konto getätigt, über das die App heruntergeladen wurde.
• Wenn die App für keines der Konten heruntergeladen wurde, wird der Kauf über das erste Konto getätigt.

Bevor du deine App vertreibst, kannst du mithilfe der Test-Tracks von Google Play zusätzliche Validierungen durchführen. Sie können z. B. Test-Tracks nutzen, damit Ihr QA-Team einen neuen Release qualifizieren kann.

Mit Test-Tracks können Nutzer deine App über Google Play installieren und eine Version deiner App testen, die noch nicht öffentlich verfügbar ist. Nutzer können mit jeder ihrer Zahlungsmethoden bei Google Play echte Einkäufe tätigen.

So testest du die Einbindung der Google Play Billing Library mithilfe von Test-Tracks:

1. Veröffentlichen Sie Ihre App in einem Test-Track. Nach der Veröffentlichung einer App in einem Test-Track kann es einige Stunden dauern, bis sie für Tester verfügbar ist.
2. Achten Sie darauf, dass alle Tester dem Test Ihrer App zustimmen. Unter der Teilnahme-URL für Ihren Test sehen Ihre Tester eine Erklärung, was es bedeutet, Tester zu sein, sowie einen Link, über den sie sich anmelden können.

Du kannst deine Integration auf jedem Android-Hardwaregerät mit Android 1.6 oder höher testen. Auf dem Gerät muss die aktuelle Version der Google Play App installiert sein. Allgemeine Informationen zum Einrichten eines Geräts für die Entwicklung von Android-Apps finden Sie unter Hardwaregeräte verwenden.

Play Billing Lab

Das Play Billing Lab ist eine Android-App, mit der Entwickler ihre Integration in das Abrechnungssystem von Google Play testen können. Sie bietet Entwicklern eine einfache und bequeme Möglichkeit, Abrechnungsfunktionen zu testen, sie schneller einzubinden und zuverlässiger zu starten. Sie können das Play Billing Lab aus dem Play Store herunterladen und installieren.

Mit Play Billing Lab können Sie bei Tests Folgendes tun:

• Ändere das Play-Land in Play Billing Lab und wende die Einstellungen auf deinen Test an. Dies ermöglicht das Testen benutzerdefinierter Nutzererfahrungen in verschiedenen Ländern/Regionen, unabhängig davon, wo der Tester physisch testet.
• Probeabos oder Einführungsangebote wiederholt mit demselben Konto testen
• Abopreisänderungen testen, ohne dass sich dies auf andere aktive Abonnenten auswirkt

Einmalkaufprodukte testen

Verbrauchsgüter testen

Beim Testen von Verbrauchsgütern empfehlen wir, verschiedene Situationen zu testen, darunter:

• Ein erfolgreicher Kauf, bei dem der Nutzer einen Artikel erhält. Mit einem Lizenztester können Sie die Zahlungsmethode Testinstrument, genehmigt immer verwenden.
• Ein Kauf, bei dem die Zahlungsmethode nicht belastet werden konnte und der Nutzer den Artikel nicht erhalten sollte. Mit einem Lizenztester können Sie die Zahlungsmethode Testinstrument, wird immer abgelehnt verwenden.
• Achten Sie darauf, dass die Artikel mehrfach gekauft werden können.

Du solltest außerdem prüfen, ob Käufe wie unter Käufe verarbeiten beschrieben ordnungsgemäß bestätigt werden. Bei Käufen von Lizenztestern wird ein Kauf nach 3 Minuten erstattet, wenn der Kauf in deiner App nicht bestätigt wird. Du erhältst dann eine E-Mail über die Stornierung. Sie können auch auf dem Tab Bestellungen in der Google Play Console nachsehen, ob eine Bestellung nach 3 Minuten erstattet wurde.

Nicht konsumierbare Produkte testen

Nicht Verbrauchsgüter sollten wie Verbrauchsgüter getestet werden, du solltest jedoch prüfen, ob ein Artikel in deiner App noch einmal gekauft werden kann. Achte darauf, die Kaufbestätigung sowohl für nicht Verbrauchsgüter als auch für Verbrauchsgüter (falls zutreffend) zu prüfen, da die Logik zur Verarbeitung der beiden Kaufarten unterschiedlich ist.

Ausstehende Käufe testen

Du solltest einen ausstehenden Kauf testen, bei dem der Artikel gewährt werden sollte, wenn der Kaufstatus PURCHASED ändert. Lizenztester haben Zugriff auf zwei Testinstrumente für verzögerte Zahlungsmittel, bei denen die Zahlung nach einigen Minuten automatisch abgeschlossen oder storniert wird.

1. Tätige einen Kauf mit einem verspäteten Zahlungsmittel „Langsame Testkarte, wird nach einigen Minuten abgelehnt“, wie in Abbildung 2 dargestellt. Starte die App neu und prüfe, ob der Kauf nicht gewährt wurde.

   

2. Tätige einen Kauf mit einem verspäteten Zahlungsmittel „Langsame Testkarte, Genehmigung nach einigen Minuten“, wie in Abbildung 3 dargestellt. Warten Sie einige Minuten und prüfen Sie, ob der Kauf gewährt wurde.

   

Weitere Informationen finden Sie unter Umgang mit ausstehenden Transaktionen.

Abospezifische Funktionen testen

Die Kaufabläufe für Einmalkaufprodukte und Abos sind ähnlich, es gibt jedoch zusätzliche Szenarien, z. B. erfolgreiche oder abgelehnte Aboverlängerungen. Um Verlängerungen zu testen, kannst du die Zahlungsmethoden Testinstrument, genehmigt immer und Testinstrument, immer abgelehnt verwenden, die für Lizenztester verfügbar sind (siehe Abbildung 1). Verwende diese Zahlungsmittel, um Szenarien nach einem erfolgreichen Abo-Szenario zu testen.

Ähnlich wie bei Einmalkaufprodukten solltest du auch hier prüfen, ob Käufe korrekt bestätigt werden, wie unter Käufe verarbeiten beschrieben. Bei Käufen von Lizenztestern wird ein Kauf nach 3 Minuten erstattet, wenn in deiner App der Kauf nicht bestätigt wird. Du erhältst dann eine E-Mail über die Stornierung. In der Google Play Console kannst du auch auf dem Tab „Bestellungen“ nachsehen, ob eine Bestellung nach 3 Minuten erstattet wurde.

Verlängerungszeiträume

Testabos werden schneller verlängert als tatsächliche Abos. Testabos können maximal sechsmal verlängert werden, kostenlose Testabos und Einführungszeiträume werden nicht berücksichtigt.

In der folgenden Tabelle sind die Testverlängerungen für Abos mit unterschiedlicher Laufzeit aufgeführt. Diese Zeiten sind Näherungswerte. Der genaue Zeitpunkt eines Ereignisses kann leicht variieren. Um Abweichungen auszugleichen, kannst du die API aufrufen, um nach jedem Ablaufdatum des Abos den aktuellen Status anzusehen.

Zeitbasierte Abofunktionen wie kostenlose Testzeiträume werden für Tests ebenfalls gekürzt. In der folgenden Tabelle sind die Testzeiträume für zeitbasierte Abofunktionen aufgeführt:

Testangebote

Mit der Testfunktion für Play Billing Lab-Testangebote kann ein Lizenztester Probeabos oder Einführungsangebote beliebig oft testen und nutzen. Dazu muss das Kästchen Kostenlosen Testzeitraum oder Einführungsangebot testen angeklickt und die Änderung übernommen werden. Du musst dann nicht mehr mehrere Konten erstellen, um ein Probeabo, das nur für neue Abonnenten verfügbar ist, zu testen.

Preisänderungen

Du kannst auch das Play Billing Lab und Lizenztester verwenden, um Änderungen der Abopreise zu testen, ohne andere aktive Abonnenten zu beeinträchtigen. Das geht so:

1. Klicken Sie im Dashboard auf der Karte Aboeinstellungen auf Verwalten.
2. Wählen Sie das aktive Abo aus, das Sie testen möchten.
3. Geben Sie den neuen Preis ein.
4. Klicken Sie das Kästchen Nutzer deaktivieren entsprechend den Testanforderungen an oder entfernen Sie das Häkchen.
5. Klicken Sie auf Übernehmen.

Nachdem die Änderungen übernommen wurden, wird der Preis ab der nächsten Verlängerung nur für den Tester aktualisiert. Andere aktive Abonnenten sind davon nicht betroffen. Alle Lizenztestregeln gelten für das Testabo. Der Tester kann seine App dann auf nachgelagerte Prozesse testen, die durch die Preisänderung ausgelöst werden, z. B. Benachrichtigungen zu Preisänderungen.

Beachten Sie bei der Planung von Testzeiträumen die folgenden Überlegungen:

• Aufgrund einer kurzen Verlängerungsdauer für Lizenztester ist es möglich, dass eine Preismigration über die Console nicht für Lizenztester registriert wird. Damit Benachrichtigungen und E-Mails zu Preisänderungen getestet werden können, sollten Entwickler die Abrechnung nach dem Auslösen einer Preisänderung um mindestens eine Stunde verschieben.
• Für Preissenkungen gibt es keinen Benachrichtigungszeitraum. Nutzer werden kurz nach der Kohortenmigration über eine Preissenkung informiert. Dies bleibt beim Testen unverändert.
• Bei Preiserhöhungen werden die Testbenachrichtigungszeiten auf dieselbe Weise berechnet wie bei tatsächlichen Erhöhungen:
  • Dem Nutzer wird zum ersten Jahrestag nach einem obligatorischen Benachrichtigungszeitraum erstmals ein Betrag in Rechnung gestellt.
  • Die Benachrichtigungszeiten werden ab dem Datum der ersten Abbuchung rückwärts berechnet.
  • Die letzte Benachrichtigung erfolgt unabhängig vom Abrechnungszeitraum immer eine Minute vor der Belastung.

Die folgende Tabelle zeigt Testabrechnungs- und Benachrichtigungszeiträume für mehrere tatsächliche Abrechnungszeiträume:

Testläufe

Maximiere den folgenden Abschnitt, indem du auf Anzeigen/Ausblenden klickst. Dann werden Testszenarien angezeigt, die du zum Überprüfen der Abointegration verwenden solltest.

Ausstehende Transaktionen testen

Du solltest testen, ob ausstehende Transaktionen korrekt verarbeitet werden und Berechtigungen entsprechend aktualisiert werden, wenn der Kaufstatus PURCHASED ändert. Lizenztester haben Zugriff auf zwei Testinstrumente für verspätete Zahlungsmittel, bei denen die Zahlung nach einigen Minuten automatisch abgeschlossen oder storniert wird.

1. Tätige einen Kauf mit einem verspäteten Zahlungsmittel „Langsame Testkarte, wird nach einigen Minuten abgelehnt“, wie in Abbildung 2 dargestellt. Starte die App neu und prüfe, ob der Kauf nicht gewährt wurde.

   

2. Tätige einen Kauf mit einem verspäteten Zahlungsmittel „Langsame Testkarte, Genehmigung nach einigen Minuten“, wie in Abbildung 3 dargestellt. Warten Sie einige Minuten und prüfen Sie, ob der Kauf gewährt wurde.

   

Gutscheincodes testen

Mit der Google Play Console kannst du Codes für eigene Tests erstellen. Beachten Sie, dass Sie pro Quartal für alle verwalteten Produkte in einer App maximal 500 Gutscheincodes erstellen können.

Testen Sie die folgenden Szenarien für die Einlösung von Gutscheincodes:

• Wenn der Gutscheincode im Kaufdialog eingegeben wird, der in deiner App geöffnet wurde.
• Wenn der Gutscheincode in der Google Play Store App eingelöst wird.
• Wenn der Gutscheincode unter https://play.google.com/store über die Schaltfläche Einlösen im linken Navigationsbereich eingelöst wird.

In diesen Szenarien solltest du das Einlösen von Codes auf so viele Arten wie möglich testen. Wir empfehlen mindestens die folgenden Tests:

• Einlösung vor Installation der App.
• Einlösung, während die App im Vordergrund ausgeführt wird. Für diesen Test benötigst du ein anderes Gerät, um den Test mit der Google Play Store App durchzuführen. Teste die Einlösungen auf verschiedenen Bildschirmen deiner App.
• Einlösung im Mehrfenstermodus, in dem Ihre App und die Google Play Store App gleichzeitig angezeigt werden.

Achte bei jedem Test darauf, dass das Element richtig erkannt und der Nutzer benachrichtigt wird.

Kauf in verschiedenen Regionen testen

Mit Play Billing Lab und Lizenztestern kannst du außerdem den Kaufvorgang in jeder Region testen, ohne eine echte Zahlungsmethode für dieses Land zu benötigen. Führe zum Testen die folgenden Schritte aus:

1. Registrieren Sie den Nutzer mit Abrechnungszugriff für die App als Lizenztester.
2. Melden Sie sich mit demselben Nutzer in Play Billing Lab an.
3. Wähle das gewünschte Land aus und wende die Änderung im Play Billing Lab an.
4. Starten Sie den Kaufvorgang in der zu testenden App.

Mit dieser Methode zum Testen von Käufen kannst du die regionale Eignung von Angeboten und die Nutzererfahrung in jeder Region testen, unabhängig davon, wo du den Test vornimmst.