스탠다드 이벤트

Note: Gaming Services Analytics is now available as a preview package. Gaming Services Analytics is an improved offering that allows you to easily understand game performance and player behaviors so you can make strategic decisions. Check out the documentation.

스탠다드 이벤트를 사용하여 다음의 다섯 가지 주요 영역에서 사용자 경험과 플레이어 동작을 추적할 수 있습니다.

• 애플리케이션(Application): 애플리케이션 사용자 인터페이스의 기본 요소 사용을 추적합니다.
• 진행도(Progression): 애플리케이션 또는 게임의 플레이어 진행도를 추적합니다.
• 온보딩(Onboarding): 플레이어와 애플리케이션/게임 간의 최초 인터랙션을 추적합니다.
• 참여(Engagement): 소셜 공유, 업적 등과 관련된 중요 액션을 추적합니다.
• 수익화(Monetization): 수익 관련 이벤트와 게임 내 경제를 추적합니다.

스탠다드 이벤트 리스트에는 게임 및 애플리케이션에서 추적하면 도움이 되는 요소들이 포함되어 있습니다. 예를 들어 대부분의 게임에는 완료한 퍼즐 수, 플레이한 매치 수, RPG 게임의 획득 경험치 등 플레이어 진행도라는 개념이 있습니다. 스탠다드 진행도 이벤트를 추적하면 플레이어가 게임 진행을 멈춘 지점 그리고 궁극적으로는 게임플레이를 멈춘 지점을 자세히 파악할 수 있습니다.

대부분의 스탠다드 이벤트는 애널리틱스 이벤트가 전송될 때 게임 상태에 관한 추가 정보를 제공하는 필수 및 옵션 파라미터를 정의합니다. 자체 커스텀 파라미터를 정의할 수도 있습니다. 이벤트에 대한 파라미터를 설정하면 이벤트가 발생할 때 수집되는 데이터를 필터링할 수 있습니다. 스탠다드 이벤트와 커스텀 이벤트에 대한 시각화 도구(예: 데이터 탐색기(Data Explorer), 퍼널 분석기(Funnel Analyzer), 세그먼트 빌더(Segment Builder))는 애널리틱스 대시보드에서 확인할 수 있습니다.

Unity 애널리틱스는 사용자당, 시간당 수락하는 스탠다드 이벤트와 커스텀 이벤트의 수를 100개로 제한합니다. 즉, 게임을 플레이하는 단일 사용자가 시간당 100개가 넘는 스탠다드 이벤트와 커스텀 이벤트를 트리거하면 애널리틱스는 초과 분량의 이벤트를 폐기합니다.

애플리케이션 이벤트

애플리케이션 이벤트는 게임 외부(예: 메뉴, 레벨 전후 컷씬 화면)에서 플레이어와 애플리케이션 사이의 인터랙션을 추적합니다. 애플리케이션 이벤트를 분석하여 플레이어가 사용자 인터페이스의 기본 요소를 여러분이 기대하는 만큼 사용하는지 확인할 수 있습니다.

진행도 이벤트

진행도 이벤트는 플레이어가 게임을 진행하는 과정을 추적합니다. 스탠다드 진행도 이벤트를 분석하여 게임 내 플레이어 진행도를 모니터링할 수 있습니다.

온보딩 이벤트

온보딩 이벤트는 최초 사용자 경험(FTUE)을 추적합니다. 스탠다드 온보딩 이벤트를 분석하여 튜토리얼의 효과를 모니터링할 수 있습니다.

참여 이벤트

참여 이벤트를 통해 플레이어가 게임에 참여하는지, 그리고 리텐션 및 바이럴리티와 높은 상관 관계가 있는 액션을 취하는지 파악할 수 있습니다.

수익화 이벤트

수익화 이벤트는 수익 및 게임 경제를 추적하여 리소스 균형을 맞추고 수익원을 개선하도록 도와줍니다.

스크립팅 스탠다드 이벤트

스크립트에서 스탠다드 이벤트를 디스패치하려면 다음의 네임스페이스를 추가하십시오.

using UnityEngine.Analytics;

참고: Unity 에셋 스토어에서 받은 스탠다드 이벤트 SDK를 사용할 때는 UnityEngine.Analytics.Experimental 네임스페이스를 대신 사용해야 합니다.

이제 AnalyticsEvent 클래스를 사용하여 스탠다드 이벤트를 디스패치할 수 있습니다. 각 스탠다드 이벤트에는 해당하는 정적 함수가 있습니다. 예를 들어 game_start 이벤트를 보낼 때는 다음 함수를 호출하십시오.

AnalyticsEvent.GameStart();

