Wydarzenia

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

  • Jak często gracze używają danego przedmiotu.
  • Jak często gracze osiągają określony poziom.
  • Jak często 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 np. dostosować poziom trudności niektórych poziomów w grze, które są zbyt trudne do ukończenia.

Aby dowiedzieć się, jak zaimplementować zdarzenia na swojej platformie, zapoznaj się z sekcją Implementacje klienta.

Integracja zdarzeń w grze

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

  1. Zdefiniuj zdarzenia. Aby zdefiniować nowe zdarzenia, które mają być rejestrowane w grze:
    1. W Konsoli Google Play otwórz stronę Zdarzenia swojej 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łaj metodę increment zdarzeń, gdy gra wykryje, że zostało wywołane zdarzenie, które ją interesuje.

  3. Wyświetl dane o zdarzeniach. Aby wyświetlić statystyki zarejestrowanych zdarzeń, w Konsoli Google Play otwórz stronę Zdarzenia swojej gry.

Podstawowe informacje o zdarzeniach

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

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

Właściwość Opis
Identyfikator 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 zawierać maksymalnie 100 znaków. Ta wartość jest używana przez Konsolę Google Play i może być wyświetlana w 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 grze.
Typ zdarzenia

Pole, które deklaruje typ danych śledzonych przez zdarzenie. Ta wartość jest używana przez Konsolę Google Play do obsługi raportowania w Analityce 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:
  • „Zarobione złote monety”
  • „Kupione szmaragdy”
Sposób na wydanie specjalnej waluty
Wybierz ten typ w przypadku zdarzeń, które śledzą sposoby na wydanie lub zużycie specjalnej waluty. Na przykład:
  • „Wydane złote monety”
  • „Zużyte szmaragdy”
Ikona Kwadratowa ikona, która będzie powiązana ze zdarzeniem.

Tworzenie zdarzenia

Aby utworzyć nowe zdarzenie w grze:

  1. W Konsoli Google Play, po lewej stronie kliknij ikonę Usługi gier i wybierz wpis dotyczący swojej gry.
  2. Po lewej stronie kliknij kartę Zdarzenia i przycisk Dodaj zdarzenie.
  3. Wypełnij szczegóły zdarzenia, które chcesz utworzyć.
  4. Kliknij Zapisz. Jeśli nie wystąpią żadne błędy, zdarzenie zostanie umieszczone w stanie „Gotowe do opublikowania”. Możesz teraz przejść do opublikowania zmian w grze.

Edytowanie zdarzenia

Aby edytować utworzone zdarzenie:

  1. W Konsoli Google Play, otwórz kartę Zdarzenia i wybierz wpis dotyczący zdarzenia, które chcesz edytować. Powinien się wyświetlić ten sam formularz, którego używasz podczas tworzenia zdarzenia.
  2. Wprowadź zmiany.
  3. Gdy skończysz edytować zdarzenie, kliknij przycisk Zapisz.
  4. Przetestuj grę, aby sprawdzić zmodyfikowane zdarzenie. Jeśli działa prawidłowo, opublikuj ponownie zmiany w grze.

Usuwanie zdarzenia

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

Resetowanie danych o zdarzeniach

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

  • Aby zresetować zdarzenia w wersji roboczej w Konsoli Google Play, kliknij przycisk Zresetuj postęp zdarzenia u dołu formularza dotyczącego tego zdarzenia.
  • Aby zresetować dane zdarzeń w sposób zautomatyzowany, wywołaj metody interfejsu API zarządzania Google Analytics Events.

Implementacje klienta

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