Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
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ć do ulepszania gry. Możesz na przykład 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:
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 ważne.
Wyświetlanie danych zdarzeń 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 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 w ramach 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:
"Zabójców zombie"
"Zbieranie czerwonych klejnotów"
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 typy zdarzeń:
Źródło specjalnej waluty
Wybierz ten typ w przypadku zdarzeń, które śledzą źródła specjalnej waluty. Przykład:
"Zdobyte złote monety"
„Emeralds bought”
Sposób na wydanie specjalnej waluty
Wybierz ten typ w przypadku zdarzeń śledzących wydatki na specjalnej walucie lub jej zużycie. Przykład:
"Wydane złote monety"
„Użyte szmaragdy”
Ikona
Kwadratowa ikona, która będzie powiązana z Twoim wydarzeniem.
Utwórz wydarzenie
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.
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.
Treść strony i umieszczone na niej fragmenty kodu podlegają licencjom opisanym w Licencji na treści. Java i OpenJDK są znakami towarowymi lub zastrzeżonymi znakami towarowymi należącymi do firmy Oracle lub jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-07-26 UTC.
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 2025-07-26 UTC."],[],[],null,["# Events\n\nThe Google Play Games events service allows you to collect cumulative\ndata generated by your players during gameplay and store them in Google's\nservers for game analytics. You can flexibly define what player data your game\nshould collect; this might include metrics such as how often:\n\n- Players use a particular item\n- Players reach a certain level\n- Players perform some specific game action\n\nYou can use the events data as feedback on how to improve your game. For\nexample, you can adjust the difficulty level of certain levels in your game\nthat players are finding too hard to complete.\n\nTo learn how to implement events for your platform, see\n[Client implementations](#implement-event).\n\nIntegrate events in your game\n-----------------------------\n\nThe following workflow describes how you can apply events in your\ngame:\n\n1. **Define events** . To define new events to capture in your game:\n 1. Go to the *Events* page for your game in the [Google Play Console](//play.google.com/apps/publish/).\n 2. Click the *Add new event* button and configure the [event properties](#event-basics).\n 3. Publish your event definitions by following the steps described in [Publishing your game changes](/games/pgs/console/publish).\n2. **Implement event capturing in your game using the events APIs** . For\n example, in your Android code, call the events `increment` method whenever\n your game detects that an event that it cares about has been triggered.\n\n | **Note:** On mobile clients, Play Games SDK updates events in batches, so you will see cumulative, rather than fine-grained, changes to your events. When using the REST API, implement your own batching to avoid sending event updates too frequently, as this might cause you to quickly exceed your [rate limits](/games/pgs/quota).\n3. **View events data** . Go to the *Events* page for your game in\n Google Play Console to view statistics for the captured events.\n\nEvent basics\n------------\n\nThe events APIs provide you with a way to define and collect interesting gameplay\nmetrics and upload these metrics to Play Games SDK.\n\nA Play Games SDK event contains these key properties:\n\n| Property | Description |\n|-----------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **ID** | A unique string generated by Google Play Console for this event. Use this unique ID to refer to the event in your game clients. |\n| **Name** | A short name of the event. The name can be up to 100 characters. This value is used by Google Play Console and can be displayed in your game. Examples: - *\"Zombies Killed\"* - *\"Red Gems Collected\"* |\n| **Description** | A longer description of the event (for example, \"Number of times a player has killed a zombie\" or \"The total number of red gems the player has eliminated and matched\"). The description can be up to 500 characters. This value is used by Google Play Console and can be displayed in your game. |\n| **Event type** | A field that declares the type of data the event is tracking. This value is used by Google Play Console to support Player Analytics reporting. Two event types are supported: Premium currency source : Select this type for events that track sources of a premium currency. For example: - *\"Gold coins earned\"* - *\"Emeralds bought\"* Premium currency sink : Select this type for events that track sinks, or consumption, of a premium currency. For example: - *\"Gold coins spent\"* - *\"Emeralds used\"* \u003cbr /\u003e |\n| **Icon** | A square icon that will be associated with your event. |\n\n### Create an event\n\nTo create a new event for your game, follow these steps:\n\n1. In the [Google Play Console](https://play.google.com/apps/publish/), click the **Game services** icon on the left and select the entry for your game.\n2. Select the **Events** tab on the left, and click the **Add event** button.\n3. Fill in the details for the event you want to create.\n4. Click **Save** . If there are no errors, your event is placed in the \"Ready to publish\" state. You can now proceed to [publish your game changes](/games/pgs/console/publish).\n\n### Edit an event\n\nTo edit an event that you've created:\n\n1. In the [Google Play Console](https://play.google.com/apps/publish/), open the **Events** tab and select the entry for the event you want to edit. You should see the same form you used when creating the event.\n2. Make your edit changes.\n3. When you've finished editing the event, click the **Save** button.\n4. Test your game to verify the modified event. If it is working correctly, [republish your game changes](/games/pgs/console/publish).\n\n### Delete an event\n\nYou can delete events that are in draft state or that have been published. To\ndelete an event in Google Play Console, click the button labeled **Delete**\nat the bottom of the form for that event.\n\n### Reset event data\n\nYou can reset player progress data for testers of your events.\n\n- To reset draft events in Google Play Console, click the button labeled **Reset event progress** at the bottom of the form for that event.\n- To reset event data programmatically, call the [Management API `Events` methods](/games/services/management/api/events).\n\nClient implementations\n----------------------\n\nTo learn how to implement events for your platform, see the following resources:\n\n- [Android](/games/pgs/android/events)\n- [Web](/games/services/web/api/rest#rest-resource:-events)"]]
