이 빠른 시작에서는 Google Analytics를 앱에 추가하고 이벤트 로깅을 시작합니다.
Google Analytics에서 앱의 사용 현황 및 행동 데이터를 수집합니다. SDK 다음과 같은 두 가지 기본 유형의 정보를 기록합니다.
- 이벤트: 사용자 행동, 시스템 이벤트, 오류 등 앱에서 발생하는 상황입니다.
- 사용자 속성: 사용자층을 나눈 세그먼트를 기술하고자 개발자가 정의하는 언어 환경설정, 지리적 위치 등의 속성입니다.
Analytics에서 자동으로 이벤트 및 사용자 속성 별도의 코드를 추가하지 않아도 됩니다.
시작하기 전에
아직 추가하지 않았다면 Apple 프로젝트에 Firebase를 추가합니다. Firebase에서 Google Analytics가 사용 설정되어 있는지 확인합니다. 프로젝트:
새 Firebase 프로젝트를 만드는 경우 Google Analytics를 사용 설정합니다. 프로젝트 생성 워크플로에서 작성할 수 있습니다
기존 Firebase 프로젝트를 사용하면 Google Analytics 사용 설정됨, 다음으로 이동: 통합
을 클릭하여 사용 설정합니다. > 탭 프로젝트 설정
프로젝트에서 Google Analytics를 사용 설정하면 Firebase 앱이 데이터 스트림 Google Analytics개에 연결되어 있습니다.
(권장) 프로젝트에 AdSupport 프레임워크를 추가하여 잠재고객 및 캠페인 기여 분석과 같은 추가 기능을 사용 설정합니다.
앱에 Analytics SDK 추가
Swift Package Manager를 사용해 Firebase 종속 항목을 설치하고 관리하세요.
- 앱 프로젝트를 연 상태로 Xcode에서 File(파일) > Add Packages(패키지 추가)로 이동합니다.
- 메시지가 표시되면 Firebase Apple 플랫폼 SDK 저장소를 추가합니다.
- Analytics 라이브러리를 선택합니다.
- 타겟 빌드 설정의 Other Linker Flags(기타 링커 플래그) 섹션에
-ObjC
플래그를 추가합니다. - Analytics 사용 환경을 최적화하려면 다음을 권장합니다. Google Analytics 사용 설정 Google 애널리틱스용 Firebase SDK를 앱에 추가하면 됩니다. 다음을 수행할 수 있습니다. IDFA 수집이 없는 라이브러리 또는 IDFA 수집이 있는 라이브러리를 선택하세요.
- 완료되면 Xcode가 백그라운드에서 자동으로 종속 항목을 확인하고 다운로드하기 시작합니다.
https://github.com/firebase/firebase-ios-sdk.git
Apple의 사용자 개인 정보 보호 및 데이터 사용과 앱 추적 투명성 문서에서 기기 수준 광고 식별자인 IDFA에 대해 자세히 알아보세요.
그런 다음 몇 가지 구성 단계를 따릅니다.
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; // ...
- 앱 대리자의
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];
- 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() } } } }
(선택사항) Apple 광고 네트워크 기여 분석 등록 사용 중지
개발자 편의를 위해 SDK는 SKAdNetwork를 통한 광고 네트워크 기여 분석을 위해 앱을 Apple에 자동으로 등록합니다.
이 기능을 사용 중지하려면 앱의 info.plist 파일에서 GOOGLE_ANALYTICS_REGISTRATION_WITH_AD_NETWORK_ENABLED
를 NO
(불리언)로 설정합니다.
이벤트 로깅 시작
FirebaseApp
인스턴스를 구성한 후에는 logEvent()
메서드를 사용하여 이벤트 로깅을 시작할 수 있습니다.
모든 앱에 권장되는 특정 이벤트가 있으며 특정 비즈니스 유형이나 카테고리에 권장되는 이벤트가 있습니다. 추천 이벤트를 사전 정의된 매개변수와 함께 전송해야 합니다. 이렇게 하면 보고서에 세부정보가 최대한 포함되고 향후 기능 및 통합을 즉시 사용할 수 있습니다. 이 섹션에서는 사전 정의된 이벤트 로깅을 보여줍니다. 이벤트 로깅에 대한 자세한 내용은 이벤트 로깅을 참조하세요.
다음 예시에서는 사용자가 앱의 특정 요소를 클릭했음을 나타내는 추천 이벤트를 로깅하는 방법을 보여줍니다.
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" }];
Xcode 디버그 콘솔에서 이 이벤트를 보려면 애널리틱스 디버깅을 사용 설정합니다.
- Xcode에서 Product(제품) > Scheme(스킴) > Edit scheme(스킴 수정)을 선택합니다.
- 왼쪽 메뉴에서 Run(실행)을 선택합니다.
- Arguments(인수) 탭을 선택합니다.
- Arguments Passed On Launch(실행 시 전달 인수) 섹션에
-FIRAnalyticsDebugEnabled
를 추가합니다.
다음 단계
- 각 애널리틱스 보고서 이해하기
- DebugView를 사용하여 이벤트를 확인합니다.
- Firebase 콘솔에서 데이터를 살펴보세요.
- 이벤트 및 사용자 속성에 대한 가이드를 살펴봅니다.
- BigQuery로 데이터를 내보내는 방법을 알아봅니다.