Testowanie integracji Biblioteki płatności w Google Play

Integrację należy testować przez cały czas tworzenia. Aby przetestować aplikację na etapie rozwoju, zalecamy skorzystanie z testerów licencjiLaboratorium płatności Google Play, aby przetestować scenariusze opisane w tej sekcji.

Udzielenie licencji testerom

Aby skonfigurować testerów licencji, zapoznaj się z artykułem Testowanie rozliczeń w aplikacji za pomocą licencjonowania aplikacji.

Korzystanie z testerów licencji zapewnia te korzyści:

  • Biblioteka rozliczeniowa Google Play jest zwykle blokowana w przypadku aplikacji, które nie zostały podpisane i przesłane do Google Play. Testerzy licencji mogą pominąć to sprawdzanie, co oznacza, że możesz wczytywać aplikacje do testowania, nawet te korzystające z wersji debugowych z podpisami debugowymi, bez konieczności przesyłania nowej wersji aplikacji. Pamiętaj, że nazwa pakietu musi być zgodna z nazwą aplikacji skonfigurowanej w Google Play, a konto Google musi być kontem testującego licencję dla konta Konsoli Google Play.
  • Testerzy z licencją mają dostęp do testowych form płatności, które umożliwiają dokonywanie zakupów bez pobierania pieniędzy od testerów. Możesz też używać testowych form płatności, aby symulować określone sytuacje, np. odrzucenie płatności. Rysunek 1 przedstawia te testowe formy płatności w ramach procesu zakupu.
  • Testerzy licencji mogą szybko testować funkcje subskrypcji.
testerzy licencji mają dostęp do testowych form płatności;
Rysunek 1. Testerzy licencji mają dostęp do testowych form płatności.

Oto dodatkowe informacje o procesie zakupu testowego:

  • Zakupy testowe korzystają z tego samego procesu zakupu w aplikacji, który jest używany w przypadku rzeczywistych zakupów.
  • Podatki nie są obliczane w przypadku zakupów testowych.
  • Google Play wskazuje zakup testowy, wyświetlając powiadomienie w środku okna dialogowego zakupu.

Możesz potwierdzić konto, które dokonuje zakupu, rozwijając okno zakupu. Uwaga:

  • Konta testowe muszą znajdować się na urządzeniu z Androidem testera.
  • Jeśli na urządzeniu jest więcej niż 1 konto, zakup zostanie dokonany za pomocą konta, na które aplikacja została pobrana.
  • Jeśli żadna z kont nie pobrała aplikacji, zakup zostanie dokonany za pomocą pierwszego konta.

Zanim zaczniesz rozpowszechniać aplikację, możesz skorzystać z torów testowych w Google Play, aby przeprowadzić dodatkową weryfikację. Możesz na przykład wykorzystać ścieżki testów, aby zespół ds. kontroli jakości zatwierdził nową wersję.

Dzięki ścieżkom testów użytkownicy mogą zainstalować Twoją aplikację z Google Play i przetestować wersję, która nie jest jeszcze dostępna publicznie. Użytkownicy mogą dokonywać prawdziwych zakupów, korzystając z dowolnej formy płatności w Google Play.

Aby przetestować integrację z Biblioteką płatności w Google Play za pomocą ścieżek testowych:

  1. Opublikuj aplikację na ścieżce testów. Pamiętaj, że po opublikowaniu aplikacji na ścieżce testów może minąć kilka godzin, zanim będzie ona dostępna dla testerów.
  2. Upewnij się, że każdy tester zgadza się na testowanie aplikacji. Na stronie URL dołączenia do testu testerzy zobaczą wyjaśnienie, na czym polega ich zadanie, i będą mogli zgodzić się na udział w teście.

Integrację możesz przetestować na dowolnym urządzeniu z Androidem w wersji 1.6 lub nowszej. Na urządzeniu musi być zainstalowana najnowsza wersja aplikacji Google Play. Informacje ogólne o konfigurowaniu urządzenia do tworzenia aplikacji na Androida znajdziesz w artykule Korzystanie z urządzeń sprzętowych.

Laboratorium Płatności w Play

