# Firebase 연동 검증

DebugView, 실시간 보고서, 이벤트 보고서로 Firebase Analytics 이벤트 수집 상태를 검증하는 절차.

- 카테고리: Firebase
- 소요 시간: 약 6분
- 난이도: 중간
- 업데이트: 2026.06.16
- 원문: /wiki/playbook/firebase-checklist/how-to-verify-firebase-integration

## 목차

- [이 문서의 목적](#purpose)
- [1단계 · DebugView 준비](#step-1)
- [2단계 · 이벤트/속성 확인](#step-2)
- [3단계 · 실시간 보고서 확인](#step-3)
- [4단계 · 이벤트 보고서 확인](#step-4)
- [5단계 · 안 보일 때 점검](#step-5)
- [참고 링크](#references)
- [자주 묻는 질문](#faq)

이 문서는 Firebase Analytics 이벤트와 User Property가 실제로 수집되는지 확인하는 절차를 다룹니다. 개발 중에는**DebugView**로 즉시 확인하고, 일반 기기 도착 여부는 **실시간 보고서**에서 확인합니다. 운영 보고서는 처리 시간이 지난 뒤 **이벤트 보고서**와 맞춤 측정기준에서 확인합니다.

> **이 문서 핵심**
>
> - SDK 초기화와 이벤트 전송 코드가 먼저 적용되어 있어야 합니다.
>
> - 디버그 기기, 일반 기기, GA4 보고서에서 같은 이벤트명을 순서대로 확인합니다.
>
> - 이벤트 이름과 파라미터가 의도대로 들어오는지 고객/개발팀이 같은 기준으로 확인할 수 있습니다.

## 1단계. DebugView 확인 준비

DebugView는 디버그 모드를 켠 기기의 이벤트를 거의 실시간으로 보여 줍니다. 앱을 실행하기 전에 먼저 테스트 기기를 디버그 모드로 전환합니다.

**Android · DebugView 모드 켜기/끄기**
```bash
# 켜기
adb shell setprop debug.firebase.analytics.app <application_id>

# 끄기
adb shell setprop debug.firebase.analytics.app .none.
```

**iOS · Xcode Scheme Run Arguments**
```text
-FIRDebugEnabled
```

그다음 GA4 콘솔에서 관리 → DebugView로 이동하고, 상단 기기 선택 영역에서 테스트 기기가 선택되어 있는지 확인합니다.

![Firebase Analytics DebugView 화면. 디버그 기기 타임라인과 인기 이벤트 영역에서 screen_view, first_open, session_start 같은 이벤트 수집을 확인하는 예시.](/wiki-assets/playbook/how-to-verify-firebase-integration/01-debugview-timeline.png)

> **화면 1.** DebugView에서 디버그 기기와 이벤트 타임라인을 먼저 확인합니다.

![iOS 디버그 기기의 Firebase Analytics DebugView 예시. -FIRDebugEnabled 실행 인수로 수집된 이벤트가 DebugView 타임라인과 인기 이벤트 패널에 표시된다.](/wiki-assets/playbook/how-to-verify-firebase-integration/02-ios-debugview.png)

> **화면 2.** iOS는 `-FIRDebugEnabled` 실행 인수로 DebugView 수집을 확인합니다.

## 2단계. 이벤트 이름, 파라미터, User Property 확인

앱에서 테스트 행동을 수행한 뒤 DebugView 타임라인에서 이벤트를 클릭합니다. 이벤트 이름뿐 아니라 주요 파라미터가 같이 들어오는지 확인해야 합니다. 사용자 상태값을 설정했다면 오른쪽의 현재 적용된 사용자 속성 영역도 함께 봅니다.

| 테스트 행동 | 확인 이벤트 | 확인 파라미터 |
| --- | --- | --- |
| 로그인 | `login` | `method` |
| 회원가입 | `sign_up` | `method` |
| 검색 | `search` | `search_term` |
| 콘텐츠 선택 | `select_content` | `content_type`, `item_id` |
| 사용자 상태 설정 | 최근 발생 이벤트와 함께 확인 | `membership_level`, `login_status`, `user_type` |
| 커스텀 행동 | 정의한 커스텀 이벤트 | 정의한 커스텀 파라미터 |

> **주의**
>
> DebugView에 이벤트는 보이는데 파라미터가 없으면, 코드에서 파라미터를 넘기지 않았거나 타입이 맞지 않을 수 있습니다. Android/iOS에서 같은 키 이름으로 보내고 있는지 먼저 확인합니다.

> **정보**
>
> User Property는 값만 설정하고 끝내지 말고, 설정 이후 테스트 이벤트를 한 번 발생시켜 DebugView의 현재 적용된 사용자 속성 영역에서 값이 붙었는지 확인합니다.

## 3단계. 실시간 보고서로 일반 기기 도착 확인

DebugView는 디버그 기기만 보여 줍니다. 디버그 모드가 아닌 일반 기기에서도 이벤트가 도착하는지는 GA4보고서 → 실시간에서 확인합니다. 최근 30분 내 이벤트 이름별 이벤트 수 카드에서 방금 보낸 이벤트명을 찾습니다.

![GA4 실시간 보고서 실제 화면. 이벤트 이름별 이벤트 수 카드에서 login, screen_view, search, select_content 이벤트 도착 여부를 확인한다.](/wiki-assets/playbook/how-to-verify-firebase-integration/03-realtime-report.png)

> **화면 3.** 실시간 보고서에서 일반 기기 이벤트가 도착하는지 확인합니다.

> **정보**
>
> 실시간 보고서는 빠르게 도착 여부를 보는 용도입니다. 정확한 누적 수치나 맞춤 측정기준 값은 처리 시간이 지난 뒤 표준 보고서에서 확인합니다.

## 4단계. 이벤트 보고서와 맞춤 측정기준 확인

운영 보고서에서는 보고서 → 참여도 → 이벤트에서 이벤트 이름별 수집량을 확인합니다. 표준 파라미터가 아닌 커스텀 파라미터는 맞춤 측정기준 등록 이후 들어온 데이터부터 보고서에서 사용할 수 있습니다.

| 확인 위치 | 확인 내용 | 주의점 |
| --- | --- | --- |
| DebugView | 개발 기기 이벤트와 파라미터 | 디버그 모드 기기만 표시 |
| 실시간 보고서 | 최근 30분 이벤트 도착 여부 | 정밀 수치 검증용은 아님 |
| 이벤트 보고서 | 처리 완료 후 이벤트 누적 수 | 보고서 반영 지연 가능 |
| 이벤트 범위 맞춤 측정기준 | 커스텀 파라미터별 분석 | 등록 이후 데이터부터 적용 |
| 사용자 범위 맞춤 측정기준 | User Property별 사용자 분석 | 등록 이후 데이터부터 적용 |

> **팁**
>
> 이벤트 보고서와 맞춤 측정기준은 처리 시간이 지난 뒤 확인합니다. 당일 구현 검증은 DebugView와 실시간 보고서를 기준으로 보고, 다음날 운영 보고서에서 누적 수집 여부를 다시 확인합니다.

## 5단계. 이벤트가 안 보일 때 점검

이벤트가 보이지 않을 때는 같은 순서로 확인합니다. 대부분은 프로젝트/앱 식별자 불일치, 디버그 모드 미적용, SDK 초기화 누락 중 하나입니다.

![Firebase 이벤트 검증 체크리스트 이미지. SDK 초기화, 앱 식별자, DebugView 모드, 실시간 보고서, 맞춤 측정기준 등록 여부를 순서대로 확인하는 표가 표시되어 있다.](/wiki-assets/playbook/how-to-verify-firebase-integration/04-verification-checklist.png)

> **체크리스트.** 안 보일 때는 프로젝트, 앱 식별자, 디버그 모드, 파라미터 등록 순서로 확인합니다.

| 점검 항목 | 확인 기준 |
| --- | --- |
| Firebase 프로젝트 | 앱에 포함된 설정 파일이 현재 확인 중인 Firebase/GA4 프로젝트와 일치 |
| 앱 식별자 | Android `applicationId`, iOS Bundle ID가 Firebase 앱 등록값과 일치 |
| SDK 초기화 | 앱 실행 시 Firebase Analytics 초기화 로그가 출력 |
| 디버그 모드 | Android는 실제 `applicationId`, iOS는 `-FIRDebugEnabled` 적용 |
| 이벤트 코드 | 사용자 행동 시점에 `logEvent`가 실제 호출됨 |
| User Property | DebugView의 현재 적용된 사용자 속성 영역에 의도한 값이 표시됨 |
| 맞춤 측정기준 | 커스텀 파라미터와 User Property는 GA4 UI에서 범위에 맞게 등록 후 재전송 |

> **완료**
>
> DebugView에서 이벤트와 파라미터가 보이고, 실시간 보고서에서 일반 기기 이벤트가 도착하면 기본 연동 검증은 완료된 상태로 봅니다.

## 참고 링크

- [Firebase Analytics DebugView](https://firebase.google.com/docs/analytics/debugview)
- [GA4 실시간 보고서 도움말](https://support.google.com/analytics/answer/9271392)
- [GA4 이벤트 보고서 도움말](https://support.google.com/analytics/answer/10075209)
- [Firebase 이벤트 전송하기](/wiki/playbook/firebase-checklist/how-to-send-firebase-events)
- [Firebase User Property 설정하기](/wiki/playbook/firebase-checklist/how-to-set-firebase-user-properties)

## 자주 묻는 질문

### DebugView에 아무 이벤트도 안 보입니다.

디버그 모드가 꺼져 있거나 잘못된 앱 식별자로 켰을 가능성이 큽니다. Android는 `setprop`의 값이 실제 `applicationId`와 같은지, iOS는 `-FIRDebugEnabled`가 Run 인수에 들어갔는지 확인하세요.

### DebugView에는 보이는데 실시간 보고서에는 늦게 보입니다.

정상일 수 있습니다. DebugView는 디버그 기기 이벤트를 빠르게 보여 주고, 실시간 보고서는 전체 트래픽 처리 과정 때문에 몇 분 정도 지연될 수 있습니다.

### 커스텀 파라미터를 보냈는데 보고서에서 안 보입니다.

표준 파라미터가 아니라면 GA4 관리 화면에서 맞춤 측정기준으로 등록해야 보고서에서 사용할 수 있습니다. 등록 전 데이터에는 소급 적용되지 않습니다.

## Navigation

- [전체 플레이북 Markdown sitemap](/wiki/playbook/sitemap.md)

### Firebase

- [Firebase](/wiki/playbook/firebase-checklist)
- [Firebase 프로젝트·앱 등록](/wiki/playbook/firebase-checklist/how-to-create-firebase-app)
- [Firebase SDK 초기화](/wiki/playbook/firebase-checklist/how-to-initialize-firebase-sdk)
- [Firebase WebView 이벤트 연동](/wiki/playbook/firebase-checklist/how-to-connect-firebase-webview-events)
- [Firebase 이벤트 전송](/wiki/playbook/firebase-checklist/how-to-send-firebase-events)
- [Firebase User ID·User Property 설정](/wiki/playbook/firebase-checklist/how-to-set-firebase-user-properties)
- [Firebase 연동 검증](/wiki/playbook/firebase-checklist/how-to-verify-firebase-integration) (현재 문서)