Nagrody za testowanie

Play Billing Lab to aplikacja towarzysząca, która pomaga testować integracje z systemem rozliczeniowym Google Play. Możesz użyć testowania wersji testowej zakupów poza aplikacją w Play Billing Lab, aby sprawdzić, czy backend jest prawidłowo skonfigurowany do obsługi produktów kupionych poza aplikacją, w tym nagród w Grach Play.

Dzięki funkcji OOAP w wersji testowej możesz wybrać konkretny produkt lub ofertę, które będą wyświetlane na platformach poza aplikacją, np. na stronie z informacjami o aplikacji w Google Play, i sprawdzić cały proces uzyskiwania uprawnień i realizacji.

Wymagania wstępne

Zanim użyjesz Play Billing Lab do przetestowania procesów zakupów poza aplikacją (OOAP) w celu sprawdzenia konfiguracji Nagród w Grach Play, upewnij się, że spełniasz te wymagania:

1. Zarejestruj się w programie wcześniejszego dostępu do nagród w Grach Play

2. Stan licencjonowanego testera: Twoje konto testowe musi być zarejestrowane jako licencjonowany tester gry. Szczegółowe informacje znajdziesz w dokumentacji dotyczącej testerów z licencją w Google Play.

   Uwaga: aplikację Play Billing Lab może wyświetlać każdy użytkownik, ale tylko licencjonowani testerzy deweloperów z programu wcześniejszego dostępu, którzy znajdują się na liście dozwolonych, mogą konfigurować i wywoływać zastąpienia OOAP.

3. Spójność konta na różnych platformach: musisz zalogować się w Play Billing Lab i Sklepie Google Play przy użyciu tego samego konta licencjonowanego testera. Jeśli konta nie będą zgodne, Sklep Play może nie wyświetlić zastąpionego produktu lub oferty testowej albo nie sfinalizować zakupu testowego.

Pobierz i zainstaluj

Aplikację Play Billing Lab możesz pobrać i zainstalować z Google Play:

• Sklep Google Play (Android): aplikacja Play Billing Lab
• Ścieżka testowania w internecie: wyrażenie zgody na testowanie Play Billing Lab w internecie

Szczegółowy przewodnik po integracji i testowaniu w ramach programu wcześniejszego dostępu

Poniżej opisujemy, jak zintegrować i przetestować nagrody w Grach Play za pomocą Play Billing Lab.

Krok 1. Uruchom Play Billing Lab i zaloguj się

Gdy po raz pierwszy otworzysz Play Billing Lab po zainstalowaniu:

• Kliknij Zaloguj się przez Google.
• Wybierz konto Google zarejestrowane jako licencjonowany tester Twojej aplikacji.
• Po zalogowaniu się zobaczysz główny panel.

Panel Play Billing Lab.

Krok 2. Przejdź do testowania zakupów poza aplikacją

• W panelu znajdź kartę Zakupy poza aplikacją.
• Kliknij Test, aby otworzyć ekran konfiguracji OOAP.

Uwaga: jeśli Twoja aplikacja nie znajduje się na liście dozwolonych w ramach tego programu wcześniejszego dostępu lub Twoje konto nie jest licencjonowanym testerem aplikacji z listy dozwolonych, ta karta nie będzie widoczna, a system uniemożliwi Ci rozpoczęcie podglądu OOAP.

Krok 3. Podaj nazwę pakietu aplikacji i identyfikator produktu

Na ekranie konfiguracji OOAP wpisz wymagane identyfikatory aplikacji:

1. Nazwa pakietu: dokładna nazwa pakietu aplikacji na Androida (np. com.example.app).
2. Typ produktu: w menu wybierz Produkt kupowany raz (zakup w aplikacji) lub Subskrypcja.
3. Identyfikator produktu (SKU): identyfikator produktu w aplikacji lub subskrypcji, którą chcesz przetestować.

Podaj nazwę pakietu aplikacji i identyfikator produktu.

Krok 4. Wybierz odpowiednią ofertę

Gdy wpiszesz nazwę pakietu, identyfikator produktu i typ produktu, Play Billing Lab wyśle zapytanie do backendu i wyświetli listę dostępnych ofert dotyczących tego produktu.

Uwaga: wyświetlane i dostępne do wyboru są tylko oferty, które są obecnie dostępne dla Twojego konta testera. Jeśli na Twoim koncie jest już niewykorzystane uprawnienie do konkretnego produktu, nie będzie ono widoczne.