Laboratorium Płatności w Play to aplikacja na Androida, która pomaga deweloperom przetestować integrację z systemem rozliczeniowym Google Play. Dzięki temu deweloperzy mogą w prosty i wygodny sposób testować funkcje płatności, szybciej je integrować i z większym przekonaniem wprowadzać na rynek. Możesz pobrać i zainstalować Play Billing Lab ze Sklepu Play.

W ramach testów w Play Billing Lab możesz wykonywać te czynności:

Panel Laboratorium płatności w Google Play
Rysunek 2. Panel Laboratorium płatności w Play.

Testowanie produktów kupowanych raz

Testowanie produktów konsumpcyjnych

Podczas testowania produktów jednorazowych należy przetestować różne sytuacje, w tym:

  • Pomyślny zakup, w którym użytkownik otrzymuje produkt. W przypadku testera licencji możesz użyć formy płatności Test instrument, always approves.
  • zakup, w którym nie udało się obciążyć formy płatności, a użytkownik nie powinien otrzymać produktu; W przypadku testera licencji możesz użyć instrumentu testowego, który zawsze odrzuca formę płatności.
  • Upewnij się, że produkty można kupić wielokrotnie.

Sprawdź, czy zakupy są prawidłowo potwierdzane zgodnie z opisem w sekcji przetwarzanie zakupów. W przypadku zakupów dokonanych przez testerów licencji zwrot środków nastąpi po 3 minutach, jeśli Twoja aplikacja nie potwierdzi zakupu. Otrzymasz e-maila z informacją o anulowaniu. Możesz też sprawdzić kartę Zamówienia w Konsoli Google Play, aby zobaczyć, czy zamówienie zostało zwrócone po 3 minutach.

Testowanie produktów niekonsumpcyjnych

Produkty nietrwałe należy testować tak samo jak produkty trwałe, ale należy sprawdzić, czy produktu nie można ponownie kupić w aplikacji. Sprawdź potwierdzenie zakupu zarówno w przypadku produktów nietrwałych, jak i trwałych (w stosownych przypadkach), ponieważ logika przetwarzania tych 2 typów zakupów jest inna.

Testowanie oczekujących zakupów

Przetestuj oczekujący zakup, w którym produkt powinien zostać przyznany, gdy stan zakupu zmieni się na PURCHASED. Testerzy licencji mają dostęp do 2 instrumentów testowych dla opóźnionych form płatności, w których przypadku płatność jest automatycznie realizowana lub anulowana po kilku minutach.

  1. Dokonać zakupu przy użyciu formy płatności o opóźnionym działaniu Powolny test karty, odrzucanie następuje po kilku minutach, jak pokazano na rysunku 3. Uruchom ponownie aplikację i sprawdź, czy zakup nie został zrealizowany.

    testować zakupy za pomocą odrzuconej karty testowej o niskiej szybkości
    Rysunek 3. Testowanie zakupu za pomocą odrzuconej karty testowej.

  2. Dokonać zakupu przy użyciu formy płatności o opóźnionym działaniu Powolny test karty, zatwierdza po kilku minutach, jak pokazano na rysunku 4. Poczekaj kilka minut i potwierdź, że zakup został zatwierdzony.

    testować zakupy za pomocą zatwierdzonej karty testowej z powolnym działaniem;
    Rysunek 4. Przetestuj zakup za pomocą zatwierdzonej karty testowej z powolnym działaniem.

Więcej informacji znajdziesz w artykule Obsługa transakcji oczekujących.

Testowanie funkcji związanych z subskrypcją

Procesy zakupu produktów kupowanych raz i subskrypcji są podobne, ale w przypadku subskrypcji występują dodatkowe scenariusze, takie jak odnowienie subskrypcji pomyślnie lub odrzucone. Aby przetestować odnowienie, możesz użyć form płatności Karta testowa, zawsze zatwierdza i Karta testowa, zawsze odrzuca, które są dostępne dla testerów licencji, jak pokazano na rysunku 1. Używaj tych instrumentów płatności do testowania scenariuszy innych niż scenariusz udanej subskrypcji.

Podobnie jak w przypadku produktów kupowanych raz, sprawdź, czy zakupy są prawidłowo potwierdzane zgodnie z opisem w sekcji przetwarzanie zakupów. W przypadku zakupów dokonanych przez testerów licencji zwrot środków następuje po 3 minutach, jeśli Twoja aplikacja nie potwierdzi zakupu, a Ty otrzymasz e-maila o anulowaniu. Możesz też sprawdzić kartę Zamówienia w Konsoli Google Play, aby dowiedzieć się, czy zamówienie zostało zwrócone po 3 minutach.

Okresy odnowienia

Testowe subskrypcje odnawiają się szybciej niż rzeczywiste subskrypcje. Mogą one odnawiać się maksymalnie 6 razy, nie licząc bezpłatnych okresów próbnych i wprowadzeń.

W tabeli poniżej znajdziesz czasy testowania odnawiania subskrypcji o różnych długościach. Czasy są przybliżone. Możesz zauważyć niewielkie różnice w dokładnym czasie wystąpienia zdarzenia. Aby to zrekompensować, wywołaj interfejs API, aby wyświetlić bieżący stan po każdej dacie wygaśnięcia subskrypcji.

Okres subskrypcji produkcyjnej Testowanie odnawiania subskrypcji
1 tydzień 5 minut
1 miesiąc 5 minut
3 miesiące 10 minut,
6 miesięcy 15 minut
1 rok 30 minut,

Funkcje subskrypcji oparte na czasie, takie jak bezpłatne okresy próbne, są również skrócone na potrzeby testowania. W tabeli poniżej przedstawiono okresy testowania funkcji subskrypcji czasowej:

Funkcja Okres testowy
Potwierdzenie zakupu 5 minut
Bezpłatny okres próbny 3 minuty
Okres obowiązywania ceny dla nowych subskrybentów Taki sam jak okres próbny subskrypcji
Okres prolongaty (3 i 7 dni) 5 minut
Zawieszenie konta 10 minut,
Wstrzymanie (1 miesiąc) 5 minut
Wstrzymanie (2 miesiące) 10 minut,
Wstrzymanie (3 miesiące) 15 minut

przyspieszenie odnowienia,

Możesz też użyć Play Billing Lab i testerów licencji, aby przyspieszyć okresy odnawiania testowych subskrypcji. Aby to zrobić:

  1. Na karcie Ustawienia subskrypcji w sekcji Panel kliknij Zarządzaj.
  2. Wybierz aktywną subskrypcję, którą chcesz przetestować.
  3. Kliknij Odnów teraz.
test subscription renew now
Rysunek 5. Test przyspieszenia okresu odnowienia subskrypcji.

Gdy klikniesz przycisk Odnów teraz, testowa subskrypcja zostanie odnowiona wkrótce.

Należy pamiętać, że:

  • Przed skorzystaniem z funkcji przyspieszonego odnawiania należy zaakceptować subskrypcje testowe, w przeciwnym razie zostaną one anulowane.
  • Proces odnowienia może potrwać kilka sekund.
  • Gdy obowiązują zmiany cen, przycisk Odnów teraz jest niedostępny.
  • Podczas odnawiania subskrypcji funkcja zmiany ceny subskrypcji jest niedostępna.

Oferty dotyczące okresu próbnego

Dzięki funkcji testowania ofert próbnych w Play Billing Lab tester licencji może testować i korzystać z bezpłatnych okresów próbnych lub ofert dla nowych użytkowników nieograniczoną liczbę razy, zaznaczając pole wyboru Testuj bezpłatny okres próbny lub ofertę dla nowych użytkowników i zapisując zmiany. Dzięki temu nie musisz tworzyć wielu kont, aby przetestować ofertę próbną dostępną tylko dla nowych subskrybentów.

testowanie ofert dotyczących okresu próbnego
Rysunek 6. testować oferty okresu próbnego.

zmiany cen.

Możesz też użyć Play Billing Lab i testerów licencji, aby przetestować zmiany cen subskrypcji bez wpływu na innych aktywnych subskrybentów. Aby to zrobić:

  1. Na karcie Ustawienia subskrypcji w sekcji Panel kliknij Zarządzaj.
  2. Wybierz aktywną subskrypcję, którą chcesz przetestować.
  3. Wpisz nową cenę.
  4. Zaznacz lub odznacz pole wyboru Wyłączenie przez użytkownika zgodnie z wymaganiami testu.
  5. Kliknij Zastosuj.
