요즘 앱 하나 만들면 끝이 아니잖아? 🤔
"우리 앱 사람들이 진짜 쓰긴 하는 건가?", "어디서 이탈하는 거지?", "이 기능은 왜 아무도 안 쓰지?"
이런 고민들, 개발자라면 한 번쯤 해봤을 거야.

바로 여기서 등장하는 게 모바일 분석(Mobile Analytics)이야!
특히 Firebase Analytics는 구글이 제공하는 무료 분석 도구로, 앱 개발자들 사이에서 진짜 핫한 툴이지.
오늘은 이 친구를 어떻게 활용해서 사용자 행동을 추적하고, 앱을 개선할 수 있는지 친구처럼 편하게 알려줄게! 😊

🎯 모바일 분석이 뭐길래 이렇게 중요할까?

솔직히 말해서, 앱 만들고 출시하는 건 시작일 뿐이야.
진짜 게임은 그 다음부터 시작되거든! 🎮

모바일 분석은 쉽게 말해서 "앱 안에서 사용자들이 뭘 하는지 몰래(?) 지켜보는 것"이야.
물론 합법적이고 윤리적인 방법으로 말이지! 😅

예를 들어볼게:
- 사용자가 앱을 열었을 때 가장 먼저 보는 화면은?
- 어떤 버튼을 가장 많이 클릭하나?
- 어느 단계에서 앱을 종료하나?
- 특정 기능을 사용하는 데 얼마나 시간이 걸리나?

이런 정보들이 쌓이면, 사용자가 원하는 게 뭔지, 불편한 게 뭔지 데이터로 알 수 있어.
그냥 "이럴 것 같은데?"라는 추측이 아니라, 팩트 기반의 확실한 인사이트를 얻는 거지! 💡

🔥 Firebase Analytics, 너는 누구냐?

Firebase Analytics는 구글이 제공하는 무료 앱 분석 플랫폼이야.
"무료"라는 말에 혹하지 않았어? 나도 처음엔 그랬어! 😂

근데 진짜 장점은 무료라는 것만이 아니야:

✨ Firebase Analytics의 핵심 장점들

1. 완전 무료 💰
월 사용량 제한 없이 무제한으로 이벤트를 추적할 수 있어.
다른 유료 분석 도구들은 사용자 수나 이벤트 수에 따라 과금되는데, Firebase는 그런 거 없어!

2. 실시간 데이터 ⚡
지금 이 순간 사용자들이 뭘 하고 있는지 실시간으로 볼 수 있어.
마치 CCTV 보듯이... 아니 그건 좀 무섭고, 대시보드로 깔끔하게 볼 수 있지! 📺

3. 다른 Firebase 서비스와 통합 🔗
Firebase Cloud Messaging, Remote Config, A/B Testing 등 다른 Firebase 기능들과 완벽하게 연동돼.
한 번 설정해두면 전체 생태계를 활용할 수 있다는 거지!

4. 자동 수집 이벤트 🤖
앱 설치, 첫 실행, 세션 시작 같은 기본적인 이벤트들은 자동으로 수집해줘.
개발자가 따로 코드 짤 필요 없이 말이야!

5. BigQuery 연동 📈
고급 분석이 필요하면 BigQuery로 원시 데이터를 내보낼 수 있어.
SQL 쿼리로 원하는 대로 데이터를 분석할 수 있다는 뜻이지!

🛠️ Firebase Analytics 시작하기: 설치부터 설정까지

자, 이제 본격적으로 Firebase Analytics를 내 앱에 적용해보자!
생각보다 어렵지 않으니까 걱정 마! 😊

📱 1단계: Firebase 프로젝트 생성

먼저 Firebase Console(console.firebase.google.com)에 접속해야 해.
구글 계정만 있으면 누구나 무료로 시작할 수 있어!

1. "프로젝트 추가" 버튼 클릭
2. 프로젝트 이름 입력 (예: "MyAwesomeApp")
3. Google Analytics 사용 설정 (기본적으로 체크되어 있음)
4. Analytics 계정 선택 또는 새로 생성
5. 프로젝트 생성 완료! 🎉

📲 2단계: 앱 등록하기

프로젝트를 만들었으면 이제 내 앱을 등록해야 해.
iOS 앱인지, Android 앱인지에 따라 과정이 조금 달라져.

Android 앱의 경우:
- Android 아이콘 클릭
- 패키지 이름 입력 (예: com.mycompany.myapp)
- 앱 닉네임 입력 (선택사항)
- google-services.json 파일 다운로드
- 이 파일을 앱의 app/ 디렉토리에 복사

iOS 앱의 경우:
- iOS 아이콘 클릭
- Bundle ID 입력
- 앱 닉네임 입력 (선택사항)
- GoogleService-Info.plist 파일 다운로드
- Xcode 프로젝트에 이 파일 추가

🔧 3단계: SDK 설치 및 초기화

이제 실제 코드 작업이 필요해. 하지만 걱정 마, 복잡하지 않아!

Android (Kotlin) 예제:

// build.gradle (프로젝트 레벨)
buildscript {
    dependencies {
        classpath 'com.google.gms:google-services:4.3.15'
    }
}

// build.gradle (앱 레벨)
plugins {
    id 'com.google.gms.google-services'
}

dependencies {
    implementation platform('com.google.firebase:firebase-bom:32.7.0')
    implementation 'com.google.firebase:firebase-analytics-ktx'
}

// MainActivity.kt
import com.google.firebase.analytics.FirebaseAnalytics
import com.google.firebase.analytics.ktx.analytics
import com.google.firebase.ktx.Firebase

class MainActivity : AppCompatActivity() {
    private lateinit var firebaseAnalytics: FirebaseAnalytics

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
        
        // Firebase Analytics 초기화
        firebaseAnalytics = Firebase.analytics
        
        // 이제 사용 준비 완료!
    }
}

iOS (Swift) 예제:

// Podfile
pod 'Firebase/Analytics'

// AppDelegate.swift
import Firebase

@main
class AppDelegate: UIResponder, UIApplicationDelegate {
    func application(_ application: UIApplication,
                    didFinishLaunchingWithOptions launchOptions: 
                    [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        
        // Firebase 초기화
        FirebaseApp.configure()
        
        return true
    }
}

// 어느 ViewController에서든 사용 가능
import FirebaseAnalytics

class ViewController: UIViewController {
    override func viewDidLoad() {
        super.viewDidLoad()
        
        // Analytics 사용 준비 완료!
    }
}

React Native 예제:

// 설치
npm install @react-native-firebase/app
npm install @react-native-firebase/analytics

// App.js
import analytics from '@react-native-firebase/analytics';

function App() {
  useEffect(() => {
    // 앱 시작 시 자동으로 초기화됨
    console.log('Firebase Analytics 준비 완료!');
  }, []);

  return (
    // 앱 컴포넌트
  );
}

Flutter 예제:

// pubspec.yaml
dependencies:
  firebase_core: ^2.24.2
  firebase_analytics: ^10.8.0

// main.dart
import 'package:firebase_core/firebase_core.dart';
import 'package:firebase_analytics/firebase_analytics.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp();
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  static FirebaseAnalytics analytics = FirebaseAnalytics.instance;
  
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      // 앱 설정
    );
  }
}

보다시피 플랫폼마다 조금씩 다르지만, 기본 개념은 같아:
1. Firebase SDK 추가
2. 초기화 코드 작성
3. Analytics 인스턴스 생성

이 세 단계만 거치면 기본 설정은 끝! 🎊

📝 이벤트 로깅: 사용자 행동 추적의 핵심

자, 이제 진짜 재미있는 부분이야! 🎪
이벤트 로깅은 "사용자가 이런 행동을 했어요!"라고 Firebase에게 알려주는 거야.

Firebase Analytics에는 크게 두 가지 종류의 이벤트가 있어:

1. 자동 수집 이벤트 (Automatically Collected Events)

이건 너가 아무것도 안 해도 Firebase가 알아서 수집해주는 이벤트들이야.
정말 편하지? 😎

주요 자동 수집 이벤트들:
- first_open: 앱을 처음 설치하고 실행했을 때
- session_start: 새로운 세션이 시작될 때
- screen_view: 새로운 화면을 볼 때
- app_update: 앱이 업데이트되었을 때
- app_remove: 앱이 삭제되었을 때 (Android만)
- os_update: OS가 업데이트되었을 때

이런 기본 이벤트들만으로도 꽤 많은 인사이트를 얻을 수 있어!

2. 커스텀 이벤트 (Custom Events)

이건 너가 직접 정의하고 로깅하는 이벤트야.
앱의 특성에 맞게 원하는 행동을 추적할 수 있지!

예를 들어 쇼핑 앱이라면:
- 상품 상세 페이지 조회
- 장바구니 추가
- 위시리스트 추가
- 검색 실행
- 필터 적용
- 리뷰 작성

이런 것들을 모두 이벤트로 만들 수 있어!

🎨 커스텀 이벤트 로깅 실전 예제

이제 실제 코드로 어떻게 이벤트를 로깅하는지 볼까?

Android (Kotlin) 예제:

// 기본 이벤트 로깅
firebaseAnalytics.logEvent("button_click") {
    param("button_name", "login_button")
    param("screen_name", "home_screen")
}

// 상품 조회 이벤트
firebaseAnalytics.logEvent("view_item") {
    param("item_id", "SKU_12345")
    param("item_name", "무선 이어폰")
    param("item_category", "전자제품")
    param("price", 89000.0)
}

// 구매 완료 이벤트 (추천 이벤트)
firebaseAnalytics.logEvent(FirebaseAnalytics.Event.PURCHASE) {
    param(FirebaseAnalytics.Param.TRANSACTION_ID, "T_12345")
    param(FirebaseAnalytics.Param.VALUE, 89000.0)
    param(FirebaseAnalytics.Param.CURRENCY, "KRW")
    param(FirebaseAnalytics.Param.ITEMS, bundleOf(
        "item_id" to "SKU_12345",
        "item_name" to "무선 이어폰",
        "quantity" to 1
    ))
}

// 검색 이벤트
firebaseAnalytics.logEvent(FirebaseAnalytics.Event.SEARCH) {
    param(FirebaseAnalytics.Param.SEARCH_TERM, "블루투스 이어폰")
}

// 레벨업 이벤트 (게임 앱)
firebaseAnalytics.logEvent(FirebaseAnalytics.Event.LEVEL_UP) {
    param(FirebaseAnalytics.Param.LEVEL, 5)
    param(FirebaseAnalytics.Param.CHARACTER, "전사")
}

iOS (Swift) 예제:

// 기본 이벤트 로깅
Analytics.logEvent("button_click", parameters: [
    "button_name": "login_button",
    "screen_name": "home_screen"
])

// 상품 조회 이벤트
Analytics.logEvent("view_item", parameters: [
    "item_id": "SKU_12345",
    "item_name": "무선 이어폰",
    "item_category": "전자제품",
    "price": 89000.0
])

// 구매 완료 이벤트
Analytics.logEvent(AnalyticsEventPurchase, parameters: [
    AnalyticsParameterTransactionID: "T_12345",
    AnalyticsParameterValue: 89000.0,
    AnalyticsParameterCurrency: "KRW",
    AnalyticsParameterItems: [
        [
            "item_id": "SKU_12345",
            "item_name": "무선 이어폰",
            "quantity": 1
        ]
    ]
])

// 공유 이벤트
Analytics.logEvent(AnalyticsEventShare, parameters: [
    AnalyticsParameterContentType: "product",
    AnalyticsParameterItemID: "SKU_12345",
    AnalyticsParameterMethod: "kakao"
])

React Native 예제:

import analytics from '@react-native-firebase/analytics';

// 기본 이벤트 로깅
await analytics().logEvent('button_click', {
  button_name: 'login_button',
  screen_name: 'home_screen',
});

// 상품 조회 이벤트
await analytics().logEvent('view_item', {
  item_id: 'SKU_12345',
  item_name: '무선 이어폰',
  item_category: '전자제품',
  price: 89000,
});

// 장바구니 추가
await analytics().logEvent('add_to_cart', {
  item_id: 'SKU_12345',
  item_name: '무선 이어폰',
  quantity: 1,
  price: 89000,
});

// 화면 조회 추적
await analytics().logScreenView({
  screen_name: 'ProductDetail',
  screen_class: 'ProductDetailScreen',
});

Flutter 예제:

import 'package:firebase_analytics/firebase_analytics.dart';

// 기본 이벤트 로깅
await FirebaseAnalytics.instance.logEvent(
  name: 'button_click',
  parameters: {
    'button_name': 'login_button',
    'screen_name': 'home_screen',
  },
);

// 상품 조회 이벤트
await FirebaseAnalytics.instance.logEvent(
  name: 'view_item',
  parameters: {
    'item_id': 'SKU_12345',
    'item_name': '무선 이어폰',
    'item_category': '전자제품',
    'price': 89000.0,
  },
);

// 구매 이벤트
await FirebaseAnalytics.instance.logPurchase(
  value: 89000.0,
  currency: 'KRW',
  parameters: {
    'transaction_id': 'T_12345',
    'items': [
      {
        'item_id': 'SKU_12345',
        'item_name': '무선 이어폰',
        'quantity': 1,
      }
    ],
  },
);

// 화면 추적
await FirebaseAnalytics.instance.logScreenView(
  screenName: 'ProductDetail',
  screenClass: 'ProductDetailScreen',
);

🎯 추천 이벤트 (Recommended Events) 활용하기

Firebase는 일반적으로 많이 사용되는 이벤트들을 "추천 이벤트"로 미리 정의해놨어.
이걸 사용하면 좋은 점이 뭐냐고?

1. 자동 리포트 생성: Firebase Console에서 자동으로 예쁜 리포트를 만들어줘
2. Google Ads 연동: 광고 캠페인 최적화에 바로 활용 가능
3. 표준화: 업계 표준을 따르니까 다른 도구와 비교하기 쉬워

주요 추천 이벤트들을 카테고리별로 정리해볼게! 📋

💡 추천 이벤트 사용 예제

실제로 어떻게 사용하는지 쇼핑 앱 시나리오로 예를 들어볼게:

// 사용자가 상품 목록에서 상품을 클릭했을 때
firebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_CONTENT) {
    param(FirebaseAnalytics.Param.CONTENT_TYPE, "product")
    param(FirebaseAnalytics.Param.ITEM_ID, "SKU_12345")
}

// 상품 상세 페이지 진입
firebaseAnalytics.logEvent(FirebaseAnalytics.Event.VIEW_ITEM) {
    param(FirebaseAnalytics.Param.ITEM_ID, "SKU_12345")
    param(FirebaseAnalytics.Param.ITEM_NAME, "무선 이어폰")
    param(FirebaseAnalytics.Param.ITEM_CATEGORY, "전자제품")
    param(FirebaseAnalytics.Param.PRICE, 89000.0)
}

// 장바구니에 추가
firebaseAnalytics.logEvent(FirebaseAnalytics.Event.ADD_TO_CART) {
    param(FirebaseAnalytics.Param.ITEM_ID, "SKU_12345")
    param(FirebaseAnalytics.Param.ITEM_NAME, "무선 이어폰")
    param(FirebaseAnalytics.Param.QUANTITY, 1)
    param(FirebaseAnalytics.Param.VALUE, 89000.0)
    param(FirebaseAnalytics.Param.CURRENCY, "KRW")
}

// 결제 시작
firebaseAnalytics.logEvent(FirebaseAnalytics.Event.BEGIN_CHECKOUT) {
    param(FirebaseAnalytics.Param.VALUE, 89000.0)
    param(FirebaseAnalytics.Param.CURRENCY, "KRW")
    param(FirebaseAnalytics.Param.ITEMS, bundleOf(
        "item_id" to "SKU_12345",
        "item_name" to "무선 이어폰",
        "quantity" to 1
    ))
}

// 결제 정보 입력
firebaseAnalytics.logEvent(FirebaseAnalytics.Event.ADD_PAYMENT_INFO) {
    param(FirebaseAnalytics.Param.PAYMENT_TYPE, "credit_card")
}

// 구매 완료!
firebaseAnalytics.logEvent(FirebaseAnalytics.Event.PURCHASE) {
    param(FirebaseAnalytics.Param.TRANSACTION_ID, "T_${System.currentTimeMillis()}")
    param(FirebaseAnalytics.Param.VALUE, 89000.0)
    param(FirebaseAnalytics.Param.CURRENCY, "KRW")
    param(FirebaseAnalytics.Param.TAX, 8900.0)
    param(FirebaseAnalytics.Param.SHIPPING, 3000.0)
    param(FirebaseAnalytics.Param.ITEMS, bundleOf(
        "item_id" to "SKU_12345",
        "item_name" to "무선 이어폰",
        "quantity" to 1,
        "price" to 89000.0
    ))
}

이렇게 사용자의 구매 여정(Customer Journey)을 단계별로 추적하면,
어느 단계에서 이탈이 많이 발생하는지 정확히 알 수 있어! 🎯

👤 사용자 속성 (User Properties) 설정하기

이벤트가 "사용자가 뭘 했는지"를 추적한다면,
사용자 속성은 "사용자가 누구인지"를 정의하는 거야.

예를 들어:
- 나이대: 20대, 30대, 40대...
- 성별: 남성, 여성, 기타
- 관심사: 패션, 전자제품, 스포츠...
- 회원 등급: 일반, VIP, VVIP
- 선호 언어: 한국어, 영어, 일본어...

이런 속성들을 설정해두면, 나중에 분석할 때 엄청 유용해!
"30대 여성 VIP 회원들은 어떤 상품을 많이 보나?" 같은 세그먼트 분석이 가능하거든. 📊

🔧 사용자 속성 설정 예제

// Android (Kotlin)
firebaseAnalytics.setUserProperty("age_group", "30s")
firebaseAnalytics.setUserProperty("gender", "female")
firebaseAnalytics.setUserProperty("membership_level", "vip")
firebaseAnalytics.setUserProperty("favorite_category", "fashion")
firebaseAnalytics.setUserProperty("preferred_language", "ko")

// iOS (Swift)
Analytics.setUserProperty("30s", forName: "age_group")
Analytics.setUserProperty("female", forName: "gender")
Analytics.setUserProperty("vip", forName: "membership_level")

// React Native
await analytics().setUserProperty('age_group', '30s');
await analytics().setUserProperty('gender', 'female');
await analytics().setUserProperty('membership_level', 'vip');

// Flutter
await FirebaseAnalytics.instance.setUserProperty(
  name: 'age_group',
  value: '30s',
);
await FirebaseAnalytics.instance.setUserProperty(
  name: 'membership_level',
  value: 'vip',
);

사용자 ID 설정하기

로그인한 사용자의 경우, 고유 ID를 설정할 수도 있어.
이렇게 하면 같은 사용자가 여러 기기에서 접속해도 하나의 사용자로 추적할 수 있지!

// Android (Kotlin)
firebaseAnalytics.setUserId("user_12345")

// iOS (Swift)
Analytics.setUserID("user_12345")

// React Native
await analytics().setUserId('user_12345');

// Flutter
await FirebaseAnalytics.instance.setUserId(id: 'user_12345');

📊 Firebase Console에서 데이터 분석하기

자, 이제 열심히 이벤트를 로깅했으니 데이터를 확인해볼 차례야! 🎉
Firebase Console은 정말 직관적이고 사용하기 쉬워.

🔥 실시간 대시보드 (DebugView)

개발 중에는 DebugView를 사용하면 진짜 편해!
실시간으로 이벤트가 찍히는 걸 볼 수 있거든.

DebugView 활성화 방법:

Android:

// 터미널에서 실행
adb shell setprop debug.firebase.analytics.app [패키지명]

// 예시
adb shell setprop debug.firebase.analytics.app com.mycompany.myapp

// 비활성화
adb shell setprop debug.firebase.analytics.app .none.

iOS:

// Xcode에서 Edit Scheme > Run > Arguments
// Arguments Passed On Launch에 추가:
-FIRDebugEnabled

// 비활성화하려면:
-FIRDebugDisabled

이렇게 설정하고 앱을 실행하면, Firebase Console의 DebugView 메뉴에서
실시간으로 이벤트가 찍히는 걸 볼 수 있어! 마치 로그를 보는 것처럼 말이야. 👀

📈 주요 리포트 메뉴 살펴보기

1. 이벤트 (Events)

여기서는 모든 이벤트의 발생 횟수를 볼 수 있어.
- 지난 30분, 24시간, 7일, 30일 단위로 필터링 가능
- 각 이벤트를 클릭하면 상세 정보 확인
- 파라미터별 분포도 확인 가능

예를 들어 "add_to_cart" 이벤트를 클릭하면:
- 총 몇 번 발생했는지
- 어떤 상품이 가장 많이 담겼는지
- 시간대별 추이는 어떤지
이런 정보들을 한눈에 볼 수 있지! 📊

2. 전환 (Conversions)

특정 이벤트를 "전환 이벤트"로 표시할 수 있어.
예를 들어 "purchase", "sign_up" 같은 중요한 이벤트들 말이야.

전환 이벤트로 표시하면:
- 대시보드 상단에 별도로 표시됨
- Google Ads와 자동 연동됨
- 전환율 추적이 쉬워짐

3. 잠재고객 (Audiences)

이건 진짜 강력한 기능이야! 🚀
특정 조건을 만족하는 사용자 그룹을 만들 수 있어.

예를 들어:
- "지난 7일간 3번 이상 구매한 사용자"
- "장바구니에 담았지만 구매하지 않은 사용자"
- "튜토리얼을 완료하지 않은 신규 사용자"

이렇게 만든 잠재고객은:
- Firebase Cloud Messaging으로 푸시 알림 발송
- Remote Config로 다른 설정 적용
- Google Ads로 리타게팅 광고
이런 것들이 가능해져! 🎯

