콘솔로 이동

이벤트 로깅

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

애널리틱스는 몇 가지 이벤트를 자동으로 로깅하며 별도의 코드 없이 이벤트를 수신할 수 있습니다. 앱에서 더 많은 데이터를 수집해야 하는 경우 앱에서 최대 500개의 서로 다른 애널리틱스 이벤트 유형을 로깅할 수 있습니다. 앱에서 로깅할 수 있는 이벤트의 총 분량에는 제한이 없습니다. 이벤트 이름은 대소문자를 구분하며, 이름에서 대소문자만 다른 두 이벤트를 로깅하면 서로 다른 두 개의 이벤트로 인식됩니다.

시작하기 전에

Android에서 애널리틱스 시작하기에 설명된 대로 프로젝트를 설정했고 애널리틱스에 액세스할 수 있는지 확인하세요.

이벤트 로깅

FirebaseAnalytics 인스턴스를 만든 후 이 인스턴스를 사용하여 logEvent() 메소드로 해당 이벤트를 로깅할 수 있습니다.

처음 시작하는 개발자를 위해 애널리틱스 SDK는 소매/전자상거래, 여행 및 게임 앱 등의 다양한 앱에서 공통적으로 사용되는 여러 가지 추천 이벤트를 정의합니다. 이러한 이벤트에 대한 자세한 내용 및 사용 방법은 Firebase 고객센터의 이벤트 및 속성 문서를 참조하세요.

추천 이벤트 구현에 관한 자세한 내용은 다음 위치를 참조하세요.

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

자바
Android

Bundle bundle = new Bundle();
bundle.putString(FirebaseAnalytics.Param.ITEM_ID, id);
bundle.putString(FirebaseAnalytics.Param.ITEM_NAME, name);
bundle.putString(FirebaseAnalytics.Param.CONTENT_TYPE, "image");
mFirebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_CONTENT, bundle);

Kotlin
Android

val bundle = Bundle()
bundle.putString(FirebaseAnalytics.Param.ITEM_ID, id)
bundle.putString(FirebaseAnalytics.Param.ITEM_NAME, name)
bundle.putString(FirebaseAnalytics.Param.CONTENT_TYPE, "image")
firebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_CONTENT, bundle)

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

  • 맞춤 매개변수: 애널리틱스 보고서의 보고 대상으로 맞춤 매개변수를 등록할 수 있습니다. 맞춤 매개변수를 잠재고객 정의에서 필터로 사용하여 모든 보고서에 적용할 수도 있습니다. 앱을 BigQuery 프로젝트에 연결한 경우 BigQuery로 내보내는 데이터에도 맞춤 매개변수가 포함됩니다.

  • VALUE 매개변수: VALUE는 이벤트에 해당하는 핵심 측정항목을 집계하는 데 유용한 범용 매개변수입니다. 수익, 거리, 시간, 점수 등을 예로 들 수 있습니다.

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

자바
Android

Bundle params = new Bundle();
params.putString("image_name", name);
params.putString("full_text", text);
mFirebaseAnalytics.logEvent("share_image", params);

Kotlin
Android

val params = Bundle()
params.putString("image_name", name)
params.putString("full_text", text)
firebaseAnalytics.logEvent("share_image", params)

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에 표시합니다.

대시보드에서 이벤트 보기

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

Firebase 콘솔에서 다음과 같이 이 데이터에 액세스할 수 있습니다.

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

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