Testowanie integracji Biblioteki płatności w Google Play

Należy testować integrację przez cały czas programowania. W trakcie tworzenia aplikacji zalecamy korzystanie z testerów licencji i Laboratorium płatności w Play w celu przeanalizowania scenariuszy opisanych w tej sekcji.

Udzielenie licencji testerom

Aby skonfigurować testerów licencji, przeczytaj artykuł o testowaniu rozliczeń w aplikacji z wykorzystaniem licencjonowania aplikacji.

Korzystanie z testerów licencji przynosi takie korzyści:

  • Zazwyczaj Biblioteka płatności w Google Play jest zablokowana dla aplikacji, które nie są podpisane i przesłane do Google Play. Testerzy licencji mogą pominąć to sprawdzanie, co oznacza, że możesz instalować aplikacje z innego źródła na potrzeby testowania, nawet jeśli korzystają z kompilacji do debugowania z podpisami debugowania, bez konieczności przesyłania ich do nowej wersji. Pamiętaj, że nazwa pakietu musi odpowiadać nazwie pakietu aplikacji skonfigurowanej pod kątem Google Play, a konto Google musi być testerem licencji na koncie Konsoli Google Play.
  • Testerzy licencji mają dostęp do form płatności, które pozwalają uniknąć obciążania ich prawdziwymi opłatami za zakupy. Możesz też użyć 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 trakcie procesu zakupu.
  • Testerzy licencji mogą szybko testować funkcje subskrypcji.
testerzy licencji mają dostęp do testowania form płatności
Rysunek 1. Testerzy licencji mają dostęp do testowania form płatności.

Oto kilka dodatkowych informacji o procesie zakupu testowego:

  • Zakupy testowe wykorzystują ten sam proces zakupu aplikacji, który jest taki sam jak w przypadku rzeczywistych zakupów.
  • W przypadku zakupów testowych nie są obliczane podatki.
  • Google Play wskazuje zakup testowy, wyświetlając powiadomienie na środku okna zakupu.

Aby sprawdzić konto, z którego dokonujesz zakupu, rozwiń okno zakupu. Uwaga:

  • Konta testowe muszą znajdować się na urządzeniu z Androidem, z którego korzysta tester.
  • Jeśli na urządzeniu jest więcej niż jedno konto, zakup jest dokonywany na koncie, z którego pobrano aplikację.
  • Jeśli żadne konto nie pobrało aplikacji, zakup jest dokonywany na pierwszym koncie.

Zanim rozpowszechniasz aplikację, możesz przeprowadzić dodatkową weryfikację, korzystając ze ścieżek testów w Google Play. Możesz na przykład wykorzystać ścieżki testów, aby zespół ds. kontroli jakości kwalifikował nową wersję.

Ścieżki testów umożliwiają użytkownikom instalowanie Twojej aplikacji z Google Play i testowanie jej wersji, 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ę Biblioteki płatności w Google Play za pomocą ścieżek testów:

  1. Opublikuj aplikację na ścieżce testów. Gdy opublikujesz aplikację na ścieżce testów, może minąć kilka godzin, zanim stanie się ona dostępna dla testerów.
  2. Upewnij się, że każdy tester dołączy do testów aplikacji. Pod adresem URL przystąpienia do testów testerzy widzą wyjaśnienie, na czym polega ich zadanie, oraz link umożliwiający dołączenie do testu.

Możesz przetestować integrację na dowolnym urządzeniu z Androidem w wersji 1.6 lub nowszej. Na urządzeniu musi być zainstalowana najnowsza wersja aplikacji Google Play. Ogólne informacje o konfigurowaniu urządzenia na potrzeby tworzenia aplikacji na Androida znajdziesz w artykule Korzystanie ze sprzętu.

Laboratorium płatności w Play

Laboratorium płatności w Play to aplikacja na Androida, która pomaga deweloperom w testowaniu integracji z systemem rozliczeniowym Google Play. Pozwala on deweloperom w łatwy i wygodny sposób testować funkcje płatności, szybciej przeprowadzać integrację i uruchamiać je z większą pewnością. Laboratorium rozliczeń Play możesz pobrać i zainstalować ze Sklepu Play.

Laboratorium płatności w Play umożliwia testowanie tych rozwiązań:

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

Testowanie produktów kupowanych raz

Testowanie produktów konsumpcyjnych

Jeśli testujesz produkty zużywalne, zalecamy sprawdzenie ich w różnych sytuacjach, na przykład w tych sytuacjach:

  • Pomyślny zakup, w wyniku którego użytkownik otrzymuje produkt. Dzięki testerowi licencji możesz użyć formy płatności instrument testowy, zawsze zatwierdza.
  • Zakup, w przypadku którego nie udało się obciążyć formy płatności, a użytkownik nie powinien otrzymać produktu. Za pomocą testera licencji możesz użyć formy płatności instrument testowy, zawsze odrzuca.
  • Upewnij się, że produkty można kupować wiele razy.

Sprawdź też, czy zakupy zostały prawidłowo potwierdzone, jak opisano w sekcji Przetwarzanie zakupów. W przypadku zakupów u testerów licencji zwrot środków za zakup następuje po 3 minutach, jeśli aplikacja nie potwierdzi zakupu, a Ty otrzymasz e-maila z informacją o anulowaniu. Na karcie Zamówienia w Konsoli Google Play możesz sprawdzić, czy po 3 minutach zwrotu środków za zamówienie zostały zwrócone.

Testowanie produktów, które się nie zużywają

Materiały niezużywalne należy testować tak samo jak materiały eksploatacyjne, ale pamiętaj, by potwierdzić, że nie możesz ich ponownie kupić w Twojej aplikacji. Pamiętaj o potwierdzeniu potwierdzenia zakupu zarówno tych, które nie są, jak i materiałów konsumpcyjnych (w odpowiednich przypadkach), ponieważ zasady przetwarzania tych 2 typów zakupów są różne.

Testowanie oczekujących zakupów

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

  1. Dokonaj zakupu za pomocą opóźnionej formy płatności: „Powolny test karty, odrzucenie po kilku minutach”, jak pokazano na Rysunku 2. Zrestartuj aplikację i sprawdź, czy zakup nie został zatwierdzony.

    przetestować zakup z odrzuconą kartą korzystającą z wolnego testu;
    Rysunek 3. Przetestuj zakup za pomocą odrzuconej karty z powolnym testem.

  2. Dokonaj zakupu za pomocą opóźnionej formy płatności: „Karta Powolny test, zatwierdza się po kilku minutach”, jak pokazano na Rysunku 3. Zaczekaj kilka minut i sprawdź, czy zakup został zrealizowany.

    przetestować zakup za pomocą zatwierdzonej karty powolnego testu;
    Rysunek 4. Przeprowadź zakup za pomocą zatwierdzonej karty powolnego testu.

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

Testowanie funkcji dostępnych tylko w ramach subskrypcji

Procesy zakupu produktów jednorazowych i subskrypcji są podobne, ale w przypadku subskrypcji wiążą się dodatkowe scenariusze, takie jak udane lub odrzucone odnowienie subskrypcji. Aby przetestować odnawianie, możesz użyć form płatności dostępnych dla testerów licencji za pomocą instrumentu testowego, zawsze zatwierdza oraz instrumentu testowego, zawsze odrzuca płatności, jak pokazano na ilustracji 1. Korzystaj z tych instrumentów płatniczych do testowania scenariuszy, które wykraczają poza scenariusz, w którym kluczowa jest subskrypcja.

Podobnie jak w przypadku produktów jednorazowych, należy też sprawdzić, czy zakupy zostały prawidłowo potwierdzone, zgodnie z opisem w sekcji na temat przetwarzania zakupów. W przypadku zakupów u testerów licencji zwrot środków za zakup następuje po 3 minutach, jeśli aplikacja nie potwierdzi zakupu. Otrzymasz też e-maila z informacją o anulowaniu. Na karcie Zamówienia w Konsoli Google Play możesz sprawdzić, czy po 3 minutach koszty zamówienia zostały zwrócone.

Okresy odnowienia

Subskrypcje testowe odnawiają się szybciej niż rzeczywiste subskrypcje. Subskrypcje testowe mogą być odnawiane maksymalnie 6 razy (nie wliczając bezpłatnych okresów próbnych ani okresów dla nowych subskrybentów).

W tabeli poniżej znajdziesz czasy odnowienia subskrypcji o różnym czasie trwania testów. Podane czasy są przybliżone. Możesz zauważyć drobne zmiany w dokładnym czasie wystąpienia zdarzenia. Aby skompensować zmienność, wywołaj interfejs API w celu wyświetlenia aktualnego stanu po każdej dacie ważności subskrypcji.

Okres subskrypcji produkcyjnej Odnawianie subskrypcji testowej
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 ograniczone czasowo, takie jak bezpłatne okresy próbne, są również skracane na potrzeby testów. W tej tabeli podano okresy testowania związane z funkcjami subskrypcji opartych na czasie:

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 testowy subskrypcji
Okres prolongaty (3- i 7-dniowy) 5 minut
Zawieszenie konta 10 minut,
Wstrzymaj (1 miesiąc) 5 minut
Wstrzymaj (2 miesiące) 10 minut,
Wstrzymaj (3 miesiące) 15 minut

Oferty okresu próbnego

Dostępna w ramach okresu próbnego w Laboratorium płatności w Play funkcja testowania licencji umożliwia testerom licencji na testowanie i korzystanie z bezpłatnej lub próbnej oferty dla nowych użytkowników nieograniczoną liczbę razy. Wystarczy, że zaznaczysz pole wyboru „Przetestuj bezpłatną wersję próbną lub ofertę dla nowych użytkowników” i zastosujesz zmianę. Dzięki temu nie trzeba tworzyć wielu kont w celu przetestowania oferty próbnej dostępnej tylko dla nowych subskrybentów.

testowe oferty próbne
Rysunek 5. Przetestuj oferty próbne.

zmiany cen.

Możesz też skorzystać z Laboratorium rozliczeń w Play i testerów licencji, żeby przetestować zmiany cen subskrypcji bez wpływu na innych aktywnych subskrybentów. Aby to zrobić:

  1. Na karcie Ustawienia subskrypcji w panelu kliknij Zarządzaj.
  2. Wybierz aktywną subskrypcję, którą chcesz przetestować.
  3. Wpisz nową cenę.
  4. Zaznacz lub odznacz pole wyboru Rezygnacja użytkownika zgodnie z wymaganiami testu.
  5. Kliknij Zastosuj.
zmiana ceny subskrypcji testowej
Rysunek 6. Przetestuj zmianę ceny subskrypcji.

Po zastosowaniu zmian cena zostanie zaktualizowana tylko dla testera od następnego odnowienia. Nie będzie to miało wpływu na innych aktywnych subskrybentów. Do subskrypcji testowej będą stosowane wszystkie reguły dotyczące testerów licencji. Tester może następnie przetestować aplikację pod kątem dalszych procesów uruchamianych po zmianie ceny, takich jak powiadomienia o zmianie ceny.

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

  • Ze względu na krótki czas odnowienia dla testerów licencji może się zdarzyć, że migracja cen przeprowadzona z konsoli może nie zostać zarejestrowana dla testerów licencji. Aby przetestować powiadomienia i e-maile o zmianach cen, deweloperzy powinni odroczyć płatności o co najmniej godzinę od wywołania zmiany ceny.
  • Obniżki cen nie mają okresu powiadomienia. Użytkownicy są powiadamiani o obniżce ceny wkrótce po migracji kohorty. Nie zmienia się to podczas testów.
  • W przypadku podwyżek cen czasy powiadomień testowych są obliczane tak samo jak w przypadku rzeczywistych wzrostów:
    • Użytkownik jest obciążany po raz pierwszy w pierwszą rocznicę rozliczenia po upływie obowiązkowego okresu powiadomienia.
    • Czasy powiadomień są obliczane wstecznie od daty pierwszego obciążenia.
    • Ostateczne powiadomienie jest zawsze wysyłane na minutę przed obciążeniem, niezależnie od okresu rozliczeniowego.

W tabeli poniżej znajdziesz testowe okresy rozliczeniowe i okresy powiadomień dla kilku rzeczywistych okresów rozliczeniowych:

Rzeczywisty okres rozliczeniowy abonamentu podstawowego Testowy okres rozliczeniowy Okres wysyłania powiadomień dotyczących testowania (regiony, w których użytkownik może włączyć lub z niego zrezygnować, z 30-dniowym wyprzedzeniem) Okres wysyłania powiadomień (regiony, w których można zrezygnować z tej funkcji, 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

Przypadki testowe

Rozwiń tę sekcję, klikając Pokaż/Ukryj, aby wyświetlić scenariusze testowania, które należy wykorzystać do zweryfikowania integracji subskrypcji.

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 wykorzystania kodu promocyjnego:

  • Wpisz kod promocyjny w oknie zakupu, które zostało otwarte w Twojej aplikacji.
  • Kod promocyjny zostanie wykorzystany w aplikacji Sklep Google Play.
  • Gdy wykorzystasz kod promocyjny na stronie https://play.google.com/store, kliknij przycisk Zrealizuj kod w panelu nawigacyjnym po lewej stronie.

W takiej sytuacji warto przetestować wykorzystanie kodów na jak najwięcej sposobów. Zalecamy wykonanie co najmniej tych testów:

  • Wykorzystanie przed zainstalowaniem aplikacji.
  • Wykorzystanie, gdy aplikacja działa na pierwszym planie. Pamiętaj, że aby przeprowadzić ten test, musisz mieć inne urządzenie, żeby przetestować ją w aplikacji Sklep Google Play. Testuj wykorzystanie na różnych ekranach w aplikacji.
  • Można go wykorzystać w trybie wielu okien, w którym aplikacja i aplikacja Sklep Google Play są wyświetlane jednocześnie.

W przypadku każdego testu sprawdź, czy element jest prawidłowo wykrywany, a użytkownik otrzyma powiadomienie.

Testowanie wrażeń klientów w różnych regionach

Laboratorium rozliczeń w Play i testerzy licencji umożliwiają też testowanie procesu zakupu w dowolnym regionie bez konieczności podawania w nim prawdziwej formy płatności. Wykonaj te czynności, aby przetestować:

  1. Zarejestruj użytkownika płatności za aplikację jako tester licencji.
  2. Zaloguj się w Laboratorium płatności w Play przy użyciu tego samego użytkownika.
  3. Wybierz kraj i zastosuj zmianę w Laboratorium płatności w Play.
  4. Uruchom proces zakupu w testowanej aplikacji.
przetestować proces zakupów w różnych regionach
Rysunek 7. Sprawdź proces zakupów w różnych regionach.

Ta metoda testowania zakupów pozwala przetestować dostępność oferty w poszczególnych regionach i wygodę użytkowników w dowolnym regionie, niezależnie od miejsca, w którym przeprowadzasz testy.