4. 퍼널 분석 (Funnel Analysis)

사용자의 여정을 단계별로 추적할 수 있어.
예를 들어 쇼핑 앱의 구매 퍼널:

5. 경로 분석 (Path Analysis)

사용자들이 앱 안에서 어떤 경로로 이동하는지 시각화해줘.
마치 지도를 보는 것처럼 말이야! 🗺️

예를 들어:
- 홈 화면 → 검색 → 상품 상세 → 장바구니 → 결제
- 홈 화면 → 카테고리 → 상품 목록 → 상품 상세 → 뒤로가기

이런 패턴들을 분석하면:
- 사용자들이 선호하는 동선 파악
- 불필요한 단계 제거
- UI/UX 개선 포인트 발견
이런 게 가능해져!

6. 코호트 분석 (Cohort Analysis)

같은 시기에 앱을 설치한 사용자 그룹의 행동을 추적하는 거야.
예를 들어 "1월에 가입한 사용자들"의 리텐션(재방문율)을 볼 수 있지.

이걸로 알 수 있는 것들:
- 신규 사용자의 정착률
- 업데이트 전후 비교
- 마케팅 캠페인 효과
- 시즌별 사용자 행동 차이

🎨 고급 활용: BigQuery 연동하기

Firebase Console의 기본 리포트로는 부족하다면?
BigQuery와 연동해서 원시 데이터를 직접 분석할 수 있어! 🚀

BigQuery는 구글의 클라우드 데이터 웨어하우스인데,
SQL 쿼리로 엄청나게 큰 데이터도 빠르게 분석할 수 있어.

🔗 BigQuery 연동 방법

1. Firebase Console → 프로젝트 설정
2. 통합 탭 → BigQuery
3. "BigQuery에 연결" 클릭
4. 데이터 스트리밍 옵션 선택
- 일일 내보내기: 매일 한 번 데이터 전송 (무료)
- 스트리밍: 실시간 데이터 전송 (유료)
5. 연결 완료!

연동하면 Firebase 데이터가 자동으로 BigQuery 테이블로 들어가.
테이블 구조는 이렇게 생겼어:

-- 테이블명: analytics_[프로젝트ID].events_[날짜]
-- 예시: analytics_12345.events_20240115

SELECT
  event_name,
  COUNT(*) as event_count,
  COUNT(DISTINCT user_pseudo_id) as unique_users
FROM `analytics_12345.events_20240115`
WHERE event_name = 'purchase'
GROUP BY event_name;

💡 유용한 BigQuery 쿼리 예제들

1. 일별 활성 사용자 수 (DAU)

SELECT
  event_date,
  COUNT(DISTINCT user_pseudo_id) as dau
FROM `analytics_12345.events_*`
WHERE _TABLE_SUFFIX BETWEEN '20240101' AND '20240131'
GROUP BY event_date
ORDER BY event_date;

2. 상품별 구매 횟수 및 매출

SELECT
  (SELECT value.string_value FROM UNNEST(event_params) 
   WHERE key = 'item_name') as product_name,
  COUNT(*) as purchase_count,
  SUM((SELECT value.double_value FROM UNNEST(event_params) 
       WHERE key = 'value')) as total_revenue
FROM `analytics_12345.events_*`
WHERE event_name = 'purchase'
  AND _TABLE_SUFFIX BETWEEN '20240101' AND '20240131'
GROUP BY product_name
ORDER BY total_revenue DESC
LIMIT 10;

3. 사용자별 세션 길이 분석

WITH session_data AS (
  SELECT
    user_pseudo_id,
    (SELECT value.int_value FROM UNNEST(event_params) 
     WHERE key = 'engagement_time_msec') / 1000 as session_duration_sec
  FROM `analytics_12345.events_*`
  WHERE event_name = 'user_engagement'
    AND _TABLE_SUFFIX = FORMAT_DATE('%Y%m%d', CURRENT_DATE())
)
SELECT
  CASE
    WHEN session_duration_sec < 30 THEN '0-30초'
    WHEN session_duration_sec < 60 THEN '30-60초'
    WHEN session_duration_sec < 180 THEN '1-3분'
    WHEN session_duration_sec < 300 THEN '3-5분'
    ELSE '5분 이상'
  END as duration_range,
  COUNT(*) as user_count
FROM session_data
GROUP BY duration_range
ORDER BY 
  CASE duration_range
    WHEN '0-30초' THEN 1
    WHEN '30-60초' THEN 2
    WHEN '1-3분' THEN 3
    WHEN '3-5분' THEN 4
    ELSE 5
  END;

4. 퍼널 전환율 계산

WITH funnel_events AS (
  SELECT
    user_pseudo_id,
    MAX(CASE WHEN event_name = 'view_item' THEN 1 ELSE 0 END) as viewed,
    MAX(CASE WHEN event_name = 'add_to_cart' THEN 1 ELSE 0 END) as added_cart,
    MAX(CASE WHEN event_name = 'begin_checkout' THEN 1 ELSE 0 END) as started_checkout,
    MAX(CASE WHEN event_name = 'purchase' THEN 1 ELSE 0 END) as purchased
  FROM `analytics_12345.events_*`
  WHERE _TABLE_SUFFIX = FORMAT_DATE('%Y%m%d', CURRENT_DATE())
  GROUP BY user_pseudo_id
)
SELECT
  SUM(viewed) as step1_view,
  SUM(added_cart) as step2_cart,
  SUM(started_checkout) as step3_checkout,
  SUM(purchased) as step4_purchase,
  ROUND(SUM(added_cart) / SUM(viewed) * 100, 2) as conversion_1_to_2,
  ROUND(SUM(started_checkout) / SUM(added_cart) * 100, 2) as conversion_2_to_3,
  ROUND(SUM(purchased) / SUM(started_checkout) * 100, 2) as conversion_3_to_4,
  ROUND(SUM(purchased) / SUM(viewed) * 100, 2) as overall_conversion
