Google I/O 2023에서 Firebase의 주요 소식을 확인하세요. 자세히 알아보기

이벤트 로깅

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

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

시작하기 전에

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

이벤트 로깅

FirebaseAnalytics 인스턴스를 만든 후 이 인스턴스를 사용하여 라이브러리의 log 메서드로 이벤트를 로깅할 수 있습니다.

사전 정의된 이벤트

시작하는 데 도움을 제공하기 위해 애널리틱스 SDK에서는 소매 및 전자상거래, 여행, 게임 앱을 포함한 다양한 유형의 앱에서 공통적으로 사용되는 여러 가지 추천 이벤트를 정의합니다. 이러한 이벤트에 대한 정보와 사용 시점을 자세히 알아보려면 추천 이벤트를 참조하세요.

API 참조에서 추천 이벤트 유형의 로그 메서드를 찾을 수 있습니다.

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

await FirebaseAnalytics.instance.logSelectContent(
    contentType: "image",
    itemId: itemId,
);

또는 logEvent()를 사용하여 동일한 이벤트를 로깅할 수 있습니다.

await FirebaseAnalytics.instance.logEvent(
    name: "select_content",
    parameters: {
        "content_type": "image",
        "item_id": itemId,
    },
);

사전 정의된(필수) 매개변수 이외의 다른 매개변수를 추가로 지정하려는 경우에 유용할 수 있습니다. 다음 매개변수를 이벤트에 추가할 수 있습니다.

맞춤 매개변수: 맞춤 매개변수를 애널리틱스 보고서에서 측정기준 또는 측정항목으로 사용할 수 있습니다. 숫자가 아닌 이벤트 매개변수 데이터에는 맞춤 측정기준을, 숫자로 보다 잘 표현되는 매개변수 데이터에는 맞춤 측정항목을 사용할 수 있습니다. SDK를 사용하여 맞춤 매개변수를 로깅한 후에는 이러한 맞춤 매개변수가 애널리틱스 보고서에 표시되도록 측정기준이나 측정항목을 등록합니다. 애널리틱스 > 이벤트 > 맞춤 정의 관리 > 맞춤 측정기준 만들기를 사용하여 등록하면 됩니다.

모든 보고서에 적용될 수 있는 잠재고객 정의에 맞춤 매개변수를 사용할 수 있습니다. 앱을 BigQuery 프로젝트에 연결한 경우 BigQuery로 내보내는 데이터에도 맞춤 매개변수가 포함됩니다. Google 애널리틱스 4 BigQuery Export에서 샘플 쿼리 등을 확인하세요.
value 매개변수: 이벤트에 해당하는 핵심 측정항목을 집계하는 데 유용한 범용 매개변수입니다. 수익, 거리, 시간, 점수 등을 예시로 들 수 있습니다.
매개변수 이름은 최대 40자(영문 기준)이며 알파벳으로 시작해야 하고 영숫자 문자와 밑줄만 포함할 수 있습니다. 문자열 및 num 유형이 지원됩니다. 문자열 매개변수 값은 최대 100자(영문 기준)까지 허용됩니다. 'firebase', 'google' 및 'ga_' 프리픽스는 예약되어 있으므로 매개변수 이름에 사용해서는 안 됩니다.

맞춤 이벤트

애플리케이션에 추천 이벤트 유형으로 해결되지 않는 특정한 요구사항이 있다면 다음 예와 같이 맞춤 이벤트를 직접 기록할 수 있습니다.

await FirebaseAnalytics.instance.logEvent(
    name: "share_image",
    parameters: {
        "image_name": name,
        "full_text": text,
    },
);

기본 이벤트 매개변수 설정

setDefaultEventParameters()를 사용하면 여러 이벤트를 아울러 매개변수를 로깅할 수 있습니다. 기본 매개변수는 이후에 로깅되는 모든 이벤트와 연결됩니다.

맞춤 매개변수와 마찬가지로 애널리틱스 보고서에 표시되도록 기본 이벤트 매개변수를 등록합니다.

유효한 매개변수 값은 문자열과 num입니다. 키 값을 null로 설정하면 해당 매개변수가 삭제됩니다. null 값을 전달하면 모든 매개변수가 삭제됩니다.

// Not supported on web
await FirebaseAnalytics.instance
  .setDefaultEventParameters({
    version: '1.2.3'
  });

매개변수가 logEvent() 또는 log 메서드에서 지정되었으면 해당 값이 기본값 대신 사용됩니다.

기본 매개변수를 삭제하려면 매개변수를 null로 설정하여 setDefaultEventParameters() 메서드를 호출합니다.

대시보드에서 이벤트 보기

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

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