대부분의 스탠다드 이벤트에는 필수 파라미터와 여러 개의 옵션 파라미터가 포함되어 있습니다. 자체 추가 파라미터를 사전에 추가할 수도 있습니다. 예를 들어 ScreenVisit 이벤트를 사용하여 플레이어가 방문하는 화면뿐만 아니라 방문하기 이전 화면도 추적하고 싶은 경우 다음과 같이 해당 정보를 사전 오브젝트에 전달할 수 있습니다.

public static void ReportScreenVisit(string screenName, string currentScreenName)
{
    AnalyticsEvent.ScreenVisit(screenName, new Dictionary<string, object>
    {
        { "from_screen", currentScreenName }
    });
}

필수 파라미터, 옵션 파라미터(사용하는 파라미터만 해당), 추가 파라미터는 총합 10개를 넘을 수 없습니다. 즉 이벤트 함수에 2개의 필수 파라미터가 있고 2개의 옵션 파라미터 중에서 하나를 설정한 경우 최대 7개의 추가 키 값 쌍이 포함된 사전을 함수에 전달할 수 있습니다. 동일한 이벤트에서 옵션 파라미터를 2개 모두 설정했다면 사전에는 6개의 추가 키 값 쌍만 포함할 수 있습니다.

스탠다드 이벤트 코드 예제

다음 클래스에서는 스탠다드 MonoBehaviour 이벤트 함수를 사용하여 레벨의 시작 및 끝과 관련된 스탠다드 이벤트를 디스패치하는 예제를 제공합니다.

Awake 함수는 level_start 이벤트를 디스패치합니다. 이 예제는 레벨 이름과 레벨 인덱스를 둘 다 제공하지만, 그중 하나만 필요합니다. 또한 이 예제는 씬 오브젝트의 이름과 인덱스를 사용하지만, 다른 값을 사용할 수도 있습니다.

OnDestroy 함수는 level_complete, level_fail, level_skip 또는 level_quit 이벤트를 디스패치합니다. 이는 현재 레벨 상태 값에 기반합니다(실제 게임에서는 이 예제에서 정의된 SetLevelPlayState() 함수를 사용하여 레벨의 다른 코드에 의해 설정될 수 있음). 예제에서는 “customParams” 사전을 통해 이러한 이벤트에 추가 파라미터를 제공합니다.

using System.Collections.Generic;
using UnityEngine;
using UnityEngine.SceneManagement;
using UnityEngine.Analytics;

public class LevelEventManager : MonoBehaviour {
    public enum LevelPlayState {InProgress, Won, Lost, Skip, Quit}

    private Scene thisScene;
    private LevelPlayState state = LevelPlayState.InProgress;
    private int score = 0;
    private float secondsElapsed = 0;
    private int deaths = 0;

    void Awake () {
        thisScene = SceneManager.GetActiveScene();
        AnalyticsEvent.LevelStart(thisScene.name, 
                                      thisScene.buildIndex);
    }

    public void SetLevelPlayState(LevelPlayState newState){
        this.state = newState;
    }

    public void IncreaseScore(int points){
        score += points;
    }

    public void IncrementDeaths(){
        deaths++;
    }

    void Update(){
        secondsElapsed += Time.deltaTime;
    }

    void OnDestroy(){
        Dictionary<string, object> customParams = new Dictionary<string, object>();
        customParams.Add("seconds_played", secondsElapsed);
        customParams.Add("points", score);
        customParams.Add("deaths", deaths);

        switch(this.state){
        case LevelPlayState.Won:
            AnalyticsEvent.LevelComplete(thisScene.name,
                                             thisScene.buildIndex, 
                                             customParams);
            break;
        case LevelPlayState.Lost:
            AnalyticsEvent.LevelFail(thisScene.name,
                                         thisScene.buildIndex, 
                                         customParams);
            break;
        case LevelPlayState.Skip:
            AnalyticsEvent.LevelSkip(thisScene.name,
                                         thisScene.buildIndex, 
                                         customParams);
            break;
        case LevelPlayState.InProgress:
        case LevelPlayState.Quit:
        default:
            AnalyticsEvent.LevelQuit(thisScene.name,
                                         thisScene.buildIndex, 
                                         customParams);
            break;
        }
    }
}

이 예제에서는 OnDestroy()에서 생성된 커스텀 파라미터 사전을 한 번만 사용합니다. 하지만 이러한 사전을 사용하는 이벤트를 자주 디스패치하는 경우 매번 새 사전을 만드는 것보다는 단일 사전 인스턴스를 생성하여 재사용하는 것이 좋습니다. 사전 오브젝트를 재사용하면 향후 프레임에서 가비지 수집 작업에 필요한 메모리 할당량이 감소합니다. 자세한 내용은 애널리틱스 이벤트 파라미터를 참조하십시오.

• 2018–03–02 페이지 게시됨

• 2018–03–02 - 이 날짜를 기준으로 서비스가 Unity 5.2 이상 버전과 호환되지만, 버전 호환성은 변경될 수 있음

• Unity 5.2의 새로운 기능