Testowanie integracji Biblioteki płatności w Google Play

Integrację należy testować przez cały okres jej tworzenia. Aby przeprowadzić testy w fazie rozwoju, zalecamy skorzystanie z testerów licencjiLaboratorium płatności w Google Play, aby przetestować scenariusze opisane w tej sekcji.

Udzielenie licencji testerom

Informacje o konfigurowaniu testerów licencji znajdziesz w artykule Testowanie rozliczeń w aplikacji za pomocą licencjonowania.

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

  • Zwykle Biblioteka płatności w Google Play jest blokowana w przypadku aplikacji, które nie są podpisane i przesłane do Google Play. Testerzy licencji mogą pominąć to sprawdzenie, co oznacza, że możesz instalować aplikacje z zewnętrznych źródeł na potrzeby testowania, nawet w przypadku aplikacji korzystających z wersji debugowania z sygnaturami debugowania, 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 testera licencji na koncie Konsoli Google Play.
  • Testerzy licencji mają dostęp do testowych form płatności, które pozwalają uniknąć obciążania ich prawdziwymi pieniędzmi za zakupy. Możesz też używać testowych form płatności, aby symulować określone sytuacje, np. odrzucenie płatności. Na ilustracji 1 widać, jak te testowe formy płatności wyglądają w procesie 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 co rzeczywiste zakupy.
  • W przypadku zakupów testowych podatki nie są obliczane.
  • Google Play informuje o zakupie testowym, wyświetlając powiadomienie na środku okna zakupu.

Konto, z którego dokonywany jest zakup, możesz sprawdzić, rozwijając okno zakupu. Uwaga:

  • Konta testowe muszą być na urządzeniu z Androidem należącym do testera.
  • Jeśli na urządzeniu jest więcej niż jedno konto, zakupu dokonuje się za pomocą konta, z którego pobrano aplikację.
  • Jeśli żadne z kont nie pobrało aplikacji, zakup zostanie dokonany na pierwszym koncie.

Przed rozpowszechnieniem aplikacji możesz skorzystać z ścieżek testów w Google Play, aby przeprowadzić dodatkową weryfikację. Możesz na przykład skorzystać ze ścieżek testów, aby zespół ds. kontroli jakości mógł sprawdzić nową wersję.

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

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

  1. Opublikuj aplikację na ścieżce testów. Pamiętaj, że po opublikowaniu aplikacji na ścieżce testowej może minąć kilka godzin, zanim będzie ona dostępna dla testerów.
  2. Upewnij się, że każdy tester wyraził zgodę na testowanie aplikacji. Na stronie 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. Ogólne informacje o konfigurowaniu urządzenia do tworzenia aplikacji na Androida znajdziesz w artykule Korzystanie z urządzeń sprzętowych.

Laboratorium Płatności w Play

Play Billing Lab to aplikacja na Androida, która pomaga deweloperom testować integrację z systemem rozliczeniowym Google Play. Umożliwia ona wygodne testowanie funkcji płatności, szybszą integrację i wdrażanie aplikacji z większym poczuciem pewności. Aplikację Play Billing Lab możesz pobrać i zainstalować ze Sklepu Play.

Laboratorium płatności w Play umożliwia Ci w trakcie testów:

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

Podczas testowania produktów konsumpcyjnych sprawdź różne sytuacje, w tym:

  • udany zakup, w którym użytkownik otrzymuje produkt; W przypadku testera 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. Użytkownik licencji testowej może używać formy płatności Test instrument, always declines.
  • Upewnij się, że produkty można kupić wiele razy.

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 zostanie przyznany po 3 minutach, jeśli aplikacja nie potwierdzi zakupu. Otrzymasz też e-maila z informacją o anulowaniu. Możesz też sprawdzić, czy zamówienie zostało zwrócone po 3 minutach, na karcie Zamówienia w Konsoli Google Play.

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

