Usługa zdarzeń Gier w Google Play umożliwia zbieranie danych kumulatywnych generowanych przez graczy podczas rozgrywki i przechowywanie ich na serwerach Google na potrzeby analizy gry. Możesz elastycznie określić, jakie dane o graczach ma zbierać Twoja gra. Mogą to być dane takie jak częstotliwość:
- Użytkownicy używają określonego przedmiotu
- gracze osiągają określony poziom,
- gracze wykonują określone działanie w grze;
Dane o zdarzeniach możesz wykorzystać jako informacje zwrotne na temat tego, jak ulepszyć grę. Możesz np. obniżyć poziom trudności tych poziomów, których ukończenie sprawia graczom najwięcej kłopotu.
Aby dowiedzieć się, jak implementować zdarzenia na swojej platformie, przeczytaj artykuł Implementacje na kliencie.
Integracja zdarzeń w grze
Ten proces pokazuje, jak stosować zdarzenia w grze:
- Zdefiniuj zdarzenia. Aby zdefiniować nowe zdarzenia do rejestrowania w grze:
- W Konsoli Google Play otwórz stronę Zdarzenia związaną z Twoją grą.
- Kliknij przycisk Dodaj nowe zdarzenie i skonfiguruj właściwości zdarzenia.
- Opublikuj definicje zdarzeń, wykonując czynności opisane w artykule Publikowanie zmian w grze.
Zaimplementuj rejestrowanie zdarzeń w grze za pomocą interfejsów API zdarzeń. Na przykład w kodzie Androida wywołaj metodę events
increment, gdy gra wykryje, że zostało wywołane zdarzenie, które jest dla niej istotne.Wyświetlanie danych o zdarzeniach Aby wyświetlić statystyki dotyczące zarejestrowanych zdarzeń, otwórz w Konsoli Google Play stronę Zdarzenia związaną z Twoją grą.
Podstawy dotyczące zdarzeń
Interfejsy API zdarzeń umożliwiają definiowanie i zbieranie interesujących danych dotyczących rozgrywki oraz przesyłanie ich do pakietu Play Games SDK.
Zdarzenie w pakiecie SDK Usług gier Google Play zawiera te kluczowe właściwości:
| Właściwość | Opis |
|---|---|
| ID | Unikalny ciąg znaków wygenerowany przez Konsolę Google Play na potrzeby tego zdarzenia. Użyj tego unikalnego identyfikatora, aby odwoływać się do zdarzenia w klientach gry. |
| Nazwa | Krótka nazwa zdarzenia. Nazwa może mieć maksymalnie 100 znaków.
Ta wartość jest używana przez Konsolę Google Play i może być wyświetlana w grze.
Przykłady:
|
| Opis | dłuższy opis zdarzenia (np. „Liczba razy, gdy gracz zabił zombie” lub „Łączna liczba czerwonych klejnotów, które gracz usunął i połączył”). Opis może zawierać maksymalnie 500 znaków. Ta wartość jest używana przez Konsolę Google Play i może być wyświetlana w grze. |
| Typ zdarzenia |
Pole określające typ danych śledzonych przez zdarzenie. Konsola Google Play używa tej wartości do obsługi raportowania Analytics dotyczących gracza. Obsługiwane są 2 rodzaje zdarzeń:
|
| Ikona | Kwadratowa ikona, która będzie powiązana z Twoim wydarzeniem. |
Tworzenie wydarzenia
Aby utworzyć nowe zdarzenie w grze:
- W Konsoli Google Play kliknij ikonę Usługi gier po lewej stronie i wybierz wpis dotyczący swojej gry.
- Po lewej stronie kliknij kartę Zdarzenia i wybierz przycisk Dodaj zdarzenie.
- Podaj szczegóły zdarzenia, które chcesz utworzyć.
- Kliknij Zapisz. Jeśli nie wystąpią żadne błędy, wydarzenie zostanie oznaczone jako „gotowe do publikacji”. Możesz teraz opublikować zmiany w grze.
Edytowanie wydarzenia
Aby edytować utworzone zdarzenie:
- W Konsoli Google Play otwórz kartę Zdarzenia i wybierz pozycję dotyczącą zdarzenia, które chcesz edytować. Powinien pojawić się ten sam formularz, którego użyto podczas tworzenia wydarzenia.
- Wprowadź zmiany.
- Gdy skończysz edytować zdarzenie, kliknij przycisk Zapisz.
- Przetestuj grę, aby sprawdzić zmodyfikowane zdarzenie. Jeśli wszystko działa prawidłowo, opublikuj ponownie zmiany w grze.
Usuwanie wydarzenia
Możesz usuwać zdarzenia, które są w stanie roboczym lub zostały opublikowane. Aby usunąć zdarzenie w Konsoli Google Play, kliknij przycisk Usuń na dole formularza tego zdarzenia.
Resetowanie danych zdarzenia
Możesz zresetować dane postępów graczy dla testerów swoich wydarzeń.
- Aby zresetować wersję roboczą zdarzeń w Konsoli Google Play, kliknij przycisk Zresetuj postęp zdarzenia u dołu formularza danego zdarzenia.
- Aby zresetować dane zdarzenia za pomocą kodu, wywołaj metody interfejsu Management API
Events.
Implementacje klienta
Instrukcje implementowania zdarzeń na danej platformie znajdziesz w tych materiałach: