본문 바로가기

카테고리 없음

[Firebase Analytics] Firebase Analytics 완벽 가이드: 프로젝트 생성부터 앱 연동, 데이터 분석까지 한 번에 이해하기

Firebase Analytics 는? 

Firebase Analytics는 Google에서 제공하는 앱 분석 도구로, 앱 사용자의 행동을 추적하고 데이터를 기반으로 앱의 성과를 개선할 수 있도록 도와주는 강력한 플랫폼입니다. Firebase Analytics는 Google Analytics 4(GA4)와 완벽하게 통합되어 앱과 웹 데이터를 한 곳에서 관리할 수 있습니다.

1. 주요 기능

  • 이벤트 데이터를 자동으로 추적.
  • 사용자 흐름을 분석하여 개선할 점 도출.
  • 이커머스, 게임, 교육 앱 등 다양한 유형의 앱에서 적용 가능.

 

2. 유입 경로 파악

광고, 이메일, 검색 등 사용자가 앱에 들어온 경로를 분석합니다. 이를 통해 어떤 채널이 가장 효과적인지 알 수 있습니다.

  • 활용 예시:
    "페이스북 광고를 통해 1,000명이 앱을 설치했습니다."
    "검색 키워드를 통해 유입된 사용자의 전환율이 높습니다."

 

3. Google Analytics 4와 통합

Firebase Analytics는 GA4와 통합되어 웹과 앱 데이터를 한 곳에서 관리할 수 있습니다. 이를 통해 사용자 행동 데이터를 더 폭넓게 분석하고 광고 성과를 추적할 수 있습니다.

 


 

Firebase Analytics를 설정하기 전에 준비해야 할 사항

 

앱 만들기

Firebase Analytics는 앱 데이터를 분석하는 도구이므로, 먼저 앱이 필요합니다. 학습 목적으로 간단한 안드로이드 앱을 만들어 보겠습니다.

 


 

안드로이드 앱 만들기 (학습용)

1. Firebase Analytics 다운 받기

https://developer.android.com/studio 에 가서 안드로이드 스튜디오를 다운받습니다. 

이후 설치 절차는 매우 간단합니다. "다음" 버튼을 클릭하여 완료하세요.

 

2. 새 안드로이드 앱 생성

1. Android Studio를 실행하고, New Project 버튼을 클릭합니다. 

2. Empty Activitiy 템플릿을 선택합니다. 

 

3. 프로젝트 세부 설정에서 다음을 입력합니다.

  • 앱 이름: 원하는 이름을 입력합니다.
  • 패키지 이름: 이 이름은 Firebase 프로젝트 생성 시 필요하니 메모해두세요. 

4. Finish 버튼을 클릭하면 앱 생성이 완료됩니다. 

 

 


 

이제 우리의 앱이 있기 때문에 그 앱을 Firebase Analytics 을 통해 데이터 수집/분석을 하고자 합니다. 

 

Firebase Analytics 구성하기

 

1. Firebase 프로젝트 생성하기

https://console.firebase.google.com 에 접속하여 새프로젝트를 생성합니다. 



프로젝트 생성하기를 클릭하면 하기와 같은 화면이 보이는데 프로젝트 이름을 짓습니다. 해당 이름은 위 화면에서의 프로젝트 이름 (test, Integrate... )를 볼 수 있는 것이므로 참고하여 지어주세요. 

 

 

Firebase 프로젝트를 생성하면, Google Cloud Platform(GCP)에도 동일한 이름으로 프로젝트가 자동으로 생성됩니다. 이는 Firebase가 백엔드로 GCP를 사용하기 때문입니다.  

고객사의 Firebase Analytics를 생성할 때 주의할 점:
Firebase 프로젝트는 GCP 프로젝트와 연결되므로 권한 및 관리 주체를 명확히 해야 합니다.  
- 권장사항: 고객사에게 Firebase 프로젝트를 직접 생성하도록 가이드하세요.  
- 이유: 
  1. GCP 계정에 대한 접근 권한 문제를 방지할 수 있습니다.  
  2. Jellyfish가 GCP 계정 관리에 관여할 경우, 불필요한 승인 절차나 권한 충돌로 인해 프로젝트 진행이 지연될 수 있습니다.  