FROM funnel_events;

BigQuery를 사용하면 Firebase Console에서는 불가능한
복잡한 분석도 자유자유롭게 할 수 있어! 💪

🔒 개인정보 보호와 데이터 보안

데이터 분석도 중요하지만, 사용자의 개인정보 보호는 더 중요해! 🛡️
특히 요즘은 GDPR, CCPA 같은 개인정보 보호 법규가 엄격하거든.

⚖️ 준수해야 할 주요 원칙들

1. 개인식별정보(PII) 수집 금지

절대로 수집하면 안 되는 것들:
- 이메일 주소
- 전화번호
- 주민등록번호
- 신용카드 번호
- 실명
- 정확한 위치 정보 (GPS 좌표)

대신 이렇게 해:
- 사용자 ID는 내부 고유 ID 사용
- 위치는 도시 수준으로만 (예: "서울", "부산")
- 나이는 범위로 (예: "20-29세")

2. 데이터 수집 동의 받기

앱 첫 실행 시 사용자에게 명확하게 알려야 해:

// Android 예시
val dialog = AlertDialog.Builder(this)
    .setTitle("데이터 수집 동의")
    .setMessage("""
        앱 개선을 위해 다음 정보를 수집합니다:
        - 앱 사용 패턴
        - 기기 정보 (모델, OS 버전)
        - 대략적인 위치 (도시 수준)
        
        개인식별정보는 수집하지 않습니다.
        동의하시겠습니까?
    """.trimIndent())
    .setPositiveButton("동의") { _, _ ->
        // Analytics 활성화
        firebaseAnalytics.setAnalyticsCollectionEnabled(true)
    }
    .setNegativeButton("거부") { _, _ ->
        // Analytics 비활성화
        firebaseAnalytics.setAnalyticsCollectionEnabled(false)
    }
    .show()

3. 데이터 수집 비활성화 옵션 제공

사용자가 언제든 데이터 수집을 거부할 수 있어야 해:

// 설정 화면에서
fun disableAnalytics() {
    firebaseAnalytics.setAnalyticsCollectionEnabled(false)
    // 사용자 속성도 초기화
    firebaseAnalytics.resetAnalyticsData()
}

// iOS
Analytics.setAnalyticsCollectionEnabled(false)
Analytics.resetAnalyticsData()

// React Native
await analytics().setAnalyticsCollectionEnabled(false);

// Flutter
await FirebaseAnalytics.instance.setAnalyticsCollectionEnabled(false);

4. 데이터 보관 기간 설정

Firebase Console에서 데이터 보관 기간을 설정할 수 있어:
- 프로젝트 설정 → 데이터 설정
- 사용자 데이터 보관: 2개월 또는 14개월 선택
- 이벤트 데이터 보관: 2개월 또는 14개월 선택

법적으로 필요한 기간만 보관하는 게 좋아!

5. 어린이 대상 앱의 특별 규정

13세 미만 어린이 대상 앱이라면:
- COPPA (미국 아동 온라인 개인정보 보호법) 준수
- 맞춤 광고 비활성화
- 리마케팅 비활성화
- 특정 Analytics 기능 제한

// 어린이 대상 앱 설정
firebaseAnalytics.setUserProperty("allow_personalized_ads", "false")

// iOS
Analytics.setUserProperty("false", forName: "allow_personalized_ads")

🚀 실전 활용 사례: 앱 개선 프로젝트

이론은 충분히 배웠으니, 이제 실제로 어떻게 활용하는지 사례를 볼까?
가상의 음식 배달 앱 "맛있다"를 예로 들어볼게! 🍕

📱 사례: "맛있다" 앱의 주문 완료율 개선 프로젝트

문제 상황:
- 앱 다운로드는 많은데 실제 주문은 적음
- 주문 완료율이 업계 평균보다 낮음
- 어디가 문제인지 모르겠음 😰

1단계: 현황 파악

먼저 Firebase Analytics로 퍼널을 분석했어:

2단계: 원인 분석

해당 단계에서 어떤 일이 일어나는지 자세히 추적했어:

// 주문하기 버튼 클릭 시
firebaseAnalytics.logEvent("order_button_click") {
    param("cart_value", cartTotal)
    param("item_count", itemCount)
    param("restaurant_id", restaurantId)
}

// 결제 화면 진입 시
firebaseAnalytics.logEvent("payment_screen_view") {
    param("load_time_ms", loadTime)
}

// 결제 정보 입력 시작
firebaseAnalytics.logEvent("payment_info_start") {
    param("payment_method", paymentMethod)
}

// 결제 화면 이탈 시
firebaseAnalytics.logEvent("payment_screen_exit") {
    param("time_spent_sec", timeSpent)
    param("info_completed", isCompleted)
}

데이터를 분석한 결과:
- 결제 화면 로딩 시간이 평균 4.2초 (너무 느림!)
- 사용자의 68%가 30초 이내에 이탈
- 카드 정보 입력 폼이 복잡함 (15개 필드)
- 모바일 키보드 때문에 화면이 가려짐

3단계: 개선 실행

문제를 파악했으니 이제 개선할 차례!

개선 1 결제 화면 로딩 최적화
- 이미지 압축 및 lazy loading
- 불필요한 API 호출 제거
- 로딩 시간 4.2초 → 1.8초로 단축 ⚡

