Google 애널리틱스를 사용하여 비정상 종료 보고서 측정항목 가져오기

Google 애널리틱스는 Firebase의 분석 엔진입니다. 앱에서 애널리틱스 및 Crashlytics를 함께 사용하면 문제를 만들어 더 구체적인 비정상 종료 데이터를 추적하는 데 도움이 되는 기능을 사용할 수 있습니다. 예를 들면 비정상 종료가 발생하지 않은 사용자, 비정상 종료 전 특정 이벤트를 추적하는 탐색경로, 앱의 주요 측정항목을 시각화할 수 있는 BigQuery가 있습니다.

이 가이드에서는 Crashlytics가 설정된 앱에(아직 추가하지 않은 경우 앱에 Crashlytics를 추가) 애널리틱스를 추가하는 방법을 설명합니다.

1단계: Firebase 구성 파일 추가

  1. 앱에 Firebase Android 구성 파일을 추가합니다.

    1. 프로젝트 설정을 엽니다. 내 앱 카드에서 구성 파일이 필요한 앱의 패키지 이름을 선택합니다.

    2. google-services.json 다운로드를 클릭하여 Firebase Android 구성 파일(google-services.json)을 가져옵니다.

      • 언제든지 다시 Firebase Android 구성 파일을 다운로드할 수 있습니다.
      • 구성 파일에 (2)와 같은 문자가 추가되지 않았는지 확인합니다.

    3. 구성 파일을 앱의 모듈(앱 수준) 디렉터리로 이동합니다.

  2. 앱에서 Firebase 제품을 사용할 수 있도록 google-services 플러그인을 Gradle 파일에 추가합니다.

    1. 루트 수준(프로젝트 수준) Gradle 파일(<project>/build.gradle.kts 또는 <project>/build.gradle)에서 Google 서비스 Gradle 플러그인을 포함하는 규칙을 추가합니다. Google의 Maven 저장소도 있는지 확인합니다.

      Kotlin 

      plugins {
   id("com.android.application") version "7.3.0" apply false
   // ...

   // Add the dependency for the Google services Gradle plugin
   id("com.google.gms.google-services") version "4.4.0" apply false
}

      Groovy 

      plugins {
   id 'com.android.application' version '7.3.0' apply false
   // ...

   // Add the dependency for the Google services Gradle plugin
   id 'com.google.gms.google-services' version '4.4.0' apply false
}

    2. 모듈(앱 수준) Gradle 파일(일반적으로 <project>/<app-module>/build.gradle.kts 또는 <project>/<app-module>/build.gradle)에서 Google 서비스 Gradle 플러그인을 적용합니다.

      Kotlin 

      plugins {
   id("com.android.application")

   // Add the Google services Gradle plugin
   id("com.google.gms.google-services")
   // ...
}

      Groovy 

      plugins {
   id 'com.android.application'

   // Add the Google services Gradle plugin
   id 'com.google.gms.google-services'
   // ...
}

2단계: 앱에 애널리틱스 SDK 추가

  1. 모듈(앱 수준) Gradle 파일(일반적으로 <project>/<app-module>/build.gradle.kts 또는 <project>/<app-module>/build.gradle)에서 Android용 애널리틱스 라이브러리의 종속 항목을 추가합니다. 라이브러리 버전 관리 제어에는 Firebase Android BoM을 사용하는 것이 좋습니다. 

    dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:32.6.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.5.0'
}
    Kotlin 전용 라이브러리 모듈을 찾고 계신가요? 2023년 10월(Firebase BoM 32.5.0)부터 Kotlin 및 Java 개발자 모두 기본 라이브러리 모듈을 사용할 수 있습니다. 자세한 내용은 이 이니셔티브에 관한 FAQ를 참조하세요.

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

    Kotlin+KTX 

    private lateinit var firebaseAnalytics: FirebaseAnalytics
    MainActivity.kt

    Java 

    private FirebaseAnalytics mFirebaseAnalytics;
    MainActivity.java

  3. onCreate() 메서드에서 초기화합니다.

    Kotlin+KTX 

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

    Java 

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

다음 단계