testowanie zmiany ceny subskrypcji
Rysunek 7. Przetestuj zmianę ceny subskrypcji.

Po zastosowaniu zmian cena zostanie zaktualizowana od następnego odnowienia tylko dla testera. Nie wpłynie to na innych aktywnych subskrybentów. Do subskrypcji testowej mają zastosowanie wszystkie reguły dotyczące testerów licencji. Testujący może następnie sprawdzić aplikację pod kątem procesów w dół łańcucha wywołanych przez zmianę ceny, np. powiadomień o zmianie ceny.

Podczas planowania okresów testowych pamiętaj o tych kwestiach:

  • Ze względu na krótki okres odnowienia dla testerów licencji możliwe, że migracja cen przeprowadzona w konsoli nie zostanie zarejestrowana dla testerów licencji. Aby mieć pewność, że powiadomienia i e-maile z powiadomieniami o zmianach cen można testować, deweloperzy powinni opóźnić rozliczenia co najmniej o 1 godzinę po wywołaniu zmiany ceny.
  • W przypadku obniżek cen nie ma okresu powiadomienia. Użytkownicy są powiadamiani o obniżeniu ceny wkrótce po migracji kohorty. Nie zmienia się to podczas testowania.
  • W przypadku podwyżek cen czasy wysyłania powiadomień testowych są obliczane tak samo jak w przypadku rzeczywistych podwyżek:
    • Użytkownikowi po raz pierwszy zostanie naliczona opłata w pierwszym dniu okresu rozliczeniowego przypadającym po okresie obowiązkowego powiadomienia.
    • Czasy powiadomień są obliczane wstecz od daty pierwszego obciążenia.
    • Ostatnie powiadomienie jest zawsze wysyłane 1 minutę przed pobraniem środków, niezależnie od okresu rozliczeniowego.

Poniższa tabela przedstawia okresy rozliczeń testowych i powiadomień w przypadku kilku rzeczywistych okresów rozliczeniowych:

Faktyczny okres rozliczeniowy abonamentu podstawowego Testowy okres rozliczeniowy Okres testowania powiadomień (regiony z wymuszoną akceptacją i z możliwością rezygnacji z 30-dniowym okresem wypowiedzenia) Okres testowania powiadomień (regiony z opcją rezygnacji z usługi z 60-dniowym wyprzedzeniem)
1 tydzień 5 minut 5 minut 10 minut,
1 miesiąc 5 minut 5 minut 10 minut,
3 miesiące 10 minut, 3 minuty 6 minut
6 miesięcy 15 minut 2 minuty 4 minuty
1 rok 30 minut, 3 minuty 6 minut

Elementy testowania

Rozwiń tę sekcję, klikając Pokaż/ukryj, aby wyświetlić scenariusze testowe, których możesz użyć do weryfikacji integracji z subskrypcją.

Testowanie oczekujących transakcji

Sprawdź, czy oczekujące transakcje są obsługiwane prawidłowo i czy uprawnienia są odpowiednio aktualizowane, gdy stan zakupu zmieni się na PURCHASED. Testerzy licencji mają dostęp do 2 instrumentów testowych służących do opóźnionych form płatności, w których przypadku płatność jest automatycznie realizowana lub anulowana po kilku minutach.

  1. Dokonać zakupu przy użyciu formy płatności o opóźnionym działaniu (powolny test karty, odrzucenie następuje po kilku minutach), jak pokazano na rysunku 8. Uruchom ponownie aplikację i sprawdź, czy zakup nie został zrealizowany.

    testować zakupy za pomocą odrzuconej karty testowej o niskiej szybkości
    Rysunek 8. Testowanie zakupu za pomocą odrzuconej karty testowej.

  2. Dokonać zakupu przy użyciu formy płatności o opóźnionym działaniu (powolny test karty, zatwierdzenie następuje po kilku minutach), jak pokazano na rysunku 9. Poczekaj kilka minut i potwierdź, że zakup został zatwierdzony.

    testować zakupy za pomocą zatwierdzonej karty testowej z powolnym działaniem;
    Rysunek 9. Przetestuj zakup za pomocą zatwierdzonej karty testowej z powolnym działaniem.

