Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

이벤트 로깅

이 가이드에서는 앱에서 이벤트를 로깅하는 방법을 설명합니다.

이벤트는 사용자 행동, 시스템 이벤트, 오류 등 앱에서 발생하는 상황을 파악하는 수단입니다.

애널리틱스는 몇 가지 이벤트를 자동으로 로깅하며 별도의 코드 없이 이벤트를 수신할 수 있습니다. 앱에서 데이터를 추가로 수집해야 하는 경우 서로 다른 애널리틱스 이벤트 유형을 최대 500개까지 로깅할 수 있습니다. 앱에서 로깅할 수 있는 이벤트의 총 분량에는 제한이 없습니다. 이벤트 이름은 대소문자를 구분합니다. 이름은 동일하지만 대소문자만 다른 두 이벤트를 로깅하면 서로 다른 이벤트 두 개로 인식됩니다.

시작하기 전에

애널리틱스 시작하기의 설명처럼 프로젝트가 설정되어 있고 애널리틱스에 액세스할 수 있는지 확인하세요.

이벤트 로깅

firebase.analytics() 인스턴스를 구성한 후에는 logEvent() 메서드를 사용하여 이벤트 로깅을 시작할 수 있습니다. Google 애널리틱스에 익숙한 경우 이 메서드는 gtag.jsevent 명령어 사용과 동일합니다.

처음 시작하는 개발자를 위해 애널리틱스 SDK에서는 소매 및 전자상거래, 여행, 게임 앱을 포함한 다양한 유형의 앱에서 공통적으로 사용되는 여러 가지 추천 이벤트를 정의합니다. 이러한 이벤트에 대한 자세한 내용과 사용법은 Firebase 고객센터의 이벤트 및 속성 문서를 참조하세요.

참고: 보고서에 세부정보를 최대한 포함하려면 앱에 적합한 추천 이벤트와 사전 정의된 매개변수를 로깅하세요. 이렇게 하면 Google 애널리틱스의 최신 기능도 출시 즉시 사용할 수 있습니다.

여러 이벤트 및 매개변수의 구현에 대한 자세한 내용은 gtag.js 이벤트 참조를 확인하세요.

다음 예시에서는 select_content 이벤트를 로깅하는 방법을 보여줍니다.

웹 버전 9

import { getAnalytics, logEvent } from "firebase/analytics";

const analytics = getAnalytics();
logEvent(analytics, 'select_content', {
  content_type: 'image',
  content_id: 'P12453',
  items: [{ name: 'Kittens' }]
});

웹 버전 8

analytics.logEvent('select_content', {
  content_type: 'image',
  content_id: 'P12453',
  items: [{ name: 'Kittens' }]
});

사전 정의된 매개변수뿐 아니라 다음과 같은 매개변수를 이벤트에 추가할 수 있습니다.

  • 커스텀 매개변수: 커스텀 매개변수를 애널리틱스 보고서의 보고 대상으로 등록할 수 있습니다. 커스텀 매개변수를 잠재고객 정의에서 필터로 사용하여 모든 보고서에 적용할 수도 있습니다. 앱을 BigQuery 프로젝트에 연결한 경우 BigQuery로 내보내는 데이터에도 커스텀 매개변수가 포함됩니다.
  • value 매개변수: value는 이벤트와 관련된 핵심 측정항목을 집계하는 데 유용한 범용 매개변수입니다. 수익, 거리, 시간, 점수 등을 예시로 들 수 있습니다.

애플리케이션에 추천 이벤트 유형으로 해결되지 않는 특정 요구사항이 있으면 자체 커스텀 이벤트를 로깅할 수 있습니다. 예를 들어 게임을 개발 중이고 플레이어가 특정 목표를 달성한 시점을 추적하려는 경우 다음 예시와 같은 이벤트를 로깅하면 됩니다.

웹 버전 9

import { getAnalytics, logEvent } from "firebase/analytics";

const analytics = getAnalytics();
logEvent(analytics, 'goal_completion', { name: 'lever_puzzle'});

웹 버전 8

analytics.logEvent('goal_completion', { name: 'lever_puzzle'});

대시보드에서 이벤트 보기

Firebase Console 대시보드에서 이벤트의 집계된 통계를 확인할 수 있습니다. 이 대시보드는 정기적, 지속적으로 업데이트됩니다. 즉각적인 테스트가 필요하다면 앞 섹션에서 설명한 logcat 출력을 사용하세요.

Firebase Console의 이벤트 대시보드에서 이 데이터에 액세스할 수 있습니다. 이 대시보드에는 앱에서 로깅된 이벤트 유형별로 자동 생성된 이벤트 보고서가 표시됩니다.