Produkty niekonsumpcyjne należy testować tak samo jak produkty konsumpcyjne, ale musisz sprawdzić, czy nie można ich ponownie kupić w aplikacji. Pamiętaj, aby potwierdzić zakup zarówno produktów niekonsumpcyjnych, jak i konsumpcyjnych (w stosownych przypadkach), ponieważ logika przetwarzania tych 2 rodzajów zakupów jest różna.

Testowanie oczekujących zakupów

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

  1. Dokonaj zakupu z użyciem opóźnionej formy płatności Slow test card, declines after a few minutes (Powolny test karty, odrzucenie następuje po kilku minutach), jak pokazano na ilustracji 3. Uruchom ponownie aplikację i sprawdź, czy zakup nie został przyznany.

    testowanie zakupu za pomocą odrzuconej powolnej karty testowej;
    Rysunek 3. Przetestuj zakup za pomocą odrzuconej powolnej karty testowej.

  2. Dokonaj zakupu z opóźnioną formą płatności Powolny test karty, zatwierdzenie następuje po kilku minutach, jak pokazano na ilustracji 4. Odczekaj kilka minut i sprawdź, czy zakup został zrealizowany.

    przetestować zakup za pomocą zatwierdzonej karty do testów o niskiej prędkości;
    Rysunek 4. Przeprowadź testowy zakup za pomocą zatwierdzonej powolnej karty testowej.

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

Testowanie funkcji dostępnych w ramach subskrypcji

Procesy zakupu produktów kupowanych raz i subskrypcji są podobne, ale w przypadku subskrypcji występują dodatkowe scenariusze, takie jak udane lub odrzucone odnowienia subskrypcji. Aby przetestować odnowienia, możesz użyć metod płatności Karta testowa, zawsze zatwierdzaKarta testowa, zawsze odrzuca, które są dostępne dla testerów licencji (patrz rysunek 1). Użyj tych instrumentów płatniczych, aby przetestować scenariusze inne niż udana subskrypcja.

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 od testerów licencji zakup jest zwracany po 3 minutach, jeśli aplikacja nie potwierdzi zakupu, a Ty otrzymasz e-maila o anulowaniu. Możesz też sprawdzić, czy zamówienie zostało zwrócone po 3 minutach, na karcie Zamówienia w Konsoli Google Play.

Okresy odnowienia

Subskrypcje testowe odnawiają się szybciej niż rzeczywiste subskrypcje i mogą być odnawiane maksymalnie 6 razy, nie licząc bezpłatnych okresów próbnych i okresów wprowadzających.

W tabeli poniżej znajdziesz czasy odnowienia testów w przypadku subskrypcji o różnym czasie trwania. Podane czasy są przybliżone. Możesz zauważyć niewielkie różnice w dokładnym czasie wystąpienia zdarzenia. Aby zrekompensować różnice, po każdej dacie wygaśnięcia subskrypcji wywołaj interfejs API, aby wyświetlić bieżący stan.

Okres subskrypcji produkcyjnej Odnowienie 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 oparte na czasie, takie jak bezpłatne okresy próbne, są również skracane na potrzeby testów. W tabeli poniżej znajdziesz okresy testowe związane z funkcjami subskrypcji opartymi na czasie:

Funkcja Okres testowy
Zawieszenie konta 10 minut,
Bezpłatny okres próbny 3 minuty
Okres prolongaty 5 minut
Okres obowiązywania ceny początkowej Taki sam jak okres testowy subskrypcji
Wstrzymanie (1 miesiąc) 5 minut
Wstrzymanie (2 miesiące) 10 minut,
Wstrzymaj (3 miesiące) 15 minut
Okres uzyskiwania zgody na podwyżkę ceny

(dotyczy tylko Korei Południowej)
3 minuty
Potwierdzenie zakupu 5 minut

Przyspieszenie odnowienia

Możesz też użyć Play Billing Lab i testerów licencji, aby przyspieszyć testowanie okresów odnowienia subskrypcji, wykonując te czynności:

  1. Na panelu na karcie Ustawienia subskrypcji kliknij Zarządzaj.
  2. Wybierz aktywną subskrypcję, którą chcesz przetestować.
  3. Kliknij Odnów teraz.