• W przypadku produktów kupowanych raz: wybierz odpowiednią opcję zakupu lub ofertę.

  

  Wybierz odpowiednią ofertę.

Krok 5. Rozpocznij test OOAP

Po wybraniu oferty kliknij Rozpocznij test. Konfiguracja zostanie zapisana i zsynchronizowana z serwerami backendu Google Play.

Po aktywacji na panelu pojawi się plakietka Aktywne na karcie Zakupy poza aplikacją, na której widoczna jest skonfigurowana nazwa pakietu, identyfikator produktu (SKU) i pozostały czas.

• Okno testowe: aktywne konfiguracje testowe OOAP pozostają aktywne domyślnie przez 2 godziny, po czym automatycznie wygasają.

• Zastąpienie backendu: gdy ta opcja jest aktywna, konfiguracja jest wyświetlana jako mająca najwyższy priorytet na różnych platformach OOAP (np. na stronie z informacjami o aplikacji w Sklepie Play).

  

  Rozpocznij test OOAP.

Krok 6. Przetestuj kompleksowy proces pozyskiwania ofert poza aplikacją

Gdy test OOAP jest aktywny w Play Billing Lab, otwórz aplikację Sklep Google Play, logując się na to samo konto licencjonowanego testera:

1. Wyczyść pamięć podręczną Sklepu Google Play:
   1. Uruchom w urządzeniu aplikację Ustawienia.
   2. Kliknij Aplikacje > Sklep Google Play.
   3. Kliknij Pamięć wewnętrzna i podręczna, a następnie Wyczyść pamięć podręczną i Wyczyść pamięć wewnętrzną.
2. Otwórz aplikację Sklep Google Play.
3. Otwórz stronę z informacjami o aplikacji.

4. Dokonaj zakupu testowego (nakładka Play Express): kliknij kartę produktu. W Sklepie Play nakłada się natywna plansza dolna szybkiej płatności w Google Play.

   • Sprawdź cenę, instrument płatniczy (instrument testowy w przypadku licencjonowanych testerów) i szczegóły oferty.
   • Aby sfinalizować transakcję, kliknij Kup 1 kliknięciem.

   

   Przetestuj cały proces pozyskiwania.

5. Sprawdź integrację backendu:

   • Po udanym zakupie sprawdź, czy Google Play wysyła do serwera backendu powiadomienie w czasie rzeczywistym dla deweloperów (RTDN).
     • Uwaga: Rewards wysyła też powiadomienia RTDN.
   • Sprawdź, czy serwer wywołuje interfejs Google Play Developer API, aby potwierdzić zakup i przyznać użytkownikowi uprawnienia.
   • Sprawdź historię zakupów użytkownika w aplikacji Sklep Play, aby potwierdzić, że zamówienie testowe zostało zarejestrowane.

Uwaga: ten krok zapewnia, że backend jest gotowy do obsługi nagród. Nagrody w Grach Play wysyłają podobne powiadomienie RTDN, wymagają tego samego interfejsu Google Play Developer API do potwierdzania i przyznawania uprawnień oraz rejestrują transakcję o wartości 0 USD w historii zakupów użytkownika w aplikacji Sklep Play.

Krok 7. Zatrzymaj i wyczyść test OOAP

Po zakończeniu testowania:

1. Otwórz stronę Zakupy poza aplikacją.
2. Kliknij Wyczyść test, aby zatrzymać test OOAP i wyczyścić jego ustawienia.

Wyczyść test OOAP.

Modyfikowanie konfiguracji testów

Nie możesz zmienić nazwy pakietu, identyfikatora produktu, wyboru oferty ani zastąpienia kraju w Sklepie Play, gdy aktywny jest test wersji przedpremierowej OOAP.

Wymaga to zatrzymania i wyczyszczenia bieżącego testu zakupów poza aplikacją.

Jak edytować produkt lub ofertę

Jeśli obecnie przeprowadzasz test OOAP i chcesz przetestować inny produkt lub inną ofertę:

1. Otwórz Play Billing Lab i na aktywnej karcie Zakupy poza aplikacją kliknij Wyświetl.
2. Kliknij Edytuj, aby zmienić nazwę pakietu, identyfikator produktu lub ofertę testową.
3. Gdy pojawi się odpowiedni komunikat, kliknij Zatrzymaj test. Test zostanie zatrzymany, a wszystkie odpowiednie dane wejściowe zostaną wyczyszczone.
4. Wpisz nowy produkt lub wybierz nową ofertę i ponownie uruchom test.

