Z tego dokumentu dowiesz się, jak wykrywać i dostarczać produkty kupowane raz w grze po tym, jak gracze kupią je za punkty Play w aplikacji Google Play.
Gdy użytkownicy wymienią punkty Play na produkt kupowany raz w aplikacji Google Play, produkty powinny zostać dostarczone natychmiast w Twojej grze. Poniżej pokazujemy, jak użytkownik kupuje produkty za punkty Play.
| 1. Kliknij Play Points. | 2. Aby wyświetlić produkty, kliknij kartę Użyj. | 3. Wybierz produkt i kliknij Użyj punktów , aby dokończyć zakup. | 4. Odbierz produkt. |
|
|
|
|
W tym przykładzie gra nie jest uruchomiona podczas zakupu produktu. Użytkownicy mogą też wymieniać punkty Play na produkty, gdy gra nie jest zainstalowana na ich urządzeniu. Z tego powodu musisz zaprojektować grę tak, aby obsługiwała dostarczanie zakupów w aplikacji spoza sklepu w grze.
Zanim rozpoczniesz
Zanim wykryjesz i dostarczysz produkt kupowany raz, musisz utworzyć produkt i promocje w programie Play Points.
Wymagania
Gdy dostarczasz produkty kupowane raz w grze za pomocą promocji w programie Play Points, musisz przestrzegać wymagań opisanych w tej sekcji.
Czas dostawy
Gdy gracz wymieni punkty Play na produkt kupowany raz, użyj Biblioteki płatności w Google Play, aby dostarczyć produkt na czas.
Wiadomość o dostawie
Gdy użytkownik wróci do gry po zakupie produktu kupowanego raz poza grą, musisz wyświetlić potwierdzenie, że produkt został przyznany w grze. Wiadomość powinna mieć postać okna dialogowego lub wiadomości w grze. Użytkownicy nie powinni podejmować żadnych dodatkowych działań, aby otrzymać produkt.
Oto wymagany format wiadomości:
Jasny komunikat o otrzymaniu produktu.
Wyraźne odniesienie do nazwy produktu i do „punktów Play”, aby użytkownicy mogli odróżnić go od innych otrzymywanych treści.
Jeśli istnieją podobne produkty o różnych nominałach, nazwa produktu musi też zawierać jego prawidłowy nominał.
Okno dialogowe, wiadomość lub powiadomienie w grze powinny być widoczne dla użytkownika, dopóki nie kliknie on potwierdzenia, np. Dalej lub OK. Nie powinno być przycisku anulowania, ponieważ ta wiadomość ma tylko informować użytkowników o produkcie, który otrzymali w grze. Jeśli nie ma przycisku potwierdzenia, wiadomość powinna być widoczna dla użytkowników przez co najmniej 3 sekundy, zanim zniknie, aby użytkownicy wiedzieli, że otrzymali produkt.
Oto przykładowa wiadomość:
„Produkt otrzymany! Wymieniłeś punkty Play na 100 klejnotów. Dalej”.
Użytkownicy powinni zobaczyć animację lub potwierdzenie wizualne informujące o zwiększeniu salda waluty w grze. Jeśli produkt jest trwałym lub jednorazowym zakupem w aplikacji, użytkownicy powinni zostać przekierowani do miejsca, w którym produkt został odblokowany lub jest dostępny w grze.
Wykrywanie produktów otrzymanych poza grą
Jeśli Twoja gra korzysta z systemu rozliczeniowego Google Play, przeczytaj artykuł Wykrywanie i przetwarzanie zakupów, aby dowiedzieć się, jak wykrywać produkty kupowane raz otrzymane poza grą.
Wyświetlanie potwierdzenia dostawy
Gdy użytkownicy wymieniają punkty Play i otrzymują produkt, oczekują, że gra wyświetli wiadomość w grze lub użyje jakiegoś powiadomienia, aby poinformować ich, że gra prawidłowo otrzymała i przetworzyła produkt. Przeczytaj artykuł Informowanie użytkownika o pomyślnym zakupie.
Aktualizacje dotyczące konkretnych silników gier
Oto kilka kwestii, które warto wziąć pod uwagę w przypadku konkretnych silników gier:
Jeśli Twoja gra jest tworzona za pomocą Unity, sprawdź, czy używane przez Ciebie wdrożenie zakupów w aplikacji obsługuje już promocje w programie Play Points.
Jeśli Twoja gra jest tworzona za pomocą Cocos2d-x lub Unreal Engine (C/C++), najprawdopodobniej będziesz musiał napisać kod JNI, który wywołuje interfejsy API Java z kodu C/C++.
Sprawdzone metody po stronie serwera
Ta sekcja zawiera sprawdzone metody po stronie serwera, których możesz używać w przypadku promocji w programie Play Points:
Jeśli wywołujesz na serwerze metodę
Purchases.products: get, sprawdź, czy musisz osobno obsługiwać produkty wymieniane na nagrody Play i inne produkty kupowane raz na podstawie wartościproductId.Jeśli używasz na serwerze metody
Onetimeproducts: list, sprawdź, czy musisz oddzielić produkty wymieniane na nagrody Play od innych produktów kupowanych raz według wartościproductId.Zapoznaj się ze sprawdzonymi metodami opisanymi poniżej, aby sprawdzić, czy musisz wprowadzić dodatkowe zmiany:
- Odnośnik:
- Wdróż weryfikację podpisu po stronie serwera.
- Upewnij się, że wartości
purchaseTokeniorderIdsą unikalne i nie były wcześniej używane.
Rozwiązywanie problemów
Ta sekcja zawiera rekomendacje dotyczące scenariuszy, które mogą powodować zapytania klientów.
Wielu użytkowników
Jeśli użytkownik ma na urządzeniu kilka kont Google i wymieni punkty Play na niewłaściwym koncie, Google nie może przenieść produktów na inne konta. Podobnie Twoja aplikacja nie może przenieść produktu, wywołując metodę getPurchases(). W takim przypadku rozważ ręczne udostępnienie użytkownikowi produktów w aplikacji za pomocą obsługi klienta.
Opóźnione lub brakujące produkty
Jeśli gracze mają problemy z opóźnionymi lub brakującymi nagrodami, zapoznaj się z przewodnikiem rozwiązywania problemów z zakupami w aplikacji w dokumentacji pomocy Google Play.