새로운 Firebase Studio 기능부터 AI 통합 방법까지 I/O에서 발표된 모든 내용을 확인해 보세요. 블로그 읽기

이벤트 로깅

이벤트는 사용자 행동, 시스템 이벤트, 오류 등 앱에서 발생하는 상황을 파악하는 수단입니다.

Google Analytics는 몇 가지 이벤트를 자동으로 로깅하며 별도로 코드를 추가하지 않아도 이벤트를 수신할 수 있습니다. 앱에서 데이터를 추가로 수집해야 하는 경우 서로 다른 Analytics 이벤트 유형을 최대 500개까지 로깅할 수 있습니다. 앱에서 로깅할 수 있는 이벤트의 총분량에는 제한이 없습니다. 이벤트 이름은 대소문자를 구분합니다. 이름은 동일하지만 대소문자만 다른 두 이벤트를 로깅하면 서로 다른 이벤트 2개로 인식됩니다.

시작하기 전에

Google Analytics을 사용하려면 먼저 다음 작업을 해야 합니다.

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

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

이벤트 로깅

Firebase.Analytics.FirebaseAnalytics 모듈을 초기화한 후 이를 사용하여 LogEvent() 메서드로 이벤트를 로깅할 수 있습니다.

시작하는 데 도움을 제공하기 위해 Analytics SDK에서는 소매 및 전자상거래, 여행, 게임 앱을 포함한 다양한 유형의 앱에서 공통적으로 사용되는 여러 가지 추천 이벤트를 정의합니다. 이러한 이벤트에 대한 정보와 사용 시점을 자세히 알아보려면 Google 애널리틱스 고객센터의 추천 이벤트를 참조하세요.

추천 이벤트 구현에 대한 자세한 내용은 다음을 참조하세요.

추천 이벤트: Event 상수 목록을 참조하세요.
사전 정의된 매개변수: Parameters 상수 목록을 참조하세요.

다음 예시에서는 추천 SELECT_CONTENT 이벤트를 로깅하는 방법을 보여줍니다.

    // Log an event with multiple parameters, passed as an array:

Firebase.Analytics.FirebaseAnalytics.LogEvent(
  Firebase.Analytics.FirebaseAnalytics.EventSelectContent,
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterItemId, id),
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterItemName, "name"),
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.UserPropertySignUpMethod, "Google"),
  new Firebase.Analytics.Parameter(
    "favorite_food", mFavoriteFood),
  new Firebase.Analytics.Parameter(
    "user_id", mUserId)
);

사전 정의된 매개변수뿐 아니라 다음과 같은 매개변수를 이벤트에 추가할 수 있습니다.

맞춤 매개변수: 맞춤 매개변수는 Analytics 보고서에 직접 표시되지 않지만 잠재고객 정의에서 필터로 사용하여 모든 보고서에 적용할 수 있습니다. 앱을 BigQuery 프로젝트에 연결한 경우 BigQuery로 내보내는 데이터에도 맞춤 매개변수가 포함됩니다.
VALUE 매개변수: VALUE는 Analytics 이벤트에 해당하는 핵심 측정항목을 집계하는 데 유용한 범용 매개변수입니다. 수익, 거리, 시간, 점수 등을 예시로 들 수 있습니다.

애플리케이션에 Analytics 이벤트 유형으로 해결되지 않는 특정한 요구사항이 있으면 다음 예시와 같이 커스텀 Analytics 이벤트를 직접 로깅할 수 있습니다.

Firebase.Analytics.FirebaseAnalytics.LogEvent("custom_progress_event", "percent", 0.4f);

로그 출력에서 이벤트 보기

Android

Android 스튜디오 디버그 로그에서 상세 로깅을 사용 설정하면 SDK가 이벤트를 정상적으로 로깅하는지 확인할 수 있습니다. 여기에는 자동으로 로깅되는 이벤트와 수동으로 로깅되는 이벤트가 모두 포함됩니다.

일련의 adb 명령어로 상세 로깅을 사용 설정할 수 있습니다.

adb shell setprop log.tag.FA VERBOSE

adb shell setprop log.tag.FA-SVC VERBOSE

adb logcat -v time -s FA FA-SVC

이 명령어는 이벤트 전송 여부를 즉시 확인할 수 있도록 이벤트를 Android 스튜디오 logcat에 표시합니다.

iOS+

이벤트는 Console에 로깅되며 앱 실행 중에 Xcode를 통해 확인할 수 있습니다.

대시보드에서 애널리틱스 이벤트 보기

Firebase Console 대시보드에서 Analytics 이벤트의 집계된 통계를 확인할 수 있습니다. 이 대시보드는 주기적, 지속적으로 업데이트됩니다. 즉각적인 테스트가 필요하다면 앞 섹션에서 설명한 logcat 출력을 사용하세요.

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

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

앱에서 로깅된 Analytics 이벤트 유형별로 자동으로 작성된 이벤트 보고서가 이벤트 탭에 표시됩니다. 대시보드에 관해 자세히 알아보세요.