Edytuj produkt lub ofertę.

Jak przetestować lokalne ceny za pomocą zastąpień dla kraju

Play Billing Lab umożliwia zastąpienie kraju w Sklepie Google Play, aby przetestować ceny regionalne i formatowanie waluty. Jednak zmiany kraju muszą być zsynchronizowane z testami OOAP:

1. Zatrzymywanie aktywnego testu OOAP: jeśli spróbujesz edytować zastąpienie kraju, gdy test OOAP jest aktywny, w panelu lub na stronie Zakupy poza aplikacją, Play Billing Lab wyświetli ostrzeżenie z prośbą o zatrzymanie testu. Potwierdzenie przez kliknięcie Zatrzymaj test spowoduje zatrzymanie bieżącego testu zakupu poza aplikacją i wyczyszczenie danych wejściowych testu.

2. Ustaw zastąpienie kraju: po zatrzymaniu testu OOAP możesz edytować ustawienie kraju na stronie Ustawienia konfiguracji. Wybierz kraj docelowy (np. Japonia, Wielka Brytania) i kliknij Zastosuj.

3. Ponowne uruchomienie testu zakupów poza aplikacją: gdy zastąpienie kraju będzie aktywne, wróć do karty Zakupy poza aplikacją, wybierz produkt i ofertę, a następnie kliknij Rozpocznij test.

   W panelu będą teraz widoczne zarówno aktywne zastąpienie kraju, jak i aktywny test OOAP.

4. Sprawdź zlokalizowaną cenę w Sklepie Play: otwórz Sklep Play i wejdź na stronę z informacjami o aplikacji. Karta interfejsu i plansza dolna Play Express będą teraz wyświetlać cenę produktu sformatowaną w walucie lokalnej zastąpionego kraju.

Przetestuj ceny lokalne z zastąpieniami dla poszczególnych krajów.

Rozwiązywanie problemów i najczęstsze pytania

Dlaczego skonfigurowana przeze mnie oferta testowa nie wyświetla się na stronie z informacjami o aplikacji w Sklepie Play?

• Spójność konta: sprawdź, czy konto zalogowane w aplikacji Sklep Play jest tym samym kontem, które jest zalogowane w Play Billing Lab.
• Lista dozwolonych w programie wcześniejszego dostępu i stan licencjonowanego testera: sprawdź, czy Twoje konto dewelopera znajduje się na liście dozwolonych w programie wcześniejszego dostępu do wersji testowej OOAP w Play Billing Lab i czy jest wymienione jako aktywny licencjonowany tester w Konsoli Play.
• Wygaśnięcie: aktywne testy OOAP wygasają po 2 godzinach. Otwórz Play Billing Lab, aby sprawdzić, czy tag testowy zmienił się na Wygasł. W takim przypadku rozpocznij nowy test.

Dlaczego podczas konfigurowania produktu w Play Billing Lab nie mogę wybrać ani zobaczyć żadnych ofert?

• Kryteria kwalifikacji do oferty: Play Billing Lab wyświetla tylko oferty, które Twoje konto testera może obecnie kupić.

Dlaczego mój zakup testowy w nakładce Play Express się nie powiódł?

• Upewnij się, że na urządzeniu testowym jest zainstalowany Android 12 (poziom interfejsu API 31) lub nowszy oraz najnowsza wersja Sklepu Google Play.
• Sprawdź integrację webhooka RTDN i interfejsu API w backendzie aplikacji. Podczas testowania w Sklepie Play zakupy są dokonywane poza standardowym interfejsem aplikacji. Serwer backendu musi niezawodnie odbierać wiadomości RTDN z Google Play i asynchronicznie potwierdzać zakupy.

Jak zatrzymać lub wyczyścić aktywny test przed upływem 2 godzin?

• Otwórz Play Billing Lab, znajdź aktywną kartę (Zakupy poza aplikacją lub Ustawienia konfiguracji) i kliknij Zatrzymaj lub Usuń. Gdy pojawi się odpowiedni komunikat, potwierdź swój wybór. Zastąpienie zostanie natychmiast usunięte z serwerów Google Play.