Firebase Summit에서 발표된 모든 내용을 살펴보고 Firebase로 앱을 빠르게 개발하고 안심하고 앱을 실행하는 방법을 알아보세요. 자세히 알아보기

Google 애널리틱스 시작하기

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

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

Google Analytics는 앱의 사용 및 행동 데이터를 수집합니다. SDK는 두 가지 기본 유형의 정보를 기록합니다.

  • 이벤트: 사용자 작업, 시스템 이벤트 또는 오류와 같이 앱에서 일어나는 일.
  • 사용자 속성: 언어 기본 설정 또는 지리적 위치와 같이 사용자 기반의 세그먼트를 설명하기 위해 정의하는 속성입니다.

Analytics는 일부 이벤트사용자 속성 을 자동으로 기록합니다. 활성화하기 위해 코드를 추가할 필요가 없습니다.

시작하기 전에

아직 추가하지 않았다면 Android 프로젝트에 Firebase를 추가 하고 Firebase 프로젝트에서 Google Analytics가 활성화되어 있는지 확인합니다.

  • 새 Firebase 프로젝트를 생성하는 경우 프로젝트 생성 워크플로 중에 Google 애널리틱스를 활성화합니다.

  • Google 애널리틱스가 활성화되지 않은 기존 Firebase 프로젝트를 사용하는 경우 통합 탭 > 프로젝트 설정 으로 이동하여 활성화합니다.

프로젝트에서 Google Analytics를 활성화하면 Firebase 앱이 Google Analytics 데이터 스트림에 연결됩니다.

앱에 Analytics SDK 추가

  1. 모듈(앱 수준) Gradle 파일 (일반적으로 <project>/<app-module>/build.gradle )에서 Analytics Android 라이브러리에 대한 종속성을 추가합니다. Firebase Android BoM 을 사용하여 라이브러리 버전 관리를 제어하는 ​​것이 좋습니다.

    Java

    dependencies {
        // Import the BoM for the Firebase platform
        implementation platform('com.google.firebase:firebase-bom:31.1.0')
    
        // Add the dependency for the Analytics library
        // When using the BoM, you don't specify versions in Firebase library dependencies
        implementation 'com.google.firebase:firebase-analytics'
    }
    

    Firebase Android BoM 을 사용하면 앱에서 항상 호환되는 Firebase Android 라이브러리 버전을 사용합니다.

    (또는) BoM을 사용 하지 않고 Firebase 라이브러리 종속성을 추가합니다.

    Firebase BoM을 사용하지 않기로 선택한 경우 종속성 줄에 각 Firebase 라이브러리 버전을 지정해야 합니다.

    앱에서 여러 Firebase 라이브러리를 사용하는 경우 모든 버전이 호환되도록 BoM을 사용하여 라이브러리 버전을 관리하는 것이 좋습니다.

    dependencies {
        // Add the dependency for the Analytics library
        // When NOT using the BoM, you must specify versions in Firebase library dependencies
        implementation 'com.google.firebase:firebase-analytics:21.2.0'
    }
    

    Kotlin+KTX

    dependencies {
        // Import the BoM for the Firebase platform
        implementation platform('com.google.firebase:firebase-bom:31.1.0')
    
        // Add the dependency for the Analytics library
        // When using the BoM, you don't specify versions in Firebase library dependencies
        implementation 'com.google.firebase:firebase-analytics-ktx'
    }
    

    Firebase Android BoM 을 사용하면 앱에서 항상 호환되는 Firebase Android 라이브러리 버전을 사용합니다.

    (또는) BoM을 사용 하지 않고 Firebase 라이브러리 종속성을 추가합니다.

    Firebase BoM을 사용하지 않기로 선택한 경우 종속성 줄에 각 Firebase 라이브러리 버전을 지정해야 합니다.

    앱에서 여러 Firebase 라이브러리를 사용하는 경우 모든 버전이 호환되도록 BoM을 사용하여 라이브러리 버전을 관리하는 것이 좋습니다.

    dependencies {
        // Add the dependency for the Analytics library
        // When NOT using the BoM, you must specify versions in Firebase library dependencies
        implementation 'com.google.firebase:firebase-analytics-ktx:21.2.0'
    }
    

  2. 활동 상단에서 com.google.firebase.analytics.FirebaseAnalytics 개체를 선언합니다.

    Java

    private FirebaseAnalytics mFirebaseAnalytics;

    Kotlin+KTX

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

    Java

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

    Kotlin+KTX

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

이벤트 로깅 시작

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

특정 이벤트는 모든 앱에 권장됩니다 . 다른 것들은 특정 비즈니스 유형이나 업종에 권장됩니다. 보고서에서 사용 가능한 최대한의 세부 정보를 확인하고 향후 기능 및 통합이 제공되는 대로 이점을 누리려면 사전 정의된 매개변수와 함께 제안된 이벤트를 보내야 합니다. 이 섹션에서는 미리 정의된 이벤트를 기록하는 방법을 보여줍니다. 이벤트 기록에 대한 자세한 내용은 이벤트 기록 을 참조 하십시오 .

다음 코드는 사용자가 앱의 특정 요소를 클릭할 때 SELECT_CONTENT 이벤트를 기록합니다.

Java

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 Studio logcat에 이벤트를 표시하므로 이벤트가 전송되고 있는지 즉시 확인할 수 있습니다.

다음 단계