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.
Lizenztester haben Zugriff auf Testzahlungsmethoden
Abbildung 1. Lizenztester haben Zugriff auf Testzahlungsmethoden.

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.
  • Bei 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:

Play Billing Lab-Dashboard
Abbildung 2. Play Billing Lab-Dashboard.

Einmalkaufprodukte testen

Verbrauchsgüter testen

Testen Sie beim Testen von Verbrauchsgütern verschiedene Situationen, 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 mehrmals gekauft werden können.

Achte darauf, dass 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

Teste einen ausstehenden Kauf, bei dem der Artikel gewährt werden soll, wenn der Kaufstatus zu PURCHASED wechselt. Lizenztester haben Zugriff auf zwei Testinstrumente für verspätete Zahlungsmittel, bei denen die Zahlung automatisch nach einigen Minuten abgeschlossen oder storniert wird.

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

    Kauf mit einer abgelehnten, langsamen Testkarte testen
    Abbildung 3: Teste einen Kauf mit einer abgelehnten langsamen Testkarte.

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

    Kauf mit einer genehmigten langsamen Testkarte testen
    Abbildung 4: Teste einen Kauf mit einer genehmigten langsamen Testkarte.

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. Du kannst die Zahlungsmethoden Testkarte, wird immer genehmigt und Testkarte, lehnt immer verwenden, die für Lizenztester verfügbar sind (siehe Abbildung 1), um Verlängerungen zu testen. Verwende diese Zahlungsmittel, um Szenarien nach einem erfolgreichen Abo-Szenario zu testen.

Ähnlich wie bei Einmalkaufprodukten solltest du darauf achten, dass Käufe wie unter Käufe verarbeiten beschrieben korrekt 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 und du eine E-Mail über die Stornierung erhältst. 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.

Abolaufzeit für Produktion Aboverlängerung testen
1 Woche 5 Minuten
1 Monat 5 Minuten
3 Monate 10 Minuten
6 Monate 15 Minuten
1 Jahr 30 Minuten

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:

Funktion Testzeitraum
Kaufbestätigung 5 Minuten
Kostenloser Testzeitraum 3 Minuten
Zeitraum des Einführungspreises Entspricht dem Testzeitraum des Abos
Kulanzzeitraum 5 Minuten
Kontosperre 10 Minuten
Pausieren (1 Monat) 5 Minuten
Pausieren (2 Monate) 10 Minuten
Pausieren (3 Monate) 15 Minuten

Beschleunigung der Verlängerung

Sie können auch das Play Billing Lab und Lizenztester verwenden, um die Verlängerungszeiträume von Testabos zu beschleunigen. Gehen Sie dazu so vor:

  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. Klicken Sie auf Jetzt verlängern.
Testabo jetzt verlängern
Abbildung 5. Beschleunigte Verlängerung der Aboverlängerung

Nachdem Sie auf die Schaltfläche Jetzt verlängern geklickt haben, wird das Testabo kurz darauf verlängert.

Beachte außerdem Folgendes:

  • Testabos müssen vor der Verwendung der Funktion „Beschleunigte Verlängerung“ bestätigt werden. Andernfalls wird das Abo gekündigt.
  • Die Verlängerung kann einige Sekunden dauern.
  • Die Schaltfläche Jetzt verlängern ist bei einer Preisänderung nicht verfügbar.
  • Wenn das Abo verlängert wird, ist die Funktion zur Änderung von Abopreisen nicht verfügbar.

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.

Test-Probeabo-Angebote
Abbildung 6: Testangebote 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. Gehe dazu so vor:

  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 gemäß den Testanforderungen an oder entfernen Sie das Häkchen.
  5. Klicken Sie auf Übernehmen.
Testabo-Preisänderung
Abbildung 7. Testabo-Preisänderung.

Nach dem Übernehmen der Änderungen 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:

Tatsächlicher Abrechnungszeitraum des Basis-Abos Testzeitraum Benachrichtigungszeitraum für Tests (Regionen mit einer Frist von 30 Tagen für die Aktivierung bzw. Deaktivierung) Benachrichtigungszeitraum für Tests (Opt-out-Regionen mit einer Frist von 60 Tagen)
1 Woche 5 Minuten 5 Minuten 10 Minuten
1 Monat 5 Minuten 5 Minuten 10 Minuten
3 Monate 10 Minuten 3 Minuten 6 Minuten
6 Monate 15 Minuten 2 Minuten 4 Minuten
1 Jahr 30 Minuten 3 Minuten 6 Minuten

Testläufe

Maximiere den folgenden Abschnitt, indem du auf Anzeigen/Ausblenden klickst. Dann werden Testszenarien angezeigt, die du zur Überprüfung deiner 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 8 gezeigt. Starte die App neu und prüfe, ob der Kauf nicht gewährt wurde.

    Kauf mit einer abgelehnten, langsamen Testkarte testen
    Abbildung 8. Teste einen Kauf mit einer abgelehnten langsamen Testkarte.

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

    Kauf mit einer genehmigten langsamen Testkarte testen
    Abbildung 9. Teste einen Kauf mit einer genehmigten langsamen Testkarte.

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 nur 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. Führe mindestens die folgenden Tests durch:

  • 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

Sie können den Kaufprozess mit oder ohne das Play Billing Lab testen:

Testen mit

Mit der Android-App Play Billing Lab kannst du den Kaufvorgang in jeder Region testen. Um das Play Billing Lab verwenden zu können, müssen Sie jedoch ein Lizenztester sein. Führe zum Testen die folgenden Schritte aus:

  1. Registrieren Sie den Nutzer mit Abrechnungszugriff als Lizenztester.
  2. Melden Sie sich mit demselben Nutzer in der Play Billing Lab App 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.
Kauferfahrung in verschiedenen Regionen testen
Abbildung 10. Testen Sie die Kaufabwicklung in verschiedenen Regionen.

Testen ohne

Du kannst den Kaufvorgang auch in einer beliebigen Region testen, ohne das Play Billing Lab zu verwenden. So testen Sie:

  1. Erstellen Sie ein neues Gmail-Konto. Das Konto kann in einem beliebigen Land erstellt werden.
  2. Optional können Sie einen Lizenztest für den Nutzer einrichten.
  3. VPN in das gewünschte Land, das getestet werden soll.
  4. Starten Sie den Kaufvorgang.

Sie können Play Store-Daten löschen und den Cache leeren und dann die Schritte 3 und 4 für jedes Land wiederholen, das Sie testen möchten. Nach dem Wechsel zu einem neuen Land musst du Daten löschen, damit der Google Play Store Daten aus dem vorherigen Land löschen kann.

Mit beiden Methoden zum Testen von Käufen kannst du die regionalen Voraussetzungen und die Nutzerfreundlichkeit in jeder Region testen, unabhängig davon, wo du den Test vornimmst.

Kauferlebnis mit echten Zahlungsmethoden testen

Mit der Play Billing Lab App für Android können Sie den Kaufprozess mit echten Zahlungsmethoden testen.

So testen Sie echte Zahlungsmethoden:

  1. Registrieren Sie den Nutzer des Google-Kontos als Lizenztester.
  2. Melden Sie sich mit demselben Nutzer in der Play Billing Lab App an.
  3. Aktiviere echte Zahlungsmethoden in der Play Billing Lab App.
  4. Starten Sie den Kaufvorgang in der zu testenden App neu.