이벤트

Google Play 게임즈 이벤트 서비스를 사용하면 게임플레이 중에 플레이어가 생성한 누적 데이터를 수집하고 이를 게임 분석용으로 Google 서버에 저장할 수 있습니다. 게임에서 수집해야 하는 플레이어 데이터를 유연하게 정의할 수도 있습니다. 세부적으로는 다음과 같은 측정항목이 해당될 수 있습니다.

  • 플레이어가 특정 아이템을 사용하는 횟수
  • 플레이어가 특정 레벨에 도달하는 횟수
  • 플레이어가 특정 게임 작업을 실행하는 횟수

이벤트 데이터를 게임 개선 방법에 관한 피드백으로 활용할 수 있습니다. 예를 들어 플레이어가 완료하기에 너무 어려운 특정 게임 레벨의 난이도를 조정할 수 있습니다.

플랫폼에 이벤트를 구현하는 방법은 클라이언트 구현을 참고하세요.

게임에 이벤트 통합

다음 워크플로는 게임에 이벤트를 적용하는 방법을 설명합니다.

  1. 이벤트를 정의합니다. 게임에서 캡처할 새 이벤트를 정의하려면 다음 단계를 따르세요.
    1. Google Play Console에서 게임의 이벤트 페이지로 이동합니다.
    2. 새 이벤트 추가 버튼을 클릭하고 이벤트 속성을 구성합니다.
    3. 게임 변경사항 게시하기에 설명된 단계에 따라 이벤트 정의를 게시합니다.

  2. 이벤트 API를 사용하여 게임에서 캡처할 이벤트를 구현합니다. 예를 들어 관심 대상 이벤트가 트리거된 것을 게임에서 감지할 때마다 Android 코드에서 이벤트 increment 메서드를 호출합니다.

  3. 이벤트 데이터를 봅니다. Google Play Console에서 게임의 이벤트 페이지로 이동하여 캡처된 이벤트의 통계를 확인합니다.

이벤트 기본 사항

이벤트 API를 사용하면 흥미로운 게임플레이 측정항목을 정의 및 수집하고 이러한 측정항목을 Google Play 게임즈 서비스에 업로드할 수 있습니다.

Google Play 게임즈 서비스 이벤트에는 다음과 같은 주요 속성이 포함됩니다.

속성 설명
ID Google Play Console에서 이 이벤트에 대해 생성한 고유 문자열입니다. 이 고유 ID를 사용하여 게임 클라이언트의 이벤트를 참조할 수 있습니다.
이름 이벤트의 짧은 이름입니다. 이름은 최대 100자(영문 기준)까지 입력할 수 있습니다. 이 값은 Google Play Console에서 사용되며, 게임에 표시될 수 있습니다.

예:

  • '죽은 좀비'
  • '수집한 빨간색 보석'
설명 이벤트에 관한 긴 설명(예: '플레이어가 좀비를 죽인 횟수' 또는 '플레이어가 없애고 짝을 맞춘 빨간색 보석의 총 개수')입니다. 설명은 최대 500자(영문 기준)까지 입력할 수 있습니다. 이 값은 Google Play Console에서 사용되며, 게임에 표시될 수 있습니다.
이벤트 유형

이벤트가 추적하는 데이터 유형을 선언하는 필드입니다. 이 값은 Google Play Console에서 플레이어 분석 보고를 지원하는 데 사용됩니다.

두 가지 이벤트 유형이 지원됩니다.

프리미엄 통화 출처
프리미엄 통화의 출처를 추적하는 이벤트에 이 유형을 선택합니다. 예:
  • '획득한 금화'
  • '구입한 에메랄드'
프리미엄 통화 지출
프리미엄 통화의 감소 또는 소비를 추적하는 이벤트에 이 유형을 선택합니다. 예:
  • '소비된 금화'
  • '사용한 에메랄드'
아이콘 이벤트와 관련된 정사각형 아이콘입니다.

이벤트 만들기

게임의 새 이벤트를 만들려면 다음 단계를 따르세요.

  1. 아직 추가하지 않았다면 Google Play Console에 게임을 추가합니다.
  2. Google Play Console에서 왼쪽의 게임 서비스 아이콘을 클릭하고 게임 항목을 선택합니다.
  3. 왼쪽의 이벤트 탭을 선택하고 이벤트 추가 버튼을 클릭합니다.
  4. 만들려는 이벤트에 관한 세부정보를 입력합니다.
  5. 저장을 클릭합니다. 오류가 없으면 이벤트가 '게시 준비' 상태가 됩니다. 이제 게임 변경사항 게시를 진행할 수 있습니다.

일정 수정하기

만든 이벤트를 수정하려면 다음 안내를 따르세요.

  1. Google Play Console에서 이벤트 탭을 열고 수정하려는 이벤트의 항목을 선택합니다. 이벤트를 만들 때 사용한 것과 같은 양식이 표시됩니다.
  2. 필요에 따라 수정합니다.
  3. 이벤트 수정을 마치면 저장 버튼을 클릭합니다.
  4. 게임을 테스트하여 수정된 이벤트를 확인합니다. 올바르게 작동하면 게임 변경사항을 다시 게시합니다.

일정 삭제하기

초안 상태이거나 게시된 이벤트를 삭제할 수 있습니다. Google Play Console에서 이벤트를 삭제하려면 해당 이벤트 양식 하단에 있는 삭제 버튼을 클릭합니다.

이벤트 데이터 재설정

이벤트 테스터를 위해 플레이어 진행 상황 데이터를 초기화할 수 있습니다.

  • Google Play Console에서 초안 이벤트를 초기화하려면 해당 이벤트 양식 하단에 있는 이벤트 진행률 재설정 버튼을 클릭합니다.
  • 프로그래매틱 방식으로 이벤트 데이터를 초기화하려면 Management API Events 메서드를 호출합니다.

클라이언트 구현

플랫폼의 이벤트를 구현하는 방법은 다음 리소스를 참고하세요.