이벤트 로깅


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

이벤트는 사용자 행동, 시스템 이벤트 또는 오류와 같은 앱에서 발생하는 상황에 대한 통계를 제공합니다.

Analytics에서 자동으로 이벤트 아니에요 메시지를 수신하려면 코드를 추가해야 합니다. 앱에서 추가 전화번호 정보를 수집해야 하는 경우 데이터의 경우 앱에서 최대 500개의 서로 다른 Analytics 이벤트 유형을 로깅할 수 있습니다. 앱에서 로깅할 수 있는 이벤트의 총 분량에는 제한이 없습니다. 이벤트 이름은 대소문자를 구분합니다. 이름은 동일하지만 대소문자만 다른 두 이벤트를 로깅하면 서로 다른 이벤트 2개로 인식됩니다.

시작하기 전에

프로젝트를 설정했는지, 다음으로 Analytics에 액세스할 수 있는지 확인하세요. 설명 Analytics 시작하기

이벤트 로깅

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

시작하는 데 도움이 되도록 Analytics SDK에서는 다음과 같이 다양한 유형의 앱에서 공통적으로 사용되는 추천 이벤트입니다. 소매업 및 전자상거래, 여행, 게임 앱이 포함됩니다. 자세히 알아보기 이벤트 정보 언제 사용하는지 알아보려면 추천 이벤트를 참고하세요.

구현에 대한 자세한 내용은 SwiftObjective-C의 상수 참조를 확인하세요.

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

Swift

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

Objective-C

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

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

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

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

  • kFIRParameterValue 매개변수: kFIRParameterValue는 이벤트와 관련된 핵심 측정항목을 집계하는 데 유용한 범용 매개변수입니다. 수익, 거리, 시간, 점수 등을 예시로 들 수 있습니다.

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

Swift

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

Objective-C

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

기본 이벤트 매개변수 설정

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

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

Swift

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

Objective-C

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

매개변수가 logEvent() 드림 메서드의 경우 기본값 대신 해당 값이 사용됩니다.

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

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

상세 로깅을 사용 설정하여 SDK의 이벤트 로깅을 모니터링하면 이벤트가 올바르게 로깅되는지 확인할 수 있습니다. 여기에는 자동으로 로깅되는 이벤트와 수동으로 로깅되는 이벤트가 모두 포함됩니다.

다음과 같이 상세 로깅을 사용 설정할 수 있습니다.

  1. Xcode에서 Product(제품) > Scheme(스킴) > Edit scheme(스킴 수정)을 선택합니다.
  2. 왼쪽 메뉴에서 Run(실행)을 선택합니다.
  3. Arguments(인수) 탭을 선택합니다.
  4. Arguments Passed On Launch(실행 시 전달 인수) 섹션에 -FIRAnalyticsVerboseLoggingEnabled를 추가합니다.

다음에 앱을 실행하면 Xcode 디버그 콘솔에 이벤트가 표시되어 이벤트 전송 여부를 즉시 확인할 수 있습니다.

대시보드에서 이벤트 보기

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

이 데이터는 이벤트 대시보드는 Firebase 콘솔에서 확인할 수 있습니다. 이 대시보드에는 앱에서 로깅된 이벤트 유형별로 자동 생성된 이벤트 보고서가 표시됩니다.