Tip:  
- 고객이 생성한 Firebase 프로젝트에 Jellyfish의 필요 권한만 추가하면, 효율적으로 협업할 수 있습니다.  
- GCP와 Firebase의 관계를 사전에 이해하고 이를 명확히 안내하면 고객과의 의사소통이 원활해질 것입니다.

 

 

그 다음 화면으로 넘어가면 해당 프로젝트를 Google Analytics에서 볼 수 있게 할 것인지에대한 선택 버튼이 나오는데 (자동으로 켜져 있음) 자동으로 켜져있는 채로 남겨 두고 다음 버튼을 클릭 합니다. 

 

 

연동할 GA4 Account / Property 를 선택합니다. 기존에 있는 GA4 Account / Property 에 설정하는 방법이 있고, Firebase Analytics 에서 새롭게 생성하는 방법이 있습니다. 

 

 

 

다음 버튼을 누르면 Firebase Analytics 가 생성되고 있다는 로딩창을 볼 수 있고, 조금 지나면 생성이 완료됐다는 화면을 볼 수 있습니다. 

Firebase Analytics 프로젝트는 오직 GA4 프로퍼티와 1:1 연동만 가능하니 이 점 반드시 유념해주시기 바랍니다. 

 

 

Firebase Analytics 프로젝트를 만들었습니다!

이제 그 프로젝트 안에 앱을 생성하겠습니다. 해당 앱은 iOS, Android, Flutter 등이 있습니다만, 우리는 위 단계에서 안드로이드 앱을 생성했기 때문에 안드로이드를 클릭하여 안드로이드 앱을 생성합니다. 해당 앱은 추후 GA4의 스트림과 매칭됩니다. 

 

 

안드로이드 버튼을 클릭하면 하기와 같은 절차를 따라야합니다. 

 

1. Android 패키지 이름을 넣어주세요 - 앱 생성할 때 입력했던 그 패키지 이름을 정확히 입력해야합니다. 

2. 그런 다음 안내서에서 시키는대로 google-services.json 파일을 다운받습니다. 

3. 세번째 단계에서 보이는 각각의 몇 줄의 소스를 생성한 앱 파일에 넣어야하는데 우선은 Firebase Analytics 앱부터 생성하겠습니다. 이후에 다시 돌아와서 합니다. 그런 다음에 "다음" 버튼을 누릅니다. 

4. 이전 단계에서 연동하도록 설정한 GA4 프로퍼티가 있다면, Firebase Analytics 앱이 GA4 의 해당 프로퍼티 이하에 스트림으로 들어가 있는 것을 확인하실 수 있습니다.

 

 

다시, Firebase 로 돌아가서 앱을 클릭합니다. 그런 다음에 톱니바퀴 모양을 클릭합니다. 

 

 

 

톱니바퀴 버튼을 클릭하여 들어간 화면에서 스크롤 다운하면 하기 화면을 볼 수 있습니다. "See SDK Instuctions" 을 클릭하여 3. Add Firebase SDK 화면을 확인합니다. 

 

 

해당 화면을 보면서, 다시, 본인의 앱을 만들었던 Android Studio 로 돌아갑니다. 

 

 

Android Studio 에서 좌측 최상단에 있는 것을 "Project Files"로 설정합니다. 

최상단 폴더를 root 라고 칭하겠습니다. root 바로 아래에 build.gradle.kts 가 있는데 이게 root-level 의 gradle 파일입니다. 띄워놨던 Firebase SDK 화면으로 돌아서 해당 라인을 복사한 후 하기와 같이 plugins 에 붙여 넣기 합니다.  

 

 

root 하위에는 app이라는 폴더가 있습니다. 해당 폴더에서도 동일한 build.gradle.kts 가 있습니다. 다시 띄워놨던 Firebase SDK 화면으로 돌아서 해당 라인을 복사한 후 하기와 같이 plugins 에 붙여 넣기 합니다.  

 

 

 

우리의 앱에 Firebase SDK 를 넣었으니, 이제 기본적인 데이터 수집이 가능합니다. 데이터가 잘 들어오는지 확인하기 위해서 하기 데이터 검증이 필요합니다. 

 


 

Firebase Analytics  데이터가 잘 들어오는지 확인하기

1. 맥북에서 adb 환경 설정 하기 

데이터가 잘 들어오는지 확인하기 위해서는 ADB 환경 설정이 필요합니다. 

맥북에서 ADB 환경 설정하는 방법 이 글을 참고해주세요 -> https://alcoholrithmhub.com/32 

 

맥북에서 adb 환경 설정 하기

맥북에서 ADB 환경 설정 가이드ADB 환경 설정은 한번 설정해 놓으면 더이상 필요하지 않지만, 새 노트북 설정이나 다른 이에게 가이드를 제공해야 하는 상황에서 참고할 수 있도록 정리했습니다.

alcoholrithmhub.com

2. 앱 실행하기 및 ADB 커맨드 입력하기

본인의 안드로이드 디바이스가 있다면 Wire와 연동해주세요. 디바이스가 없다면 에뮬레이터를 사용하여 앱을 실행할 수 있습니다. 

상단의 플레이버튼을 클릭하면 앱이 본인의 안드로이드 폰에서 실행될 것입니다. 그러면 하기 ADB command를 입력해주세요. 

adb shell setprop log.tag.FA VERBOSE 
adb shell setprop log.tag.FA-SVC VERBOSE
adb logcat -v time -s FA FA-SVC

* ADB란 무엇인가요?
ADB는 Android Debug Bridge의 약자로, 컴퓨터와 안드로이드 기기를 연결해 다양한 작업을 수행할 수 있게 도와주는 도구입니다. Firebase Analytics와 같은 도구를 사용할 때, 이벤트가 올바르게 기록되고 전송되는지 확인하려면 ADB를 통해 데이터를 직접 확인할 수 있습니다. 이는 앱 개발과 QA 프로세스에서 필수적인 부분입니다.

 

그러면 Firebase SDK를 설치함으로서 볼 수 있는 기본 이벤트와 파라미터를 다음과 같이 확인하실 수 있습니다. 

 

또한, Firebase 의 DebugView에서도 실시간으로 각 이벤트와 파라미터를 확인할 수 있습니다. DebugView에서 확인할 때에도를 입력해야만 데이터를 확인하실 수 있습니다. 

adb shell setprop log.tag.FA VERBOSE 
adb shell setprop log.tag.FA-SVC VERBOSE
adb logcat -v time -s FA FA-SVC

DebugView가 버그로 인해서 제대로 동작하지 않는 상황이 있습니다. 이 점 참고하시어 각 상황에 맞는 방법으로 데이터가 잘 들어오는지 확인할 수 있습니다. 

 

 

Firebase SDK를 통합하면 기본 이벤트 데이터를 자동으로 수집할 수 있습니다. 이를 통해 앱에서 발생하는 사용자 행동 데이터를 간단히 확인할 수 있습니다.

 


 

Firebase SDK로 자동 수집되는 기본 이벤트

Firebase SDK를 설치하고 나면 다음과 같은 이벤트가 자동으로 기록됩니다:

  1. 첫 실행(First Open): 사용자가 앱을 처음으로 실행한 시점.
  2. 세션 시작(Session Start): 사용자가 앱에서 활동을 시작한 시점.
  3. 화면 보기(Screen View): 사용자가 앱의 특정 화면을 방문한 이벤트.

이 데이터는 앱의 기본적인 사용자 활동을 분석하는 데 충분히 유용합니다.


 

추가 구현을 통한 확장 데이터

기본 데이터만으로는 사용자가 앱에서 구체적으로 어떤 행동을 했는지 파악하기 어렵습니다.
예를 들어:

  • 상품 조회 수: 특정 상품이나 카테고리를 얼마나 많이 보았는지.
  • 구매 데이터: 사용자가 어떤 상품을 구매했는지, 구매 금액은 얼마인지.

이와 같은 상세한 이벤트를 기록하려면 추가 구현이 필요합니다.

  • e-커머스 예시:
    • 상품 상세 페이지 조회 시 view_item 이벤트 추가.
    • 구매 완료 시 purchase 이벤트 추가.

 


 

추후 계획

이 글에서는 Firebase SDK를 설치함으로써 자동으로 수집되는 기본 데이터를 다뤘습니다.
상품 조회, 구매 데이터를 포함한 커스텀 이벤트 구현 방법은 추후 글에서 자세히 설명드리겠습니다.

Firebase Analytics를 통해 기본 데이터부터 확장 데이터까지 활용하면 앱의 사용자 경험을 최적화하고 성과를 극대화할 수 있습니다. 😊