Zdarzenia

Usługa zdarzeń w Grach Google Play umożliwia gromadzenie zbiorczych danych wygenerowanych przez graczy podczas rozgrywki i przechowywanie ich na serwerach Google na potrzeby statystyk gier. Możesz elastycznie określić, jakie dane o graczach ma zbierać Twoja gra. Mogą to być na przykład takie dane jak:

  • Gracze używają konkretnego elementu
  • Gracze osiągają określony poziom
  • Gracze wykonują określone działania w grze

Możesz wykorzystać te dane o zdarzeniach, by pomóc w ulepszaniu gry. Możesz na przykład dostosować poziom trudności tych poziomów w grze, których ukończenie jest dla graczy zbyt trudne.

Więcej informacji o implementowaniu zdarzeń na platformie znajdziesz w artykule Implementacje klientów.

Integrowanie zdarzeń z grą

Ten przepływ pracy opisuje, jak zastosować zdarzenia w grze:

  1. Definiowanie zdarzeń. Aby zdefiniować nowe zdarzenia do rejestrowania w grze:
    1. W Konsoli Google Play otwórz stronę Wydarzenia dotyczącą gry.
    2. Kliknij przycisk Dodaj nowe zdarzenie i skonfiguruj właściwości zdarzenia.
    3. Opublikuj definicje zdarzeń, wykonując czynności opisane w sekcji Publikowanie zmian w grze.

  2. Zaimplementuj rejestrowanie zdarzeń w grze za pomocą interfejsów API zdarzeń. Na przykład w kodzie Androida wywoływaj metodę increment za każdym razem, gdy gra wykryje, że zostało wywołane ważne dla niej zdarzenie.

  3. Wyświetlanie danych zdarzeń. Otwórz stronę Zdarzenia swojej gry w Konsoli Google Play, aby zobaczyć statystyki zarejestrowanych zdarzeń.

Podstawowe informacje o wydarzeniach

Interfejsy API zdarzeń umożliwiają definiowanie i zbieranie interesujących danych dotyczących rozgrywki oraz przesyłanie ich do pakietu SDK Gier Play.

Zdarzenie z pakietu SDK Gier 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, by odwołać się do wydarzenia w klientach gier.
funkcji 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 Twojej grze.

Przykłady:

  • "Zabite zombie"
  • "Zebrano czerwone klejnoty"
Description Dłuższy opis zdarzenia (np. „Liczba razy, gdy gracz zabił zombie” lub „Łączna liczba czerwonych klejnotów, które gracz wyeliminował i dopasował”). Opis może mieć maksymalnie 500 znaków. Ta wartość jest używana przez Konsolę Google Play i może być wyświetlana w Twojej grze.
Typ zdarzenia

Pole deklarujące typ danych śledzonych przez zdarzenie. Ta wartość jest używana przez Konsolę Google Play do obsługi raportów ze statystykami graczy.

Obsługiwane są 2 rodzaje zdarzeń:

Źródło specjalnej waluty
Wybierz ten typ w przypadku zdarzeń, które śledzą źródła waluty premium. Na przykład:
  • „Zdobyte złote monety”
  • „Szmaragd kupione”
Sposób na wydanie specjalnej waluty
Wybierz ten typ w przypadku zdarzeń śledzących ujścia, czyli wykorzystanie waluty premium. Na przykład:
  • „Wydane złote monety”
  • „Emeralds used” (używany szmaragd)
Ikona Kwadratowa ikona, która zostanie powiązana z wydarzeniem.

Tworzenie wydarzenia

Aby utworzyć nowe wydarzenie w grze, wykonaj te czynności:

  1. Dodaj grę do Konsoli Google Play, jeśli jeszcze jej nie masz.
  2. W Konsoli Google Play kliknij ikonę usług gier po lewej stronie i wybierz wpis swojej gry.
  3. Wybierz kartę Zdarzenia po lewej stronie i kliknij przycisk Dodaj zdarzenie.
  4. Wpisz szczegóły wydarzenia, które chcesz utworzyć.
  5. Kliknij Zapisz. Jeśli nie wystąpią błędy, wydarzenie będzie miało stan „Gotowe do publikacji”. Możesz teraz przejść do opublikowania zmian w grze.

Edytowanie wydarzenia

Aby edytować utworzone przez siebie wydarzenie:

  1. W Konsoli Google Play otwórz kartę Zdarzenia i wybierz wpis wydarzenia, które chcesz edytować. Powinien wyświetlić się ten sam formularz, który został użyty podczas tworzenia zdarzenia.
  2. Wprowadź zmiany.
  3. Po zakończeniu edytowania zdarzenia kliknij przycisk Zapisz.
  4. Przetestuj grę, aby sprawdzić zmodyfikowane zdarzenie. Jeśli działa, ponownie opublikuj zmiany w grze.

Usuwanie wydarzenia

Możesz usuwać wydarzenia, które są w wersji roboczej lub zostały opublikowane. Aby usunąć wydarzenie w Konsoli Google Play, kliknij przycisk Usuń u dołu formularza tego wydarzenia.

Zresetuj dane zdarzenia

Możesz zresetować dane o postępach gracza, którzy testują wydarzenia.

  • Aby zresetować zdarzenia w wersji roboczej w Konsoli Google Play, u dołu formularza odpowiedniego wydarzenia kliknij przycisk Resetuj postęp zdarzenia.
  • Aby automatycznie zresetować dane zdarzeń, wywołaj metody Events interfejsu Management API.

Implementacje klienta

Aby dowiedzieć się, jak wdrożyć zdarzenia na swojej platformie, zapoznaj się z tymi materiałami: