Firebase Summit에서 발표된 모든 내용을 살펴보고 Firebase로 앱을 빠르게 개발하고 안심하고 앱을 실행하는 방법을 알아보세요. 자세히 알아보기

로그 이벤트

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

이 가이드는 앱에서 이벤트를 기록하는 방법을 보여줍니다.

이벤트 는 사용자 작업, 시스템 이벤트 또는 오류와 같이 앱에서 일어나는 일에 대한 통찰력을 제공합니다.

Analytics는 자동으로 일부 이벤트 를 기록합니다. 코드를 받기 위해 코드를 추가할 필요가 없습니다. 앱에서 추가 데이터를 수집해야 하는 경우 앱에서 최대 500개의 서로 다른 분석 이벤트 유형 을 기록할 수 있습니다. 앱이 기록하는 이벤트의 총량에는 제한이 없습니다. 이벤트 이름은 대소문자를 구분하며 이름이 대소문자만 다른 두 이벤트를 기록하면 두 개의 고유한 이벤트가 발생합니다.

시작하기 전에

프로젝트를 설정했고 Analytics 시작하기 에 설명된 대로 Analytics에 액세스할 수 있는지 확인하십시오.

이벤트 기록

FirebaseApp 인스턴스를 구성한 후에는 logEvent() 메서드를 사용하여 이벤트 로깅을 시작할 수 있습니다.

시작하는 데 도움이 되도록 Analytics SDK는 소매 및 전자 상거래, 여행, 게임 앱을 비롯한 다양한 유형의 앱에서 공통적인 여러 권장 이벤트를 정의합니다. 이러한 이벤트 와 사용 시기에 대해 자세히 알아보려면 권장 이벤트 를 참조하십시오.

SwiftObjective-C 에 대한 상수 참조에서 구현 세부 정보를 찾을 수 있습니다.

다음 예는 권장 kFIRSelectContent 이벤트를 기록하는 방법을 보여줍니다.

빠른

Analytics.logEvent(AnalyticsEventSelectContent, parameters: [
  AnalyticsParameterItemID: "id-\(title!)",
  AnalyticsParameterItemName: title!,
  AnalyticsParameterContentType: "cont",
])

오브젝티브-C

[FIRAnalytics logEventWithName:kFIREventSelectContent
                    parameters:@{
                                 kFIRParameterItemID:[NSString stringWithFormat:@"id-%@", self.title],
                                 kFIRParameterItemName:self.title,
                                 kFIRParameterContentType:@"image"
                                 }];

규정된 매개변수 외에도 다음 매개변수를 모든 이벤트에 추가할 수 있습니다.

  • 맞춤 매개변수: 맞춤 매개변수는 애널리틱스 보고서 에서 측정기준 또는 측정항목 으로 사용할 수 있습니다. 숫자가 아닌 이벤트 매개변수 데이터에는 사용자 정의 측정기준을 사용하고 숫자로 더 잘 표현되는 매개변수 데이터에는 사용자 정의 측정항목을 사용할 수 있습니다. SDK를 사용하여 맞춤 매개변수를 기록했으면 측정기준 또는 측정항목을 등록하여 해당 맞춤 매개변수가 Analytics 보고서에 표시되도록 합니다. 분석 > 이벤트 > 맞춤 정의 관리 > 맞춤 측정기준 만들기 를 통해 이 작업을 수행합니다.

    맞춤 매개변수는 모든 보고서에 적용될 수 있는 잠재고객 정의에 사용할 수 있습니다. 앱이 BigQuery 프로젝트에 연결된 경우 BigQuery로 내보낸 데이터에도 맞춤 매개변수가 포함됩니다. Google 애널리틱스 4 BigQuery 내보내기 에서 샘플 쿼리 등을 찾아보세요.

  • kFIRParameterValue 매개변수: kFIRParameterValue 는 이벤트와 관련된 주요 메트릭을 누적하는 데 유용한 범용 매개변수입니다. 예로는 수익, 거리, 시간 및 포인트가 있습니다.

애플리케이션에 권장 이벤트 유형에서 다루지 않는 특정 요구 사항이 있는 경우 다음 예와 같이 고유한 사용자 지정 이벤트를 기록할 수 있습니다.

빠른

Analytics.logEvent("share_image", parameters: [
  "name": name as NSObject,
  "full_text": text as NSObject,
])

오브젝티브-C

[FIRAnalytics logEventWithName:@"share_image"
                    parameters:@{
                                 @"name": name,
                                 @"full_text": text
                                 }];

기본 이벤트 매개변수 설정

setDefaultEventParameters 를 사용하여 이벤트 전반에 걸쳐 매개변수를 기록할 수 있습니다. 기본 매개변수는 기록되는 모든 향후 이벤트와 연결됩니다.

맞춤 매개변수와 마찬가지로 기본 이벤트 매개변수를 등록하여 해당 맞춤 매개변수가 Analytics 보고서에 표시되도록 합니다.

빠른

Analytics.setDefaultEventParameters([
  "level_name": "Caverns01",
  "level_difficulty": 4
])

오브젝티브-C

[FIRAnalytics setDefaultEventParameters:
  @{
  @"level_name": "Caverns01",
  @"level_difficulty": @(4)
}];

매개변수가 logEvent() 메소드에 지정된 경우 기본값 대신 해당 값이 사용됩니다.

기본 매개변수를 지우려면 매개변수가 nil 로 설정된 setDefaultEventParameters 메소드를 호출하십시오.

Xcode 디버그 콘솔에서 이벤트 보기

자세한 로깅을 활성화하여 SDK에서 이벤트 로깅을 모니터링하여 이벤트가 제대로 로깅되고 있는지 확인할 수 있습니다. 여기에는 자동 및 수동으로 기록된 이벤트가 모두 포함됩니다.

다음과 같이 상세 로깅을 활성화할 수 있습니다.

  1. Xcode에서 제품 > 구성표 > 구성표 편집... 을 선택합니다.
  2. 왼쪽 메뉴에서 실행 을 선택합니다.
  3. 인수 탭을 선택합니다.
  4. 실행 시 전달된 인수 섹션에서 -FIRAnalyticsVerboseLoggingEnabled 를 추가합니다.

다음에 앱을 실행할 때 이벤트가 Xcode 디버그 콘솔에 표시되어 이벤트가 전송되고 있는지 즉시 확인할 수 있습니다.

대시보드에서 이벤트 보기

Firebase 콘솔 대시보드에서 이벤트에 대한 집계된 통계를 볼 수 있습니다. 이러한 대시보드는 하루 종일 주기적으로 업데이트됩니다. 즉각적인 테스트를 위해 이전 섹션에서 설명한 대로 logcat 출력을 사용하십시오.

Firebase 콘솔의 이벤트 대시보드에서 이 데이터에 액세스할 수 있습니다. 이 대시보드는 앱에 의해 기록된 각각의 고유한 이벤트 유형에 대해 자동으로 생성되는 이벤트 보고서를 보여줍니다.