콘솔로 이동

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

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

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

  • 사용자 속성: 사용자층을 나눈 세그먼트를 기술하고자 개발자가 정의하는 언어 설정, 지리적 위치 등의 속성입니다.

애널리틱스는 일부 이벤트사용자 속성을 자동으로 로깅하며 별도의 코드 없이 이러한 속성을 사용 설정할 수 있습니다.

시작하기 전에

새 프로젝트를 만드는 경우 Android 프로젝트에 Firebase를 추가하고 프로젝트를 만드는 동안 프로젝트에 Google 애널리틱스를 설정하는 단계를 따릅니다.

기존 프로젝트가 있는데 Google 애널리틱스를 구성하지 않은 경우 settings > 프로젝트 설정통합 탭에서 Google 애널리틱스를 프로젝트에 연결할 수 있습니다.

앱에 애널리틱스 추가

  1. Google 애널리틱스 Android 라이브러리의 종속 항목을 모듈(앱 수준) Gradle 파일(일반적으로 app/build.gradle)에 추가합니다.

    implementation 'com.google.firebase:firebase-analytics:17.0.1'
    
  2. 활동 상단에서 com.google.firebase.analytics.FirebaseAnalytics 객체를 선언합니다.

    자바

    private FirebaseAnalytics mFirebaseAnalytics;

    Kotlin

    private lateinit var firebaseAnalytics: FirebaseAnalytics
  3. onCreate() 메소드에서 초기화합니다.

    자바

    // Obtain the FirebaseAnalytics instance.
    mFirebaseAnalytics = FirebaseAnalytics.getInstance(this);

    Kotlin

    // Obtain the FirebaseAnalytics instance.
    firebaseAnalytics = FirebaseAnalytics.getInstance(this)

이벤트 로깅

FirebaseAnalytics 인스턴스를 만든 후 사용하여 logEvent() 메서드로 사전 정의된 이벤트나 커스텀 이벤트를 로깅할 수 있습니다. FirebaseAnalytics.EventFirebaseAnalytics.Param 참조 문서에서 사전 정의된 이벤트와 매개변수를 살펴볼 수 있습니다.

다음 코드는 사용자가 앱에서 특정 요소를 클릭할 때 SELECT_CONTENT 이벤트를 로깅합니다.

자바

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

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)

이벤트 확인

자세한 로깅을 사용 설정하여 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에 표시합니다.

다음 단계