Google Play 게임즈 이벤트 서비스를 사용하면 게임플레이 중에 플레이어가 생성한 누적 데이터를 수집하고 이를 게임 분석용으로 Google 서버에 저장할 수 있습니다. 게임에서 수집해야 하는 플레이어 데이터를 유연하게 정의할 수도 있습니다. 세부적으로는 다음과 같은 측정항목이 해당될 수 있습니다.
플레이어가 특정 아이템을 사용하는 횟수
플레이어가 특정 레벨에 도달하는 횟수
플레이어가 특정 게임 작업을 실행하는 횟수
이벤트 데이터를 게임 개선 방법에 관한 피드백으로 활용할 수 있습니다. 예를 들어 플레이어가 완료하기에 너무 어려운 특정 게임 레벨의 난이도를 조정할 수 있습니다.
이벤트 API를 사용하여 게임에서 캡처할 이벤트를 구현합니다. 예를 들어 관심 대상 이벤트가 트리거된 것을 게임에서 감지할 때마다 Android 코드에서 이벤트 increment 메서드를 호출합니다.
이벤트 데이터를 봅니다. Google Play Console에서 게임의 이벤트 페이지로 이동하여 캡처된 이벤트의 통계를 확인합니다.
이벤트 기본 사항
이벤트 API는 관심 있는 게임플레이 측정항목을 정의 및 수집하고 Play 게임즈 SDK에 그러한 측정항목을 업로드할 방법을 제공합니다.
Play 게임즈 SDK 이벤트에는 다음과 같은 주요 속성이 포함됩니다.
속성
설명
ID
Google Play Console에서 이 이벤트와 관련해 생성한 고유 문자열입니다.
게임 클라이언트에서 이벤트를 참조할 때 이 고유 ID를 사용하세요.
이름
이벤트의 짧은 이름입니다. 이름은 최대 100자(영문 기준)까지 입력할 수 있습니다.
이 값은 Google Play Console에 사용되며, 게임에 표시될 수 있습니다.
예:
'죽은 좀비'
'수집한 빨간색 보석'
설명
이벤트에 관한 긴 설명(예: '플레이어가 좀비를 죽인 횟수' 또는 '플레이어가 없애고 짝을 맞춘 빨간색 보석의 총 개수')입니다. 설명은 최대 500자(영문 기준)까지 입력할 수 있습니다.
이 값은 Google Play Console에 사용되며, 게임에 표시될 수 있습니다.
이벤트 유형
이벤트가 추적하는 데이터 유형을 선언하는 필드입니다.
이 값은 Google Play Console에서 플레이어 분석 보고를 지원하는 데 사용됩니다.
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 OpenJDK는 Oracle 및 Oracle 계열사의 상표 또는 등록 상표입니다.
최종 업데이트: 2025-07-26(UTC)
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 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)"]]
