Unity에서 Google 애널리틱스 시작하기

Google 애널리틱스는 앱의 사용량과 행동 데이터를 수집합니다. 이 SDK는 다음 두 가지 기본 유형의 정보를 로깅합니다.

이벤트: 사용자 행동, 시스템 이벤트, 오류 등 앱에서 발생하는 상황입니다.
사용자 속성: 사용자층을 나눈 세그먼트를 기술하고자 개발자가 정의하는 언어 설정, 지리적 위치 등의 속성입니다.

애널리틱스는 몇 가지 이벤트와 사용자 속성을 자동으로 로깅하며 별도의 코드 없이 이러한 속성을 사용 설정할 수 있습니다. 앱에서 데이터를 추가로 수집해야 하는 경우 서로 다른 애널리틱스 사용자 속성을 최대 25개까지 설정하고 서로 다른 애널리틱스 이벤트 유형을 최대 500개까지 로깅할 수 있습니다. 앱에서 로깅할 수 있는 이벤트의 총 분량에는 제한이 없습니다.

이 데이터에 액세스하는 방법은 다음과 같습니다.

Firebase Console에서 프로젝트를 엽니다.
메뉴에서 애널리틱스를 선택하여 애널리틱스 보고 대시보드를 표시합니다.

앱에서 로깅된 애널리틱스 이벤트 유형별로 자동으로 작성된 이벤트 보고서가 이벤트 탭에 표시됩니다. 자세한 내용은 Firebase 고객센터의 애널리틱스 보고 대시보드를 참조하세요.

시작하는 데 도움을 제공하기 위해 애널리틱스 SDK에서는 소매 및 전자상거래, 여행, 게임 앱을 포함한 다양한 유형의 앱에서 공통적으로 사용되는 여러 가지 추천 이벤트를 정의합니다. 이러한 이벤트에 대한 자세한 내용 및 사용 방법은 Firebase 고객센터의 이벤트 및 속성 문서를 참조하세요. 앱에 적합한 추천 애널리틱스 이벤트와 사전 정의된 매개변수를 로깅하면 보고서에 최대한 세부적인 정보를 포함할 수 있습니다. 이렇게 하면 Google 애널리틱스의 최신 기능도 출시 즉시 사용할 수 있습니다.

시작하기 전에

Google 애널리틱스를 사용하려면 먼저 다음 작업을 해야 합니다.

Unity 프로젝트를 등록하고 Firebase를 사용하도록 구성합니다.
- Unity 프로젝트에서 현재 Firebase를 사용하고 있다면 이미 등록되어 Firebase용으로 구성된 것입니다.
- Unity 프로젝트가 없는 경우 샘플 앱을 다운로드할 수 있습니다.
Firebase Unity SDK(특히 FirebaseAnalytics.unitypackage)를 Unity 프로젝트에 추가합니다.

Unity 프로젝트에 Firebase를 추가할 때 Firebase Console 및 열려 있는 Unity 프로젝트 모두에서 작업을 수행해야 합니다. 예를 들어 콘솔에서 Firebase 구성 파일을 다운로드한 후 이 파일을 Unity 프로젝트로 이동하는 작업이 필요합니다.

이벤트 로깅

LogEvent() 메서드로 즉시 이벤트 로깅을 시작할 수 있습니다.

다음 예시에서는 다양한 인수 유형을 사용하여 이벤트를 로깅합니다.

// Log an event with no parameters.
Firebase.Analytics.FirebaseAnalytics
  .LogEvent(Firebase.Analytics.FirebaseAnalytics.EventLogin);

// Log an event with a float parameter
Firebase.Analytics.FirebaseAnalytics
  .LogEvent("progress", "percent", 0.4f);

// Log an event with an int parameter.
Firebase.Analytics.FirebaseAnalytics
  .LogEvent(
    Firebase.Analytics.FirebaseAnalytics.EventPostScore,
    Firebase.Analytics.FirebaseAnalytics.ParameterScore,
    42
  );

// Log an event with a string parameter.
Firebase.Analytics.FirebaseAnalytics
  .LogEvent(
    Firebase.Analytics.FirebaseAnalytics.EventJoinGroup,
    Firebase.Analytics.FirebaseAnalytics.ParameterGroupId,
    "spoon_welders"
  );

// Log an event with multiple parameters, passed as a struct:
Firebase.Analytics.Parameter[] LevelUpParameters = {
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterLevel, 5),
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterCharacter, "mrspoon"),
  new Firebase.Analytics.Parameter(
    "hit_accuracy", 3.14f)
};
Firebase.Analytics.FirebaseAnalytics.LogEvent(
  Firebase.Analytics.FirebaseAnalytics.EventLevelUp,
  LevelUpParameters);

다음 단계

Firebase Console에서 데이터가 주기적으로 업데이트되는 것을 확인합니다.
이벤트 및 사용자 속성에 대한 가이드를 살펴봅니다.