Google 애널리틱스 시작하기

iOS+ Android 웹 Flutter

이 빠른 시작에서는 앱에 Google Analytics를 추가하고 이벤트 로깅을 시작하는 방법을 설명합니다.

Google Analytics는 앱의 사용량과 행동 데이터를 수집합니다. 이 SDK는 다음 두 가지 기본 유형의 정보를 로깅합니다.

• 이벤트: 사용자 행동, 시스템 이벤트, 오류 등 앱에서 발생하는 상황입니다.
• 사용자 속성: 사용자층을 나눈 세그먼트를 기술하고자 개발자가 정의하는 언어 환경설정, 지리적 위치 등의 속성입니다.

Analytics는 몇 가지 이벤트와 사용자 속성을 자동으로 로깅하며 별도의 코드 없이 이러한 속성을 사용 설정할 수 있습니다.

시작하기 전에

1. Apple 프로젝트에 Firebase를 추가하지 않은 경우 추가하여 Firebase 프로젝트에서 Google Analytics를 사용 설정해야 합니다.

   • 새 Firebase 프로젝트를 만드는 경우 프로젝트 생성 워크플로에서 Google Analytics를 사용 설정합니다.

   • Google Analytics가 사용 설정되지 않은 기존 Firebase 프로젝트를 사용하는 경우 > 프로젝트 설정의 통합 탭에서 Google 애널리틱스를 사용 설정할 수 있습니다.

   경고: 2019년 7월 31일 이전에 만든 Firebase 프로젝트를 아직 업그레이드하지 않은 경우 전체 Google 애널리틱스 4 환경으로 업그레이드해야 합니다. (업그레이드가 필요한 경우 Analytics 대시보드에 배너가 표시됩니다) 데이터 수집을 계속하려면 관련 서비스 약관에 2022년 2월 15일까지 동의해야 합니다. 업그레이드에 대한 자세한 내용은 지원 FAQ의 프로젝트 소유자 찾기를 참조하세요.

   프로젝트에서 Google Analytics를 사용 설정하면 Firebase 앱이 Google Analytics 데이터 스트림에 연결됩니다.

2. (권장) 프로젝트에 AdSupport 프레임워크를 추가하여 잠재고객 및 캠페인 기여 분석과 같은 추가 기능을 사용 설정합니다.

앱에 Analytics SDK 추가

Swift Package Manager를 사용해 Firebase 종속 항목을 설치하고 관리하세요.

설치 가이드를 참조하여 직접 프레임워크 가져오기, CocoaPods 사용 등 Firebase SDK를 Apple 프로젝트에 추가하는 다양한 방법을 알아보세요.

1. 앱 프로젝트를 연 상태로 Xcode에서 File(파일) > Add Packages(패키지 추가)로 이동합니다.
2. 메시지가 표시되면 Firebase Apple 플랫폼 SDK 저장소를 추가합니다.

  https://github.com/firebase/firebase-ios-sdk.git

참고: 새 프로젝트에서 기본(최신) SDK 버전을 사용해야 하지만, 필요하면 이전 버전을 선택할 수도 있습니다. 최신 버전에서는 iOS의 온디바이스 전환 측정 업데이트와 같이 SDK 구조에 중요한 새로운 기능과 개선사항을 제공합니다.
3. Analytics 라이브러리를 선택합니다.
4. 타겟 빌드 설정의 Other Linker Flags(기타 링커 플래그) 섹션에 -ObjC 플래그를 추가합니다.
5. Analytics 사용 환경을 최적화하려면 Firebase 프로젝트에서 Google Analytics를 사용 설정하고 Google 애널리틱스용 Firebase SDK를 앱에 추가하는 것이 좋습니다. IDFA 수집이 없는 라이브러리 또는 IDFA 수집이 있는 라이브러리를 선택할 수 있습니다. Firebase용 Google Analytics SDK의 최신 모듈 구성에 대한 FAQ를 참조하세요.
6. 완료되면 Xcode가 백그라운드에서 자동으로 종속 항목을 확인하고 다운로드하기 시작합니다.

Apple의 사용자 개인 정보 보호 및 데이터 사용과 앱 추적 투명성 문서에서 기기 수준 광고 식별자인 IDFA에 대해 자세히 알아보세요.

그런 다음 몇 가지 구성 단계를 따릅니다.

1. UIApplicationDelegate의 FirebaseCore 모듈과 앱 대리자가 사용하는 다른 Firebase 모듈을 가져옵니다. 예를 들어 Cloud Firestore와 Authentication을 사용하려면 다음을 따르세요.

   SwiftUI

   import SwiftUI
   import FirebaseCore
   import FirebaseFirestore
   import FirebaseAuth
   // ...
         

   Swift

   import FirebaseCore
   import FirebaseFirestore
   import FirebaseAuth
   // ...
         

   Objective-C

   @import FirebaseCore;
   @import FirebaseFirestore;
   @import FirebaseAuth;
   // ...
         

2. 앱 대리자의 application(_:didFinishLaunchingWithOptions:) 메서드에서 FirebaseApp 공유 인스턴스를 구성합니다.

   SwiftUI

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

   Swift

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

   Objective-C

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

3. SwiftUI를 사용하는 경우 앱 대리자를 만들고 UIApplicationDelegateAdaptor 또는 NSApplicationDelegateAdaptor를 통해 App 구조체에 연결해야 합니다. 앱 대리자 재구성도 중지해야 합니다. 자세한 내용은 SwiftUI 안내를 참조하세요.

   SwiftUI

   @main
   struct YourApp: App {
     // register app delegate for Firebase setup
     @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate
   
     var body: some Scene {
       WindowGroup {
         NavigationView {
           ContentView()
         }
       }
     }
   }
         

인앱 구매를 추적하는 경우 Firebase를 초기화하기 전에 application:didFinishLaunchingWithOptions:에서 트랜잭션 관찰자를 초기화해야 합니다. 그렇지 않으면 관찰자가 모든 구매 알림을 받지 못할 수 있습니다. 자세한 내용은 Apple의 In-App Purchase Best Practices(인앱 구매 권장사항)를 참조하세요.

(선택사항) Apple 광고 네트워크 기여 분석 등록 사용 중지

개발자 편의를 위해 SDK는 SKAdNetwork를 통한 광고 네트워크 기여 분석을 위해 앱을 Apple에 자동으로 등록합니다. 이 기능을 사용 중지하려면 앱의 info.plist 파일에서 GOOGLE_ANALYTICS_REGISTRATION_WITH_AD_NETWORK_ENABLED를 NO(불리언)로 설정합니다.

이벤트 로깅 시작

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

모든 앱에 권장되는 특정 이벤트가 있으며 특정 비즈니스 유형이나 카테고리에 권장되는 이벤트가 있습니다. 추천 이벤트를 사전 정의된 파라미터와 함께 전송해야 합니다. 이렇게 하면 보고서에 세부정보가 최대한 포함되고 향후 기능 및 통합을 즉시 사용할 수 있습니다. 이 섹션에서는 사전 정의된 이벤트 로깅을 보여줍니다. 이벤트 로깅에 대한 자세한 내용은 이벤트 로깅을 참조하세요.

다음 예시에서는 사용자가 앱의 특정 요소를 클릭했음을 나타내는 추천 이벤트를 로깅하는 방법을 보여줍니다.

Swift

참고: 이 Firebase 제품은 macOS 대상에서 사용할 수 없습니다.

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

Objective-C

참고: 이 Firebase 제품은 macOS 대상에서 사용할 수 없습니다.

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

Xcode 디버그 콘솔에서 이 이벤트를 보려면 애널리틱스 디버깅을 사용 설정합니다.

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

다음 단계

• 각 애널리틱스 보고서를 이해합니다.
• DebugView를 사용하여 이벤트를 확인합니다.
• Firebase console에서 데이터를 살펴봅니다.
• 이벤트 및 사용자 속성에 대한 가이드를 살펴봅니다.
• BigQuery로 데이터를 내보내는 방법을 알아봅니다.