Testowanie kodów promocyjnych

W Konsoli Google Play możesz tworzyć kody do własnych testów. Pamiętaj, że możesz utworzyć maksymalnie 500 kodów promocyjnych na kwartał na wszystkie produkty zarządzane w aplikacji.

Należy przetestować te scenariusze korzystania z kodów promocyjnych:

  • gdy kod promocyjny zostanie wpisany w oknie zakupu, które zostało otwarte w aplikacji.
  • Gdy kod promocyjny zostanie wykorzystany w aplikacji Sklep Google Play.
  • Gdy kod promocyjny zostanie wykorzystany na stronie https://play.google.com/store za pomocą przycisku Aktywuj w menu nawigacyjnym po lewej stronie.

W ramach tych scenariuszy należy przetestować wykorzystanie kodów na jak najwięcej sposobów. Wykonaj co najmniej te testy:

  • Wykorzystanie przed zainstalowaniem aplikacji.
  • Wykorzystanie podczas działania aplikacji na pierwszym planie. Pamiętaj, że do przeprowadzenia tego testu potrzebujesz innego urządzenia, na którym możesz użyć aplikacji Sklep Google Play. Pamiętaj, aby przetestować wykupywanie nagród na różnych ekranach aplikacji.
  • Wykorzystanie w trybie wielookiennym, w którym zarówno Twoja aplikacja, jak i aplikacja Sklep Google Play są wyświetlane jednocześnie.

W przypadku każdego testu sprawdź, czy produkt jest prawidłowo wykrywany i czy użytkownik jest o tym informowany.

Testowanie procesu zakupu w różnych regionach

Możesz przetestować proces zakupu z użyciem Laboratorium płatności w Play lub bez niego:

Testuj za pomocą

Aplikacja Laboratorium płatności w Play na Androida umożliwia testowanie procesu zakupu w dowolnym regionie. Aby jednak korzystać z Play Billing Lab, musisz być testerem licencji. Aby przetestować tę funkcję:

  1. Zarejestruj użytkownika rozliczeń w aplikacji jako testującego licencję.
  2. Zaloguj się w aplikacji Laboratorium płatności w Play za pomocą tego samego konta użytkownika.
  3. Wybierz odpowiedni kraj i zastosuj zmianę w Play Billing Lab.
  4. Uruchom proces zakupu w aplikacji, którą testujesz.
testowanie procesu zakupu w różnych regionach;
Rysunek 10. Testowanie procesu zakupu w różnych regionach.

Test bez

Możesz też przetestować proces zakupu w dowolnym regionie bez korzystania z Play Billing Lab. Aby przetestować:

  1. Utwórz nowe konto Gmail. Konto można utworzyć w dowolnym kraju.
  2. Opcjonalnie możesz skonfigurować użytkownika jako testera licencji.
  3. VPN do wybranego kraju, w którym chcesz przeprowadzić test.
  4. Uruchom proces zakupu.

Możesz wyczyścić dane i pamięć podręczną Sklepu Play, a następnie powtórzyć kroki 3 i 4 w dowolnym kraju, który chcesz przetestować. Po przejściu do nowego kraju musisz wyczyścić dane Sklepu Google Play, aby usunąć dane związane z poprzednim krajem.

Obie te metody testowania zakupów umożliwiają sprawdzenie dostępności oferty w danym regionie oraz wrażeń użytkownika w dowolnym regionie, niezależnie od tego, gdzie fizycznie przeprowadzasz test.

Testowanie procesu zakupu przy użyciu rzeczywistych form płatności

Możesz przetestować proces zakupu za pomocą rzeczywistych form płatności w aplikacji Laboratorium płatności w Play na urządzeniu z Androidem.

Aby przetestować rzeczywiste formy płatności:

  1. Zarejestruj użytkownika konta Google jako testera licencji.
  2. Zaloguj się w aplikacji Laboratorium płatności w Play za pomocą tego samego konta użytkownika.
  3. Włącz rzeczywiste formy płatności w aplikacji Laboratorium Płatności w Play.
  4. Ponownie uruchom proces zakupu i uruchom go w aplikacji, którą testujesz.