DebugView로 애널리틱스 구성 확인하기

개발 중에 DebugView를 사용하여 앱의 애널리틱스 구성이 제대로 되었는지 확인하세요.

애널리틱스의 배포 기능은 휴대기기의 네트워크 데이터 보존과 배터리 수명 연장을 위해 사용 데이터를 주기적으로(일반적으로 1시간마다) 폴링합니다. 그러나 개발 중에는 바로 조정이 가능하도록 이벤트를 즉시 확인하는 것이 좋습니다. DebugView를 사용하면 앱 및 웹사이트의 이벤트를 실시간으로 모니터링할 수 있습니다.

DebugView를 사용하려면 먼저 기기 또는 사이트에서 디버그 모드를 사용 설정해야 합니다.

휴대기기 또는 브라우저에서 사용 설정

Android

에뮬레이션된 Android 기기에서 애널리틱스 디버그 모드를 사용 설정하려면 다음 명령줄을 실행하세요.

adb shell setprop debug.firebase.analytics.app <package_name>

이 동작은 아래의 명령줄을 실행하여 디버그 모드를 명시적으로 사용 중지할 때까지 유지됩니다.

adb shell setprop debug.firebase.analytics.app .none.

iOS

개발 기기에 애널리틱스 디버그 모드를 사용 설정하려면 Xcode에서 다음 명령줄 인수를 지정합니다.

-FIRDebugEnabled

이 동작은 아래의 명령줄 인수를 지정하여 디버그 모드를 명시적으로 사용 중지할 때까지 유지됩니다.

-FIRDebugDisabled

브라우저

브라우저에서 애널리틱스 디버그 모드를 사용 설정하려면 Google 애널리틱스 디버거 Chrome 확장 프로그램을 설치하세요.

프로그램이 설치되면 확장 프로그램을 사용 설정하고 페이지를 새로고침합니다. 이 시점부터 확장 프로그램은 디버그 모드로 앱의 이벤트를 로깅합니다.

Firebase Console의 DebugView에서 로깅된 이벤트를 볼 수 있습니다.

참고: DebugView를 사용하기 전에 기기의 시간이 정확한지 확인해야 합니다. 기기 시계에 오차가 있으면 애널리틱스 보고서에서 이벤트가 지연되거나 누락될 수 있습니다.

웹사이트에서 사용 설정

모든 이벤트에 대해 gtag.js를 통해

'debug mode' = true 매개변수를 포함합니다. 예:

gtag('config', 'G-12345ABCDE',{'debug_mode':true});

개별 이벤트에 대해 gtag.js를 통해

gtag('event', 'xyz', {
  'debug_mode':true
});

모든 이벤트에 대해 Google 태그 관리자를 통해

Google 애널리틱스 태그 유형: GA4 구성을 사용합니다.

'debug mode' = true 필드를 포함합니다.

개별 이벤트에 대해 Google 태그 관리자를 통해

Google 애널리틱스 태그 유형: GA4 이벤트를 사용합니다.

이벤트에 대해 debug_mode 필드를 true로 설정합니다.

보고서

클라이언트 측에서 개인정보 보호 설정을 구현했거나 개발자가 동의 모드를 구현하고 사용자가 애널리틱스 쿠키에 동의하지 않은 경우 디버그 모드에서 이벤트가 표시되지 않습니다.

개발 기기에서 디버그 모드를 사용 설정했으면 DebugView로 이동한 후 앱 사용을 시작하여 DebugView 보고서에 기록되는 앱 이벤트를 확인하세요.

가운데 열의 초 스트림에는 최근 60초 동안 기록된 이벤트가 표시됩니다. 왼쪽 열의 분 스트림에는 최근 30분 동안 보관처리된 일련의 이벤트가 표시됩니다. 오른쪽 열에는 30분 동안 기록된 상위 이벤트 및 현재 선택한 개발 기기의 현재 사용자 속성이 표시됩니다.

초 스트림

기본적으로 최근 60초 동안 기록된 이벤트의 목록이 표시됩니다. 각 이벤트에는 개발 기기에 기록된 시간의 타임스탬프가 표시됩니다. 이벤트를 클릭하여 연결된 매개변수 목록을 확인할 수 있습니다. 앱 사용 중에 사용자 속성 값이 변경되면 스트림에 이벤트가 나타나며 최신 이벤트가 맨 위에 표시됩니다.

분 스트림

이 스트림에는 일련의 원이 표시되며, 원 하나가 최근 30분을 나타냅니다. 원의 숫자는 각 1분에 수신된 이벤트의 수를 나타냅니다. 원 하나를 클릭하면 해당 1분 동안 기록된 이벤트가 초 스트림에 표시됩니다. 이러한 방식을 통해 최근 30분 동안 기록된 이벤트를 자세히 분석할 수 있습니다.

인기 이벤트 및 현재 사용자 속성

인기 이벤트 표에는 30분 동안 가장 많이 기록된 이벤트가 표시됩니다. 현재 사용자 속성 표에는 현재 선택한 개발 기기에 대한 사용자 속성 세트의 최신 상태가 표시됩니다.

기기 선택기

다양한 개발 기기에 디버그 모드를 사용 설정할 수 있으므로 기기 선택기를 사용하여 DebugView 보고서에서 초점을 맞출 특정 기기를 선택할 수 있습니다. 이를 통해 여러 개발자가 서로에게 영향을 주지 않고 자신이 담당한 계측 및 검증 업무에 집중할 수 있습니다. 기기 선택기 메뉴는 디버그 기기 보고서의 왼쪽 상단에 있습니다.

도움이 되었나요?
어떻게 하면 개선할 수 있을까요?