개선 2 간편 결제 옵션 추가
- 카카오페이, 네이버페이, 토스 연동
- 원클릭 결제 가능
- 카드 정보 입력 필드 15개 → 3개로 축소

개선 3 UI/UX 개선
- 키보드 올라올 때 화면 자동 스크롤
- 입력 필드 크기 확대
- 실시간 유효성 검사 추가

4단계: A/B 테스팅

개선된 버전을 바로 전체 배포하지 않고,
Firebase Remote Config와 A/B Testing을 활용했어:

// Remote Config로 기능 플래그 설정
val remoteConfig = Firebase.remoteConfig
remoteConfig.fetchAndActivate().addOnCompleteListener {
    val useNewPaymentFlow = remoteConfig.getBoolean("new_payment_flow")
    
    if (useNewPaymentFlow) {
        // 새로운 결제 화면
        showNewPaymentScreen()
    } else {
        // 기존 결제 화면
        showOldPaymentScreen()
    }
}

사용자의 50%에게만 새 버전을 보여주고,
나머지 50%는 기존 버전을 유지했어.

2주간 테스트한 결과:

5단계: 전체 배포 및 모니터링

A/B 테스트 결과가 좋으니까 전체 사용자에게 배포!
그리고 계속 모니터링하면서 추가 개선점을 찾았어.

// 개선 후 추가 이벤트 로깅
firebaseAnalytics.logEvent("simple_payment_used") {
    param("payment_provider", provider) // kakao, naver, toss
    param("completion_time_sec", completionTime)
}

firebaseAnalytics.logEvent("payment_error") {
    param("error_type", errorType)
    param("error_message", errorMessage)
    param("payment_provider", provider)
}

최종 결과:

프로젝트 시작 3개월 후:
- 전체 주문 완료율: 9.5% → 14.2% (49% 증가!)
- 월 주문 건수: 28,500건 → 42,300건
- 사용자 만족도: 3.2점 → 4.1점 (5점 만점)
- 앱 리뷰 평점: 3.8점 → 4.5점

데이터 기반으로 문제를 정확히 파악하고 개선한 결과,
비즈니스 성과도 크게 향상됐어! 🚀

🛠️ 실무에서 자주 하는 실수와 해결법

Firebase Analytics를 처음 사용하면 누구나 실수를 해.
나도 처음엔 많이 헤맸거든! 😅
자주 하는 실수들과 해결법을 정리해봤어.

❌ 실수 1: 너무 많은 이벤트 로깅

문제:
모든 버튼 클릭, 모든 화면 전환을 다 로깅하려고 해.
결과적으로 이벤트가 500개를 넘어서 일부가 무시됨.

해결:
- 비즈니스 목표와 관련된 중요한 이벤트만 로깅
- 비슷한 이벤트는 하나로 통합하고 파라미터로 구분
- 예: "button_click_login", "button_click_signup" → "button_click" (type: "login")

❌ 실수 2: 개발/테스트 데이터 혼입

문제:
개발자들의 테스트 데이터가 실제 사용자 데이터와 섞임.
분석 결과가 왜곡됨.

해결:
- 개발용 Firebase 프로젝트 별도 생성
- 프로덕션 빌드에서만 Analytics 활성화
- 내부 테스터 IP 필터링

// 디버그 빌드에서는 Analytics 비활성화
if (BuildConfig.DEBUG) {
    firebaseAnalytics.setAnalyticsCollectionEnabled(false)
}

// 또는 사용자 속성으로 구분
if (isInternalTester) {
    firebaseAnalytics.setUserProperty("user_type", "internal_tester")
}

❌ 실수 3: 이벤트 이름 일관성 부족

문제:
- "userLogin", "user_login", "UserLogin" 등 제각각
- 나중에 분석할 때 헷갈림

해결:
- 이벤트 이름 규칙 문서화
- 상수로 정의해서 사용

// 이벤트 이름 상수 정의
object AnalyticsEvents {
    const val USER_LOGIN = "user_login"
    const val USER_SIGNUP = "user_signup"
    const val PRODUCT_VIEW = "product_view"
    const val PRODUCT_PURCHASE = "product_purchase"
    const val CART_ADD = "cart_add"
    const val CART_REMOVE = "cart_remove"
}

object AnalyticsParams {
    const val ITEM_ID = "item_id"
    const val ITEM_NAME = "item_name"
    const val ITEM_CATEGORY = "item_category"
    const val VALUE = "value"
    const val CURRENCY = "currency"
}

// 사용
firebaseAnalytics.logEvent(AnalyticsEvents.PRODUCT_VIEW) {
    param(AnalyticsParams.ITEM_ID, productId)
    param(AnalyticsParams.ITEM_NAME, productName)
}

❌ 실수 4: 파라미터 값 타입 불일치

문제:
같은 파라미터인데 어떨 때는 문자열, 어떨 때는 숫자로 전송.
BigQuery에서 분석할 때 타입 에러 발생.

해결:
- 파라미터 타입을 명확히 정의
- 헬퍼 함수 사용

// 헬퍼 함수 정의
fun logProductView(productId: String, productName: String, price: Double) {
    firebaseAnalytics.logEvent(AnalyticsEvents.PRODUCT_VIEW) {
        param(AnalyticsParams.ITEM_ID, productId)
        param(AnalyticsParams.ITEM_NAME, productName)
        param(AnalyticsParams.VALUE, price) // 항상 Double
        param(AnalyticsParams.CURRENCY, "KRW") // 항상 String
    }
}

// 사용
logProductView("SKU_123", "무선 이어폰", 89000.0)

❌ 실수 5: 네트워크 상태 미고려

문제:
오프라인 상태에서 발생한 이벤트가 손실됨.

해결:
Firebase Analytics는 자동으로 오프라인 이벤트를 큐에 저장하고
온라인 상태가 되면 전송해줘. 하지만 앱이 강제 종료되면 손실될 수 있으니
중요한 이벤트는 로컬 DB에도 저장하는 게 좋아.

❌ 실수 6: 화면 추적 누락

문제:
일부 화면에서만 screen_view 이벤트를 로깅해서
사용자 흐름 분석이 불완전함.

해결:
- Base Activity/Fragment에서 자동으로 로깅

// Android
abstract class BaseActivity : AppCompatActivity() {
    protected lateinit var firebaseAnalytics: FirebaseAnalytics
    
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        firebaseAnalytics = Firebase.analytics
        
        // 화면 이름 자동 로깅
        firebaseAnalytics.logEvent(FirebaseAnalytics.Event.SCREEN_VIEW) {
            param(FirebaseAnalytics.Param.SCREEN_NAME, this::class.simpleName ?: "Unknown")
            param(FirebaseAnalytics.Param.SCREEN_CLASS, this::class.java.name)
        }
    }
}

// iOS
class BaseViewController: UIViewController {
    override func viewDidAppear(_ animated: Bool) {
        super.viewDidAppear(animated)
        
        Analytics.logEvent(AnalyticsEventScreenView, parameters: [
            AnalyticsParameterScreenName: String(describing: type(of: self)),
            AnalyticsParameterScreenClass: String(describing: type(of: self))
        ])
    }
}

🎓 더 배우고 싶다면?

Firebase Analytics는 정말 방대한 주제야.
이 글에서 다룬 내용은 기초부터 중급까지인데,
더 깊이 있게 배우고 싶다면 이런 것들을 공부해봐! 📚

🚀 다음 단계 학습 주제들

1. Google Analytics 4 (GA4) 연동
Firebase Analytics는 사실 GA4의 모바일 버전이야.
웹과 앱 데이터를 통합해서 분석할 수 있어.

2. Crashlytics와 연동
앱 크래시 발생 시 어떤 이벤트 흐름에서 발생했는지 추적.
버그 수정 우선순위 결정에 도움이 돼.

3. Performance Monitoring
앱 성능 지표(로딩 시간, API 응답 시간 등)를 Analytics와 함께 분석.

4. Predictions (예측)
머신러닝으로 사용자 행동 예측.
"이 사용자가 7일 내에 구매할 확률은 85%"
이런 걸 자동으로 계산해줘!

5. Cloud Functions 연동
특정 이벤트 발생 시 서버 로직 자동 실행.
예: 고액 구매 시 자동으로 VIP 등급 업그레이드

6. Data Studio 리포팅
BigQuery 데이터를 Google Data Studio로 시각화.
경영진에게 보고할 멋진 대시보드 제작!

7. 고급 세그먼테이션
복잡한 조건의 사용자 그룹 생성 및 분석.
예: "지난 30일간 3회 이상 구매했지만 최근 7일간 접속 안 한 사용자"

🎬 마무리하며

와, 여기까지 읽었다면 정말 대단해! 👏
Firebase Analytics에 대해 꽤 많은 걸 배웠을 거야.

핵심만 다시 정리해볼게:

🎯 기억해야 할 핵심 포인트

1. 데이터는 거짓말하지 않는다
추측이 아닌 팩트 기반으로 의사결정을 해야 해.
Firebase Analytics는 그 팩트를 제공해주는 도구야.

2. 작게 시작하고 점진적으로 확장
처음부터 모든 걸 추적하려고 하지 마.
핵심 이벤트부터 시작해서 필요에 따라 추가해.

3. 사용자 개인정보는 신성불가침
아무리 좋은 데이터라도 개인정보 보호를 위반하면 안 돼.
법적 문제뿐만 아니라 사용자 신뢰를 잃게 돼.

4. 분석은 수단이지 목적이 아니다
데이터를 보는 것 자체가 목표가 아니야.
인사이트를 도출하고 실제로 개선하는 게 중요해.

5. 지속적인 학습과 개선
Firebase Analytics는 계속 업데이트되고 새 기능이 추가돼.
꾸준히 공부하고 실험하면서 성장해야 해.

🚀 이제 시작이야!

이 글을 읽은 것만으로는 아무것도 변하지 않아.
중요한 건 실제로 적용해보는 것이야! 💪

오늘 당장 할 수 있는 것들:
1. Firebase 프로젝트 생성하기
2. 내 앱에 Firebase SDK 추가하기
3. 첫 번째 커스텀 이벤트 로깅하기
4. Firebase Console에서 실시간으로 확인하기

작은 것부터 시작해봐.
그리고 점점 더 복잡한 분석으로 나아가면 돼.

데이터 분석이 처음엔 어렵고 막막할 수 있어.
하지만 한 번 익숙해지면, 데이터 없이는
앱 개발을 할 수 없을 정도로 중요한 도구가 될 거야! 📊

행운을 빌어! 🍀

그리고 궁금한 게 있거나 막히는 부분이 있으면,
Firebase 공식 문서나 커뮤니티를 활용해봐.
또는 재능넷에서 경험 많은 개발자들에게 조언을 구하는 것도 좋은 방법이야!

자, 이제 나가서 멋진 앱을 만들고,
데이터로 사용자들을 행복하게 만들어봐! 🎉

Happy Coding! 💻✨