Wydarzenia

Usługa zdarzeń w Grach Google Play umożliwia zbieranie danych skumulowanych generowanych przez graczy podczas rozgrywki i przechowywanie ich na serwerach Google na potrzeby analizy gry. Możesz elastycznie określać, jakie dane graczy ma zbierać Twoja gra. Mogą to być np. dane o tym, jak często:

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

Dane o zdarzeniach możesz wykorzystać jako informacje zwrotne, które pomogą Ci ulepszyć grę. Możesz na przykład obniżyć poziom trudności tych poziomów w grze, których ukończenie sprawia graczom najwięcej kłopotu.

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

Integrowanie zdarzeń w grze

Poniższy proces opisuje, jak możesz stosować zdarzenia w swojej grze:

  1. Określ zdarzenia. Aby zdefiniować nowe zdarzenia do rejestrowania w grze:
    1. Otwórz stronę WydarzeniaKonsoli Google Play.
    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łuj metodę zdarzeń increment za każdym razem, gdy gra wykryje wywołanie zdarzenia, które Cię interesuje.

  3. Wyświetlanie danych o zdarzeniach Aby wyświetlić statystyki zarejestrowanych wydarzeń, otwórz stronę Wydarzenia w Konsoli Google Play.

Podstawowe informacje o wydarzeniach

Interfejsy API zdarzeń umożliwiają definiowanie i zbieranie interesujących danych o rozgrywce oraz przesyłanie ich do pakietu SDK Usług Google Play w grach.

Zdarzenie pakietu SDK Usług gier Play zawiera te kluczowe właściwości:

Właściwość Opis
ID Unikalny ciąg znaków wygenerowany przez Konsolę Google Play dla tego wydarzenia. 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 Twojej grze.

Przykłady:

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

Pole, które określa typ danych śledzonych przez zdarzenie. Ta wartość jest używana przez Konsolę Google Play do obsługi raportów Analityki graczy.

Obsługiwane są 2 typy zdarzeń:

Źródło specjalnej waluty
Wybierz ten typ w przypadku zdarzeń, które śledzą źródła specjalnej waluty. Na przykład:
  • „Złote monety zdobyte”
  • „Kupione szmaragdy”
Sposób na wydanie specjalnej waluty
Wybierz ten typ w przypadku zdarzeń, które śledzą sposoby wydawania lub zużywania specjalnej waluty. Na przykład:
  • „Wydane złote monety”
  • „Wykorzystane szmaragdy”

Ikona Kwadratowa ikona, która będzie powiązana z Twoim wydarzeniem.

Utwórz wydarzenie

Aby utworzyć nowe wydarzenie w grze:

  1. Konsoli Google Play kliknij ikonę Usługi gier po lewej stronie i wybierz wpis dotyczący Twojej gry.
  2. Po lewej stronie kliknij kartę Zdarzenia i przycisk Dodaj zdarzenie.
  3. Podaj szczegóły wydarzenia, które chcesz utworzyć.
  4. Kliknij Zapisz. Jeśli nie ma błędów, wydarzenie zostanie umieszczone w stanie „Gotowe do publikacji”. Możesz teraz opublikować zmiany w grze.

Edytowanie wydarzenia

Aby edytować utworzone wydarzenie:

  1. Konsoli Google Play otwórz kartę Zdarzenia i wybierz wpis zdarzenia, które chcesz edytować. Wyświetli się formularz użyty do utworzenia wydarzenia.
  2. Wprowadź zmiany.
  3. Gdy skończysz edytować wydarzenie, kliknij przycisk Zapisz.
  4. Przetestuj grę, aby sprawdzić zmodyfikowane zdarzenie. Jeśli wszystko działa prawidłowo, opublikuj ponownie zmiany w grze.

Usuwanie wydarzenia

Możesz usuwać wydarzenia, które są w stanie „Wersja robocza” lub zostały opublikowane. Aby usunąć zdarzenie w Konsoli Google Play, kliknij przycisk Usuń u dołu formularza tego zdarzenia.

Resetowanie danych zdarzenia

Możesz zresetować dane o postępach graczy w przypadku testerów Twoich wydarzeń.

  • Aby zresetować zdarzenia w wersji roboczej w Konsoli Google Play, kliknij przycisk Zresetuj postęp zdarzenia na dole formularza dotyczącego tego zdarzenia.
  • Aby zresetować dane zdarzeń w sposób zautomatyzowany, wywołaj metody Eventsinterfejsu Management API.

Implementacje klienta

Więcej informacji o implementowaniu zdarzeń na Twojej platformie znajdziesz w tych materiałach: