이벤트 로깅

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

애널리틱스는 몇 가지 이벤트를 자동으로 기록하며 별도의 코드 없이 이벤트를 수신할 수 있습니다. 앱에서 더 많은 데이터를 수집해야 하는 경우 앱에서 최대 500개의 서로 다른 애널리틱스 이벤트 유형을 기록할 수 있습니다. 앱에서 기록할 수 있는 이벤트의 총 분량에는 제한이 없습니다.

시작하기 전에

처음으로 앱에 애널리틱스를 추가하는 경우 다음 단계를 완료하세요.

Firebase 콘솔에서 앱 연결

  1. Firebase SDK를 설치합니다.
  2. Firebase 콘솔에서 Firebase 프로젝트에 앱을 추가합니다.

앱에 애널리틱스 추가

  1. Podfile에 Firebase 종속 항목을 추가합니다.
    pod 'Firebase/Core'
  2. pod install을 실행하고 생성된 .xcworkspace 파일을 엽니다.
  3. UIApplicationDelegate에서 Firebase 모듈을 가져옵니다.

    Swift

    import Firebase
    

    Objective-C

    @import Firebase;
    
  4. 일반적으로 애플리케이션의 application:didFinishLaunchingWithOptions: 메소드에서 FirebaseApp 공유 인스턴스를 구성합니다.

    Swift

    // Use Firebase library to configure APIs
    FirebaseApp.configure()
    

    Objective-C

    // Use Firebase library to configure APIs
    [FIRApp configure];
    

이벤트 로깅

FirebaseApp 인스턴스를 구성한 후 logEventWithName() 메소드로 이벤트 로깅을 시작할 수 있습니다.

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

구현에 대한 자세한 내용은 다음 위치를 참조하세요.

  • 추천 이벤트: FIREventNames.h 헤더 파일 참조
  • 사전 정의된 이벤트: FIRParameterNames.h 헤더 파일 참조

다음 예에서는 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"
                                 }];

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

  • 맞춤 매개변수: 애널리틱스 보고서의 보고 대상으로 맞춤 매개변수를 등록할 수 있습니다. 맞춤 매개변수를 잠재고객 정의에서 필터로 사용하여 모든 보고서에 적용할 수도 있습니다. 앱을 BigQuery 프로젝트에 연결한 경우 BigQuery로 내보내는 데이터에도 맞춤 매개변수가 포함됩니다.

  • 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
                                 }];

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

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

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

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

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

대시보드에서 이벤트 보기

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

Firebase 콘솔에서 다음과 같이 이 데이터에 액세스할 수 있습니다.

  1. Firebase 콘솔에서 프로젝트를 엽니다.
  2. 메뉴에서 애널리틱스를 선택하여 애널리틱스 보고 대시보드를 표시합니다.

앱에서 로깅된 애널리틱스 이벤트 유형별로 자동으로 작성된 이벤트 보고서이벤트 탭에 표시됩니다. 자세한 내용은 Firebase 고객센터에서 애널리틱스 보고 대시보드를 참조하세요.

다음에 대한 의견 보내기...

도움이 필요하시나요? 지원 페이지를 방문하세요.