Zdarzenia

Usługa wydarzeń gier Google Play umożliwia gromadzenie zbiorczych danych generowanych przez graczy podczas rozgrywki i przechowywanie ich na serwerach Google na potrzeby analizy gier. W elastyczny sposób możesz określać, jakie dane o graczach mają zbierać. Może to być na przykład takie dane jak:

  • Gracze używają konkretnego elementu
  • Gracze osiągają określony poziom
  • Gracze wykonują pewne czynności w grze

Możesz wykorzystać dane o zdarzeniach, aby dowiedzieć się, jak ulepszyć grę. Możesz na przykład ustawić poziom trudności niektórych poziomów gry, które gracze uznają za zbyt trudne do ukończenia.

Więcej informacji o wdrażaniu zdarzeń na swojej platformie znajdziesz w artykule Implementacje klienta.

Integrowanie zdarzeń w grze

Poniżej opisujemy, jak stosować zdarzenia w grach:

  1. Definiowanie zdarzeń Aby zdefiniować nowe zdarzenia, które mają być rejestrowane w grze:
    1. W Konsoli Google Play otwórz stronę Wydarzenia dotyczącą Twojej 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 grach.
  2. Implementowanie przechwytywania zdarzeń w grze za pomocą interfejsów API zdarzeń. Na przykład w kodzie Androida możesz wywoływać metodę increment zdarzeń za każdym razem, gdy gra wykryje, że oczekiwane zdarzenie zostało wywołane.

  3. Wyświetlanie danych zdarzeń Na stronie Zdarzenia w swojej grze w Konsoli Google Play możesz zobaczyć statystyki przechwyconych zdarzeń.

Podstawy wydarzeń

Interfejsy API zdarzeń umożliwiają definiowanie i zbieranie ciekawych danych dotyczących gry oraz przesyłanie ich do usług gier Google Play.

Zdarzenie usług gier Google Play zawiera te kluczowe właściwości:

Właściwość Opis
Identyfikator Niepowtarzalny ciąg wygenerowany przez Konsolę Google Play dla tego zdarzenia. Używaj 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:

  • „Zombies Killed”
  • „ zebranie czerwonych klejnotów”
Description Dłuższy opis zdarzenia (np. „Liczba przypadków, w których gracz zabił zombie” lub „Łączna liczba czerwonych klejnotów usuniętych przez gracza i dopasowana”). Może mieć 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 statystyk graczy.

Obsługiwane są 2 typy zdarzeń:

Źródło waluty premium
Wybierz ten typ w przypadku zdarzeń, które śledzą źródła waluty premium. Przykład:
  • „Złote monety zdobyte”
  • „Kupili szmaragd”
Sposób na wydanie specjalnej waluty
Wybierz ten typ w przypadku zdarzeń, które śledzą zlewy lub konsumpcję dodatkowej waluty. Przykład:
  • „Wykorzystane złote monety”
  • „Używany szmaragd”

Ikona Kwadratowa ikona, która zostanie powiązana z Twoim wydarzeniem.

Tworzenie wydarzenia

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

  1. Dodaj grę w Konsoli Google Play.
  2. W Konsoli Google Play kliknij ikonę usług gier po lewej stronie i wybierz pozycję swojej gry.
  3. Wybierz kartę Wydarzenia po lewej stronie i kliknij przycisk Dodaj zdarzenie.
  4. Podaj szczegóły zdarzenia, które chcesz utworzyć.
  5. Kliknij Zapisz. Jeśli nie wystąpią żadne błędy, stan wydarzenia zmieni się na „Gotowe do publikacji”. Możesz teraz opublikować zmiany w grach.

Edytowanie wydarzenia

Aby edytować utworzone wydarzenie:

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

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ń na dole formularza tego wydarzenia.

Resetuję dane zdarzenia

Możesz zresetować dane postępów graczy dotyczące testerów Twoich zdarzeń.

  • Aby zresetować wersje robocze wydarzeń w Konsoli Google Play, kliknij przycisk Resetuj postęp wydarzenia u dołu formularza.
  • Aby automatycznie zresetować dane zdarzeń, wywołaj metody interfejsu API zarządzania Events.

Implementacje klienta

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