odnów subskrypcję testową
Rysunek 5. Testowanie przyspieszenia okresu odnowienia subskrypcji.

Po kliknięciu przycisku Odnów teraz subskrypcja testowa zostanie wkrótce odnowiona.

Uwaga:

  • Subskrypcje testowe muszą zostać potwierdzone przed użyciem funkcji przyspieszonego odnowienia, w przeciwnym razie zostaną anulowane.
  • Proces odnowienia może potrwać kilka sekund.
  • Gdy subskrypcja jest odnawiana, funkcja zmiany ceny subskrypcji jest niedostępna.
  • Jeśli klikniesz przycisk Odnowij teraz, gdy obowiązuje zmiana ceny, Play zastosuje nową cenę, jeśli użytkownik ją zaakceptował. Jeśli jednak nowa cena wymaga akceptacji użytkownika, a użytkownik jeszcze jej nie zaakceptował, Google Play anuluje subskrypcję.

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. Wystarczy, że zaznaczy pole wyboru Przetestuj bezpłatny okres próbny lub ofertę dla nowych użytkowników i zastosuje zmianę. Dzięki temu nie musisz tworzyć wielu kont, aby przetestować ofertę próbną dostępną tylko dla nowych subskrybentów.

testować oferty dotyczące okresu próbnego,
Rysunek 6. Testuj 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, wykonując te czynności:

  1. Na panelu na karcie Ustawienia subskrypcji 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.
testowanie zmiany ceny subskrypcji,
Rysunek 7. Przetestuj zmianę ceny subskrypcji.

Po wprowadzeniu zmian cena zostanie zaktualizowana od następnego odnowienia tylko w przypadku testera. Nie wpłynie to na innych aktywnych subskrybentów. W przypadku subskrypcji testowej obowiązują wszystkie reguły testerów licencji. Tester może wtedy przetestować aplikację pod kątem procesów podrzędnych wywoływanych przez zmianę ceny, takich jak powiadomienia o zmianie ceny.

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

  • Ze względu na krótki okres odnowienia w przypadku testerów licencji migracja ceny przeprowadzona z konsoli może nie zostać zarejestrowana w przypadku testerów licencji. Aby można było przetestować powiadomienia i e-maile o zmianie ceny, deweloperzy powinni odłożyć płatność o co najmniej godzinę po wywołaniu zmiany ceny.
  • Obniżki cen nie mają okresu powiadomienia. Użytkownicy są powiadamiani o obniżeniu ceny wkrótce po migracji kohorty. Podczas testowania ta wartość nie ulega zmianie.
  • W przypadku podwyżek cen czas wysyłania powiadomień testowych jest obliczany tak samo jak w przypadku rzeczywistych podwyżek:
    • Pierwsza opłata jest pobierana w pierwszą rocznicę rozliczenia po obowiązkowym okresie powiadomienia.
    • Czas powiadomienia jest obliczany wstecz od daty pierwszej płatności.
    • Ostateczne powiadomienie jest zawsze wysyłane na minutę przed obciążeniem, niezależnie od okresu rozliczeniowego.

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

