Google은 흑인 공동체를 위한 인종적 평등을 추구하기 위해 노력하고 있습니다. 자세히 알아보기

Google 애널리틱스 시작하기

이 빠른 시작에서는 앱에 Google 애널리틱스를 추가하고 이벤트 로깅을 시작하는 방법을 설명합니다.

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

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

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

시작하기 전에

Android 프로젝트에 Firebase를 추가하지 않은 경우 추가하여 Firebase 프로젝트에서 Google 애널리틱스를 사용 설정해야 합니다.

  • 새 Firebase 프로젝트를 만드는 경우 프로젝트 생성 워크플로 중에 Google 애널리틱스를 사용 설정합니다.

  • 기존 Firebase 프로젝트가 있지만 Google 애널리틱스를 사용 설정하지 않은 경우 > 프로젝트 설정통합 탭에서 Google 애널리틱스를 사용 설정할 수 있습니다.

프로젝트에서 Google 애널리틱스를 사용 설정하면 Firebase 앱이 Google 애널리틱스 데이터 스트림에 연결됩니다.

앱에 애널리틱스 SDK 추가

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

    자바

    implementation 'com.google.firebase:firebase-analytics:17.5.0'
    

    Kotlin+KTX

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

    자바

    private FirebaseAnalytics mFirebaseAnalytics;

    Kotlin+KTX

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

    자바

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

    Kotlin+KTX

    // Obtain the FirebaseAnalytics instance.
    firebaseAnalytics = Firebase.analytics

이벤트 로깅 시작

FirebaseAnalytics 인스턴스를 만든 후에는 logEvent() 메서드를 사용하여 이벤트 로깅을 시작할 수 있습니다.

모든 앱에 권장되는 이벤트가 있고 특정 비즈니스 유형 또는 카테고리에 권장되는 이벤트도 있습니다. 추천 이벤트를 사전 정의된 매개변수와 함께 전송해야 합니다. 이렇게 하면 보고서에 세부정보가 최대한 포함되고 향후 기능 및 통합을 즉시 사용할 수 있습니다. 이 섹션에서는 사전 정의된 이벤트 로깅을 보여줍니다. 이벤트 로깅에 대한 자세한 내용은 이벤트 로깅을 참조하세요.

다음 코드는 사용자가 앱의 특정 요소를 클릭할 때 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+KTX

firebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_ITEM) {
    param(FirebaseAnalytics.Param.ITEM_ID, id)
    param(FirebaseAnalytics.Param.ITEM_NAME, name)
    param(FirebaseAnalytics.Param.CONTENT_TYPE, "image")
}

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

다음 단계