Rzeczywisty okres rozliczeniowy abonamentu podstawowego Testowy okres rozliczeniowy Okres powiadamiania o teście (regiony, w których obowiązuje zasada rezygnacji i włączenia, z 30-dniowym wyprzedzeniem) Okres powiadomienia o teście (regiony, w których można zrezygnować z udziału, 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

Informacje dotyczące podwyższenia ceny, które wymagają zgody użytkownika, będą dostępne w interfejsie purchases.subscriptionsv2.get API.

Przed wprowadzeniem podwyżki Google Play wysyła do odpowiednich użytkowników (w tym testerów licencji) 2 powiadomienia push i e-maile o podwyżce ceny. Okres powiadomienia w przypadku testowania jest następujący:

Harmonogram powiadomień Okres powiadomienia testowego
Pierwsze powiadomienie 3 minuty
Drugie (ostateczne) powiadomienie 1 minuta

Elementy testowania

Kliknij Pokaż/Ukryj, aby rozwinąć sekcję i wyświetlić scenariusze testowe, których należy użyć do sprawdzenia integracji subskrypcji.

Testowanie transakcji oczekujących

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

  1. Dokonaj zakupu z opóźnioną formą płatności Slow test card, declines after a few minutes (Powolny test karty, odrzucenie następuje po kilku minutach), jak pokazano na rysunku 8. Uruchom ponownie aplikację i sprawdź, czy zakup nie został przyznany.

    testowanie zakupu za pomocą odrzuconej powolnej karty testowej;
    Rysunek 8. Przetestuj zakup za pomocą odrzuconej powolnej karty testowej.

  2. Dokonaj zakupu z użyciem opóźnionej formy płatności Powolny test karty, zatwierdzenie następuje po kilku minutach, jak pokazano na rysunku 9. Odczekaj kilka minut i sprawdź, czy zakup został zrealizowany.

    przetestować zakup za pomocą zatwierdzonej karty do testów o niskiej prędkości;
    Rysunek 9. Przeprowadź testowy zakup za pomocą zatwierdzonej powolnej karty testowej.

Testowanie kodów promocyjnych

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

Przetestuj te scenariusze wykorzystania kodu promocyjnego:

  • 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 Wykorzystaj w menu po lewej stronie.

W ramach tych scenariuszy przetestuj wykorzystywanie kodów na jak najwięcej sposobów. Przeprowadź co najmniej te testy:

  • Wykorzystanie przed zainstalowaniem aplikacji.
  • Wykorzystanie podczas działania aplikacji na pierwszym planie. Pamiętaj, że do tego testu potrzebujesz innego urządzenia, na którym możesz przetestować aplikację Sklep Google Play. Sprawdź, czy kody można wykorzystać na różnych ekranach w aplikacji.
  • Realizacja w trybie wielu okien, w którym jednocześnie wyświetlane są Twoja aplikacja i aplikacja Sklep Google Play.

W przypadku każdego testu upewnij się, że produkt został prawidłowo wykryty i że użytkownik otrzymał powiadomienie.

Testowanie procesu zakupu w różnych regionach

Możesz przetestować proces zakupu z użyciem aplikacji Play Billing Lab lub bez niej:

Test

z

Aplikacja na Androida Play Billing Lab umożliwia testowanie procesu zakupu w dowolnym regionie. Aby jednak korzystać z Play Billing Lab, musisz być testerem licencji. Aby przeprowadzić test:

  1. Zarejestruj użytkownika rozliczeń w aplikacji jako testera licencji.
  2. Zaloguj się w aplikacji Laboratorium Płatności w Play jako ten sam użytkownik.
  3. Wybierz wymagany kraj i zastosuj zmianę w Play Billing Lab.
  4. Uruchom proces zakupu w testowanej aplikacji.
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 przeprowadzić test:

  1. Utwórz nowe konto Gmail. Konto można utworzyć w dowolnym kraju.
  2. Opcjonalnie możesz skonfigurować użytkownika jako testera licencji.
  3. Połącz się z VPN w wymaganym kraju, aby 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 przypadku dowolnego kraju, który chcesz przetestować. Po przełączeniu się na nowy kraj musisz wyczyścić dane Sklepu Google Play, aby usunąć dane związane z poprzednim krajem.

Obie te metody testowania zakupów umożliwiają testowanie dostępności oferty w danym regionie i wygody użytkowników w dowolnym regionie, niezależnie od tego, gdzie fizycznie przeprowadzane są testy.

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 na Androida Laboratorium Płatności w Play.

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 jako ten sam użytkownik.
  3. Włącz rzeczywiste formy płatności w aplikacji Laboratorium Płatności w Play.
  4. Uruchom ponownie proces zakupu w testowanej aplikacji.